Skip to main content

Simple git changelog file generator

Project description

simple-git-changelog

PyPI - Status PyPI GitHub PyPI - Python Version

simple-git-changelog is a command-line tool for creating and updating a git project's changelog file.

Create the Changelog File

To create your project's changelog file, run simple-git-changelog in your project's root directory:

$ simple-git-changelog

By default, the "CHANGELOG.md" file is created with your project's changes. For example:

# Changelog

## 2021-04-30

- [abcdf0](https://github.com/username/project-name/commit/abcdf0) most recent change

- [abcdef](https://github.com/username/project-name/commit/abcdef) previous change

Edit "CHANGELOG.md" as appropriate and commit. Changes to the changelog title are maintained across updates.

Update the Changelog File

To update your changelog file, simply run simple-git-changelog again. Change items for new git changes are added to the top of the changelog:

# MyProject Changelog

## 2021-05-01

- [abcdf1](https://github.com/username/project-name/commit/abcdf1) one more thing

## 2021-04-30

- [abcdf0](https://github.com/username/project-name/commit/abcdf0) most recent change

- [abcdef](https://github.com/username/project-name/commit/abcdef) previous change

Usage

usage: simple-git-changelog [-h] [-o FILE]

options:
  -h, --help  show this help message and exit
  -o FILE     specify the change log file (default is "CHANGELOG.md")

Development

This package is developed using python-build. It was started using python-template as follows:

template-specialize python-template/template/ simple-git-changelog/ -k package simple-git-changelog -k name 'Craig A. Hobbs' -k email 'craigahobbs@gmail.com' -k github 'craigahobbs' -k noapi 1

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

simple_git_changelog-1.1.4.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

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

simple_git_changelog-1.1.4-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file simple_git_changelog-1.1.4.tar.gz.

File metadata

  • Download URL: simple_git_changelog-1.1.4.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for simple_git_changelog-1.1.4.tar.gz
Algorithm Hash digest
SHA256 851a55ddb3495a9dc46c769d1e45208d49c1d01fd176d1b59ccd3f8cf3251a87
MD5 f6b32858dad9b62b7225e114917f358c
BLAKE2b-256 132e6eaba901df43fb7fa2aaad72c8beed9865ccb397f4f81fceaf50663a21e7

See more details on using hashes here.

File details

Details for the file simple_git_changelog-1.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_git_changelog-1.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1c0a7c3454bdaef0565770a793a87774dc222a827b9f5bf50f9c5c3b78b2001a
MD5 95b2c6decbae630d238550b2fe25a028
BLAKE2b-256 3a348915bec72fc88b227c30f76624f3931a9869ff60249fbf366bf7b3979b9f

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