All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Do not release same version twice.
- Show helpful error message if
show <release>does not find requestedrelease.
Python3.13and3.14are now explicitly supported.
Python3.9support has been removed.
2.0.0 - 2024-06-14
Python3.7and3.8are not supported anymore.
Python3.12is now explicitly supported.
- Uncategorized change (usually comments) will no longer impact the release version.
- Typing is using built-in types for
tuple,listanddictconsistently.
keepachangelog.starlette.add_changelog_endpointis nowkeepachangelog.starlette.changelog_endpoint. Refer to documentation for more details.
2.0.0.dev5 - 2023-01-03
keepachangelog showdoes not support--rawoption anymore. It will always be the raw markdown output.keepachangelog releasewill now fail if there is nothing to release.
keepachangelog showdoes not support--rawoption anymore.
2.0.0.dev4 - 2022-12-22
- Add a CLI to interact with
keepachangelogAPI. (Thanks Luca Faggianelli)
- Changelog file is now expected to be
utf-8encoded when read. (Thanks 0x55aa) - Changelog file is now
utf-8encoded when written.
2.0.0.dev3 - 2022-10-19
keepachangelog.from_dictnow returns a single new line at end of file in case no url could be found. (Thanks rockstarr-programmerr)
- Dropped support for python 3.6
2.0.0.dev2 - 2021-08-04
keepachangelog.releasewill now properly bump version in case the number of digit to compare was previously increased (such as if version 9 and 10 existed).
keepachangelog.to_sorted_semanticto be able to sort semantic versions.
2.0.0.dev1 - 2021-05-27
keepachangelog.releasewill now returnNoneinstead of throwing an exception if there is no Unreleased content.
2.0.0.dev0 - 2021-05-27
keepachangelog.to_dictnow contains releases that have a URL but no section.keepachangelog.to_raw_dictnow contains releases that have a URL but no section.
keepachangelog.to_dictnow containsuncategorizedkey for each item if uncategorized information are available for the version.keepachangelog.to_dictnow containsmetadatakey whereversion,release_date,semantic_versionandurlhave been moved.keepachangelog.to_raw_dictnow containsmetadatakey whereversion,release_date,semantic_versionandurlhave been moved.- As
keepachangelog.starlette.add_changelog_endpointis returning data as returned bykeepachangelog.to_dict, the endpoint output is now modified. - As
keepachangelog.flask_restx.add_changelog_endpointis returning data as returned bykeepachangelog.to_dict, the endpoint output is now modified.
keepachangelog.from_dictto create a changelog content based on a dictionary.keepachangelog.to_dictnow allows to provide any line iterable instead of only a file path.
1.0.0 - 2021-05-21
keepachangelog.to_dictnow containsurlkey for each item if a link is available for the version.keepachangelog.to_raw_dictnow containsurlkey for each item if a link is available for the version.keepachangelog.to_dictnow containssemantic_versionkey for each item if the version follows semantic versioning.keepachangelog.to_raw_dictnow containssemantic_versionkey for each item if the version follows semantic versioning.
keepachangelog.releaseis now allowing to provide a custom new version thanks to the newnew_versionparameter.
keepachangelog.releasenow allowspre-releaseandbuild metadatainformation as part of valid semantic version. As per semantic versioning specifications. To ensure compatibility with some python specific versioning,pre-releaseis also handled as not being prefixed with-, or prefixed with..keepachangelog.releasewill now bump a pre-release version to a stable version. It was previously failing.
0.5.0 - 2021-04-19
keepachangelog.releasefunction to guess new version number based onUnreleasedsection, update changelog and return new version number.keepachangelog.to_raw_dictfunction returning a raw markdown description of the release underrawdict.
- Handle any category name.
- Add more flexibility for release format.
Unreleasedis now reported as lower casedunreleased.
0.4.0 - 2020-09-21
keepachangelog.flask_restx.add_changelog_endpointfunction to add a changelog endpoint to a Flask-RestX application.
0.3.1 - 2020-07-13
- Keep star character at the end of a line as it can be used to mark as italic.
0.3.0 - 2020-03-01
- Information is now stored without star, space or caret at start or end of line.
0.2.0 - 2020-02-24
- It is now possible to retrieve "Unreleased" information thanks to the
show_unreleasedparameter. (Thanks Alessandro Ogier)
0.1.0 - 2020-02-17
keepachangelog.starlette.add_changelog_endpointfunction to add a changelog endpoint to a Starlette application.
0.0.1 - 2020-02-17
- Initial release.