Skip to main content
bumper is a version bumper for projects using git and semantic versioning. It automates the process of incrementing version numbers and creating git tags.

Installation

Run directly

nix run github:spotdemo4/nur#bumper

Add to flake

devShells.default = pkgs.mkShell {
  packages = with pkgs.trev; [
    bumper
  ];
};

Usage

Bump patch version

bumper patch

Bump minor version

bumper minor

Bump major version

bumper major

Preview changes

See what version would be created without making changes:
bumper patch --dry-run

Features

  • Semantic versioning: Follows semver (major.minor.patch) conventions
  • Git integration: Automatically creates tags
  • Dry run mode: Preview changes before applying
  • Customizable: Configure tag prefixes and formats

How it works

1

Detect current version

Bumper reads the current version from git tags
2

Calculate new version

Increments the version number based on your choice (major, minor, patch)
3

Create git tag

Creates a new git tag with the updated version
Use bumper in CI/CD pipelines to automate version management during releases.

Build docs developers (and LLMs) love