bump-version
This skill should be used when the user wants to bump the version number in the workspace. It updates versions across all pyproject.toml files (root, tde, and tda packages) and the CHANGELOG.md to keep them synchronized.
When & Why to Use This Skill
This Claude skill automates the version management process within a development workspace. It ensures consistency by simultaneously updating version strings across multiple configuration files—including pyproject.toml, setup.py, and package source files—while streamlining the release workflow through automated git commits and verification steps.
Use Cases
- New Release Preparation: Automatically increment major, minor, or patch versions to ensure all configuration files are synchronized before a deployment.
- Consistency Auditing: Quickly identify and fix version mismatches across different project files (e.g., pyproject.toml vs. __init__.py) to prevent build failures.
- Standardized Release Tagging: Generate consistent git commit messages for version bumps, maintaining a clean and professional repository history.
- Workflow Automation: Reduce manual editing time and human error when managing multi-package workspaces or complex Python environments.
| name | bump-version |
|---|---|
| description | Bump the version of the zenoh-ros2-sdk package across all configuration files. Use when the user asks to update, bump, or change the package version, or when preparing a new release. |
Bump Version
This skill guides you through upgrading the version number of the zenoh-ros2-sdk package.
When to Use
- User asks to "bump", "update", or "change" the version
- Preparing a new release (major, minor, or patch)
- Version numbers are out of sync across config files
1. Determine the New Version
Decide whether this is a Major, Minor, or Patch release.
- Current Version: Check
pyproject.tomlorzenoh_ros2_sdk/__init__.py. - Example:
0.1.2->0.1.3(Patch)
2. Update Files
You must update the version string in the following 3 files. Ensure they all match exactly.
A. pyproject.toml
Update the version field under [project]:
[project]
name = "zenoh-ros2-sdk"
version = "0.1.3" # <--- Update this
B. zenoh_ros2_sdk/__init__.py
Update the __version__ variable:
__version__ = "0.1.3" # <--- Update this
C. setup.py
Update the version argument in the setup() call:
setup(
name="zenoh-ros2-sdk",
version="0.1.3", # <--- Update this
# ...
)
3. Verify Changes
Run the following command to verify consistency:
python3 setup.py --version
The output must match your new version.
4. Commit Changes
Commit the changes with a standard message:
git add pyproject.toml setup.py zenoh_ros2_sdk/__init__.py
git commit -m "bump(version): update version to 0.1.3"