BUMPVERSION(1)

📦
version 1.0.1 · 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

✨ NAME ✨

bumpversion — version-bump your software, bestie 💖 (it's the manual page, and it's serving)

🦋 DESCRIPTION 🦋

okay so real talk, this is literally the usage of bumpversion, here's the whole thing:

bumpversion [-h] [--config-file FILE] [--verbose] [--list]
       [--allow-dirty] [--parse REGEX] [--serialize FORMAT] [--search
       SEARCH] [--replace REPLACE] [--current-version VERSION]
       [--no-configured-files] [--dry-run] --new-version VERSION
       [--commit | --no-commit] [--tag | --no-tag] [--sign-tags |
       --no-sign-tags] [--tag-name TAG_NAME] [--tag-message TAG_MESSAGE]
       [--message COMMIT_MSG] [--commit-args COMMIT_ARGS] part [file
       ...]

and the version check moment:

bumpversion: v1.0.1 (using Python v3.9.7)

🎀 POSITIONAL ARGUMENTS 🎀

  • part — which lil slice of the version is getting bumped. that's the whole assignment. 👑
  • file — the files you wanna change (default: []) 📂

💅 OPTIONAL ARGUMENTS 💅

  • -h, --help — shows this help message and dips. classic. (default behavior: shows help and exits) ✨
  • --config-file FILE — the config file it reads most of the variables from (default: .bumpversion.cfg) 📝
  • --verbose — prints verbose logging to stderr (default: 0) — turn it up, get the tea 🫖
  • --list — list machine readable information (default: False) 🤖
  • --allow-dirty — don't abort if the working directory is dirty (default: False) — chaotic energy, respect 🫶
  • --parse REGEX — the regex that parses the version string (default: (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\-(?P<release>[a-z ]+))?)) 🔍
  • --serialize FORMAT — how to format what's parsed back into a version (default: ['{major}.{minor}.{patch}-{release}', '{major}.{minor}.{patch}']) 🧚
  • --search SEARCH — template for the complete string to search (default: {current_version}) 🔎
  • --replace REPLACE — template for the complete string to replace (default: {new_version}) 🔁
  • --current-version VERSION — the version that needs to be updated (default: 1.0.1) 📌
  • --no-configured-files — only replace the version in files specified on the command line, ignoring the files from the configuration file (default: False) 🙈
  • --dry-run, -n — don't write any files, just pretend. (default: False) — manifesting only, no cap ✨
  • --new-version VERSION — the new version that should be in the files (default: None) 🌟
  • --commit — commit to version control (default: True) 💾
  • --no-commit — do not commit to version control 🚫
  • --tag — create a tag in version control (default: True) 🏷️
  • --no-tag — do not create a tag in version control 🚫
  • --sign-tags — sign tags if created (default: False) ✍️
  • --no-sign-tags — do not sign tags if created 🚫
  • --tag-name TAG_NAME — tag name (only works with --tag) (default: v{new_version}) 🏷️✨
  • --tag-message TAG_MESSAGE — tag message (default: Bump version: {current_version} ??? {new_version}) 💬
  • --message COMMIT_MSG, -m COMMIT_MSG — commit message (default: Bump version: {current_version} ??? {new_version}) 💬
  • --commit-args COMMIT_ARGS — extra arguments to commit command (default: ``) ➕
ngl bestie, if you're doing a --dry-run first, you're the main character. periodt. 💅

🌈 SEE ALSO 🌈

The full documentation for bumpversion is maintained as a Texinfo manual. If the info and bumpversion programs are properly installed at your site, the command

info bumpversion

should give you access to the complete manual. 👑

that's the whole vibe check, babe 💖 bumpversion 1.0.1, November 2021, BUMPVERSION(1) — ok bye love u, go bump responsibly 🎀🦋🌸

📦 where this page comes from