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.
2.0.0 - 2024-06-14
Python
3.7
and3.8
are not supported anymore.
Python
3.12
is now explicitly supported.
- Uncategorized change (usually comments) will no longer impact the release version.
- Typing is using built-in types for
tuple
,list
anddict
consistently.
keepachangelog.starlette.add_changelog_endpoint
is nowkeepachangelog.starlette.changelog_endpoint
. Refer to documentation for more details.
2.0.0.dev5 - 2023-01-03
keepachangelog show
does not support--raw
option anymore. It will always be the raw markdown output.keepachangelog release
will now fail if there is nothing to release.
keepachangelog show
does not support--raw
option anymore.
2.0.0.dev4 - 2022-12-22
- Add a CLI to interact with
keepachangelog
API. (Thanks Luca Faggianelli)
- Changelog file is now expected to be
utf-8
encoded when read. (Thanks 0x55aa) - Changelog file is now
utf-8
encoded when written.
2.0.0.dev3 - 2022-10-19
keepachangelog.from_dict
now 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.release
will 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_semantic
to be able to sort semantic versions.
2.0.0.dev1 - 2021-05-27
keepachangelog.release
will now returnNone
instead of throwing an exception if there is no Unreleased content.
2.0.0.dev0 - 2021-05-27
keepachangelog.to_dict
now contains releases that have a URL but no section.keepachangelog.to_raw_dict
now contains releases that have a URL but no section.
keepachangelog.to_dict
now containsuncategorized
key for each item if uncategorized information are available for the version.keepachangelog.to_dict
now containsmetadata
key whereversion
,release_date
,semantic_version
andurl
have been moved.keepachangelog.to_raw_dict
now containsmetadata
key whereversion
,release_date
,semantic_version
andurl
have been moved.- As
keepachangelog.starlette.add_changelog_endpoint
is returning data as returned bykeepachangelog.to_dict
, the endpoint output is now modified. - As
keepachangelog.flask_restx.add_changelog_endpoint
is returning data as returned bykeepachangelog.to_dict
, the endpoint output is now modified.
keepachangelog.from_dict
to create a changelog content based on a dictionary.keepachangelog.to_dict
now allows to provide any line iterable instead of only a file path.
1.0.0 - 2021-05-21
keepachangelog.to_dict
now containsurl
key for each item if a link is available for the version.keepachangelog.to_raw_dict
now containsurl
key for each item if a link is available for the version.keepachangelog.to_dict
now containssemantic_version
key for each item if the version follows semantic versioning.keepachangelog.to_raw_dict
now containssemantic_version
key for each item if the version follows semantic versioning.
keepachangelog.release
is now allowing to provide a custom new version thanks to the newnew_version
parameter.
keepachangelog.release
now allowspre-release
andbuild metadata
information as part of valid semantic version. As per semantic versioning specifications. To ensure compatibility with some python specific versioning,pre-release
is also handled as not being prefixed with-
, or prefixed with.
.keepachangelog.release
will now bump a pre-release version to a stable version. It was previously failing.
0.5.0 - 2021-04-19
keepachangelog.release
function to guess new version number based onUnreleased
section, update changelog and return new version number.keepachangelog.to_raw_dict
function returning a raw markdown description of the release underraw
dict.
- Handle any category name.
- Add more flexibility for release format.
Unreleased
is now reported as lower casedunreleased
.
0.4.0 - 2020-09-21
keepachangelog.flask_restx.add_changelog_endpoint
function 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_unreleased
parameter. (Thanks Alessandro Ogier)
0.1.0 - 2020-02-17
keepachangelog.starlette.add_changelog_endpoint
function to add a changelog endpoint to a Starlette application.
0.0.1 - 2020-02-17
- Initial release.