Semversioner
The easiest way to manage semantic versioning in your project and generate CHANGELOG.md file automatically.
Semversioner will provide the tooling to automate semver release process for libraries, docker images, etc.
This project was inspired by the way AWS manages their versioning for AWS-cli.
Semantic Versioning
The semantic versioning spec involves several possible variations, but to simplify, in Semversioner we are using the three-part version number:
<major>.<minor>.<patch>
Constructed with the following guidelines:
- Breaking backward compatibility or major features bumps the major (and resets the minor and patch).
- New additions without breaking backward compatibility bumps the minor (and resets the patch).
- Bug fixes and misc changes bumps the patch.
An example would be 1.0.0
How it works
At any given time, the .semversioner/ directory looks like:
.semversioner
└── next-release
├── minor-20181227010225.json
└── major-20181228010225.json
├── 1.1.0.json
├── 1.1.1.json
├── 1.1.2.json
The release process takes everything in next-release and aggregates them all together in a single JSON file for that release (e.g 1.12.0.json). This
JSON file is a list of all the individual JSON files from next-release.
Install
$ pip install semversioner
Usage
Bumping the version
In your local environment your will use the CLI to create the different changeset files that will be committed with your code. For example:
$ semversioner add-change --type patch --description "Fix security vulnerability with authentication."
Then, in your CI/CD tool you will need to release (generating automatically version number) and creating the the changelog file.
$ semversioner release
Generating Changelog
As a part of your CI/CD workflow, you will be able to generate the Changelog file with all changes.
$ semversioner changelog > CHANGELOG.md
License
Copyright (c) 2020 Raul Gomis. MIT licensed, see LICENSE file.
Made with ♥ by Raul Gomis <https://twitter.com/rgomis>.
Changelog
Note: version releases in the 0.x.y range may introduce breaking changes.
0.10.0
- minor: Add new 'status' command to display the state of the working directory and unreleased changes
- patch: Fix build and deployment configuration
- patch: Refactor method names and code for better code readability and testability
0.9.0
- minor: Deprecated .changes directory in favour of .semversioner directory
- patch: Internal refactor to improve code quality and test coverage
0.8.1
- patch: Fix installer error when referencing to LICENSE file
0.8.0
- minor: Enabled autocompletion by default
0.7.1
- patch: Improve docs for open source
0.7.0
- minor: Fail with error code when no changes are provided in the release command
0.6.16
- patch: Fix bug: add require module in setup.py
0.6.15
- patch: Fix packaging for LICENSE
- patch: Improve README.md documentation
- patch: Use jinja2 template engine internally to generate the changelog
0.6.14
- patch: Update docs
0.6.13
- patch: Fix README.md
0.6.12
- patch: Fix long description content type
0.6.11
- patch: Add README.md file
0.6.10
- patch: Fix code consistency
0.6.9
- patch: Fix packaging
0.6.8
- patch: Tag the repository when releasing
0.6.7
- patch: Fix tests and improve coverage
0.6.6
- minor: Initial version
1 maintainer
Metadata
1 maintainer
Release files for semversioner 0.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| semversioner-0.10.0.tar.gz | 8.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| semversioner-0.10.0-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 16.9 kB
Release files / semversioner-0.10.0.tar.gz
| Download URL | semversioner-0.10.0.tar.gz |
|---|---|
| Size | 8.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0c32ad106a7d4e42862f1454b07cdf7b40ab64940da1fdee1aa5164e4dd5c530
|
|
BLAKE2b-256 checksum How to use checksums |
cb73cf520ff261f67dc4e1ff6bfaf25460e2a55be536ad324cc55369badcc278
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.8.6
|
Release files / semversioner-0.10.0-py2.py3-none-any.whl
| Download URL | semversioner-0.10.0-py2.py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
9a233e285c93afece6ef2f87ef47aa27d9ec054fe50cf254445fee34894444d6
|
|
BLAKE2b-256 checksum How to use checksums |
8bc0825b83199567c458e0daed69d0bacd0ca48d0e0fc6ac8bc3fe5dbbdbf520
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.8.6
|
