Asdf

==================

.. note::
The ASDF Standard is at v1.6.0

- Cleanup ``asdf.util`` including deprecating: ``human_list``
``resolve_name`` ``minversion`` and ``iter_subclasses`` [`1688 <https://github.com/asdf-format/asdf/issues/1688>`_]

- Deprecate validation on ``AsdfFile.tree`` assignment. Please
use ``AsdfFile.validate`` to validate the tree [`1691 <https://github.com/asdf-format/asdf/issues/1691>`_]

- Deprecate validation during ``AsdfFile.resolve_references``. Please
use ``AsdfFile.validate`` to validate the tree [`1691 <https://github.com/asdf-format/asdf/issues/1691>`_]

- Deprecate ``asdf.asdf`` and ``AsdfFile.resolve_and_inline`` [`1690 <https://github.com/asdf-format/asdf/issues/1690>`_]

- Deprecate automatic calling of ``AsdfFile.find_references`` during
``AsdfFile.__init__`` and ``asdf.open`` [`1708 <https://github.com/asdf-format/asdf/issues/1708>`_]

- Allow views of memmapped arrays to keep the backing mmap
open to avoid segfaults [`1668 <https://github.com/asdf-format/asdf/issues/1668>`_]

- Introduce ``memmap`` argument to ``asdf.open`` that
overrides ``copy_arrays`` with documentation that describes
that the default for ``memmap`` when ``copy_arrays``
is removed in an upcoming asdf release will be ``False`` and
asdf will no longer by-default memory map arrays. [`1667 <https://github.com/asdf-format/asdf/issues/1667>`_]

- Introduce ``asdf.util.load_yaml`` to load just the YAML contents
of an ASDF file (with the option ``tagged`` to load the contents
as a tree of ``asdf.tagged.Tagged`` instances to preserve tags) [`1700 <https://github.com/asdf-format/asdf/issues/1700>`_]

- Require pytest 7+ and update asdf pytest plugin to be compatible
with the current development version of pytest (8.1) [`1731 <https://github.com/asdf-format/asdf/issues/1731>`_]

- Eliminate the use of the legacy ``tmpdir`` fixture in favor of
the new ``tmp_path`` fixture for temporary directory creation. [`1759 <https://github.com/asdf-format/asdf/issues/1759>`_]

- Remove conversion of warnings to errors in asdf pytest plugin. This
prevented other warning filters (like those provided with ``-W``)
from working. If you want these warnings to produce errors you can
now add your own warning filter [`1757 <https://github.com/asdf-format/asdf/issues/1757>`_]

- Only show ``str`` representation during ``info`` and ``search``
if it contains a single line (and does not fail) [`1748 <https://github.com/asdf-format/asdf/issues/1748>`_]

==================

.. note::
The ASDF Standard is at v1.6.0

- Fix bug in ``asdftool diff`` for arrays within a list [`1672 <https://github.com/asdf-format/asdf/issues/1672>`_]
- For ``info`` and ``search`` show ``str`` representation of childless
(leaf) nodes if ``show_values`` is enabled [`1687 <https://github.com/asdf-format/asdf/issues/1687>`_]
- Deprecate ``asdf.util.is_primitive`` [`1687 <https://github.com/asdf-format/asdf/issues/1687>`_]

==================

.. note::
The ASDF Standard is at v1.6.0

- Drop support for ASDF-in-FITS. [`1288 <https://github.com/asdf-format/asdf/issues/1288>`_]
- Add ``all_array_storage``, ``all_array_compression`` and
``all_array_compression_kwargs`` to ``asdf.config.AsdfConfig`` [`1468 <https://github.com/asdf-format/asdf/issues/1468>`_]
- Move built-in tags to converters (except ndarray and integer). [`1474 <https://github.com/asdf-format/asdf/issues/1474>`_]
- Add block storage support to Converter [`1508 <https://github.com/asdf-format/asdf/issues/1508>`_]
- Remove deprecated legacy extension API [`1464 <https://github.com/asdf-format/asdf/issues/1464>`_]
- Fix issue opening files that don't support ``fileno`` [`1557 <https://github.com/asdf-format/asdf/issues/1557>`_]
- Allow Converters to defer conversion to other Converters
by returning ``None`` in ``Converter.select_tag`` [`1561 <https://github.com/asdf-format/asdf/issues/1561>`_]
- Remove deprecated tests.helpers [`1597 <https://github.com/asdf-format/asdf/issues/1597>`_]
- Remove deprecated load_custom_schema [`1596 <https://github.com/asdf-format/asdf/issues/1596>`_]
- Remove deprecated TagDefinition.schema_uri [`1595 <https://github.com/asdf-format/asdf/issues/1595>`_]
- Removed deprecated AsdfFile.open and deprecated asdf.open
AsdfFile.write_to and AsdfFile.update kwargs [`1592 <https://github.com/asdf-format/asdf/issues/1592>`_]
- Fix ``AsdfFile.info`` loading all array data [`1572 <https://github.com/asdf-format/asdf/issues/1572>`_]
- Blank out AsdfFile.tree on close [`1575 <https://github.com/asdf-format/asdf/issues/1575>`_]
- Move ndarray to a converter, add ``convert_unknown_ndarray_subclasses``
to ``asdf.config.AsdfConfig``, move ``asdf.Stream`` to
``asdf.tags.core.Stream``, update block storage support for
Converter and update internal block API [`1537 <https://github.com/asdf-format/asdf/issues/1537>`_]
- Remove deprecated resolve_local_refs argument to load_schema [`1623 <https://github.com/asdf-format/asdf/issues/1623>`_]
- Move IntegerType to converter and drop cache of converted values. [`1527 <https://github.com/asdf-format/asdf/issues/1527>`_]
- Remove legacy extension API [`1637 <https://github.com/asdf-format/asdf/issues/1637>`_]
- Fix bug that left out the name of the arrays that differed
for ``asdftool diff`` comparisons [`1652 <https://github.com/asdf-format/asdf/issues/1652>`_]

==================-

.. note::
The ASDF Standard is at v1.6.0

- Add support for python 3.12 [`1641 <https://github.com/asdf-format/asdf/issues/1641>`_]

==================-

.. note::
The ASDF Standard is at v1.6.0

- Drop Python 3.8 support [`1556 <https://github.com/asdf-format/asdf/issues/1556>`_]
- Drop NumPy 1.20, 1.21 support [`1568 <https://github.com/asdf-format/asdf/issues/1568>`_]
- Convert numpy scalars to python types during yaml encoding
to handle NEP51 changes for numpy 2.0 [`1605 <https://github.com/asdf-format/asdf/issues/1605>`_]
- Vendorize jsonschema 4.17.3 [`1591 <https://github.com/asdf-format/asdf/issues/1591>`_]
- Drop jsonschema as a dependency [`1614 <https://github.com/asdf-format/asdf/issues/1614>`_]

==================-

.. note::
The ASDF Standard is at v1.6.0

- Require numpy<1.25 for python 3.8 [`1327 <https://github.com/asdf-format/asdf/issues/1327>`_]
- Add AsdfProvisionalAPIWarning to warn developers of new features that
may undergo breaking changes but are likely to be included as stable
features (without this warning) in a future version of ASDF [`1295 <https://github.com/asdf-format/asdf/issues/1295>`_]
- Add AsdfDeprecationWarning to AsdfFile.blocks [`1336 <https://github.com/asdf-format/asdf/issues/1336>`_]
- Document policy for ASDF release cycle including when support for ASDF versions
end. Also document dependency support policy. [`1323 <https://github.com/asdf-format/asdf/issues/1323>`_]
- Update lower pins on ``numpy`` (per release policy), ``packaging``, and ``pyyaml`` to
ones that we can successfully build and test against. [`1360 <https://github.com/asdf-format/asdf/issues/1360>`_]
- Provide more informative filename when failing to open a file [`1357 <https://github.com/asdf-format/asdf/issues/1357>`_]
- Add new plugin type for custom schema validators. [`1328 <https://github.com/asdf-format/asdf/issues/1328>`_]
- Add AsdfDeprecationWarning to ``asdf.types.CustomType`` [`1359 <https://github.com/asdf-format/asdf/issues/1359>`_]
- Throw more useful error when provided with a path containing an
extra leading slash [`1356 <https://github.com/asdf-format/asdf/issues/1356>`_]
- Add AsdfDeprecationWarning to AsdfInFits. Support for reading and
writing ASDF in fits files is being moved to `stdatamodels
<https://github.com/spacetelescope/stdatamodels>`_. [`#1337 <https://github.com/asdf-format/asdf/issues/1337>`_]
- Add AsdfDeprecationWarning to asdf.resolver [`1362 <https://github.com/asdf-format/asdf/issues/1362>`_]
- Add AsdfDeprecationWarning to asdf.tests.helpers.assert_extension_correctness [`1388 <https://github.com/asdf-format/asdf/issues/1388>`_]
- Add AsdfDeprecationWarning to asdf.type_index [`1403 <https://github.com/asdf-format/asdf/issues/1403>`_]
- Add warning to use of asdftool extract and remove-hdu about deprecation
and impending removal [`1411 <https://github.com/asdf-format/asdf/issues/1411>`_]
- Deprecate AsdfFile attributes that use the legacy extension api [`1417 <https://github.com/asdf-format/asdf/issues/1417>`_]
- Add AsdfDeprecationWarning to asdf.types [`1401 <https://github.com/asdf-format/asdf/issues/1401>`_]
- deprecate default_extensions, get_default_resolver and
get_cached_asdf_extension_list in asdf.extension [`1409 <https://github.com/asdf-format/asdf/issues/1409>`_]
- move asdf.types.format_tag to asdf.testing.helpers.format_tag [`1433 <https://github.com/asdf-format/asdf/issues/1433>`_]
- Deprecate AsdfExtenion, AsdfExtensionList, BuiltinExtension [`1429 <https://github.com/asdf-format/asdf/issues/1429>`_]
- Add AsdfDeprecationWarning to asdf_extensions entry point [`1361 <https://github.com/asdf-format/asdf/issues/1361>`_]
- Deprecate asdf.tests.helpers [`1440 <https://github.com/asdf-format/asdf/issues/1440>`_]
- respect umask when determining file permissions for written files [`1451 <https://github.com/asdf-format/asdf/issues/1451>`_]
- rename master branch to main [`1479 <https://github.com/asdf-format/asdf/issues/1479>`_]