Skip to content

Ansible Changelog Tool Release Notes

v0.35.1

Release Summary

Bugfix release.

Bugfixes

v0.35.0

Release Summary

Feature release.

Minor Changes

v0.34.0

Release Summary

Feature release for antsibull-build.

Minor Changes

v0.33.0

Release Summary

Maintenance release for fixing / deprecating certain boolean options.

Breaking Changes / Porting Guide

Deprecated Features

v0.32.0

Release Summary

Feature release.

Major Changes

Minor Changes

Breaking Changes / Porting Guide

Deprecated Features

  • The configuration settings changelog_filename_template, changelog_filename_version_depth, and output_formats are deprecated and will eventually be removed. Use the new setting output instead. Note that there are no runtime warnings right now. If the time to remove them comes nearer, there will be runtime warnings for a longer time first before they are actually removed (https://github.com/ansible-community/antsibull-changelog/pull/194).

Removed Features (previously deprecated)

v0.31.2

Release Summary

Bugfix release.

Bugfixes

v0.31.1

Release Summary

Bugfix release for ansible-core.

Bugfixes

v0.31.0

Release Summary

Feature release.

Minor Changes

Breaking Changes / Porting Guide

  • More internal code related to the old changelog format has been removed. This only potentially affects other projects which consume antsibull-changelog as a library. The sister antsibull projects antsibull-build and antsibull-docs might only be affected in older versions. Users of the antsibull-changelog CLI tool are not affected by this change (https://github.com/ansible-community/antsibull-changelog/pull/179).

v0.30.0

Release Summary

Feature release.

Minor Changes

v0.29.0

Release Summary

Feature release.

Minor Changes

Removed Features (previously deprecated)

Bugfixes

  • Remove Python version check that was checking for Python >= 3.6 (instead of >= 3.9). This check is not really necessary since pyproject.toml declares requires-python, and old enough Python versions where pip does not know about requires-python will not load antsibull-changelog due to syntax errors anyway (https://github.com/ansible-community/antsibull-changelog/pull/167).

v0.28.0

Release Summary

Feature release.

Minor Changes

v0.27.0

Release Summary

Feature release.

Minor Changes

v0.26.0

Release Summary

Feature release.

Minor Changes

v0.25.0

Release Summary

Bugfix and feature release.

Minor Changes

Bugfixes

v0.24.0

Release Summary

Feature release which now allows to output MarkDown.

Minor Changes

Deprecated Features

v0.23.0

Release Summary

Feature release.

Minor Changes

v0.22.0

Release Summary

New feature release

Minor Changes

v0.21.0

Release Summary

Maintenance release with a deprecation.

Deprecated Features

v0.20.0

Release Summary

Bugfix and maintenance release using a new build system.

Major Changes

Bugfixes

v0.19.0

Release Summary

Feature release.

Minor Changes

v0.18.0

Release Summary

Maintenance release that drops support for older Python versions.

Breaking Changes / Porting Guide

v0.17.0

Release Summary

Feature release for ansible-core.

Minor Changes

v0.16.0

Release Summary

Feature and bugfix release.

Minor Changes

Bugfixes

v0.15.0

Release Summary

Feature release.

Minor Changes

v0.14.0

Release Summary

Feature release that will speed up the release process with ansible-core 2.13.

Minor Changes

v0.13.0

Release Summary

This release makes changelog building more reliable.

Minor Changes

Bugfixes

v0.12.0

Release Summary

New feature release which supports other projects than ansible-core and Ansible collections.

Minor Changes

Bugfixes

  • Fix prerelease collapsing when use_semantic_versioning is set to true for ansible-core.

v0.11.0

Minor Changes

  • When using ansible-core 2.11 or newer, will now detect new roles with argument spec. We only consider the main entrypoint of roles.

Bugfixes

  • When subdirectories of modules are used in ansible-base/ansible-core, the wrong module name was passed to ansible-doc when --use-ansible-doc was not used.

v0.10.0

Minor Changes

  • The new --cummulative-release option for antsibull-changelog release allows to add all plugins and objects to a release since whose version_added is later than the previous release version (or ancestor if there was no previous release), and at latest the current release version. This is needed for major releases of community.general and similarly organized collections.
  • Will now print a warning when a release is made where the no prelude_section_name section (default: release_summary) appears.

Bugfixes

  • Make sure that the plugin caching inside ansible-base/-core works without --use-ansible-doc.

v0.9.0

Major Changes

  • Add support for reporting new playbooks and roles in collections.
  • Add support for special changelog fragment sections which add new plugins and/or objects to the changelog for this version. This is mainly useful for test and filter plugins, and for playbook and role objects, which are not yet automatically detected and mentioned in changelogs/changelog.yaml or the generated RST changelog.

The format of these sections and their content is as follows:

---
add plugin.filter:
  - name: to_time_unit
    description: Converts a time expression to a given unit
  - name: to_seconds
    description: Converts a time expression to seconds
add object.role:
  - name: nginx
    description: The most awesome nginx installation role ever
add object.playbook:
  - name: wipe_server
    description: Totally wipes a server

For every entry, a list of plugins (section add plugin.xxx) or objects (section add object.xxx) of the given type (filter, test for plugins, playbook, role for objects) will be added. Every plugin or object has a short name as well as a short description. These fields correspond to the module/plugin name and the short_description field of the DOCUMENTATION block of modules and documentable plugins.

Minor Changes

  • Add --update-existing option for antsibull-changelog release, which allows to update the current release's release date and (if relevant) codename instead of simply reporting that the release already exists.

Breaking Changes / Porting Guide

  • The new option prevent_known_fragments with default value being the value of keep_fragments allows to control whether fragments with names that already appeared in the past are ignored or not. The new behavior happens if keep_fragments=false, and is less surprising to users (see https://github.com/ansible-community/antsibull-changelog/issues/46). Changelogs with keep_fragments=true, like the ansible-base/ansible-core changelog, are not affected.

v0.8.1

Bugfixes

  • Fixed error on generating changelogs when using the trivial section.

v0.8.0

Minor Changes

  • Allow to not save a changelog on release when using API.
  • Allow to sanitize changelog data on load/save. This means that unknown information will be removed, and bad information will be stripped. This will be enabled in newly created changelog configs, but is disabled for backwards compatibility.

v0.7.0

Minor Changes

  • A new config option, ignore_other_fragment_extensions allows for configuring whether only .yaml and .yml files are used (as mandated by the ansible-test sanity --test changelog test). The default value for existing configurations is false, and for new configurations true.
  • Allow to use semantic versioning also for Ansible-base with the use_semantic_versioning configuration setting.
  • Refactoring changelog generation code to provide all preludes (release summaries) in changelog entries, and provide generic functionality to extract a grouped list of versions. These changes are mainly for the antsibull project.

v0.6.0

Minor Changes

  • New changelog configurations place the CHANGELOG.rst file by default in the top-level directory, and not in changelogs/.
  • The config option archive_path_template allows to move fragments into an archive directory when keep_fragments is set to false.
  • The option use_fqcn (set to true in new configurations) allows to use FQCN for new plugins and modules.

v0.5.0

Minor Changes

  • The internal changelog generator code got more flexible to help antsibull generate Ansible porting guides.

v0.4.0

Minor Changes

  • Allow to enable or disable flatmapping via config.yaml.

Bugfixes

  • Fix bad module namespace detection when collection was symlinked into Ansible's collection search path. This also allows to add releases to collections which are not installed in a way that Ansible finds them.

v0.3.1

Bugfixes

  • Do not fail when changelogs/fragments does not exist. Simply assume there are no fragments in that case.
  • Improve behavior when changelogs/config.yaml is not a dictionary, or does not contain sections.
  • Improve error message when --is-collection is specified and changelogs/config.yaml cannot be found, or when the lint subcommand is used.

v0.3.0

Minor Changes

  • Allow to pass path to ansible-doc binary via --ansible-doc-bin.
  • Changelog generator can be ran via python -m antsibull_changelog.
  • Use ansible-doc instead of /path/to/checkout/bin/ansible-doc when being run in ansible-base checkouts.

v0.2.1

Bugfixes

  • Allow to enumerate plugins/modules with ansible-doc by specifying --use-ansible-doc.

v0.2.0

Minor Changes

  • Added more testing.
  • Fix internal API for ACD changelog generation (pruning and concatenation of changelogs).
  • Improve error handling.
  • Improve reStructuredText creation when new modules with and without namespace exist at the same time.
  • Title generation improved (remove superfluous space).
  • Use PyYAML C loader/dumper if available.
  • lint subcommand no longer requires specification whether it is run inside a collection or not (if usual indicators are absent).

v0.1.0

Release Summary

Initial release as antsibull-changelog. The Ansible Changelog Tool has originally been developed by @mattclay in the ansible/ansible repository for Ansible itself. It has been extended in felixfontein/ansible-changelog and ansible-community/antsibull to work with collections, until it was moved to its current location ansible-community/antsibull-changelog.