--- id: tbump version: "6.11.0" license: BSD-3-Clause license_treatment: permissive maintenance: abandoned --- # tbump — Bump software releases License: permissive · Maintenance: abandoned · Downloads: 187.0K/mo ## 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 above — 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 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 - License: BSD-3-Clause (permissive) - Python support: supports_current - Install friction: low - Maintenance: abandoned - Downloads: 187.0K/month (top 15,000 on PyPI) - Known vulnerabilities: none known ## Tags version bump automation, semantic versioning release tool, git tag and commit version, multi-file version updater, release workflow automation, version string replacement, automated release management, release-automation, version-management, git-workflow [View on SkillFed](https://skillfed.io/packages/tbump) · [View on PyPI](https://pypi.org/project/tbump/)