2.2.0

Release Summary

Add support for Python 3.12 and improve subprocess_util

Minor Changes

• Declare support for Python 3.12 (#103).
• subprocess_util.async_log_run(), subprocess_util.log_run(), and the corresponding functions in venv now support passing generic callback functions for stdout_loglevel and stderr_loglevel (#113).

Bugfixes

• Fix typing for antsibull_core.app_context.app_context() functions (#109).
• subprocess_util.log_run - use proper string formatting when passing command output to the logger (#116).

2.1.0

Release Summary

Feature release.

Minor Changes

• Allow to overwrite the version and the program name when using antsibull_core.args.get_toplevel_parser() (#96).

1.6.0

Release Summary

Feature and bugfix release that adds support for Galaxy v3 API.

Minor Changes

• Allow Galaxy client to communicate with the Galaxy v3 API (#45).

Bugfixes

• Fix a bug in Galaxy download code when the filename is found in the cache, but the checksum does not match. In that case, the collection was not copied to the destination, and the code did not try to download the correct file (#76).
• Remove improper usage of @functools.lru_cache on async functions in the antsibull_core.ansible_core module (#67, #69).
• Restrict the pydantic dependency to major version 1 (#35).

2.0.0

Release Summary

New major release

Minor Changes

• Add async_log_run() and log_run() methods to antsibull_core.venv.VenvRunner and antsibull_core.venv.FakeVenvRunner. These should be used instead of get_command() (#50).
• Add a store_yaml_stream function to antsibull_core.yaml to dump YAML to an IO stream (#24).
• Add a new antsibull_core.subprocess_util module to help run subprocesses output and log their output (#40).
• Allow Galaxy client to communicate with the Galaxy v3 API (#45).
• Allow the Galaxy downloader to trust its collection cache to avoid having to query the Galaxy server if an artifact exists in the cache. This can be set with the new configuration file option trust_collection_cache (#78).
• Allow to cache ansible-core download artifacts with a new config file option ansible_core_cache (#80).
• Allow to fully trust the ansible-core artifacts cache to avoid querying PyPI with a new config file option trust_ansible_core_cache (#80).
• Allow to skip content check when doing async file copying using antsibull_core.utils.io.copy_file() (#78).
• Avoid using the collection artifact filename returned by the Galaxy server. Instead compose it in a uniform way (#78).
• Replace internal usage of sh with the antsibull.subprocess_util module (#51).
• The fields ansible_core_repo_url, galaxy_url, and pypi_url have been added to the library context. If ansible_core_repo_url is not provided, it will be populated from the field ansible_base_url if that has been provided (#81).
• Use the pypa build tool instead of directly calling setup.py which is deprecated (#51).

Breaking Changes / Porting Guide

• Remove breadcrumbs, indexes, and use_html_blobs from global antsibull config handling. These options are only used by antsibull-docs, which already validates them itself (#54).
• Support for Python 3.6, 3.7, and 3.8 has been dropped. antsibull-core 2.x.y needs Python 3.9 or newer. If you need to use Python 3.6 to 3.8, please use antsibull-core 1.x.y (#16).
• The install_package() method of antsibull_core.venv.VenvRunner now returns a subprocess.CompletedProcess object instead of an sh.RunningCommand. The rest of the function signature remains the same. Most callers should not need to access the output to begin with (#50).

Deprecated Features

• Deprecate the get_command() methods of antsibull_core.venv.VenvRunner` and antsibull_core.venv.FakeVenvRunner. These methods will be removed in antsibull-core 3.0.0. Use the new log_run()andasync_run()`` methods instead (#50).
• The antsibull_core.compat module deprecates the metadata module. Use importlib.metadata instead, which is available from Python 3.8 on (#16).
• The antsibull_core.compat module deprecates the functions asyncio_run, best_get_loop, and create_task. Replace asyncio_run with asyncio.run, create_task with asyncio.create_task, and best_get_loop with asyncio.get_running_loop (#16).
• The doc_parsing_backend option from the library context is deprecated and will be removed in antsibull-core 3.0.0. Applications that need it, such as antsibull-docs, must ensure they allow and validate this option themselves (#59).
• The fields ansible_base_url, galaxy_url, and pypi_url of the app context have been deprecated. Use the fields ansible_core_repo_url, galaxy_url, and pypi_url, respectively, of the library context instead (#81).

Removed Features (previously deprecated)

• The unused antsibull_core.schemas.config.ConfigModel model and the unused antsibull_core.config.read_config function have been removed (#82).

Bugfixes

• Fix a bug in Galaxy download code when the filename is found in the cache, but the checksum does not match. In that case, the collection was not copied to the destination, and the code did not try to download the correct file (#76).
• Remove improper usage of @functools.cache on async functions in the antsibull_core.ansible_core module (#67).
• Restrict the pydantic dependency to major version 1 (#35).
• Restrict the sh dependency to versions before 2.0.0 (#31).

2.0.0a2

Release Summary

Second alpha release of 2.0.0.

Minor Changes

• Add async_log_run() and log_run() methods to antsibull_core.venv.VenvRunner` and antsibull_core.venv.FakeVenvRunner. These should be used instead of get_command()`` (#50).
• Add a new antsibull_core.subprocess_util module to help run subprocesses output and log their output (#40).
• Allow Galaxy client to communicate with the Galaxy v3 API (#45).
• Replace internal usage of sh with the antsibull.subprocess_util module (#51).
• Use the pypa build tool instead of directly calling setup.py which is deprecated (#51).

Breaking Changes / Porting Guide

• Remove breadcrumbs, indexes, and use_html_blobs from global antsibull config handling. These options are only used by antsibull-docs, which already validates them itself (#54).
• The install_package() method of antsibull_core.venv.VenvRunner now returns a subprocess.CompletedProcess` object instead of an sh.RunningCommand``. The rest of the function signature remains the same. Most callers should not need to access the output to begin with (#50).

Deprecated Features

• Deprecate the get_command() methods of antsibull_core.venv.VenvRunner` and antsibull_core.venv.FakeVenvRunner. These methods will be removed in antsibull-core 3.0.0. Use the new log_run()andasync_run()`` methods instead (#50).
• The doc_parsing_backend option from the library context is deprecated and will be removed in antsibull-core 3.0.0. Applications that need it, such as antsibull-docs, must ensure they allow and validate this option themselves (#59).

Bugfixes

• Remove improper usage of @functools.cache on async functions in the antsibull_core.ansible_core module (#67).
• Restrict the pydantic dependency to major version 1 (#35).
• Restrict the sh dependency to versions before 2.0.0 (#31).

1.5.1

Release Summary

Bugfix release to avoid breakage due to sh 2.0.0.

Bugfixes

• Restrict the sh dependency to versions before 2.0.0 (#31).

2.0.0a1

Release Summary

Alpha release of 2.0.0.

Minor Changes

• Add a store_yaml_stream function to antsibull_core.yaml to dump YAML to an IO stream (#24).

Breaking Changes / Porting Guide

• Support for Python 3.6, 3.7, and 3.8 has been dropped. antsibull-core 2.x.y needs Python 3.9 or newer. If you need to use Python 3.6 to 3.8, please use antsibull-core 1.x.y (#16).

Deprecated Features

• The antsibull_core.compat module deprecates the metadata module. Use importlib.metadata instead, which is available from Python 3.8 on (#16).
• The antsibull_core.compat module deprecates the functions asyncio_run, best_get_loop, and create_task. Replace asyncio_run with asyncio.run, create_task with asyncio.create_task, and best_get_loop with asyncio.get_running_loop (#16).

1.5.0

Release Summary

Feature release.

Minor Changes

• Add a store_yaml_stream function to antsibull_core.yaml to dump YAML to an IO stream (#24).

1.4.0

Release Summary

Bugfix and feature release.

Minor Changes

• Fix overly restrictive file name type annotations. Use StrOrBytesPath type annotation instead of str for functions that accept a file name (#14).

Bugfixes

• Remove use of blocking IO in an async function (#13).

1.3.1

Release Summary

Maintenance release to fix unwanted 1.3.0.post0 release.