SemVer Toolkit
Parse, validate, compare, bump, and sort semantic version strings per the SemVer 2.0.0 spec.
Quick Start
CODEBLOCK0
Commands
| Command | Description |
|---|
| INLINECODE0 | Break version into major, minor, patch, prerelease, build |
| INLINECODE1 |
Check if versions are valid semver |
|
bump VERSION PART | Bump major/minor/patch/prerelease (optional
--pre TAG) |
|
compare A B | Show which version is greater/less/equal |
|
sort VERSION... | Sort versions in semver order (
-r for descending) |
Notes
- - Accepts optional
v prefix (e.g. v1.2.3) - Prerelease precedence follows SemVer spec (numeric < alpha, no prerelease > prerelease)
- Python 3 stdlib only — no external dependencies
- Use
-f json on any command for machine-readable output
SemVer 工具包
根据 SemVer 2.0.0 规范解析、验证、比较、提升和排序语义化版本字符串。
快速开始
bash
将版本解析为组件
python3 scripts/semver_toolkit.py parse 1.2.3-beta.1+build.42
验证版本
python3 scripts/semver_toolkit.py validate 1.0.0 v2.1 not-a-version
提升版本
python3 scripts/semver_toolkit.py bump 1.2.3 minor
python3 scripts/semver_toolkit.py bump 1.2.3 major --pre rc
比较两个版本
python3 scripts/semver_toolkit.py compare 1.2.3 2.0.0
排序版本（升序）
python3 scripts/semver_toolkit.py sort 3.0.0 1.0.0-alpha 1.0.0 2.1.0
降序排序，JSON 输出
python3 scripts/semver_toolkit.py sort 3.0.0 1.0.0 2.1.0 -r -f json
命令
| 命令 | 描述 |
|---|
| parse VERSION | 将版本分解为主版本、次版本、补丁、预发布、构建元数据 |
| validate VERSION... |
检查版本是否为有效的语义化版本 |
| bump VERSION PART | 提升主版本/次版本/补丁/预发布（可选 --pre TAG） |
| compare A B | 显示哪个版本更大/更小/相等 |
| sort VERSION... | 按语义化版本顺序排序（-r 表示降序） |
说明
- - 接受可选的 v 前缀（例如 v1.2.3）
- 预发布优先级遵循 SemVer 规范（数字 < 字母，无预发布 > 有预发布）
- 仅使用 Python 3 标准库 — 无外部依赖
- 在任何命令上使用 -f json 可获得机器可读的输出
