Deprecations
ASDF 2.15 introduced many new asdf.exceptions.AsdfDeprecationWarning
messages. These
warnings are subclasses of the built-in python DeprecationWarning
and will by
default be ignored except in __main__
and with testing tools such as
pytest.
These are intended to highlight use of features that we will likely remove in the next major version of ASDF (see our Release Cycle and Major Dependency Support Policy for more details about our versioning, compatibility and support policy).
Legacy Extension API Deprecation
A large number of asdf.exceptions.AsdfDeprecationWarning
messages appear related to
use of the legacy extension api. Some examples include:
asdf.type_index
asdf.resolver
the
asdf_extensions
entry pointportions of asdf.extension including:
asdf.extension.default_extensions
asdf.extension.get_cached_asdf_extensions
attributes to asdf.AsdfFile including:
This deprecated api is replaced by new-style converters, extensions and validators. asdf-astropy is a useful example package that uses these new-style extension api.
ASDF-in-FITS Deprecation
Support for AsdfInFits
(including the asdf.fits_embed
module) is
deprecated. Code using this format can migrate to using stdatamodels
which
contains functions to read and write AsdfInFits files
(see AsdfInFits for migration information).
Without support for fits_embed.AsdfInFits
the extract
and
remove-hdu
commands for asdftool are no longer usable and are
deprecated.
AsdfFile.blocks Deprecation
Direct usage of the ASDF block manager through asdf.AsdfFile.blocks
is deprecated.
The BlockManager api was not previously included in the documentation and
was unused by the legacy and new style extensions. Planned features for ASDF 3.0
include adding block storage support to converters.
asdf.tests.helpers Deprecation
Use of asdf.tests.helpers
is deprecated. Please see asdf.testing.helpers
for alternative functions to aid in testing.