zt-devops-cli 0.2.3__tar.gz → 0.2.4__tar.gz

{zt_devops_cli-0.2.3 → zt_devops_cli-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zt-devops-cli
-Version: 0.2.3
+Version: 0.2.4
 Summary: DevOps 平台迭代管理 CLI
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown

{zt_devops_cli-0.2.3 → zt_devops_cli-0.2.4}/pyproject.toml

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

{zt_devops_cli-0.2.3 → zt_devops_cli-0.2.4}/src/zt_devops_cli/api.py

@@ -346,6 +346,13 @@ class DevOpsAPI:
             data=data,
         )
 
+    def get_bug(self, bug_id: str) -> dict:
+        """查询单个工作项详情（GET issue/{projectId}/{issueId}，缺陷详情页同源接口）。"""
+        return self._request(
+            "GET",
+            f"/ms/vteam/api/user/issue/{self.project_id}/{bug_id}",
+        )
+
     def bug_direction_next(
             self,
             issue_id: str,

{zt_devops_cli-0.2.3 → zt_devops_cli-0.2.4}/src/zt_devops_cli/cli.py

@@ -152,12 +152,12 @@ def _is_api_success(payload) -> bool:
 
 
 def _print_action_result(
-    ctx,
-    result,
-    success_text: str = "",
-    fail_prefix: str = "操作失败",
-    success_checker: Optional[Callable[[dict], bool]] = None,
-    success_text_builder: Optional[Callable[[dict], str]] = None,
+        ctx,
+        result,
+        success_text: str = "",
+        fail_prefix: str = "操作失败",
+        success_checker: Optional[Callable[[dict], bool]] = None,
+        success_text_builder: Optional[Callable[[dict], str]] = None,
 ) -> bool:
     """统一处理命令结果输出；返回是否成功。"""
     checker = success_checker or _is_api_success
@@ -249,8 +249,8 @@ def zteam_project():
 @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", required=True, help="迭代目标")
-@click.option("--test-start", required=True,  help="测试开始日期")
-@click.option("--test-end",required=True,  help="测试结束日期")
+@click.option("--test-start", required=True, help="测试开始日期")
+@click.option("--test-end", required=True, help="测试结束日期")
 @click.pass_context
 def create_sprint(ctx, project, title, start_date, end_date, purpose, test_start, test_end):
     """创建迭代"""
@@ -283,6 +283,7 @@ def create_sprint(ctx, project, title, start_date, end_date, purpose, test_start
     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")
@@ -881,6 +882,79 @@ def list_bugs(
         click.echo(f"错误: {e}", err=True)
 
 
+def _flatten_issue_detail_for_table(detail):
+    """将详情接口返回的 data 展平为 {字段: 显示值}，供 human 表格使用。"""
+    if not isinstance(detail, dict):
+        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 json.dumps(v, ensure_ascii=False)
+
+    rows = {}
+    prop = detail.get("property")
+    if isinstance(prop, dict):
+        for k, v in prop.items():
+            rows[k] = _unwrap_value(v)
+
+    for k, v in detail.items():
+        if k == "property":
+            continue
+        if k in rows:
+            continue
+        if isinstance(v, (dict, list)):
+            rows[k] = json.dumps(v, ensure_ascii=False) if v else ""
+        else:
+            rows[k] = v
+
+    return rows
+
+
+@bug.command("detail")
+@click.option("--project", "-p", default=None, help="项目 ID")
+@click.option("--bug-id", "-i", required=True, help="缺陷 ID（与列表「缺陷ID」、详情页 URL 中 id 一致）")
+@click.pass_context
+def get_bug_detail(ctx, project, bug_id):
+    """查询单个缺陷详情"""
+    project_id = project or ctx.obj["project"]
+    if not project_id:
+        click.echo("错误: 请通过 -p 指定项目 ID 或在配置中设置 default_project", err=True)
+        raise click.Abort()
+
+    api = DevOpsAPI(project_id)
+    try:
+        payload = api.get_bug(bug_id)
+        data = payload.get("data") if isinstance(payload, dict) else None
+
+        if ctx.obj.get("output_format") == "json":
+            out = data if data is not None else payload
+            click.echo(json.dumps(out, ensure_ascii=False, indent=2, default=str))
+            return
+
+        if data is None:
+            msg = _extract_api_message(payload) if isinstance(payload, dict) else ""
+            click.echo(msg or "未返回详情数据", err=True)
+            return
+
+        flat = _flatten_issue_detail_for_table(data)
+        if not flat:
+            click.echo(json.dumps(data, ensure_ascii=False, indent=2, default=str))
+            return
+
+        keys = sorted(flat.keys(), key=lambda x: (str(x).lower(), str(x)))
+        render_table(
+            headers=["字段", "值"],
+            rows=[[k, flat[k]] for k in keys],
+            no_truncate_headers=["字段", "值"],
+        )
+    except Exception as e:
+        click.echo(f"错误: {e}", err=True)
+
+
 @bug.command("get-states")
 @click.option("--project", "-p", required=True, help="项目 ID")
 @click.option(
@@ -1110,12 +1184,13 @@ def list_bug_types(ctx, project, all_options, field_id):
 @click.option("--zteam-project-id", required=True, help="ZTeam 项目 ID")
 @click.option("--sprint-id", required=True, default="", show_default=True, help="迭代 id")
 @click.option("--title", "-t", required=True, help="缺陷标题")
-@click.option("--priority",  default="CENTRAL", show_default=True, help="缺陷优先级")
+@click.option("--priority", default="CENTRAL", show_default=True, help="缺陷优先级")
 @click.option("--desc-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("--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("--severity", required=True, default="", show_default=True, help="缺陷严重程度")
 @click.option("--type", required=True, default="", show_default=True, help="缺陷分类")
 @click.option("--discovery-phase", required=True, default="", show_default=True, help="缺陷发现阶段")
@@ -1232,7 +1307,6 @@ def _bug_direction_go(ctx, project, bug_id, target_key, comment, operators):
 
 
 def _bug_direction_options(cmd):
-
     cmd = click.option(
         "-i",
         "--bug-id",
@@ -1428,6 +1502,7 @@ def create_task(
     except Exception as e:
         click.echo(f"错误: {e}", err=True)
 
+
 def main():
     cli()
 

{zt_devops_cli-0.2.3 → zt_devops_cli-0.2.4}/src/zt_devops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zt-devops-cli
-Version: 0.2.3
+Version: 0.2.4
 Summary: DevOps 平台迭代管理 CLI
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown