---
ancestor: null
releases:
  0.1.0:
    changes:
      release_summary: Initial release.
    release_date: '2020-05-26'
  0.2.0:
    release_date: '2020-05-26'
  0.3.0:
    release_date: '2020-05-29'
  0.4.0:
    release_date: '2020-06-01'
  0.5.0:
    release_date: '2020-06-02'
  0.6.0:
    release_date: '2020-06-03'
  0.7.0:
    release_date: '2020-06-04'
  0.8.0:
    release_date: '2020-06-08'
  0.9.0:
    release_date: '2020-06-18'
  0.10.0:
    release_date: '2020-06-26'
  0.11.0:
    release_date: '2020-06-27'
  0.12.0:
    release_date: '2020-07-05'
  0.13.0:
    release_date: '2020-07-08'
  0.14.0:
    release_date: '2020-07-08'
  0.15.0:
    release_date: '2020-07-09'
  0.16.0:
    release_date: '2020-07-10'
  0.17.0:
    release_date: '2020-07-23'
  0.18.0:
    release_date: '2020-07-27'
  0.19.0:
    release_date: '2020-08-03'
  0.20.0:
    release_date: '2020-08-14'
  0.21.0:
    release_date: '2020-08-14'
  0.22.0:
    release_date: '2020-09-29'
  0.23.0:
    release_date: '2020-11-03'
  0.24.0:
    release_date: '2020-11-23'
  0.25.0:
    release_date: '2020-11-30'
  0.26.0:
    release_date: '2021-02-09'
  0.27.0:
    release_date: '2021-02-17'
  0.28.0:
    release_date: '2021-03-16'
  0.29.0:
    release_date: '2021-03-23'
  0.30.0:
    release_date: '2021-03-30'
  0.31.0:
    release_date: '2021-05-11'
  0.32.0:
    release_date: '2021-05-25'
  0.33.0:
    release_date: '2021-06-01'
  0.34.0:
    release_date: '2021-06-22'
  0.35.0:
    release_date: '2021-06-06'
  0.36.0:
    release_date: '2021-07-12'
  0.37.0:
    release_date: '2021-08-11'
  0.38.0:
    changes:
      release_summary: Support CLI options for the ansible.builtin.ssh connection
        plugin, and support ansible-core 2.12 module/plugin attributes.
    release_date: '2021-09-25'
  0.38.1:
    changes:
      release_summary: 'Fix for attributes support: also allow new support value ``N/A``.'
    release_date: '2021-09-26'
  0.38.2:
    changes:
      release_summary: Avoid creating role documentation for roles without argument
        spec. Avoid naming collision with Ansible Sphinx config's ``rst_epilog`` contents.
    release_date: '2021-09-27'
  0.39.0:
    changes:
      release_summary: 'Docs generation:


        * Improve boilerplate for ansible.builtin documentation

        * Render ``choices`` in return value documentation

        * Add alternating background colors to option and return value tables


        Also improves the Ansible release playbook/role.

        '
    release_date: '2021-11-01'
  0.39.1:
    changes:
      release_summary: '* Fixes ``M(...)`` when used in HTML blobs.

        * Improve wait on HTTP retries.

        '
    release_date: '2021-11-09'
  0.39.2:
    changes:
      release_summary: '* Fixes an incompatibility with antsibull-lint with Python
        3.9.8.

        * Improves and extends the Ansible build role and its tests.

        '
    release_date: '2021-11-10'
  0.40.0:
    changes:
      bugfixes:
        - Fix ``rsync`` flags in build scripts generated by ``antsibull-docs sphinx-init``
          to allow Sphinx to not rebuild unchanged files (https://github.com/ansible-community/antsibull/pull/357).
        - Fix boolean logic error when ``--skip-indexes`` was used in ``antsibull-docs``
          (https://github.com/ansible-community/antsibull/pull/377).
        - Fix feature freeze handling after Beta 1 in build role (https://github.com/ansible-community/antsibull/pull/337).
        - Require Python 3.8 for Ansible 5 (https://github.com/ansible-community/antsibull/pull/345).
      deprecated_features:
        - The ``antsibull-build single`` subcommand is deprecated. Use the ``prepare``
          and ``rebuild-single`` subcommands instead (https://github.com/ansible-community/antsibull/pull/341).
      major_changes:
        - Responsive parameter and return value tables. Also use RST tables instead
          of HTML blobs (https://github.com/ansible-community/antsibull/pull/335).
      minor_changes:
        - Add a changelog (https://github.com/ansible-community/antsibull/pull/378).
        - Allow to specify ``collection_cache`` in config file (https://github.com/ansible-community/antsibull/pull/375).
        - Allow to still use HTML blobs for parameter and return value tables. This
          can be controlled by a CLI option ``--use-html-blobs`` and by a global config
          option ``use_html_blobs`` (https://github.com/ansible-community/antsibull/pull/360).
        - Avoid prereleases when creating the ``.build`` file in ``antsibull-build
          new-acd``. The old behavior of including them can be obtained by passing
          the ``--allow-prereleases`` option (https://github.com/ansible-community/antsibull/pull/298).
        - Change ansible-base references in documentation and code to ansible-core
          where it makes sense (https://github.com/ansible-community/antsibull/pull/353).
        - During docs build, only write/copy files to the destination that have changed
          assuming they are not too large (https://github.com/ansible-community/antsibull/pull/374).
        - Improve ``build-ansible.sh`` script integrated in the release tarball (https://github.com/ansible-community/antsibull/pull/369).
        - Improve ``galaxy-requirements.yaml`` generation (https://github.com/ansible-community/antsibull/pull/350).
        - Mention new options in the porting guide (https://github.com/ansible-community/antsibull/pull/363).
        - Modify ``thread_max`` default value from 80 to 8 (https://github.com/ansible-community/antsibull/pull/365,
          https://github.com/ansible-community/antsibull/pull/370).
        - Move modules to beginning of plugin index (https://github.com/ansible-community/antsibull/pull/336).
        - Remove unnecessary Python 2 boilerplates (https://github.com/ansible-community/antsibull/pull/371).
        - Simplify ansible-core dependency in ``setup.py`` with compatibility operator
          (https://github.com/ansible-community/antsibull/pull/346).
        - Split ``antsibull-build single`` subcommand into ``prepare`` and ``rebuild-single``
          subcommand (https://github.com/ansible-community/antsibull/pull/341).
        - Stop using deprecated Python standard library ``distutils.version`` (https://github.com/ansible-community/antsibull/pull/372).
        - Various improvements to the build role (https://github.com/ansible-community/antsibull/pull/338).
      release_summary: Feature and bugfix release.
    fragments:
      - 0.40.0.yml
    release_date: '2022-01-07'
  0.40.1:
    changes:
      bugfixes:
        - Fix bug in collection enum for docs generation, which caused role FQCNs
          to be mangled (https://github.com/ansible-community/antsibull/pull/379).
      release_summary: Bugfix release.
    fragments:
      - 0.40.1.yml
      - 379-collection-enum-fix.yml
    release_date: '2022-01-07'
  0.40.2:
    changes:
      bugfixes:
        - Fix ``rsync`` call when ``antsibull-docs sphinx-init`` is used with ``--squash-hieararchy``
          (https://github.com/ansible-community/antsibull/pull/382).
        - Fix invalid HTML in return value RST tables. Closing ``</div>`` were missing
          for a wrapping ``<div>`` of every content cell, causing problems with some
          text-based browsers (https://github.com/ansible-community/antsibull/issues/386,
          https://github.com/ansible-community/antsibull/pull/387).
        - Work around Python argparse bug by using vendored class for all Python versions
          until the bug is fixed in argparse. This makes ``--help`` work for all antsibull-docs
          subcommands (https://github.com/ansible-community/antsibull/pull/384).
      release_summary: Bugfix release.
    fragments:
      - 0.40.2.yml
      - 382-sphinx-init-squash-hierarchy.yml
      - 384-help.yml
      - 386-fix-html.yml
    release_date: '2022-01-14'
  0.41.0:
    changes:
      bugfixes:
        - If plugin parsing fails for ``antsibull-docs plugin``, handle this more
          gracefully (https://github.com/ansible-community/antsibull/pull/393).
        - Improve error message when plugin specified for ``antsibull-docs plugin``
          cannot be found (https://github.com/ansible-community/antsibull/pull/383).
        - When using ``--use-html-blobs``, malformed HTML was generated for parameter
          aliases (https://github.com/ansible-community/antsibull/pull/388).
      minor_changes:
        - Add ``--fail-on-error`` to all antsibull-docs subcommands for usage in CI
          (https://github.com/ansible-community/antsibull/pull/393).
        - Allow to select a different Sphinx theme for ``antsibull-docs sphinx-init``
          with the new ``--sphinx-theme`` option (https://github.com/ansible-community/antsibull/pull/392).
        - Fully implement ``antsibull-docs collection``. So far ``--current`` was
          required (https://github.com/ansible-community/antsibull/pull/383).
        - Mention the plugin type more prominently in the documentation (https://github.com/ansible-community/antsibull/pull/364).
        - Remove email addresses and ``(!UNKNOWN)`` from plugin and role author names
          (https://github.com/ansible-community/antsibull/pull/389).
        - Support new ``keyword`` field in plugin documentations (https://github.com/ansible-community/antsibull/pull/329).
        - The ``conf.py`` generated by ``antsibull-docs sphinx-init`` will be set
          to try resolving intersphinx references to Ansible's ``devel`` docs instead
          of a concrete Ansible version (https://github.com/ansible-community/antsibull/pull/391).
      release_summary: Feature and bugfix release.
    fragments:
      - 0.41.0.yml
      - 329-keywords.yml
      - 364-plugin-type.yml
      - 383-antsibull-docs-collections.yml
      - 388-table-html-alias.yml
      - 389-remove-email-addresses.yml
      - 391-sphinx-init-ansible-docs-fallback.yml
      - 392-sphinx-init-theme.yml
      - 393-fail-on-error.yml
    release_date: '2022-02-01'
  0.42.0b1:
    changes:
      bugfixes:
        - Fix filename of mentioned ansible-core porting guide in Ansible's porting
          guide introductionary comment (https://github.com/ansible-community/antsibull/pull/398).
        - antsibull-docs will no longer traceback when it tries to process plugins
          not found in its own constant but are available in ansible-core (https://github.com/ansible-community/antsibull/pull/404).
      major_changes:
        - Building Ansible 6+ now builds wheels next to the source tarball (https://github.com/ansible-community/antsibull/pull/394).
        - Remove Ansible 2.9 / ansible-base 2.10 checks from ``setup.py`` for Ansible
          6 so that we can finally ship wheels. This change is only active for Ansible
          6 (https://github.com/ansible-community/antsibull/pull/394).
      minor_changes:
        - Change more references to ansible-base to ansible-core in the code (https://github.com/ansible-community/antsibull/pull/398).
        - Mention the ``ansible-core`` major version in the Ansible porting guide
          (https://github.com/ansible-community/antsibull/pull/397).
        - Redo attributes table using the same structure as the options and return
          value table. This improves its look and adds a linking mechanism (https://github.com/ansible-community/antsibull/pull/401).
      release_summary: Beta release to allow merging of https://github.com/ansible/ansible/pull/74963.
    fragments:
      - 0.42.0b1.yml
      - 394-setup.py-collision.yml
      - 395-wheels.yml
      - 397-ansible-core-version-in-porting-guide.yml
      - 398-core.yml
      - 401-attributes.yml
      - 404_not_found.yml
    release_date: '2022-02-23'
  0.42.0:
    changes:
      bugfixes:
        - Fix ansible-core version parsing for ``ansible-doc`` docs parsing backend
          (https://github.com/ansible-community/antsibull/pull/401).
      major_changes:
        - Allow collections to specify extra links (https://github.com/ansible-community/antsibull/pull/355).
        - From Ansible 6 on, improve ``setup.py`` to exclude unnecessary files in
          the Python distribution (https://github.com/ansible-community/antsibull/pull/342).
      minor_changes:
        - Add a new docs parsing backend ``ansible-core-2.13``, which supports ansible-core
          2.13+ (https://github.com/ansible-community/antsibull/pull/401).
        - Add an autodetection ``auto`` for the docs parsing backend to select the
          fastest supported backend. This is the new default (https://github.com/ansible-community/antsibull/pull/401).
        - Add option ``--no-semantic-versioning`` to ``antsibull-lint changelog-yaml``
          command (https://github.com/ansible-community/antsibull/pull/405).
        - If the role is used to build a non-alpha or first beta version and the bulid
          file does not exist, it is created instead of later failing because it does
          not exist (https://github.com/ansible-community/antsibull/pull/408).
      release_summary: Major feature release preparing for Ansible 6. Also adds support
        for the new collection links file, and improves the attributes tables.
    fragments:
      - 0.42.0.yml
      - 342-setup.py-ignore.yml
      - 355-extra-links.yml
      - 402-ansible-core-2.13.yml
      - 405-changelog-yaml-lint.yml
      - 408-build-file-role.yml
    release_date: '2022-03-26'
  0.42.1:
    changes:
      bugfixes:
        - antsibull-docs sphinx-init - the ``--fail-on-error`` option resulted in
          an invalid ``build.sh`` (https://github.com/ansible-community/antsibull/pull/409).
      release_summary: Bugfix release.
    fragments:
      - 0.42.1.yml
      - 409-sphinx-init-fail-on-error.yml
    release_date: '2022-03-28'
  0.43.0:
    changes:
      bugfixes:
        - Prevent crashing when non-strings are found for certain pathnames for ``antsibull-docs
          lint-collection-docs`` and ``antsibull-lint collection-docs`` (https://github.com/ansible-community/antsibull/pull/411).
      minor_changes:
        - Add ``lint-collection-docs`` subcommand to ``antsibull-docs``. It behaves
          identical to ``antsibull-lint collection-docs`` (https://github.com/ansible-community/antsibull/pull/411,
          https://github.com/ansible-community/antsibull/issues/410).
        - Support ``MANIFEST.json`` and not only ``galaxy.yml`` for ``antsibull-docs
          lint-collection-docs`` and ``antsibull-lint collection-docs`` (https://github.com/ansible-community/antsibull/pull/411).
      release_summary: Feature release.
    fragments:
      - 0.43.0.yml
      - 411-lint-collection-docs.yml
    release_date: '2022-03-30'
  0.44.0:
    changes:
      deprecated_features:
        - The antsibull-lint command is deprecated. Use ``antsibull-changelog lint-changelog-yaml``
          instead of ``antsibull-lint changelog-yaml``, and use ``antsibull-docs lint-collection-docs``
          instead of ``antsibull-lint collection-docs`` (https://github.com/ansible-community/antsibull/pull/412,
          https://github.com/ansible-community/antsibull/issues/410).
      known_issues:
        - When upgrading from antsibull < 0.44.0 to antsibull 0.44.0+, it could happen
          that the ``antsibull-docs`` binary is removed due to how pip works. To make
          sure the ``antsibull-docs`` binary is present, either first uninstall (``pip
          uninstall antsibull``) before installing the latest antsibull version, or
          re-install ``antsibull-docs`` once the installation finished (``pip install
          --force-reinstall antsibull-docs``) (https://github.com/ansible-community/antsibull/pull/414).
      major_changes:
        - The ``antsibull`` package now depends on ``antsibull-core`` and ``antsibull-docs``,
          and most code was moved to these two packages. The ``antsibull-docs`` CLI
          tool is now part of the ``antsibull-docs`` package as well. The behavior
          of the new version should be identical to the previous version (https://github.com/ansible-community/antsibull/pull/414).
      release_summary: Split up antsibull into multiple PyPi packages (``antsibull-core``,
        ``antsibull-docs``, and ``antsibull``). **Note** that upgrading is a bit more
        complicated due to the way ``pip`` works! See below for details.
    fragments:
      - 0.44.0.yml
      - 412-deprecate-antsibull-lint.yml
      - 414-antsibull-splitup.yml
    release_date: '2022-04-10'
  0.45.0:
    changes:
      breaking_changes:
        - The ``build-release`` role no longer uses poetry to run antsibull, but assumes
          that antsibull is installed. To revert to the old behavior, set the Ansible
          variable ``antsibull_build_command`` to ``poetry run antsibull`` (https://github.com/ansible-community/antsibull/pull/420).
      minor_changes:
        - Add ``antsibull-build`` subcommand ``validate-deps`` which validates dependencies
          for an ``ansible_collections`` tree (https://github.com/ansible-community/antsibull/pull/416).
        - Check collection dependencies during ``antsibull-build rebuild-single``
          and warn about errors (https://github.com/ansible-community/antsibull/pull/416).
        - In the ``build-release`` role, stop shipping a separate ``roles/build-release/files/deps-to-galaxy.py``
          script and use the new galaxy-requirements.yaml style file created during
          release preparation (https://github.com/ansible-community/antsibull/pull/417).
        - Update Ansible's ``README.rst`` to focus on Ansible package details (https://github.com/ansible-community/antsibull/pull/415).
        - When preparing a new Ansible release with ``antsibull-build prepare`` or
          ``antsibull-build single``, create a galaxy-requirements.yaml style file
          next to the dependencies file (https://github.com/ansible-community/antsibull/pull/417).
      release_summary: New feature release with one breaking change to the ``build-release``
        role.
    fragments:
      - 0.45.0.yml
      - 415-ansible-readme.yml
      - 416-deps.yml
      - 417-galaxy.yml
      - 420-release-role-poetry.yml
    release_date: '2022-05-03'
  0.45.1:
    changes:
      bugfixes:
        - The ``build-release`` role now no longer ignores collection prereleases
          of collections for the alpha releases (https://github.com/ansible-community/antsibull/pull/420).
      release_summary: Bugfix release.
    fragments:
      - 0.45.1.yml
      - 421-prereleases.yml
    release_date: '2022-05-04'
  0.46.0:
    changes:
      bugfixes:
        - In the build-release role, when ``antsibull_force_rebuild`` is true, delete
          the existing python wheel in addition to the release tarball (https://github.com/ansible-community/antsibull/pull/427).
        - Remove various empty lines from generated ``setup.py`` (https://github.com/ansible-community/antsibull/issues/424,
          https://github.com/ansible-community/antsibull/pull/425).
        - Use ``packaging.version`` instead of (indirectly) ``distutils.version``
          to check whether the correct ansible-core version is installed (https://github.com/ansible-community/antsibull/pull/426).
      minor_changes:
        - Avoid including the complete condensed changelog of collections added to
          Ansible to that Ansible release's changelog and porting guide entries (https://github.com/ansible-community/antsibull/pull/428).
        - The ``build-release`` role now also uses ``antsibull_data_reset`` to prevent
          regeneration of ``build-X.ansible`` for alpha and beta-1 releases (https://github.com/ansible-community/antsibull/pull/422).
      release_summary: Feature and bugfix release with improvements for the release
        role, release building, and changelog generation.
    fragments:
      - 0.46.0.yml
      - 422-build-role-reset.yml
      - 425-setup.py-empty-lines.yml
      - 426-role-version-test.yml
      - 427-also-delete-the-python-wheel.yaml
      - 428-changelog.yml
    release_date: '2022-05-30'
  0.47.0:
    changes:
      minor_changes:
        - Include ``ansible-community`` CLI program with ``--version`` parameter from
          Ansible 6.0.0rc1 on (https://github.com/ansible-community/antsibull/pull/429).
      release_summary: Feature release for Ansible 6.0.0rc1.
    fragments:
      - 0.47.0.yml
      - 429-ansible-community-version.yml
    release_date: '2022-06-07'
  0.48.0:
    changes:
      breaking_changes:
        - In the release role, ``antsibull_ansible_version`` and ``antsibull_ansible_git_version``
          must now always be specified (https://github.com/ansible-community/antsibull/pull/430).
      bugfixes:
        - When preparing a new Ansible release, bump the ansible-core version to the
          latest bugfix version (https://github.com/ansible-community/antsibull/pull/430).
      minor_changes:
        - In the release role, automatically set ``antsibull_build_file`` and ``antsibull_data_dir``
          based on ``antsibull_ansible_version`` (https://github.com/ansible-community/antsibull/pull/430).
        - The release role has now an argument spec (https://github.com/ansible-community/antsibull/pull/430).
      release_summary: Bugfix and feature release containing some breaking changes
        in the release role.
    fragments:
      - 0.48.0.yml
      - 430-prepare-ansible-core-version.yml
      - 431-role.yml
    release_date: '2022-06-18'
  0.49.0:
    changes:
      breaking_changes:
        - The ``build-release`` role now depends on the ``community.general`` collection
          (https://github.com/ansible-community/antsibull/pull/432).
      bugfixes:
        - Fix typo in generated MANIFEST.in to list the existing file ``README.rst``
          instead of the non-existing file ``README`` (https://github.com/ansible-community/antsibull/pull/435).
        - When preparing a new Ansible release, only use pre-releases for ansible-core
          when the Ansible release itself is an alpha pre-release. This encodes that
          the first beta release of a new major Ansible release coincides with the
          ansible-core GA (https://github.com/ansible-community/antsibull/pull/436).
      minor_changes:
        - Allow to copy the files used to create the source distribution and wheels
          to a new directory during ``antsibull-build rebuild-single`` (https://github.com/ansible-community/antsibull/pull/435).
        - Perform minor refactoring of the ``build-release`` role, mostly concerning
          ``tasks/tests.yml``. This reduces use of ``shell`` and ``set_fact``, makes
          the role more robust, and replaces short names with FQCNs (https://github.com/ansible-community/antsibull/pull/432).
        - Show warnings emitted by building the source distribution and/or wheels
          (https://github.com/ansible-community/antsibull/pull/435).
        - The files in the source repository now follow the `REUSE Specification <https://reuse.software/spec/>`_.
          The only exceptions are changelog fragments in ``changelogs/fragments/``
          (https://github.com/ansible-community/antsibull/pull/437).
      release_summary: Bugfix and feature release containing breaking changes in the
        release role.
    fragments:
      - 0.49.0.yml
      - 432-build-release-role-minor-refactoring.yml
      - 435-setup.py.yml
      - 436-ansible-core-prereleases.yml
      - 437-licenses.yml
    release_date: '2022-07-31'
  0.50.0:
    changes:
      bugfixes:
        - Adjust release role to work around a bug in the current beta version of
          ansible-core 2.14 (https://github.com/ansible-community/antsibull/pull/447).
        - Fix typing errors in the ``multiple`` subcommand (https://github.com/ansible-community/antsibull/pull/443).
      minor_changes:
        - Added galaxy ``requirements.yml`` file as ``build-release`` role depends
          on ``community.general`` collection (https://github.com/ansible-community/antsibull/pull/432)
        - Define minimal Python requirement for Ansible X depending on X, under the
          assumption that ansible-core's Python requirement is increased by one version
          every two ansible-core major releases, and that every Ansible major release
          corresponds to an ansible-core major release from Ansible 5 on (https://github.com/ansible-community/antsibull/pull/448).
        - The ``build-release`` role fails to execute when ``./build/antsibull-build-data``
          doesn't exist and when the ``antsibull_data_reset`` variable is set to ``false``
          (https://github.com/ansible-community/antsibull/pull/442).
        - When building Ansible 6.3.0 or newer, fail on collection dependency validations
          (https://github.com/ansible-community/community-topics/issues/94, https://github.com/ansible-community/antsibull/pull/440).
      release_summary: Feature and bugfix release.
    fragments:
      - 0.50.0.yml
      - 440-fail-on-invalid-dependencies.yml
      - 441-add-galaxy-requirement-file.yml
      - 442.yml
      - 443-typing.yml
      - 447-work-around-2.14-bug.yml
      - 448-python-version.yml
    release_date: '2022-09-29'
  0.51.0:
    changes:
      minor_changes:
        - Now requires antsibull-core >= 1.3.0 (https://github.com/ansible-community/antsibull/pull/449).
        - The ``python_requires`` information is now extracted from ansible-core and
          stored in the ``.build`` and ``.deps`` files instead of guessing it from
          the Ansible version (https://github.com/ansible-community/antsibull/pull/449).
      release_summary: Feature release for Ansible 7.
    fragments:
      - 0.51.0.yml
      - 449-python_requires.yml
    release_date: '2022-10-07'
  0.51.1:
    changes:
      bugfixes:
        - Fix handling of Python dependency data when building changelogs and collections
          (https://github.com/ansible-community/antsibull/pull/452).
      release_summary: Bugfix release.
    fragments:
      - 0.51.1.yml
      - 452-python-deps-build.yml
    release_date: '2022-10-13'
  0.51.2:
    changes:
      bugfixes:
        - Add ``--collection-dir`` to the ``antsibull-build`` ``collection`` and ``build-collection``
          subcommands. Previously, the ``--collection-dir`` option was added to the
          wrong CLI argument parser and not exposed to users. (https://github.com/ansible-community/antsibull/pull/461).
        - Use compatibility code instead of trying to run ``asyncio.run`` directly,
          which will fail with Python 3.6 (https://github.com/ansible-community/antsibull/pull/459).
      release_summary: Bugfix release. The next minor release will no longer support
        Python 3.6 and 3.7.
    fragments:
      - 0.51.2.yml
      - 459-asyncio.run-compat.yml
      - 461-collection-dir.yml
    release_date: '2022-11-23'
  0.52.0:
    changes:
      breaking_changes:
        - Drops support for Python 3.6 an 3.7 (https://github.com/ansible-community/antsibull/issues/458,
          https://github.com/ansible-community/antsibull/pull/460).
        - The antsibull-docs dependency has been removed (https://github.com/ansible-community/antsibull/pull/451).
      minor_changes:
        - Add a ``validate-tags`` subcommand to ensure that collection versions in
          an Ansible release are tagged in collections' respective git repositories
          (https://github.com/ansible-community/antsibull/pull/456).
        - Make compatible with antsibull-core 2.x.y (https://github.com/ansible-community/antsibull/pull/463).
      release_summary: Major feature and bugfix release with breaking changes.
      removed_features:
        - The deprecated ``antsibull-lint`` subcommands have been removed. Use ``antsibull-changelog
          lint-changelog-yaml`` or ``antsibull-docs lint-collection-docs`` depending
          on your use-case (https://github.com/ansible-community/antsibull/pull/451).
        - The deprecated ``build-collection`` subcommand of ``antsibull-build`` has
          been removed. Use ``collection`` instead (https://github.com/ansible-community/antsibull/pull/451).
        - The deprecated ``build-multiple`` subcommand of ``antsibull-build`` has
          been removed. Use ``multiple`` instead (https://github.com/ansible-community/antsibull/pull/451).
        - The deprecated ``build-single`` subcommand of ``antsibull-build`` has been
          removed. Use ``single`` instead (https://github.com/ansible-community/antsibull/pull/451).
        - The deprecated ``new-acd`` subcommand of ``antsibull-build`` has been removed.
          Use ``new-ansible`` instead (https://github.com/ansible-community/antsibull/pull/451).
    fragments:
      - 0.52.0.yml
      - 456-validate-tags.yaml
      - 460-drop-python-3.6-3.7.yml
      - 463-antsibull-core.yml
      - removals.yml
    release_date: '2022-12-07'
  0.53.0:
    changes:
      bugfixes:
        - Correct Python version classifiers in the ansible ``setup.py`` template.
          Limit the Python 3.8 classifer to ansible 5 and 6 and add the Python 3.11
          classifier to ansible >= 7 (https://github.com/ansible-community/antsibull/pull/479).
        - Do not crash when the ``changelogs/changelog.yaml`` file of a collection
          cannot be loaded (https://github.com/ansible-community/antsibull/issues/481,
          https://github.com/ansible-community/antsibull/pull/482).
      minor_changes:
        - Add ``--tags-file`` option to the ``single``, ``rebuild-single``, and ``prepare``
          subcommands. This allows including a collection git tags data file in ansible-build-data
          and the ansible sdist (https://github.com/ansible-community/antsibull/pull/476/).
        - Add ``pyproject.toml`` to ansible sdist to use the ``setuptools.build_meta``
          `PEP 517 <https://peps.python.org/pep-0517/>`__ backend. Tools that still
          call ``setup.py`` directly will work the same as they did before (https://github.com/ansible-community/antsibull/pull/471).
        - Bump minimum ``antsibull-core`` requirement to 1.5.0. It contains changes
          that are needed for the new ``--tags-file`` option (https://github.com/ansible-community/antsibull/pull/476/).
        - There have been internal refactorings to simplify typing (https://github.com/ansible-community/antsibull/pull/469).
      release_summary: Feature and bugfix release.
    fragments:
      - 0.53.0.yml
      - 469-typing.yml
      - 471.yaml
      - 476-tags_file.yaml
      - 482-changelog-yaml-parsing-handling.yml
      - correct-classifiers.yaml
    release_date: '2023-01-30'
  0.54.0:
    changes:
      breaking_changes:
        - Drop support for Python 3.8 (https://github.com/ansible-community/antsibull/pull/465).
      bugfixes:
        - Explicitly declare the ``sh`` dependency and limit it to before 2.0.0. Also
          explicitly declare the dependencies on ``packaging``, ``semantic_version``,
          ``aiofiles``, ``aiohttp``, and ``twiggy`` (https://github.com/ansible-community/antsibull/pull/487).
        - Fix broken ansible-build-data repository link in ansible package README
          (https://github.com/ansible-community/antsibull/pull/485).
      release_summary: New release with features, bugfixes, and breaking changes.
      removed_features:
        - Removed the ``antsibull-lint`` command line utility. It had no functionality
          anymore for some time now (https://github.com/ansible-community/antsibull/pull/466).
    fragments:
      - 0.54.0.yml
      - 465-drop-python3.8.yml
      - 466-remove-antsibull-lint.yml
      - 485-fix-broken-ansible-build-data-link.yml
      - 487-sh.yml
    release_date: '2023-02-24'
  0.55.0:
    changes:
      deprecated_features:
        - The ``multiple`` and ``collection`` subcommands are deprecated and will
          be removed soon. They were never used to our knowledge except in the exploratory
          phase before the first Ansible 2.10 releases, have no test coverage, and
          might not even work at all. If you are actively using them and are interested
          in keeping them, please create an issue in the antsibull repository as soon
          as possible (https://github.com/ansible-community/antsibull/pull/505).
      major_changes:
        - Change pyproject build backend from ``poetry-core`` to ``hatchling``. ``pip
          install antsibull`` works exactly the same as before, but some users may
          be affected depending on how they build/install the project (https://github.com/ansible-community/antsibull/pull/490).
      minor_changes:
        - Add a ``-I`` / ``--ignore`` and a ``--ignores-file`` flag to the ``antsibull-build
          validate-tags`` and ``antsibull-build validate-tags-file`` subcommands to
          ignore errors for certain collections (https://github.com/ansible-community/antsibull/pull/491).
        - Make compatible with deprecations issued by newer setuptools releases (https://github.com/ansible-community/antsibull/issues/433,
          https://github.com/ansible-community/antsibull/pull/502).
        - Use the pypa ``build`` tool to build wheels and source distributions for
          ansible in an isolated environment. This replaces direct calls to ``python
          setup.py bdist_wheel`` and ``python setup.py sdist`` which are deprecated
          (https://github.com/ansible-community/antsibull/pull/492).
      release_summary: Release with new features, other improvements, a new build
        system, and a deprecation
    fragments:
      - 0.55.0.yml
      - 490-hatchling.yaml
      - 491.yaml
      - 492-build.yaml
      - 502-setup.py.yml
      - 505-deprecate.yml
    release_date: '2023-04-08'
  0.56.0:
    changes:
      deprecated_features:
        - Support for building ansible major versions less than 6 is deprecated and
          will be removed in an upcoming release (https://github.com/ansible-community/antsibull/pull/515).
      minor_changes:
        - Remove now broken self-test from release role (https://github.com/ansible-community/antsibull/pull/512).
        - Remove the parameters ``antsibull_ansible_git_repo``, ``antsibull_ansible_git_version``,
          and ``antsibull_ansible_git_dir`` from release role (https://github.com/ansible-community/antsibull/pull/512).
      release_summary: Maintenance release.
    fragments:
      - 0.56.0.yml
      - 512-release-role-tests.yml
      - 515-deprecate-old-ansible.yaml
    release_date: '2023-04-19'
  0.56.1:
    changes:
      bugfixes:
        - For ``setup.py`` generated for Ansible 8+, do not use recursive globs (``**``)
          as these are only supported since setuptools 62.3.0 (https://github.com/ansible-community/antsibull/pull/520).
      release_summary: Hotfix release to fix compatibility with older setuptools versions
    fragments:
      - 0.56.1.yml
      - 520-setup.py.yml
    release_date: '2023-05-01'
  0.57.0:
    changes:
      bugfixes:
        - Properly handle non-standard version ranges or version pins for feature
          freeze (https://github.com/ansible-community/antsibull/issues/532, https://github.com/ansible-community/antsibull/pull/533).
      minor_changes:
        - Antsibull now no longer depends directly on ``sh`` (https://github.com/ansible-community/antsibull/pull/514).
        - Antsibull now uses ``sys.executable`` instead of the first ``'python'``
          in ``$PATH`` to call the PyPA build tool (https://github.com/ansible-community/antsibull/pull/514).
        - Make ``dep_closure`` errors clearer by including the offending collection's
          version in the message (https://github.com/ansible-community/antsibull/pull/531).
        - Move setuptools configuration into the declarative ``setup.cfg`` format
          for Ansible 9 and above. ``ansible`` sdists will still contain a ``setup.py``
          file, but we recommend that users move to tools like ``pip`` and ``build``
          and the PEP 517 interface instead of setuptools' deprecated ``setup.py``
          interface (https://github.com/ansible-community/antsibull/pull/530).
        - Now depends antsibull-core 2.0.0 or newer; antsibull-core 1.x.y is no longer
          supported (https://github.com/ansible-community/antsibull/pull/514).
        - release playbook - run ``antsibull-build validate-tags-file`` to ensure
          that collections follow the Release Management section of the Collection
          Requirements (https://github.com/ansible-community/antsibull/pull/518).
      release_summary: This release adds a couple new features and drops support for
        older ansible versions.
      removed_features:
        - Remove code to build ansible versions < 6.0.0 from the ``setup.py`` template
          and elsewhere in the codebase. ``antsibull-build`` will error out if a user
          attempts to build an unsupported version (https://github.com/ansible-community/antsibull/pull/477,
          https://github.com/ansible-community/antsibull/pull/524).
        - Removed the deprecated ``multiple`` and ``collection`` subcommands (https://github.com/ansible-community/antsibull/issues/522,
          https://github.com/ansible-community/antsibull/pull/525).
    fragments:
      - 0.57.0.yml
      - 122-antsibull-core-sh.yml
      - 477-setup_py.yaml
      - 518-enforce-release-tagging.yaml
      - 525-remove-multiple-collection-subcommands.yml
      - 530-setup-cfg.yaml
      - 531-dep-closure-error.yaml
      - 533-feature-freeze.yml
    release_date: '2023-07-07'
  0.57.1:
    changes:
      bugfixes:
        - Retrieve the ansible-core Porting Guide from the ansible-documentation repo.
          These files are being removed from the ansible-core repo (https://github.com/ansible-community/antsibull/pull/540).
      release_summary: This bugfix release fixes the retrieval of ansible-core Porting
        Guides.
    fragments:
      - 0.57.1.yml
      - 540.yaml
    release_date: '2023-07-18'
  0.58.0:
    changes:
      bugfixes:
        - Fix URL to ``ansible-core`` on PyPI in the ``ansible`` README (https://github.com/ansible-collections/overview/issues/228,
          https://github.com/ansible-community/antsibull/pull/541).
      minor_changes:
        - Support a constraints file that allows to fix dependencies for the ``new-ansible``
          and ``prepare`` subcommands (https://github.com/ansible-community/antsibull/pull/546).
      release_summary: Feature release for the upcoming Ansible 9.0.0a1 release.
    fragments:
      - 0.58.0.yml
      - 541-pypi-url.yml
      - 546-constraints.yml
    release_date: '2023-09-27'
  0.59.0:
    changes:
      bugfixes:
        - Fix regression in ``validate-tags`` subcommand argument validation that
          caused a traceback (https://github.com/ansible-community/antsibull/pull/51).
      minor_changes:
        - '``ansible`` python metadata - remove links specific to ``ansible-core``
          and add links to the Ansible forum and the ``ansible-build-data`` repository
          (https://github.com/ansible-community/antsibull/pull/558).'
        - 'build-release role - add ``changed_when: false`` to validate-tags task
          (https://github.com/ansible-community/antsibulll/pull/557).'
        - build-release role - add a test to ensure that Python files in the ansible
          package successfully compile (https://github.com/ansible-community/antsibull/pull/552).
        - build-release role - directly install the wheel when running tests (https://github.com/ansible-community/antsibull/pull/553).
      release_summary: Feature release for the upcoming Ansible 9.0.0rc1 release.
    fragments:
      - 0.59.0.yml
      - 549-2.10-removal.yml
      - 551-validate-tags-fix.yaml
      - 552-compileall.yaml
      - 553-release-wheel-test.yaml
      - 557-changed-when-vt.yaml
      - 558-classifiers2.yaml
    release_date: '2023-11-14'
  0.59.1:
    changes:
      bugfixes:
        - Use the correct directive in ``setup.cfg`` for Ansible 9+ for requiring
          a Python version, i.e. use ``python_requires`` instead of ``requires_python``
          (https://github.com/ansible-community/antsibull/pull/559).
      release_summary: Hottfix for the ansible 9.0.1 release to fix setup.cfg metadata
    fragments:
      - 0.59.1.yml
      - 559-python_requires.yml
    release_date: '2023-11-21'
  0.60.0:
    changes:
      bugfixes:
        - Use certain fields from library context instead of app context that are
          deprecated in the app context and are removed from antsibull-core 3.0.0
          (https://github.com/ansible-community/antsibull/pull/569).
      minor_changes:
        - Add a ``sanity-tests`` subcommand to run sanity tests accross the collection
          tree created by ``verify-upstreams`` and display the results (https://github.com/ansible-community/antsibull/pull/556).
        - Add a ``verify-upstreams`` subcommand to ensure that files in a collections'
          Galaxy collection artifact match its upstream repository (https://github.com/ansible-community/antsibull/pull/556).
        - Add new ``antsibull-build announcements`` command to generate release announcement
          text (https://github.com/ansible-community/antsibull/pull/573).
        - Add new ``antsibull-build send-announcements`` command to interactively
          send release announcements. Make sure to install ``pyperclip`` with ``pip
          install antsibull[clipboard]`` to fully take advantage of its functionality
          (https://github.com/ansible-community/antsibull/pull/573).
        - Add support for the latest antsibull-core v3 pre-release, ``3.0.0a1`` (https://github.com/ansible-community/antsibull/pull/586).
        - Adjust the ``pip install antsibull`` call in the ``build-ansible.sh`` script
          added to the ``ansible`` source distribution to use the version of antsibull
          used to build the ansible release (https://github.com/ansible-community/antsibull/pull/563).
        - Change the license from ``GPL-3.0-or-later`` to ``GPL-3.0-or-later AND Python-2.0.1``.
          Antsibull now contains a small amount of code derived from CPython (https://github.com/ansible-community/antsibull/pull/556).
        - Explicitly set up Galaxy context instead of relying on deprecated functionality
          from antsibull-core (https://github.com/ansible-community/antsibull/pull/570).
        - The Ansible changelog is now generated both in MarkDown and ReStructuredText
          (https://github.com/ansible-community/antsibull/pull/576).
        - The dependency on antsibull-changelog has been bumped to 0.24.0 or later
          (https://github.com/ansible-community/antsibull/pull/576).
        - '``ansible`` package README - add a link to the ``ansible-build-data`` issue
          tracker (https://github.com/ansible-community/antsibull/pull/554).'
      release_summary: Bugfix and feature release
    fragments:
      - 0.60.0.yml
      - 554-readme2.yaml
      - 556-verify-upstream.yaml
      - 563-version-build-ansible.yml
      - 569-context.yml
      - 570-galaxy-context.yml
      - 573-announcement.yaml
      - 576-markdown.yml
      - 586-core-3.0.0a1.yaml
    release_date: '2024-02-14'
  0.61.0:
    changes:
      bugfixes:
        - announcements - add missing newline before heading in email template (https://github.com/ansible-community/antsibull/pull/589).
      minor_changes:
        - Add support for the antsibull-core v3 (https://github.com/ansible-community/antsibull/pull/593).
      release_summary: Maintenance and bugfix release.
    fragments:
      - 0.61.0.yml
      - 589-announcement-fix2.yaml
      - core-v3.yml
    release_date: '2024-03-17'
  0.61.1:
    changes:
      bugfixes:
        - The PyPI API model used during the release announcement generation has been
          updated to accept ``null`` for ``keywords``, ``maintainer``, and ``maintainer_email``
          (https://github.com/ansible-community/antsibull/pull/594).
      release_summary: Bugfix release.
    fragments:
      - 0.61.1.yml
      - 594-announcements.yml
    release_date: '2024-04-17'
  0.62.0:
    changes:
      breaking_changes:
        - The release role no longer automatically skips the ``prepare`` step when
          the ``.deps`` file already exists. If you need this behavior, set ``antsibull_skip_prepare=true``
          (https://github.com/ansible-community/antsibull/pull/598).
      minor_changes:
        - Add option ``--preserve-deps`` to the ``prepare`` subcommand that allows
          to preserve the dependencies if a ``.deps`` file for that version already
          exists. The versions from that ``.deps`` file are validated against the
          build requirements and constraints, and the remainder of the release preparation
          process remains unchanged. The release role allows to pass this flag when
          ``antsibull_preserve_deps=true`` (https://github.com/ansible-community/antsibull/pull/599).
        - Allow the release role to skip the ``prepare`` step by setting ``antsibull_skip_prepare=true``
          if the ``.deps`` file already exists (https://github.com/ansible-community/antsibull/pull/598).
        - The ``prepare`` subcommand will no longer overwrite an existing release
          summary in the ``changelog.yaml`` file (https://github.com/ansible-community/antsibull/pull/597).
        - Use feature freeze for all betas from ``b2`` on, and all release candidates
          in the release role (https://github.com/ansible-community/antsibull/pull/598).
      release_summary: Feature release for improving the automatic release workflow.
    fragments:
      - 0.62.0.yml
      - 597-release_summary-overwrite.yml
      - 598-release-role.yml
      - 599-prepare-preserve.yml
    release_date: '2024-05-13'
  0.63.0:
    changes:
      minor_changes:
        - The release role now has a ``antsibull_build_reset`` option, which defaults
          to the value of ``antsibull_data_reset``, that allows to control whether
          ``.build`` files are reset during alpha and beta-1 releases (https://github.com/ansible-community/antsibull/pull/601).
      release_summary: Feature release for improving the automatic release workflow.
    fragments:
      - 0.63.0.yml
      - 601-antsibull_build_reset.yml
    release_date: '2024-05-14'
  0.63.1:
    changes:
      bugfixes:
        - Fix bug in ``--preserve-deps`` option handling (https://github.com/ansible-community/antsibull/pull/602).
      release_summary: Bugfix release.
    fragments:
      - 0.63.1.yml
      - 602-preserve_deps.yml
    release_date: '2024-05-14'
  0.64.0:
    changes:
      bugfixes:
        - Fix bug when handling ``antsibull_build_reset`` was passed in as a string
          from CLI (https://github.com/ansible-community/antsibull/pull/602).
      minor_changes:
        - If you are using `argcomplete <https://pypi.org/project/argcomplete/>`__,
          you can now tab-complete ``antsibull-build`` command lines. See `Activating
          global completion <https://pypi.org/project/argcomplete/#activating-global-completion>`__
          in the argcomplete README for how to enable tab completion globally. This
          will also tab-complete Ansible commands such as ``ansible-playbook`` and
          ``ansible-test`` (https://github.com/ansible-community/antsibull/pull/611).
      release_summary: Bugfix and feature release.
    fragments:
      - 0.64.0.yml
      - 602-antsibull_build_reset.yml
      - 610-pyre.yml
      - 611-argcomplete.yml
    release_date: '2024-08-17'
  0.65.0:
    changes:
      breaking_changes:
        - Antsibull now depends on antsibull-core >= 3.1.0 and pydantic >= 2.0.0 (https://github.com/ansible-community/antsibull/pull/617,
          https://github.com/ansible-community/antsibull/pull/620).
      bugfixes:
        - Add explicit dependency on PyYAML, since we directly use it (https://github.com/ansible-community/antsibull/pull/619).
        - announcements - fix link to ansible-core changelog in the Ansible package
          release announcement template (https://github.com/ansible-community/antsibull/pull/621).
      minor_changes:
        - Add dependency on antsibull-fileutils. Some functionality from antsibull-core
          is moving there, so we can use it from there directly (https://github.com/ansible-community/antsibull/pull/619).
        - Add subcommand ``lint-build-data`` for linting build data in ``ansible-build-data``
          (https://github.com/ansible-community/antsibull/pull/617).
        - Remove the mention of mailing lists from the Ansible README (https://github.com/ansible-community/antsibull/pull/613).
      release_summary: Bugfix and feature release with breaking changes
      removed_features:
        - The ``announcements --send`` command no longer attempts to send mails to
          the mailing lists, which have been sunset (https://github.com/ansible-community/antsibull/pull/613).
    fragments:
      - 0.65.0.yml
      - 613-mailing-list-removal.yml
      - 617-collection-meta-linter.yml
      - 619-antsibull-fileutils.yml
      - 621-forum-heading.yaml
    release_date: '2024-09-14'
