Поднять версию проекта
Проверяет semver и обновляет версию в pyproject.toml, package.json или файле VERSION с резервной копией.
Что делает скрипт
Скрипт поддерживает major, minor и patch, а также точное значение через --set. Формат версии проверяется по semver. По умолчанию показывается только план. С --apply файл обновляется, рядом сохраняется копия .bak с временной меткой.
- С --apply файл версии будет изменён, рядом появится резервная копия.
Быстрый старт
python version_bump.py --file pyproject.toml --part minor
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python version_bump.py --file pyproject.toml --part minorpython version_bump.py --file package.json --part patch --applypython version_bump.py --file VERSION --set 2.0.0 --apply
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
version_bump.py
#!/usr/bin/env python3
"""Обновление версии проекта с проверкой semver."""
from __future__ import annotations
import argparse
import json
import re
from datetime import datetime
from pathlib import Path
SEMVER = re.compile(
r"^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)"
r"(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$"
)
def parse_version(value: str) -> tuple[int, int, int]:
match = SEMVER.fullmatch(value.strip())
if not match:
raise ValueError(f"Версия не соответствует semver: {value}")
return int(match.group(1)), int(match.group(2)), int(match.group(3))
def bump(value: str, part: str) -> str:
major, minor, patch = parse_version(value)
if part == "major":
return f"{major + 1}.0.0"
if part == "minor":
return f"{major}.{minor + 1}.0"
return f"{major}.{minor}.{patch + 1}"
def detect_file(path: Path | None) -> Path:
if path:
return path
for name in ("pyproject.toml", "package.json", "VERSION", "version.txt"):
candidate = Path(name)
if candidate.is_file():
return candidate
raise FileNotFoundError("Не найден pyproject.toml, package.json, VERSION или version.txt")
def read_version(path: Path) -> str:
if path.name == "package.json":
data = json.loads(path.read_text(encoding="utf-8"))
return str(data.get("version", "")).strip()
text = path.read_text(encoding="utf-8")
if path.suffix == ".toml":
section = ""
for line in text.splitlines():
stripped = line.strip()
if stripped.startswith("[") and stripped.endswith("]"):
section = stripped
continue
if section in ("[project]", "[tool.poetry]") and re.match(r"^version\s*=", line):
match = re.search(r"[\"']([^\"']+)[\"']", line)
if match:
return match.group(1).strip()
return text.strip()
def write_version(path: Path, old: str, new: str) -> None:
if path.name == "package.json":
data = json.loads(path.read_text(encoding="utf-8"))
data["version"] = new
path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
return
text = path.read_text(encoding="utf-8")
if path.suffix == ".toml":
lines = text.splitlines(keepends=True)
section = ""
for index, line in enumerate(lines):
stripped = line.strip()
if stripped.startswith("[") and stripped.endswith("]"):
section = stripped
continue
if section not in ("[project]", "[tool.poetry]"):
continue
match = re.search(r"version\s*=\s*[\"']([^\"']+)[\"']", line)
if match and match.group(1) == old:
start, end = match.start(1), match.end(1)
lines[index] = line[:start] + new + line[end:]
path.write_text("".join(lines), encoding="utf-8")
return
raise ValueError("Не удалось найти версию в pyproject.toml")
path.write_text(new + "\n", encoding="utf-8")
def main() -> int:
parser = argparse.ArgumentParser(description="Обновить версию проекта")
parser.add_argument("--file", type=Path, help="Файл версии")
group = parser.add_mutually_exclusive_group(required=True)
group.add_argument("--part", choices=["major", "minor", "patch"], help="Часть semver")
group.add_argument("--set", dest="exact", help="Точная новая версия")
parser.add_argument("--apply", action="store_true", help="Записать изменение")
args = parser.parse_args()
try:
path = detect_file(args.file)
except FileNotFoundError as error:
print(error)
return 2
if not path.is_file():
print(f"Файл не найден: {path}")
return 2
try:
old = read_version(path)
new = args.exact.strip() if args.exact else bump(old, args.part)
parse_version(new)
except (OSError, ValueError, json.JSONDecodeError) as error:
print(f"Ошибка версии: {error}")
return 2
if old == new:
print("Версия не изменилась.")
return 0
print(f"Файл: {path}")
print(f"Было: {old}")
print(f"Станет: {new}")
if not args.apply:
print("Это предпросмотр. Для записи добавьте --apply.")
return 0
backup = path.with_name(path.name + ".bak." + datetime.now().strftime("%Y%m%d-%H%M%S"))
backup.write_text(path.read_text(encoding="utf-8"), encoding="utf-8")
try:
write_version(path, old, new)
except (OSError, ValueError, json.JSONDecodeError) as error:
print(f"Не удалось обновить версию: {error}")
return 1
print(f"Версия обновлена. Резервная копия: {backup}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.