qtcloud-devops-cli 0.1.0__py3-none-any.whl

app/cli.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""qtcloud-devops-cli — DevOps 发布管理命令行工具。
+
+基于 devops-release 技能，提供预检查、发布前确认、执行发布、验证、回滚的全流程自动化。
+
+用法:
+    qtcloud-devops release --version v0.1.0                   # 标签 + GitHub Release
+    qtcloud-devops release --version v0.1.0 --tag-only        # 仅创建 Git 标签
+    qtcloud-devops release --version v0.1.0 --release-only    # 仅创建 GitHub Release
+    qtcloud-devops release --version v0.1.0 --dry-run         # 仅检查
+    qtcloud-devops release --version v0.1.0 -y                # 跳过确认
+"""
+
+import typer
+
+app = typer.Typer()
+
+
+@app.callback()
+def main_callback() -> None: ...
+
+
+@app.command()
+def release(
+    version: str = typer.Option(..., "--version", "-V", help="版本号（如 v0.1.0）"),
+    changelog: str = typer.Option(
+        "CHANGELOG.md", "--changelog", help="CHANGELOG.md 路径"
+    ),
+    dry_run: bool = typer.Option(False, "--dry-run", help="仅检查，不执行"),
+    tag_only: bool = typer.Option(
+        False, "--tag-only", help="仅创建 Git 标签（默认行为，显式声明意图）"
+    ),
+    release_only: bool = typer.Option(
+        False, "--release-only", help="仅创建 GitHub Release，跳过 Git 标签"
+    ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="跳过确认提示，直接发布"),
+):
+    """发布 Release。
+
+    默认行为：创建 Git 标签并推送 + GitHub Release（仓库从 git remote 自动检测）。
+    --tag-only：仅打标签，跳过 GitHub Release。
+    --release-only：仅为已有标签创建 GitHub Release（跳过标签创建）。
+    """
+    from pathlib import Path
+
+    from app.release import run
+
+    code = run(version, Path(changelog), dry_run, tag_only, release_only, yes)
+    raise typer.Exit(code=code)
+
+
+def main():
+    return app()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    exit(main())

app/config.py

@@ -0,0 +1,8 @@
+from pydantic_settings import BaseSettings
+
+
+class Settings(BaseSettings):
+    model_config = {"env_prefix": "QTCLOUD_DEVOPS_"}
+
+
+settings = Settings()

app/release.py

@@ -0,0 +1,253 @@
+import re
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+
+def get_remote_repo() -> Optional[str]:
+    """从 git remote 解析 owner/name。"""
+    result = subprocess.run(
+        ["git", "remote", "get-url", "origin"],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        return None
+    url = result.stdout.strip()
+    m = re.search(r"github\.com[/:]([^/]+/[^/]+?)(?:\.git)?$", url)
+    if m:
+        return m.group(1)
+    return None
+
+
+def precheck(version: str, changelog: Path, release_only: bool = False) -> list[str]:
+    errors = []
+
+    if not re.match(
+        r"^(v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?|[a-zA-Z0-9_.-]+/v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?)$",
+        version,
+    ):
+        errors.append(f"版本号格式错误: {version}")
+
+    if changelog.exists():
+        content = changelog.read_text(encoding="utf-8")
+        ver = version.split("/v", 1)[1] if "/v" in version else version.lstrip("v")
+        if f"## [{ver}]" not in content:
+            errors.append(f"CHANGELOG.md 未找到 {ver} 版本记录")
+    else:
+        errors.append(f"CHANGELOG.md 不存在: {changelog}")
+
+    if release_only:
+        result = subprocess.run(
+            ["git", "tag", "-l"],
+            capture_output=True,
+            text=True,
+        )
+        existing_tags = result.stdout.strip().split("\n")
+        if version not in existing_tags:
+            errors.append(f"标签不存在: {version}（--release-only 需要标签已存在）")
+
+    result = subprocess.run(
+        ["git", "status", "--porcelain"],
+        capture_output=True,
+        text=True,
+    )
+    if result.stdout.strip():
+        errors.append("工作区有未提交的变更")
+
+    result = subprocess.run(
+        ["git", "rev-parse", "--abbrev-ref", "HEAD"],
+        capture_output=True,
+        text=True,
+    )
+    branch = result.stdout.strip()
+    if not branch.startswith(("main", "master", "release/")):
+        errors.append(
+            f"不在可发布分支上 (当前: {branch})，请切换到 main/master/release/*"
+        )
+
+    return errors
+
+
+def extract_notes(version: str, changelog: Path) -> Optional[str]:
+    ver = version.split("/v", 1)[1] if "/v" in version else version.lstrip("v")
+    content = changelog.read_text(encoding="utf-8")
+    lines = content.split("\n")
+    capture = False
+    notes: list[str] = []
+    for line in lines:
+        if line.startswith(f"## [{ver}]"):
+            capture = True
+            continue
+        if capture:
+            if line.startswith("## ["):
+                break
+            notes.append(line)
+    text = "\n".join(notes).strip()
+    return text if text else None
+
+
+def confirm_release(version: str, notes: Optional[str], yes: bool = False) -> bool:
+    """🧠 AI 介入点：展示检查摘要并等待用户确认"""
+    print(f"\n发布版本: {version}")
+    print()
+    print("检查结果:")
+    print("  ✓ 预检查全部通过")
+    print()
+    print("Release Notes 预览:")
+    print(notes or "(空)")
+    print()
+
+    if yes:
+        return True
+
+    try:
+        response = input("确认发布? (y/N): ").strip().lower()
+        return response in ("y", "yes")
+    except (EOFError, KeyboardInterrupt):
+        return False
+
+
+def create_tag(version: str) -> bool:
+    result = subprocess.run(
+        ["git", "tag", version],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"创建标签失败: {result.stderr.strip()}")
+        return False
+    return True
+
+
+def push_tag(version: str) -> bool:
+    result = subprocess.run(
+        ["git", "push", "origin", version],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"推送标签失败: {result.stderr.strip()}")
+        return False
+    return True
+
+
+def create_release(version: str, notes: str, repo: str) -> bool:
+    result = subprocess.run(
+        [
+            "gh",
+            "release",
+            "create",
+            version,
+            "--title",
+            version,
+            "--notes",
+            notes,
+            "--repo",
+            repo,
+        ],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"创建 Release 失败: {result.stderr.strip()}")
+        return False
+    return True
+
+
+def verify_release(version: str, repo: str) -> bool:
+    """🤖 规则：发布后验证"""
+    result = subprocess.run(
+        ["gh", "release", "view", version, "--repo", repo],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"⚠ 验证 Release 失败: {result.stderr.strip()}")
+        return False
+    print(result.stdout.strip())
+    return True
+
+
+def rollback_tag(version: str) -> None:
+    """🧠 AI 介入点：标签已推送但后续失败时回滚"""
+    subprocess.run(["git", "tag", "-d", version], capture_output=True)
+    subprocess.run(
+        ["git", "push", "origin", "--delete", version],
+        capture_output=True,
+        text=True,
+    )
+    print(f"↻ 标签 {version} 已回滚")
+
+
+def run(
+    version: str,
+    changelog: Optional[Path] = None,
+    dry_run: bool = False,
+    tag_only: bool = False,
+    release_only: bool = False,
+    yes: bool = False,
+):
+    changelog = changelog or Path.cwd() / "CHANGELOG.md"
+
+    if tag_only and release_only:
+        print("错误: --tag-only 和 --release-only 不能同时使用")
+        return 1
+
+    # --- 预检查 ---
+    errors = precheck(version, changelog, release_only=release_only)
+    if errors:
+        print("预检查失败:")
+        for err in errors:
+            print(f"  ✗ {err}")
+        return 1
+
+    notes = extract_notes(version, changelog)
+    print(f"\n=== Release Notes 预览 ===")
+    print(notes or "(空)")
+    print("=========================\n")
+
+    if dry_run:
+        print("✓ 预检查通过 (dry-run 模式，不执行)")
+        return 0
+
+    # --- 发布前确认 ---
+    if not confirm_release(version, notes, yes=yes):
+        print("已取消发布")
+        return 0
+
+    # --- 执行发布 ---
+    tag_created = False
+
+    if not release_only:
+        result = subprocess.run(
+            ["git", "tag", "-l"],
+            capture_output=True, text=True,
+        )
+        tag_exists = version in result.stdout.strip().split("\n")
+        if tag_exists:
+            print(f"→ 标签 {version} 已存在，跳过 tag 创建")
+        else:
+            if not create_tag(version):
+                return 1
+            if not push_tag(version):
+                rollback_tag(version)
+                return 1
+            tag_created = True
+            print(f"✓ 标签 {version} 已创建并推送")
+
+    if not tag_only:
+        repo = get_remote_repo()
+        if not repo:
+            print("错误: 无法从 git remote 解析 GitHub 仓库")
+            if tag_created:
+                rollback_tag(version)
+            return 1
+        if not create_release(version, notes or "", repo):
+            if tag_created:
+                rollback_tag(version)
+            return 1
+        print(f"✓ GitHub Release {version} 已创建")
+        print(f"  https://github.com/{repo}/releases/tag/{version}")
+
+    return 0

qtcloud_devops_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: qtcloud-devops-cli
+Version: 0.1.0
+Summary: DevOps CLI — 发布管理
+Requires-Python: >=3.12
+Requires-Dist: typer
+Requires-Dist: pydantic-settings

qtcloud_devops_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+app/cli.py,sha256=AuVlQxk-PhynHVABzMrOhPV3mvi4WYicDo31CZ4UYK8,1956
+app/config.py,sha256=cIxqxLjbvr3lfQ1hnGUAb3e6yA4EfgLJCPfOry9Wbpk,152
+app/release.py,sha256=03lBPKdhEIhwEzwtm-Fdvl5HnABPQ8ePlKExAB0gUxQ,7272
+qtcloud_devops_cli-0.1.0.dist-info/METADATA,sha256=0lb_Da6p8qKJ_Wd0RG3E7dg6WNXvWgT0GaoSfJBu9ts,177
+qtcloud_devops_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+qtcloud_devops_cli-0.1.0.dist-info/entry_points.txt,sha256=PGuY7dCz6wVxBm4fHmYM9QCBojaXfiWbr3xgc4VXQS8,48
+qtcloud_devops_cli-0.1.0.dist-info/top_level.txt,sha256=io9g7LCbfmTG1SFKgEOGXmCFB9uMP2H5lerm0HiHWQE,4
+qtcloud_devops_cli-0.1.0.dist-info/RECORD,,

qtcloud_devops_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

qtcloud_devops_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qtcloud-devops = app.cli:main

qtcloud_devops_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+app