https://github.com/s0ders/go-semver-release
Automate semantic versioning of Git repositories by analyzing their formatted commit history and tagging them with the right semver.
https://github.com/s0ders/go-semver-release
ci cicd semantic-version semantic-versioning semver semver-release versioning
Last synced: about 1 month ago
JSON representation
Automate semantic versioning of Git repositories by analyzing their formatted commit history and tagging them with the right semver.
- Host: GitHub
- URL: https://github.com/s0ders/go-semver-release
- Owner: s0ders
- License: mit
- Created: 2022-12-05T13:30:28.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-06T09:32:10.000Z (about 1 month ago)
- Last Synced: 2025-03-08T15:50:10.177Z (about 1 month ago)
- Topics: ci, cicd, semantic-version, semantic-versioning, semver, semver-release, versioning
- Language: Go
- Homepage: https://go-semver-release.akira.sh
- Size: 1.26 MB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-go - go-semver-release - Automate the semantic versioning of Git repositories. (Continuous Integration / Standard CLI)
- fucking-awesome-go - go-semver-release - Automate the semantic versioning of Git repositories. (Continuous Integration / Standard CLI)
- awesome-go - go-semver-release - Automate the semantic versioning of Git repositories. (Continuous Integration / Standard CLI)
- awesome-go-with-stars - go-semver-release - Automate the semantic versioning of Git repositories. (Continuous Integration / Standard CLI)
- awesome-go-cn - go-semver-release - semver-release) [![godoc][D]](https://godoc.org/github.com/s0ders/go-semver-release) (持续集成 / 标准CLI)
- awesome-go-plus - go-semver-release - Automate the semantic versioning of Git repositories.  (Continuous Integration / Standard CLI)
- awesome-go-plus - go-semver-release - Automate the semantic versioning of Git repositories.  (Continuous Integration / Standard CLI)
README
# Go Semver Release
Go Semver Release is a CLI program designed to automate versioning of Git repository by analyzing their [formatted commit history](https://www.conventionalcommits.org) and tagging them with the right [SemVer](https://semver.org/spec/v2.0.0.html) number.
This documentation is also available at [https://go-semver-release.akira.sh](https://go-semver-release.akira.sh)
## Features
* 🏷️ Automatic semantic versioning of your Git repository via annotated Git tags
* 🌐 Local or remote mode of execution (local removes the need for secret token)
* 🌴 Support for multiple release branch, prerelease and build metadata
* 🗂️ Support for monorepo (i.e., multiple projects inside a single repository, all versioned separately)
* ⚙️ Custom tag prefix
* 📝 Tag signature using GPG
## Motivation
This project was built to create a lightweight and simple tool to automate the semantic versioning on your Git repository in a language and CI agnostic way by strictly following the Semantic Versioning and Conventional Commit convention.
Following the UNIX philosophy of "make each program do one thing well", it only handles publishing SemVer tags to your Git repository, no package publishing or any other features.
All you need to have is an initialized Git repository, a release branch (e.g. `main`) and a formatted commit history on that branch following the [Conventional Commit](https://www.conventionalcommits.org/en/v1.0.0/) specification. Many IDEs support plugins that help formatting messages (e.g. [VSCode](https://marketplace.visualstudio.com/items?itemName=vivaxy.vscode-conventional-commits), [IntelliJ](https://plugins.jetbrains.com/plugin/13389-conventional-commit)).
> [!NOTE]
> This program can only read annotated Git tags. If at some point you need to manually add a SemVer tag to your repository, make sure it is annotated, otherwise the program will not be able to detect it.
## How is this different from \ ?
Other tools exist to version software using semantic versions such as [semantic-release](https://github.com/semantic-release/semantic-release). Go Semver Release focuses on versioning only, no package publishing, release log generation or other features.
If you want a simple tool that handle the generation of the next semantic version tag for your project, you are at the right place. This allows the program to work with minimal dependencies and work faster.
## Documentation
### Usage
* [Install](usage/install.md)
* [Quickstart](usage/quickstart.md)
* [Configuration](usage/configuration.md)
* [Output](usage/output.md)
### Recipes
* [Workflow examples](recipes/workflow-examples.md)
### Miscellaneous
* [Benchmark](miscellaneous/benchmark.md)
* [How it works](miscellaneous/how-it-works.md)
Project's illustration designed by [@TristanDacross](https://github.com/TristanDacross)