Building changelogs from fragments.

The binaries can be downloaded from releases.

Note: because changelogging was originally written in python, releases on PyPI have different versions: for instance, the 0.4.1 release is on PyPI with version 2.4.1, meaning the major part of the version is always incremented twice to get the PyPI one.

Installing changelogging with pipx is quite simple:

$ pipx install changelogging

Alternatively, the package can be installed from source:

$ pipx install git+https://github.com/nekitdev/changelogging.git

Or via cloning the repository:

$ git clone https://github.com/nekitdev/changelogging.git
$ cd changelogging
$ pipx install .

Installing the crate with cargo is as simple as with pipx:

$ cargo install changelogging

Alternatively, the crate can be installed from source:

$ cargo install --git https://github.com/nekitdev/changelogging.git

Or via cloning the repository:

$ git clone https://github.com/nekitdev/changelogging.git
$ cd changelogging
$ cargo install --path .

Once changelogging is installed, we can start building changelogs!

First things first, we need to configure the context of the project.

Create changelogging.toml and add the name, version and URL of the project:

[context]
name = "changelogging"
version = "0.4.1"
url = "https://github.com/nekitdev/changelogging"

Then we need to create the changes directory.

$ mkdir changes

Now we can add fragments:

$ changelogging create --content "Added cool features!" 13.feature.md
$ changelogging create --content "Fixed annoying bugs!" 64.fix.md

And finally, preview the changelog entry!

$ changelogging preview
## 0.4.1 (YYYY-MM-DD)

### Features

- Added cool features! (#13)

### Fixes

- Fixed annoying bugs! (#64)

Then let us add our CHANGELOG.md file with the following content:

# Changelog

<!-- changelogging: start -->

Note that the start is essential if we want to add some content before the changelog entries.

Assuming the preview is what we expected it to be, writing it to the changelog is as simple as:

$ changelogging build

Finally, let's see the changelog:

$ cat CHANGELOG.md
# Changelog

<!-- changelogging: start -->

## 0.4.1 (YYYY-MM-DD)

### Features

- Added cool features! (#13)

### Fixes

- Fixed annoying bugs! (#64)

You can find the documentation here.

If you need support with the library, you can send an email or refer to the official Discord server.

You can find the changelog here.

You can find the Security Policy of changelogging here.

If you are interested in contributing to changelogging, make sure to take a look at the Contributing Guide, as well as the Code of Conduct.

changelogging is licensed under the MIT License terms. See License for details.