zt-devops-cli 0.1.7__tar.gz → 0.1.9__tar.gz

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zt-devops-cli
-Version: 0.1.7
+Version: 0.1.9
 Summary: DevOps 平台迭代管理 CLI
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -58,6 +58,14 @@ zt-devops-cli zteam-project list --project f39507
 zt-devops-cli sprint list --project k64352
 ```
 
+#### 迭代提测列表
+```bash
+zt-devops-cli sprint test-list --project b9f157 \
+  --search "BSC_V26.701.01" \
+  --num 1 \
+  --size 10
+```
+
 #### 创建迭代
 
 ```bash
@@ -93,6 +101,29 @@ zt-devops-cli task list --project f39507 \
   --creator zt07905
 ```
 
+### 缺陷管理
+
+#### 查询缺陷列表（BUG）
+```bash
+zt-devops-cli bug list --project b9f157 \
+  --num 1 \
+  --size 20 \
+  --no-remember
+```
+
+#### 新增缺陷（BUG）
+```bash
+zt-devops-cli bug create --project b9f157 \
+  --title "test" \
+  --owner zt07905 \
+  --zteam-project-id 15678224 \
+  --field f05cf2f5dc614dbaa05a13894abb5683=9Clfj3I8fR \
+  --field f672b38532614f428828d9a68a514e24=bgEHPFOjFt \
+  --field 684f26d36cd747f68dde32104a701956=3129a9cd7315457eb2963bfe19919e72 \
+  --field bcee87c140d3475496a2a31c236631f4=vENjmMhXMC \
+  --field 8756c5b483434c2bb54bd6bc6586b09b=
+```
+
 #### 新增任务（TASK）
 ```bash
 zt-devops-cli task create --project <project-id> \ # 通过 project list 获取

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/README.md

@@ -47,6 +47,14 @@ zt-devops-cli zteam-project list --project f39507
 zt-devops-cli sprint list --project k64352
 ```
 
+#### 迭代提测列表
+```bash
+zt-devops-cli sprint test-list --project b9f157 \
+  --search "BSC_V26.701.01" \
+  --num 1 \
+  --size 10
+```
+
 #### 创建迭代
 
 ```bash
@@ -82,6 +90,29 @@ zt-devops-cli task list --project f39507 \
   --creator zt07905
 ```
 
+### 缺陷管理
+
+#### 查询缺陷列表（BUG）
+```bash
+zt-devops-cli bug list --project b9f157 \
+  --num 1 \
+  --size 20 \
+  --no-remember
+```
+
+#### 新增缺陷（BUG）
+```bash
+zt-devops-cli bug create --project b9f157 \
+  --title "test" \
+  --owner zt07905 \
+  --zteam-project-id 15678224 \
+  --field f05cf2f5dc614dbaa05a13894abb5683=9Clfj3I8fR \
+  --field f672b38532614f428828d9a68a514e24=bgEHPFOjFt \
+  --field 684f26d36cd747f68dde32104a701956=3129a9cd7315457eb2963bfe19919e72 \
+  --field bcee87c140d3475496a2a31c236631f4=vENjmMhXMC \
+  --field 8756c5b483434c2bb54bd6bc6586b09b=
+```
+
 #### 新增任务（TASK）
 ```bash
 zt-devops-cli task create --project <project-id> \ # 通过 project list 获取

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "zt-devops-cli"
-version = "0.1.7"
+version = "0.1.9"
 description = "DevOps 平台迭代管理 CLI"
 readme = "README.md"
 requires-python = ">=3.10"

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/src/devops_cli/api.py

@@ -98,6 +98,32 @@ class DevOpsAPI:
         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_sprint_tests(
+            self,
+            num: int = 1,
+            size: int = 20,
+            search: str = "",
+            result: Optional[list] = None,
+            create_user: Optional[list] = None,
+            create_time: Optional[list] = None,
+            principal: Optional[list] = None,
+            obj_id: Optional[list] = None,
+    ) -> dict:
+        """查询迭代提测列表"""
+        data = {
+            "result": result or [],
+            "createUser": create_user or [],
+            "createTime": create_time or [],
+            "principal": principal or [],
+            "objId": obj_id or [],
+            "search": search,
+        }
+        return self._request(
+            "POST",
+            f"/ms/vteam/api/user/test/{self.project_id}/all?num={num}&size={size}",
+            data=data,
+        )
+
     def list_projects(self) -> dict:
         """查询项目列表"""
         return self._request("GET",
@@ -139,6 +165,33 @@ class DevOpsAPI:
         }
         return self._request("POST", f"/ms/vteam/api/user/issue/{self.project_id}", data=data)
 
+    def create_bug(
+            self,
+            title: str,
+            model_type_id: str,
+            priority: str = "CENTRAL",
+            editor_type: str = "RICHTEXT",
+            desc: str = "",
+            parent_id: str = "",
+            demand_classify: str = "-1",
+            instance_values: Optional[list] = None,
+    ) -> dict:
+        """创建 BUG 缺陷"""
+        data = {
+            "title": title,
+            "modelTypeId": model_type_id,
+            "priority": priority,
+            "editorType": editor_type,
+            "desc": desc,
+            "parentId": parent_id,
+            "relationIssue": {},
+            "demandClassify": demand_classify,
+            "fileVO": [],
+            "labelId": [],
+            "instanceValue": instance_values or [],
+        }
+        return self._request("POST", f"/ms/vteam/api/user/issue/{self.project_id}", data=data)
+
     def list_tasks(
             self,
             creator: Optional[str] = None,
@@ -163,3 +216,18 @@ class DevOpsAPI:
             f"/ms/vteam/api/user/issue/{self.project_id}/table/TASK?num={num}&size={size}&remember={remember_value}",
             data=data,
         )
+
+    def list_bugs(
+            self,
+            num: int = 1,
+            size: int = 20,
+            remember: bool = False,
+    ) -> dict:
+        """查询 BUG 列表（缺陷）"""
+        remember_value = str(remember).lower()
+        data = [{"name": "exclude", "value": []}]
+        return self._request(
+            "POST",
+            f"/ms/vteam/api/user/issue/{self.project_id}/table/BUG?num={num}&size={size}&remember={remember_value}",
+            data=data,
+        )

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/src/devops_cli/auth.py

@@ -89,12 +89,12 @@ def open_login_page(page) -> bool:
 
     return False
 
-def get_cookies_from_browser() -> dict:
+def get_cookies_from_browser(headless) -> dict:
     """通过 Playwright 从浏览器获取 cookie"""
     print("正在启动浏览器（无头模式），请登录...")
 
     with sync_playwright() as p:
-        browser = p.chromium.launch(headless=True)
+        browser = p.chromium.launch(headless=headless)
         context = browser.new_context()
         page = context.new_page()
 
@@ -156,10 +156,10 @@ def get_cookies_from_browser() -> dict:
 
     return cookie_dict
 
-def login() -> dict:
+def login(headless) -> dict:
     """手动登录 - 强制打开浏览器重新获取 cookie"""
     print("正在启动浏览器（无头模式），请重新登录...")
-    cookies = get_cookies_from_browser()
+    cookies = get_cookies_from_browser(headless)
     save_cookies(cookies)
     print("登录成功，cookie 已缓存!")
     return cookies

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/src/devops_cli/cli.py

@@ -7,6 +7,19 @@ from .auth import login
 from .config import config
 
 
+def _parse_custom_fields(entries):
+    result = []
+    for item in entries:
+        if "=" not in item:
+            raise click.ClickException(f"--field 参数格式错误: {item}，应为 fieldId=value")
+        field_id, value = item.split("=", 1)
+        field_id = field_id.strip()
+        if not field_id:
+            raise click.ClickException(f"--field 参数格式错误: {item}，fieldId 不能为空")
+        result.append({"fieldId": field_id, "value": value})
+    return result
+
+
 def _normalize_cell(value):
     if value is None:
         return "-"
@@ -102,10 +115,14 @@ def cli(ctx, project, output_format):
 
 
 @cli.command("login")
-def cmd_login():
-    """登录 - 打开浏览器重新获取 cookie"""
-    login()
-
+@click.option(
+    "--headed",
+    is_flag=True,
+    help="显示浏览器窗口，用于无环境变量时的手动登录",
+)
+def cmd_login(headed):
+    """登录 - 打开浏览器重新获取 cookie（默认无头；需手动登录时请传 --headed）"""
+    login(headless=not headed)
 
 @cli.group()
 def sprint():
@@ -124,6 +141,11 @@ def issue():
     """需求管理命令组"""
     pass
 
+@cli.group()
+def bug():
+    """缺陷管理命令组"""
+    pass
+
 
 @cli.group()
 def task():
@@ -292,6 +314,72 @@ def list_sprint(ctx, project):
         click.echo(f"错误: {e}", err=True)
 
 
+@sprint.command("test-list")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--num", default=1, show_default=True, type=int, help="页码")
+@click.option("--size", default=20, show_default=True, type=int, help="每页条数")
+@click.option("--search", default="", show_default=True, help="搜索关键词（如迭代名称）")
+@click.option("--result", "results", multiple=True, help="提测结果，可重复传入")
+@click.option("--create-user", "create_users", multiple=True, help="创建人账号，可重复传入")
+@click.option("--create-time", "create_times", multiple=True, help="创建时间筛选值，可重复传入")
+@click.option("--principal", "principals", multiple=True, help="负责人账号，可重复传入")
+@click.option("--obj-id", "obj_ids", multiple=True, help="对象 ID，可重复传入")
+@click.pass_context
+def list_sprint_tests(ctx, project, num, size, search, results, create_users, create_times, principals, obj_ids):
+    """查询迭代提测列表"""
+    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:
+        payload = api.list_sprint_tests(
+            num=num,
+            size=size,
+            search=search,
+            result=list(results),
+            create_user=list(create_users),
+            create_time=list(create_times),
+            principal=list(principals),
+            obj_id=list(obj_ids),
+        )
+        data = payload.get("data", {}) if isinstance(payload, dict) else {}
+        test_list = data.get("content", []) if isinstance(data, dict) else []
+        if not isinstance(test_list, list):
+            test_list = []
+
+        if ctx.obj.get("output_format") == "json":
+            click.echo(
+                json.dumps(
+                    test_list,
+                    ensure_ascii=False,
+                    indent=2,
+                    default=str,
+                )
+            )
+            return
+
+        render_table(
+            headers=["提测ID", "迭代名称", "提测标题", "提测结果", "负责人", "创建人", "创建时间"],
+            rows=[
+                [
+                    s.get("id"),
+                    s.get("objName") or s.get("sprintName"),
+                    s.get("title") or s.get("name"),
+                    s.get("result"),
+                    s.get("principal"),
+                    s.get("createUser"),
+                    s.get("createTime"),
+                ]
+                for s in test_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):
@@ -478,6 +566,177 @@ def list_task(ctx, project, start_date, end_date, creator, num, size, remember):
         click.echo(f"错误: {e}", err=True)
 
 
+@bug.command("list")
+@click.option("--project", "-p", required=True, help="项目 ID")
+@click.option("--num", default=1, show_default=True, type=int, help="页码")
+@click.option("--size", default=20, show_default=True, type=int, help="每页条数")
+@click.option("--remember/--no-remember", default=False, show_default=True, help="是否启用后端记忆筛选条件")
+@click.pass_context
+def list_bugs(ctx, project, num, size, remember):
+    """查询缺陷列表（BUG）"""
+    def _extract_bug_list(payload):
+        if not isinstance(payload, dict):
+            return []
+        data = payload.get("data")
+        if isinstance(data, list):
+            return data
+        if not isinstance(data, dict):
+            return []
+
+        content = None
+        if isinstance(data.get("content"), list):
+            content = data.get("content")
+        else:
+            records = data.get("records")
+            if isinstance(records, dict) and isinstance(records.get("content"), list):
+                content = records.get("content")
+
+        if not isinstance(content, list):
+            return []
+
+        def _unwrap_value(v):
+            if not isinstance(v, dict):
+                return v
+            for key in ("value", "label", "name", "displayName", "text", "title"):
+                if key in v and v.get(key) not in (None, ""):
+                    return v.get(key)
+            return None
+
+        result = []
+        for item in content:
+            if not isinstance(item, dict):
+                continue
+            prop = item.get("property")
+            if isinstance(prop, dict):
+                flattened = {}
+                for k, v in prop.items():
+                    flattened[k] = _unwrap_value(v)
+                result.append(flattened)
+                continue
+
+            normalized = {}
+            for k, v in item.items():
+                normalized[k] = _unwrap_value(v)
+            result.append(normalized)
+        return result
+
+    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.list_bugs(
+            num=num,
+            size=size,
+            remember=remember,
+        )
+        bug_list = _extract_bug_list(result)
+
+        if ctx.obj.get("output_format") == "json":
+            click.echo(
+                json.dumps(
+                    bug_list,
+                    ensure_ascii=False,
+                    indent=2,
+                    default=str,
+                )
+            )
+            return
+
+        render_table(
+            headers=["缺陷ID", "标题", "状态", "创建人", "负责人", "优先级", "严重程度"],
+            rows=[
+                [
+                    b.get("id") or b.get("issue_id"),
+                    b.get("title") or b.get("name"),
+                    b.get("state") or b.get("status"),
+                    b.get("createUser") or b.get("creator"),
+                    b.get("currentOwner") or b.get("handler"),
+                    b.get("priority"),
+                    b.get("severity"),
+                ]
+                for b in bug_list
+            ],
+            no_truncate_headers=["缺陷ID", "标题"],
+        )
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
+@bug.command("create")
+@click.option("--project", "-p", required=True, help="项目 ID")
+@click.option("--title", "-t", required=True, help="缺陷标题")
+@click.option("--model-type-id", default="808fb2fd3da74f1da4c772712e10c665", show_default=True, help="缺陷模型 ID")
+@click.option("--priority", default="CENTRAL", show_default=True, help="优先级")
+@click.option("--editor-type", default="RICHTEXT", show_default=True, help="编辑器类型")
+@click.option(
+    "--desc",
+    default="<h2><span style=\"font-size: 16px;\">【前置条件】</span></h2>\n"
+            "<h2><span style=\"font-size: 16px;\">【操作步骤】</span></h2>\n"
+            "<h2><span style=\"font-size: 16px;\">【实际结果】</span></h2>\n"
+            "<h2><span style=\"font-size: 16px;\">【预期结果】</span></h2>",
+    show_default=True,
+    help="缺陷描述（支持 HTML）",
+)
+@click.option("--parent-id", default="", show_default=True, help="父缺陷 ID")
+@click.option("--demand-classify", default="-1", show_default=True, help="需求分类")
+@click.option("--owner", required=True, help="提单人账号，例如 zt07905")
+@click.option("--handler", default="", show_default=True, help="处理人账号，默认与 --owner 一致")
+@click.option("--zteam-project-id", required=True, help="ZTeam 项目 ID")
+@click.option("--field", "custom_fields", multiple=True, help="自定义字段，格式: fieldId=value，可重复")
+@click.pass_context
+def create_bug(
+        ctx,
+        project,
+        title,
+        model_type_id,
+        priority,
+        editor_type,
+        desc,
+        parent_id,
+        demand_classify,
+        owner,
+        handler,
+        zteam_project_id,
+        custom_fields,
+):
+    """创建缺陷（BUG）"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
+        raise click.Abort()
+
+    # 基础字段沿用页面创建缺陷抓包；其余字段可通过 --field 传入
+    instance_values = [
+        {"fieldId": "456e808faf85419b912535da923b7f22", "value": owner},
+        {"fieldId": "5abdcb4c783e11edbef4fa819a160800", "value": zteam_project_id},
+        {"fieldId": "3cd53ac875944b599f5e70e035327d42", "value": handler or owner},
+    ]
+    instance_values.extend(_parse_custom_fields(custom_fields))
+
+    api = DevOpsAPI(project_id)
+    try:
+        result = api.create_bug(
+            title=title,
+            model_type_id=model_type_id,
+            priority=priority,
+            editor_type=editor_type,
+            desc=desc,
+            parent_id=parent_id,
+            demand_classify=demand_classify,
+            instance_values=instance_values,
+        )
+        if ctx.obj.get("output_format") == "json":
+            click.echo(json.dumps(result, ensure_ascii=False, indent=2, default=str))
+            return
+        bug_id = result.get("data", {}).get("id") if isinstance(result, dict) else None
+        click.echo(f"创建成功! 缺陷 ID: {bug_id or '-'}")
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
 @task.command("create")
 @click.option("--project", "-p", required=True, help="项目 ID")
 @click.option("--title", "-t", required=True, help="任务标题")
@@ -519,18 +778,6 @@ def create_task(
         click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project")
         raise click.Abort()
 
-    def _parse_custom_fields(entries):
-        result = []
-        for item in entries:
-            if "=" not in item:
-                raise click.ClickException(f"--field 参数格式错误: {item}，应为 fieldId=value")
-            field_id, value = item.split("=", 1)
-            field_id = field_id.strip()
-            if not field_id:
-                raise click.ClickException(f"--field 参数格式错误: {item}，fieldId 不能为空")
-            result.append({"fieldId": field_id, "value": value})
-        return result
-
     # 与浏览器抓包参数保持一致，便于直接复现页面创建行为
     instance_values = [
         {"fieldId": "456e808faf85419b912535da923b7f22", "value": owner},

{zt_devops_cli-0.1.7 → zt_devops_cli-0.1.9}/src/zt_devops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zt-devops-cli
-Version: 0.1.7
+Version: 0.1.9
 Summary: DevOps 平台迭代管理 CLI
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -58,6 +58,14 @@ zt-devops-cli zteam-project list --project f39507
 zt-devops-cli sprint list --project k64352
 ```
 
+#### 迭代提测列表
+```bash
+zt-devops-cli sprint test-list --project b9f157 \
+  --search "BSC_V26.701.01" \
+  --num 1 \
+  --size 10
+```
+
 #### 创建迭代
 
 ```bash
@@ -93,6 +101,29 @@ zt-devops-cli task list --project f39507 \
   --creator zt07905
 ```
 
+### 缺陷管理
+
+#### 查询缺陷列表（BUG）
+```bash
+zt-devops-cli bug list --project b9f157 \
+  --num 1 \
+  --size 20 \
+  --no-remember
+```
+
+#### 新增缺陷（BUG）
+```bash
+zt-devops-cli bug create --project b9f157 \
+  --title "test" \
+  --owner zt07905 \
+  --zteam-project-id 15678224 \
+  --field f05cf2f5dc614dbaa05a13894abb5683=9Clfj3I8fR \
+  --field f672b38532614f428828d9a68a514e24=bgEHPFOjFt \
+  --field 684f26d36cd747f68dde32104a701956=3129a9cd7315457eb2963bfe19919e72 \
+  --field bcee87c140d3475496a2a31c236631f4=vENjmMhXMC \
+  --field 8756c5b483434c2bb54bd6bc6586b09b=
+```
+
 #### 新增任务（TASK）
 ```bash
 zt-devops-cli task create --project <project-id> \ # 通过 project list 获取