Разработка и Git

Поднять версию проекта

Проверяет semver и обновляет версию в pyproject.toml, package.json или файле VERSION с резервной копией.

Python Windows macOS Linux Средний
Скачать version_bump.py
Описание

Что делает скрипт

Скрипт поддерживает 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 minor
  • python version_bump.py --file package.json --part patch --apply
  • python version_bump.py --file VERSION --set 2.0.0 --apply
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get dev-version-bump
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Разработка и Git

Git, сборка, тесты, зависимости, логи и обслуживание проектов.