Skip to main content

Lightweight semantic version + changelog manager

Project description

autochange

Lightweight semantic version + changelog manager.

Features

  • Maintain a markdown CHANGELOG.md with sections: Added, Changed, Deprecated, Removed, Fixed, Security.
  • Add unreleased changes quickly.
  • Release and automatically stamp date + version.
  • Compute next semantic version via bump parts (major/minor/patch) or explicit version.
  • Import Conventional Commits directly into the unreleased section.

Install

pip install autochange

Development dependencies

pip install -e .[dev]

Usage

autochange init               # create CHANGELOG.md
autochange add -t added "New feature" --scope api
autochange add -t fixed "Bug in parser"
autochange release minor      # bumps minor based on last release
autochange release auto --tag --commit --push  # infer bump from changes, commit, tag and push
autochange import-commits --since v0.1.0  # parse commits after tag v0.1.0
autochange tag                # create git tag for latest released version
autochange tag 1.2.3 --push   # create & push tag v1.2.3

Changelog Format

Subset of Keep a Changelog. Example:

# Changelog

## Unreleased - UNRELEASED
### Added
- (api) New feature

## 0.1.0 - 2025-08-13
### Fixed
- Parser bug

Roadmap

  • Conventional commit parser integration.
  • Auto-detect bump type from unreleased changes.
  • Git tag creation helper.
  • Export JSON.
  • Supporting different environments (e.g. package.json, Cargo.toml).

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

autochange-0.1.1.tar.gz (15.0 kB view details)

Uploaded Source

Built Distribution

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

autochange-0.1.1-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file autochange-0.1.1.tar.gz.

File metadata

  • Download URL: autochange-0.1.1.tar.gz
  • Upload date:
  • Size: 15.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.0

File hashes

Hashes for autochange-0.1.1.tar.gz
Algorithm Hash digest
SHA256 9ea133e1141bade1aac1063e65ca81752df605f0311dcef244032442dbd960e8
MD5 9579b0148c7e5f32ea725fe843348061
BLAKE2b-256 7c835d52c1f940b705610bb09767b5eb3c1152302e2f92f6db7986eb3f36f8be

See more details on using hashes here.

File details

Details for the file autochange-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: autochange-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.0

File hashes

Hashes for autochange-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7922536ee4c29bd58cbcd6a144aa956f32f7783273512abc0880276633342935
MD5 104ae6ad081ce062b09f1bee7d4b155d
BLAKE2b-256 98ab0baf1b9eddf81807eea5f144ec89a3339adbd64c927acdb7cf25ccfc65c1

See more details on using hashes here.

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