Skip to main content

A CLI tool to manage project versioning and changelogs with Keep a Changelog compliance.

Project description

changelogbump

Python Poetry PyPI - Version

A command-line tool that updates a project's changelog and bumps its semantic version according to Keep a Changelog conventions.

Features

  • Initializes a new CHANGELOG.md file with a standard header.
  • Increments the project version (major, minor, or patch) and updates:
    • The pyproject.toml version.
    • The changelog, prompting for added, changed, or removed entries.
  • Helps maintain strict adherence to semantic versioning.

Requirements

  • pyproject.toml

Installation

  1. Ensure you have Python 3.11 or newer installed.
  2. Install via pip:
    pip install changelogbump
    

Usage

From your terminal, run:

  • Initialize a fresh changelog in the project root (if not present):

    changelogbump init
    
  • Add and bump your version, specifying the part to increment:

    changelogbump add --major
    changelogbump add --minor
    changelogbump add --patch
    
  • Provide a summary for the version:

    changelogbump add --patch --summary "Small bug fixes"
    
  • Check the currently installed version of changelogbump:

    changelogbump version
    

You will be prompted for items to add under different sections (Added, Changed, Removed), which are appended to the changelog.

Contributing

Pull requests, issues, and feature requests are welcome! Feel free to check out the issues page.

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

changelogbump-0.5.0.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

changelogbump-0.5.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file changelogbump-0.5.0.tar.gz.

File metadata

  • Download URL: changelogbump-0.5.0.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for changelogbump-0.5.0.tar.gz
Algorithm Hash digest
SHA256 28f0f255ca118a123b113d41e843af9107735a6c469c619d4b74ab1a501952c9
MD5 08ce0d495df88a06d35977db57b5229a
BLAKE2b-256 bd0202a3c6d9e0f26b0f59af612aa60c777486f56eb772752160ef417cf3ad3f

See more details on using hashes here.

Provenance

The following attestation bundles were made for changelogbump-0.5.0.tar.gz:

Publisher: python-publish.yml on muad-dweeb/ChangelogBump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file changelogbump-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: changelogbump-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for changelogbump-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5fa931ce8fea655c0f43c70458ab10bc4d0dd576a8f05ef6b3582ab264b51920
MD5 75c81c71efd57f41f284d0dbdb964020
BLAKE2b-256 5afb7fdad16df271d3d2ccfc3190795b1fe48be617dea1c06919c084c1aa2e0e

See more details on using hashes here.

Provenance

The following attestation bundles were made for changelogbump-0.5.0-py3-none-any.whl:

Publisher: python-publish.yml on muad-dweeb/ChangelogBump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page