changeloggh is a command line tool that generates changelog files for github
Project description
changeloggh
changeloggh
is a command line tool
to generate and administrate changelog files for GitHub
according to https://keepachangelog.com/en/1.1.0/.
Installation
Install with pip:
pip install changeloggh
Upgrade with pip:
pip install --upgrade changeloggh
Usage
Alias clgh
Help:
changeloggh --help
Version:
changeloggh --version
Init CHANGELOG:
changeloggh init <GitHub Repo>
Add changes:
changeloggh <added|changed|deprecated|removed|fixed|security> "entry 1" "entry 2" ...
Bump version:
changeloggh bump <major|minor|patch>
Release version:
changeloggh release <version>
Import MD:
changeloggh import
Print current version:
changeloggh latest
Print CHANGELOG:
changeloggh print --format <rich|json|text>
Development
Installing poetry:
pip install poetry
Installing development dependencies:
poetry install
Running unit tests:
poetry run python -m scripts.tests
Applying code styles:
poetry run python -m scripts.styles
Running code analysis:
poetry run python -m scripts.analyze
Running code coverage:
poetry run python -m scripts.coverage
Running cli using poetry
:
poetry run changeloggh
Release a new version
poetry run python -m scripts.bump --help
poetry run python -m scripts.bump <major|minor|patch>
Why a lock file?
A lot of tools (like yarn
, npm
, poetry
,etc) use lock files
to
ensures that installations remain identical and reproducible
across systems. A lock files
saves important metadata, so that is why
changeloggh
is using this approach. The changelog.lock
file
saves and structures changelog data in a json format.
It's highly recommended to commit the changelog.lock
file into your repository.
Limitations
- Does not support other format besides
semver
major.minor.patch
, ex.: 1.1.1. - It needs a
changelog.lock
.
Alternatives
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for changeloggh-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0bf3c7510dbe3204cee9e6c7e4bc951a33613ee7ef0bdd9eb89f9cc5ed6d9c15 |
|
MD5 | 1b4cc9888094e4a64dd9efa86a1dfdb1 |
|
BLAKE2b-256 | 261bf5524c5dcbe36d67b90901425ec37ce5f0135dca2ade124584d2645f1ac6 |