tbump

What it is and what it does

tbump is a command-line tool that automates the process of bumping your project's version number. It reads a configuration file (tbump.toml or pyproject.toml) that specifies which files contain the version string and how to match it, then replaces the old version with the new one across all listed files. Before making any changes, it displays a preview of all modifications and waits for your confirmation, allowing you to abort if something looks wrong.

Once confirmed, tbump patches the files, optionally runs custom shell commands (hooks) before and after committing, creates a git commit with a templated message, tags the commit with an annotated tag, and pushes both the commit and tag to the remote repository. It supports advanced features like restricting replacements to specific lines via regex patterns, custom version templates for complex versioning schemes, and per-field default values. The tool is designed to be used as a standalone CLI application, typically installed via pipx.

Use it for:

• Automate routine version bumps in Python projects by updating setup.py, pyproject.toml, and other version files in one command.
• Enforce consistent version numbering across multiple files and formats with regex-based pattern matching.
• Run pre-release checks or post-release publishing commands as part of the bump workflow.
• Manage complex versioning schemes using custom version templates and field defaults.
• Reduce human error in release workflows by automating git operations with a single interactive command.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

tbump automates version bumping in your project by updating version strings across configured files, creating git commits and tags, and running custom hooks—all with a confirmation step before execution.

No—the project is archived and abandoned with no releases or commits since 2023-09-09. While it has low install friction and no known vulnerabilities, the lack of active maintenance means no bug fixes, security updates, or compatibility improvements for modern Python or git workflows. Consider maintained alternatives for new projects or critical release automation.

Install

tbump on PyPI

pip install tbump

uv add tbump

poetry add tbump

Installing tbump

Before you install

Low install friction with four straightforward runtime dependencies. However, the project is archived and abandoned as of its last commit in 2026-02-20, with no releases since 2023-09-09—over 1070 days ago. No active maintenance or security updates should be expected.

License in practice

BSD-3-Clause is permissive and poses no restrictions on commercial or private use, modification, or redistribution, though you must retain the license notice.

Quickstart

pip install tbump
tbump init 1.0.0
tbump 1.0.1

Requires Python 3.7 or later. A git repository and tbump.toml configuration file are required to run version bumps.

Verify before relying

• Whether the archived status and lack of maintenance since 2023 affects compatibility with modern git or Python workflows.
• Whether the 173 GitHub stars reflect active community forks or maintained alternatives.

Package facts

Evidence: tbump-6.11.0-py3-none-any.whl

Tags

More Build Tools packages