Skip to content

Create a changelog file from all the merged pull requests

License

Notifications You must be signed in to change notification settings

MotionCorrect/changelog

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

changelog

Create a changelog file from all the merged pull requests

Usage

Install with pip (only do it once):

Standard install

pip install changelog-neuropoly

Development install

git clone git@github.com:neuropoly/changelog.git .
cd changelog
pip install -e .

Then you can use changelog from anywhere:

usage: changelog.py [-h] [--log-level LOG_LEVEL] [--update] [--name NAME] repo-url

Changelog generator script

required arguments:
  repo-url              Repository url in the format <GITHUB_USER/REPO_NAME>. Example: neuropoly/spinalcordtoolbox

optional arguments:
  -h, --help            show this help message and exit
  --log-level LOG_LEVEL Logging level (eg. INFO, see Python logging docs)
  --update              Update an existing changelog file by prepending current changelog to it.
  --name NAME           Existing changelog file to use (by default use CHANGES.md).


Examples

# create a new changelog file [user]_[repo]_changelog.[tagId].md for spinalcordtoolbox
changelog neuropoly/spinalcordtoolbox

# prepend to an existing CHANGES.md file (default)
changelog neuropoly/spinalcordtoolbox --update

# prepend to an existing CUSTOM_CHANGELOG.md
changelog neuropoly/spinalcordtoolbox --update --name CUSTOM_CHANGELOG.md

# run in debug
changelog neuropoly/spinalcordtoolbox --log-level DEBUG

To use a Github Personal Access Token (https://github.com/settings/tokens) simply export the token string via the GITHUB_TOKEN environment variable.

Unless --update is passed, the script will produce a [user]_[repo]_changelog.[tagId].md file with changelog contents.

Contributions are welcome (via a fork of the repository and pull request) 🎉

About

Create a changelog file from all the merged pull requests

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%