zt-devops-cli 0.1.0__tar.gz

zt_devops_cli-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: zt-devops-cli
+Version: 0.1.0
+Summary: DevOps 平台迭代管理 CLI
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pyyaml>=6.0
+
+# DevOps CLI
+
+蓝鲸 DevOps 平台迭代管理命令行工具。
+
+## 打包
+```bash
+python -m pip install --upgrade build twine
+python -m build
+twine upload dist/*
+```
+
+## 安装
+```bash
+pip install -e .
+```
+
+## 使用
+
+### 登陆
+
+首次运行时会自动打开浏览器，请登录蓝鲸 DevOps。登录成功后 cookie 会缓存到本地。
+```bash
+devops login
+```
+
+### 项目列表
+```bash
+devops project list
+```
+
+### 迭代列表
+```bash
+devops sprint list --project k64352
+```
+
+### 创建迭代
+
+```bash
+devops sprint create --project k64352 \
+  --title "迭代名称" \
+  --start-date 2026-04-04 \
+  --end-date 2026-05-30 \
+  --purpose "迭代目标"
+```
+
+### 启用迭代
+```bash
+devops sprint start --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint delete --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint done --project k64352 --sprint-id <id>
+```
+
+## 配置
+- cookie 缓存：`~/.devops-cli/cookies.json`
+- 配置文件：`~/.devops-cli/config.yaml`

zt_devops_cli-0.1.0/README.md

@@ -0,0 +1,63 @@
+# DevOps CLI
+
+蓝鲸 DevOps 平台迭代管理命令行工具。
+
+## 打包
+```bash
+python -m pip install --upgrade build twine
+python -m build
+twine upload dist/*
+```
+
+## 安装
+```bash
+pip install -e .
+```
+
+## 使用
+
+### 登陆
+
+首次运行时会自动打开浏览器，请登录蓝鲸 DevOps。登录成功后 cookie 会缓存到本地。
+```bash
+devops login
+```
+
+### 项目列表
+```bash
+devops project list
+```
+
+### 迭代列表
+```bash
+devops sprint list --project k64352
+```
+
+### 创建迭代
+
+```bash
+devops sprint create --project k64352 \
+  --title "迭代名称" \
+  --start-date 2026-04-04 \
+  --end-date 2026-05-30 \
+  --purpose "迭代目标"
+```
+
+### 启用迭代
+```bash
+devops sprint start --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint delete --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint done --project k64352 --sprint-id <id>
+```
+
+## 配置
+- cookie 缓存：`~/.devops-cli/cookies.json`
+- 配置文件：`~/.devops-cli/config.yaml`

zt_devops_cli-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zt-devops-cli"
+version = "0.1.0"
+description = "DevOps 平台迭代管理 CLI"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "playwright>=1.40.0",
+    "requests>=2.31.0",
+    "click>=8.1.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+devops-cli = "devops_cli.cli:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

zt_devops_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zt_devops_cli-0.1.0/src/devops_cli/api.py

@@ -0,0 +1,103 @@
+"""API 请求封装"""
+import json as json_mod
+import requests
+from typing import Optional
+
+from .auth import get_auth_cookies, get_auth_headers
+from .config import config
+
+
+class DevOpsAPI:
+    """DevOps API 客户端"""
+    
+    def __init__(self, project_id: str):
+        self.project_id = project_id
+        self.base_url = config.BASE_URL
+    
+    def _request(self, method: str, path: str, **kwargs) -> dict:
+        """发送 API 请求"""
+        cookies = get_auth_cookies()
+        headers = get_auth_headers(cookies, self.project_id)
+        
+        url = f"{self.base_url}/{path}"
+
+        # 处理 data 参数
+        if "data" in kwargs:
+            kwargs["json"] = kwargs.pop("data")
+
+        #############################################
+        # # 打印 curl 命令
+        # curl_parts = [f"curl -X {method}"]
+        # for k, v in headers.items():
+        #     curl_parts.append(f"-H '{k}: {v}'")
+        # if "json" in kwargs:
+        #     curl_parts.append(f"-d '{json_mod.dumps(kwargs['json'], ensure_ascii=False)}'")
+        # curl_parts.append(f"'{url}'")
+        # print(" ".join(curl_parts))
+        #############################################
+
+        response = requests.request(
+            method=method,
+            url=url,
+            headers=headers,
+            cookies=cookies,
+            **kwargs
+        )
+        
+        if response.status_code >= 400:
+            raise Exception(f"API 错误: {response.status_code} {response.text}")
+        
+        return response.json()
+    
+    # ========== 迭代操作 ==========
+    
+    def create_sprint(
+        self,
+        title: str,
+        start_date: str,
+        end_date: str,
+        purpose: str = "",
+        test_start_date: Optional[str] = None,
+        test_end_date: Optional[str] = None,
+        development_pic: str = "",
+        test_pic: str = "",
+        acceptance_pic: str = "",
+    ) -> dict:
+        """创建迭代"""
+        data = {
+            "title": title,
+            "startDate": start_date,
+            "endDate": end_date,
+            "purpose": purpose,
+            "daterange": [f"{start_date}T16:00:00.000Z", f"{end_date}T16:00:00.000Z"],
+            "reviewTime": "",
+            "testStartDate": test_start_date or start_date,
+            "testEndDate": test_end_date or end_date,
+            "developmentPic": development_pic,
+            "testPic": test_pic,
+            "acceptancePic": acceptance_pic,
+            "excludeTime": "",
+            "state": "ACTIVE",
+        }
+        return self._request("POST", f"/ms/vteam/api/user/issue_sprint/{self.project_id}", data=data)
+    
+    def start_sprint(self, sprint_data: dict) -> dict:
+        """启用迭代"""
+        return self._request("PUT", f"/ms/vteam/api/user/issue_sprint/{self.project_id}/start", data=sprint_data)
+    
+    def delete_sprint(self, sprint_id: str) -> dict:
+        """删除迭代"""
+        return self._request("DELETE", f"/ms/vteam/api/user/issue_sprint/{self.project_id}/{sprint_id}")
+
+    def done_sprint(self, sprint_id: str) -> dict:
+        """完成迭代"""
+        return self._request("PUT", f"/ms/vteam/api/user/issue_sprint/{self.project_id}/complete/{sprint_id}")
+
+    def list_sprints(self) -> dict:
+        """查询迭代列表"""
+        return self._request("GET", f"/ms/vteam/api/user/issue_sprint/{self.project_id}/flat?num=1&count=1&size=20&content=&start_time=&end_time=&state=ACTIVE%2CNOT_STARTED&sort_field=CREATED_TIME&sort_rule=DESC")
+
+    def list_projects(self) -> dict:
+        """查询项目列表"""
+        return self._request("GET", f"/ms/projectmanager/api/user/project/cw/selectByType?showTree=false&haveUser=false")
+

zt_devops_cli-0.1.0/src/devops_cli/auth.py

@@ -0,0 +1,161 @@
+"""认证模块 - 通过 Playwright 获取浏览器 cookie"""
+import json
+import os
+
+from playwright.sync_api import sync_playwright
+
+from .config import config
+
+
+# DevOps 域名
+DEVOPS_DOMAIN = ".ztn.cn"
+
+# SSO 登录页面
+LOGIN_URL = "https://sso.ztn.cn/v2/cas/login?service=https%3A%2F%2Fpaas.ztn.cn%2Flogin%2F%3Fc_url%3Dhttps%3A%2F%2Fdevops.ztn.cn%2Fconsole%2F&locale=zh_CN"
+
+def save_cookies(cookies: dict):
+    """保存 cookie 到缓存文件"""
+    config.CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    with open(config.COOKIE_FILE, "w") as f:
+        json.dump(cookies, f)
+
+def load_cookies() -> dict:
+    """从缓存文件加载 cookie"""
+    if config.COOKIE_FILE.exists():
+        with open(config.COOKIE_FILE) as f:
+            return json.load(f)
+    return {}
+
+def get_auth_headers(cookies: dict, project_id: str) -> dict:
+    """从 cookie 构建认证请求头"""
+    return {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "zh-CN",
+        "Content-Type": "application/json;charset=UTF-8",
+        "Origin": "https://devops.ztn.cn",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
+        "X-DEVOPS-TENANT-ID": cookies.get("X-DEVOPS-TENANT-ID", "ZTN"),
+        "bk_token": cookies.get("bk_token", ""),
+        "X-DEVOPS-TOKEN": cookies.get("X-DEVOPS-TOKEN", ""),
+        "X-DEVOPS-PROJECT-ID": project_id,
+    }
+
+def get_auth_cookies() -> dict:
+    """获取认证 cookie，优先使用缓存，失效则重新获取"""
+    cookies = load_cookies()
+
+    # 检查必要的 cookie 是否存在
+    required = ["bk_token", "X-DEVOPS-TOKEN"]
+    if all(cookies.get(k) for k in required):
+        return cookies
+
+    # 缓存失效，重新获取
+    cookies = get_cookies_from_browser()
+    save_cookies(cookies)
+
+    print(f"已获取新的 cookie: {cookies}")
+    return cookies
+
+def open_login_page(page) -> bool:
+    """自动登录 - 尝试读取环境变量自动填写账号密码"""
+    username = os.environ.get("DEVOPS_USERNAME")
+    password = os.environ.get("DEVOPS_PASSWORD")
+
+    if not username or not password:
+        return False
+
+    print(f"检测到环境变量，自动登录中...")
+
+    # 等待页面加载
+    page.wait_for_selector("#username")
+
+    try:
+        # 填写用户名
+        page.fill("#username", username)
+        print(f"已填写用户名")
+
+        # 填写密码 - 使用 #password2
+        page.fill("#password2", password)
+        print(f"已填写密码")
+
+        # 点击登录按钮
+        page.click(".login_in")
+        print("已点击登录按钮")
+
+        return True
+
+    except Exception as e:
+        print(f"自动登录失败: {e}")
+
+    return False
+
+def get_cookies_from_browser() -> dict:
+    """通过 Playwright 从浏览器获取 cookie"""
+    print("正在打开浏览器，请登录...")
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=False)
+        context = browser.new_context()
+        page = context.new_page()
+
+        # 导航到 SSO 登录页
+        page.goto(LOGIN_URL)
+
+        # 尝试自动登录
+        if not open_login_page(page):
+            print("自动登陆失败. 请在浏览器中完成登录，登录成功后会自动继续...")
+
+        print("登陆中.检测关键 cookie 出现")
+        page.wait_for_function(
+            f"""() => {{
+                const cookies = document.cookie;
+                return cookies.includes('X-DEVOPS-TOKEN');
+            }}""",
+            timeout=300000  # 5分钟超时
+        )
+
+        print("登陆成功. 已获取关键 cookie")
+
+        # 获取所有 cookie
+        cookies = context.cookies()
+
+        # 提取需要的 cookie
+        cookie_dict = {}
+        for cookie in cookies:
+            if cookie["domain"] == DEVOPS_DOMAIN or DEVOPS_DOMAIN in cookie["domain"]:
+                cookie_dict[cookie["name"]] = cookie["value"]
+
+        # 从 cookie 获取 X-DEVOPS-PROJECT-ID
+        project_id = page.evaluate("""() => {
+            const name = 'X-DEVOPS-PROJECT-ID=';
+            const decodedCookie = decodeURIComponent(document.cookie);
+            const ca = decodedCookie.split(';');
+            for (let i = 0; i < ca.length; i++) {
+                let c = ca[i];
+                while (c.charAt(0) == ' ') {
+                    c = c.substring(1);
+                }
+                if (c.indexOf(name) == 0) {
+                    return c.substring(name.length, c.length);
+                }
+            }
+            return '';
+        }""")
+
+        if project_id:
+            cookie_dict["X-DEVOPS-PROJECT-ID"] = project_id
+
+        browser.close()
+
+    return cookie_dict
+
+def login() -> dict:
+    """手动登录 - 强制打开浏览器重新获取 cookie"""
+    print("正在打开浏览器，请重新登录...")
+    cookies = get_cookies_from_browser()
+    save_cookies(cookies)
+    print("登录成功，cookie 已缓存!")
+    return cookies
+
+if __name__ == "__main__":
+    print(login())

zt_devops_cli-0.1.0/src/devops_cli/cli.py

@@ -0,0 +1,317 @@
+"""CLI 入口"""
+import click
+import json
+import shutil
+from .api import DevOpsAPI
+from .auth import login
+from .config import config
+
+
+def _normalize_cell(value):
+    if value is None:
+        return "-"
+    return str(value)
+
+
+def _truncate_text(text, width):
+    if width <= 0:
+        return ""
+    if len(text) <= width:
+        return text
+    if width <= 1:
+        return text[:width]
+    return text[: width - 1] + "…"
+
+
+def render_table(headers, rows, max_width=120, no_truncate_headers=None):
+    if not rows:
+        click.echo("暂无数据")
+        return
+
+    terminal_width = shutil.get_terminal_size((max_width, 20)).columns
+    table_max_width = min(max_width, terminal_width)
+
+    no_truncate_headers = set(no_truncate_headers or [])
+
+    normalized_rows = []
+    for row in rows:
+        normalized = [_normalize_cell(cell) for cell in row[: len(headers)]]
+        if len(normalized) < len(headers):
+            normalized.extend(["-"] * (len(headers) - len(normalized)))
+        normalized_rows.append(normalized)
+
+    widths = [len(h) for h in headers]
+    for row in normalized_rows:
+        for idx, cell in enumerate(row):
+            widths[idx] = max(widths[idx], len(cell))
+
+    # 边框和分隔占用: 左右边框 + 每列两侧空格 + 列分隔符
+    overhead = 3 * len(headers) + 1
+    available = max(20, table_max_width - overhead)
+    min_col_width = 10
+    widths = [max(min_col_width, w) for w in widths]
+
+    total = sum(widths)
+    if total > available:
+        fixed_idx = {i for i, h in enumerate(headers) if h in no_truncate_headers}
+        shrinkable_idx = [i for i in range(len(headers)) if i not in fixed_idx]
+
+        if shrinkable_idx:
+            while sum(widths) > available:
+                idx = max(shrinkable_idx, key=lambda i: widths[i])
+                if widths[idx] > min_col_width:
+                    widths[idx] -= 1
+                else:
+                    if all(widths[i] <= min_col_width for i in shrinkable_idx):
+                        break
+        # 若仍超出可用宽度，保留不截断列完整内容，允许终端自动换行/横向滚动查看
+
+    def format_row(cells):
+        parts = []
+        for i, cell in enumerate(cells):
+            text = cell if headers[i] in no_truncate_headers else _truncate_text(cell, widths[i])
+            parts.append(f" {text.ljust(widths[i])} ")
+        return "|" + "|".join(parts) + "|"
+
+    border = "+" + "+".join("-" * (w + 2) for w in widths) + "+"
+    click.echo(border)
+    click.echo(format_row(headers))
+    click.echo(border)
+    for row in normalized_rows:
+        click.echo(format_row(row))
+    click.echo(border)
+
+
+@click.group()
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option(
+    "--output",
+    "-o",
+    "output_format",
+    type=click.Choice(["human", "json"], case_sensitive=False),
+    default="json",
+    show_default=True,
+    help="输出格式: human(表格) / json",
+)
+@click.pass_context
+def cli(ctx, project, output_format):
+    """DevOps 平台迭代管理工具"""
+    ctx.ensure_object(dict)
+    ctx.obj["project"] = project or config.default_project
+    ctx.obj["output_format"] = output_format.lower()
+
+
+@cli.command("login")
+def cmd_login():
+    """登录 - 打开浏览器重新获取 cookie"""
+    login()
+
+
+@cli.group()
+def sprint():
+    """迭代管理命令组"""
+    pass
+
+@cli.group()
+def project():
+    """项目管理命令组"""
+    pass
+
+@sprint.command("create")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--title", "-t", required=True, help="迭代名称")
+@click.option("--start-date", "-s", required=True, help="开始日期 (YYYY-MM-DD)")
+@click.option("--end-date", "-e", required=True, help="结束日期 (YYYY-MM-DD)")
+@click.option("--purpose", help="迭代目标")
+@click.option("--test-start", help="测试开始日期")
+@click.option("--test-end", help="测试结束日期")
+@click.pass_context
+def create_sprint(ctx, project, title, start_date, end_date, purpose, test_start, test_end):
+    """创建迭代"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+    api = DevOpsAPI(project_id)
+    
+    try:
+        result = api.create_sprint(
+            title=title,
+            start_date=start_date,
+            end_date=end_date,
+            purpose=purpose or "",
+            test_start_date=test_start,
+            test_end_date=test_end,
+        )
+        click.echo(f"创建成功! 迭代 ID: {result.get('id')}")
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+@sprint.command("start")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--sprint-id", "-i", required=True, help="迭代 ID")
+@click.pass_context
+def start_sprint(ctx, project, sprint_id):
+    """启用迭代"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+    api = DevOpsAPI(project_id)
+    
+    try:
+        sprints = api.list_sprints()
+        sprint_data = None
+        for s in sprints.get("data").get("content"):
+            if s.get("id") == sprint_id:
+                sprint_data = s
+                break
+        
+        if not sprint_data:
+            click.echo(f"未找到迭代: {sprint_id}", err=True)
+            return
+        
+        result = api.start_sprint(sprint_data)
+        click.echo(f"启用成功!")
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+@sprint.command("delete")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--sprint-id", "-i", required=True, help="迭代 ID")
+@click.pass_context
+def delete_sprint(ctx, project, sprint_id):
+    """删除迭代"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+    api = DevOpsAPI(project_id)
+    
+    if not click.confirm(f"确认删除迭代 {sprint_id}?"):
+        return
+    
+    try:
+        api.delete_sprint(sprint_id)
+        click.echo(f"删除成功!")
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+@sprint.command("done")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--sprint-id", "-i", required=True, help="迭代 ID")
+@click.pass_context
+def done_sprint(ctx, project, sprint_id):
+    """ 完成迭代"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+    api = DevOpsAPI(project_id)
+
+    if not click.confirm(f"确认完成迭代 {sprint_id}?"):
+        return
+
+    try:
+        api.done_sprint(sprint_id)
+        click.echo(f"完成成功!")
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+
+@sprint.command("list")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.pass_context
+def list_sprint(ctx, project):
+
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+    api = DevOpsAPI(project_id)
+
+
+    try:
+        sprints = api.list_sprints()
+        sprint_list = sprints.get("data", {}).get("content", [])
+        if ctx.obj.get("output_format") == "json":
+            click.echo(
+                json.dumps(
+                    sprint_list,
+                    ensure_ascii=False,
+                    indent=2,
+                    default=str,
+                )
+            )
+            return
+        render_table(
+            headers=["迭代名称", "迭代ID", "开始时间", "结束时间", "迭代状态", "提测时间", "测试开始时间", "测试完成时间","验收完成", "负责人"],
+            rows=[
+                [
+                    s.get("title"),
+                    s.get("id"),
+                    s.get("startDate"),
+                    s.get("endDate"),
+                    s.get("state"),
+                    s.get("testStartDate"),
+                    s.get("smokeEndDate"),
+                    s.get("testEndDate"),
+                    s.get("acceptanceEndDate"),
+                    s.get("developmentPic"),
+                    s.get("testPic"),
+                    s.get("acceptancePic")
+                ]
+                for s in sprint_list
+            ],
+            no_truncate_headers=["迭代ID","迭代名称"],
+        )
+
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+
+@project.command("list")
+@click.pass_context
+def list_project(ctx):
+
+    api = DevOpsAPI("")
+
+    try:
+        projects = api.list_projects()
+        project_list = projects.get("data", [])
+        if ctx.obj.get("output_format") == "json":
+            click.echo(
+                json.dumps(
+                    project_list,
+                    ensure_ascii=False,
+                    indent=2,
+                    default=str,
+                )
+            )
+            return
+        render_table(
+            headers=["项目代码", "项目名称", "部门名称"],
+            rows=[
+                [
+                    s.get("projectCode"),
+                    s.get("projectName"),
+                    s.get("deptName"),
+                ]
+                for s in project_list
+            ],
+        )
+
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+def main():
+    cli()
+
+
+if __name__ == "__main__":
+    main()

zt_devops_cli-0.1.0/src/devops_cli/config.py

@@ -0,0 +1,38 @@
+"""配置管理模块"""
+import os
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+
+class Config:
+    """配置类"""
+    
+    CONFIG_DIR = Path.home() / ".devops-cli"
+    COOKIE_FILE = CONFIG_DIR / "cookies.json"
+    CONFIG_FILE = CONFIG_DIR / "config.yaml"
+    
+    # API 配置
+    BASE_URL = "https://devops.ztn.cn"
+    
+    def __init__(self):
+        self._config = self._load_config()
+    
+    def _load_config(self) -> dict:
+        """加载配置文件"""
+        if self.CONFIG_FILE.exists():
+            with open(self.CONFIG_FILE) as f:
+                return yaml.safe_load(f) or {}
+        return {}
+    
+    @property
+    def default_project(self) -> Optional[str]:
+        return self._config.get("default_project")
+    
+    @property
+    def browser_channel(self) -> str:
+        return self._config.get("browser_channel", "chromium")
+
+
+config = Config()

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: zt-devops-cli
+Version: 0.1.0
+Summary: DevOps 平台迭代管理 CLI
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pyyaml>=6.0
+
+# DevOps CLI
+
+蓝鲸 DevOps 平台迭代管理命令行工具。
+
+## 打包
+```bash
+python -m pip install --upgrade build twine
+python -m build
+twine upload dist/*
+```
+
+## 安装
+```bash
+pip install -e .
+```
+
+## 使用
+
+### 登陆
+
+首次运行时会自动打开浏览器，请登录蓝鲸 DevOps。登录成功后 cookie 会缓存到本地。
+```bash
+devops login
+```
+
+### 项目列表
+```bash
+devops project list
+```
+
+### 迭代列表
+```bash
+devops sprint list --project k64352
+```
+
+### 创建迭代
+
+```bash
+devops sprint create --project k64352 \
+  --title "迭代名称" \
+  --start-date 2026-04-04 \
+  --end-date 2026-05-30 \
+  --purpose "迭代目标"
+```
+
+### 启用迭代
+```bash
+devops sprint start --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint delete --project k64352 --sprint-id <id>
+```
+
+### 删除迭代
+```bash
+devops sprint done --project k64352 --sprint-id <id>
+```
+
+## 配置
+- cookie 缓存：`~/.devops-cli/cookies.json`
+- 配置文件：`~/.devops-cli/config.yaml`

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/devops_cli/__init__.py
+src/devops_cli/api.py
+src/devops_cli/auth.py
+src/devops_cli/cli.py
+src/devops_cli/config.py
+src/zt_devops_cli.egg-info/PKG-INFO
+src/zt_devops_cli.egg-info/SOURCES.txt
+src/zt_devops_cli.egg-info/dependency_links.txt
+src/zt_devops_cli.egg-info/entry_points.txt
+src/zt_devops_cli.egg-info/requires.txt
+src/zt_devops_cli.egg-info/top_level.txt

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/entry_points.txt

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

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/requires.txt

@@ -0,0 +1,4 @@
+playwright>=1.40.0
+requests>=2.31.0
+click>=8.1.0
+pyyaml>=6.0

zt_devops_cli-0.1.0/src/zt_devops_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+devops_cli