Asdf

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

Bugfix
------

- Allow ``asdf.util.load_yaml`` to handle recursive objects (`1825
<https://github.com/asdf-format/asdf/pull/1825>`_)


Doc
---

- added issue links to changelog entries (`1827
<https://github.com/asdf-format/asdf/pull/1827>`_)
- Change asdf standard changelog entries to notes to ease transition to
towncrier (`1830 <https://github.com/asdf-format/asdf/pull/1830>`_)


General
-------

- fix changelog checker to remove brackets (`1828
<https://github.com/asdf-format/asdf/pull/1828>`_)


Removal
-------

- Deprecate ``ignore_version_mismatch``. This option has done nothing since
asdf 3.0.0 and will be removed in an upcoming asdf version (`1819
<https://github.com/asdf-format/asdf/pull/1819>`_)

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

- Fix issue where roundtripping a masked array with no masked values removes the mask [`1803 <https://github.com/asdf-format/asdf/issues/1803>`_]

- Use a custom exception ``AsdfSerializationError`` to indicate when an object in the
tree fails to be serialized by asdf (and by yaml). This exception currently inherits
from ``yaml.representer.RepresenterError`` to provide backwards compatibility. However
this inheritance may be dropped in a future asdf version. Please migrate to the new
``AsdfSerializationError``. [`1809 <https://github.com/asdf-format/asdf/issues/1809>`_]

- Drop ``importlib_metadata`` as a dependency on Python 3.12 and newer [`1810 <https://github.com/asdf-format/asdf/issues/1810>`_]

- Bumped minimal requirement on ``attrs`` from ``20.1.0`` to ``22.2.0`` [`1815 <https://github.com/asdf-format/asdf/issues/1815>`_]

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

- Fix ``__asdf_traverse__`` for non-tagged objects [`1739 <https://github.com/asdf-format/asdf/issues/1739>`_]

- Deprecate ``asdf.testing.helpers.format_tag`` [`1774 <https://github.com/asdf-format/asdf/issues/1774>`_]

- Deprecate ``asdf.versioning.AsdfSpec`` [`1774 <https://github.com/asdf-format/asdf/issues/1774>`_]

- Deprecate ``asdf.util.filepath_to_url`` use ``pathlib.Path.to_uri`` [`1735 <https://github.com/asdf-format/asdf/issues/1735>`_]

- Record package providing manifest for extensions used to write
a file and ``AsdfPackageVersionWarning`` when installed extension/manifest
package does not match that used to write the file [`1758 <https://github.com/asdf-format/asdf/issues/1758>`_]

- Fix bug where a dictionary containing a key ``id`` caused
any contained references to fail to resolve [`1716 <https://github.com/asdf-format/asdf/issues/1716>`_]

- Issue a ``AsdfManifestURIMismatchWarning`` during write if a used
extension was created from a manifest registered with a uri that
does not match the id in the manifest [`1785 <https://github.com/asdf-format/asdf/issues/1785>`_]

- Allow converters to provide types as strings that can
resolve to public classes (even if the class is implemented
in a private module). [`1654 <https://github.com/asdf-format/asdf/issues/1654>`_]

- Add options to control saving the base array when saving array views
controlled via ``AsdfConfig.default_array_save_base``,
``AsdfFile.set_array_save_base`` and
``SerializationContext.set_array_save_base`` [`1753 <https://github.com/asdf-format/asdf/issues/1753>`_]

- Deprecate ``ignore_implicit_conversion`` and "implicit conversion" [`1724 <https://github.com/asdf-format/asdf/issues/1724>`_]

- Add ``lazy_tree`` option to ``asdf.open`` and ``asdf.config``
to allow lazy deserialization of ASDF tagged tree nodes to
custom objects. [`1733 <https://github.com/asdf-format/asdf/issues/1733>`_]

- Deprecate ``copy_arrays`` in favor of ``memmap`` [`1797 <https://github.com/asdf-format/asdf/issues/1797>`_]

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

- Deprecate ``AsdfFile.version_map`` [`1745 <https://github.com/asdf-format/asdf/issues/1745>`_]

- Fix ``numpy.ma.MaskedArray`` saving for numpy 2.x [`1769 <https://github.com/asdf-format/asdf/issues/1769>`_]

- Add ``float16`` support [`1692 <https://github.com/asdf-format/asdf/issues/1692>`_]

- Removed unused ``asdf-unit-schemas`` dependency [`1767 <https://github.com/asdf-format/asdf/issues/1767>`_]

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

.. 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>`_]