tapdctl 0.1.0__tar.gz

tapdctl-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+.env
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+*.egg-info/
+.ruff_cache/
+.playwright-mcp/
+.claude/

tapdctl-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: tapdctl
+Version: 0.1.0
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: typer>=0.16.0

tapdctl-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "tapdctl"
+version = "0.1.0"
+requires-python = ">=3.12"
+dependencies = [
+    "httpx>=0.28.0",
+    "typer>=0.16.0",
+]
+
+[project.scripts]
+tapdctl = "tapdctl.main:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["apolloconfigctl"]
+

tapdctl-0.1.0/tapdctl/main.py

@@ -0,0 +1,457 @@
+import json
+import os
+import sys
+from typing import Optional
+
+import httpx
+import typer
+
+app = typer.Typer(help="tapdctl — TAPD MCP Gateway CLI", add_completion=False)
+
+_DEFAULT_API_URL = os.getenv("TAPD_API_URL", "http://localhost:8000")
+
+
+def _api(api_url: str) -> str:
+    return api_url.rstrip("/") + "/api"
+
+
+def _get(api_url: str, path: str, params: dict) -> object:
+    params = {k: v for k, v in params.items() if v is not None}
+    resp = httpx.get(f"{_api(api_url)}/{path}", params=params, timeout=30)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def _post(api_url: str, path: str, body: dict) -> object:
+    body = {k: v for k, v in body.items() if v is not None}
+    resp = httpx.post(f"{_api(api_url)}/{path}", json=body, timeout=30)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def _put(api_url: str, path: str, body: dict) -> object:
+    body = {k: v for k, v in body.items() if v is not None}
+    resp = httpx.put(f"{_api(api_url)}/{path}", json=body, timeout=30)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def _out(data: object) -> None:
+    typer.echo(json.dumps(data, ensure_ascii=False, indent=2))
+
+
+# ── Stories ────────────────────────────────────────────────────────────────────
+
+@app.command("get-stories")
+def get_stories(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None, help="项目ID"),
+    iteration_id: Optional[str] = typer.Option(None, help="迭代ID"),
+    status: Optional[str] = typer.Option(None, help="需求状态"),
+    owner: Optional[str] = typer.Option(None, help="处理人"),
+    created_from: Optional[str] = typer.Option(None, help="创建时间起始 YYYY-MM-DD HH:MM:SS"),
+    created_to: Optional[str] = typer.Option(None, help="创建时间结束"),
+    modified_from: Optional[str] = typer.Option(None, help="修改时间起始"),
+    modified_to: Optional[str] = typer.Option(None, help="修改时间结束"),
+    limit: int = typer.Option(30, help="每页数量"),
+    page: int = typer.Option(1, help="页码"),
+    fields: Optional[str] = typer.Option(None, help="返回字段，逗号分隔"),
+    with_status_label: bool = typer.Option(False, help="返回中文状态名"),
+):
+    """获取需求列表。"""
+    _out(_get(api_url, "getStories", dict(
+        workspace_id=workspace_id, iteration_id=iteration_id, status=status,
+        owner=owner, created_from=created_from, created_to=created_to,
+        modified_from=modified_from, modified_to=modified_to,
+        limit=limit, page=page, fields=fields,
+        with_status_label=with_status_label or None,
+    )))
+
+
+@app.command("get-stories-count")
+def get_stories_count(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    created_from: Optional[str] = typer.Option(None),
+    created_to: Optional[str] = typer.Option(None),
+):
+    """获取需求总数。"""
+    _out(_get(api_url, "getStoriesCount", dict(
+        workspace_id=workspace_id, iteration_id=iteration_id,
+        status=status, owner=owner,
+        created_from=created_from, created_to=created_to,
+    )))
+
+
+@app.command("get-story-changes")
+def get_story_changes(
+    story_id: str = typer.Argument(help="需求ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+):
+    """获取需求变更历史。"""
+    _out(_get(api_url, "getStoryChanges", dict(
+        story_id=story_id, workspace_id=workspace_id, limit=limit, page=page,
+    )))
+
+
+@app.command("get-story-custom-fields")
+def get_story_custom_fields(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+):
+    """获取需求自定义字段配置（custom_field_* 含义对照）。"""
+    _out(_get(api_url, "getStoryCustomFields", dict(workspace_id=workspace_id)))
+
+
+# ── Bugs ───────────────────────────────────────────────────────────────────────
+
+@app.command("get-bugs")
+def get_bugs(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None, help="缺陷状态"),
+    severity: Optional[str] = typer.Option(None, help="严重程度"),
+    current_owner: Optional[str] = typer.Option(None, help="处理人"),
+    reporter: Optional[str] = typer.Option(None, help="创建人"),
+    de: Optional[str] = typer.Option(None, help="开发人员"),
+    te: Optional[str] = typer.Option(None, help="测试人员"),
+    created_from: Optional[str] = typer.Option(None),
+    created_to: Optional[str] = typer.Option(None),
+    modified_from: Optional[str] = typer.Option(None),
+    modified_to: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+    fields: Optional[str] = typer.Option(None),
+    with_status_label: bool = typer.Option(False),
+):
+    """获取缺陷列表。"""
+    _out(_get(api_url, "getBugs", dict(
+        workspace_id=workspace_id, iteration_id=iteration_id, status=status,
+        severity=severity, current_owner=current_owner, reporter=reporter,
+        de=de, te=te, created_from=created_from, created_to=created_to,
+        modified_from=modified_from, modified_to=modified_to,
+        limit=limit, page=page, fields=fields,
+        with_status_label=with_status_label or None,
+    )))
+
+
+@app.command("get-bugs-count")
+def get_bugs_count(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    severity: Optional[str] = typer.Option(None),
+    current_owner: Optional[str] = typer.Option(None),
+    created_from: Optional[str] = typer.Option(None),
+    created_to: Optional[str] = typer.Option(None),
+):
+    """获取缺陷总数。"""
+    _out(_get(api_url, "getBugsCount", dict(
+        workspace_id=workspace_id, iteration_id=iteration_id,
+        status=status, severity=severity, current_owner=current_owner,
+        created_from=created_from, created_to=created_to,
+    )))
+
+
+@app.command("get-bug-changes")
+def get_bug_changes(
+    bug_id: str = typer.Argument(help="缺陷ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+):
+    """获取缺陷变更历史。"""
+    _out(_get(api_url, "getBugChanges", dict(
+        bug_id=bug_id, workspace_id=workspace_id, limit=limit, page=page,
+    )))
+
+
+# ── Iterations ─────────────────────────────────────────────────────────────────
+
+@app.command("get-iterations")
+def get_iterations(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None, help="迭代状态，如 open、done"),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+):
+    """获取迭代列表。"""
+    _out(_get(api_url, "getIterations", dict(
+        workspace_id=workspace_id, status=status, limit=limit, page=page,
+    )))
+
+
+@app.command("get-iterations-count")
+def get_iterations_count(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+):
+    """获取迭代总数。"""
+    _out(_get(api_url, "getIterationsCount", dict(workspace_id=workspace_id, status=status)))
+
+
+# ── Tasks ──────────────────────────────────────────────────────────────────────
+
+@app.command("get-tasks")
+def get_tasks(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    story_id: Optional[str] = typer.Option(None, help="关联需求ID"),
+    owner: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+    fields: Optional[str] = typer.Option(None),
+):
+    """获取任务列表。"""
+    _out(_get(api_url, "getTasks", dict(
+        workspace_id=workspace_id, iteration_id=iteration_id, story_id=story_id,
+        owner=owner, status=status, limit=limit, page=page, fields=fields,
+    )))
+
+
+# ── Measure ────────────────────────────────────────────────────────────────────
+
+@app.command("get-life-times")
+def get_life_times(
+    entity_id: str = typer.Argument(help="业务对象ID"),
+    entity_type: str = typer.Argument(help="对象类型：story、bug 或 task"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(200),
+    page: int = typer.Option(1),
+):
+    """获取工作项状态流转时间（各阶段耗时数据）。"""
+    _out(_get(api_url, "getLifeTimes", dict(
+        entity_id=entity_id, entity_type=entity_type,
+        workspace_id=workspace_id, limit=limit, page=page,
+    )))
+
+
+@app.command("get-workflow-status-map")
+def get_workflow_status_map(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    entity_type: str = typer.Option("story", help="对象类型：story、bug 或 task"),
+    workspace_id: Optional[str] = typer.Option(None),
+):
+    """获取工作流状态的中英文名称映射。"""
+    _out(_get(api_url, "getWorkflowStatusMap", dict(entity_type=entity_type, workspace_id=workspace_id)))
+
+
+# ── Timesheets ─────────────────────────────────────────────────────────────────
+
+@app.command("get-timesheets")
+def get_timesheets(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    entity_type: Optional[str] = typer.Option(None, help="story、bug 或 task"),
+    entity_id: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    spent_date_from: Optional[str] = typer.Option(None, help="工时日期起始 YYYY-MM-DD"),
+    spent_date_to: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+):
+    """获取工时花费记录。"""
+    _out(_get(api_url, "getTimesheets", dict(
+        workspace_id=workspace_id, entity_type=entity_type, entity_id=entity_id,
+        owner=owner, spent_date_from=spent_date_from, spent_date_to=spent_date_to,
+        limit=limit, page=page,
+    )))
+
+
+# ── Comments ───────────────────────────────────────────────────────────────────
+
+@app.command("get-comments")
+def get_comments(
+    entity_type: str = typer.Argument(help="story、bug 或 task"),
+    entity_id: str = typer.Argument(help="对象ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    limit: int = typer.Option(30),
+    page: int = typer.Option(1),
+):
+    """获取工作项评论。"""
+    _out(_get(api_url, "getComments", dict(
+        entity_type=entity_type, entity_id=entity_id,
+        workspace_id=workspace_id, limit=limit, page=page,
+    )))
+
+
+# ── Workspace ──────────────────────────────────────────────────────────────────
+
+@app.command("get-workspace-info")
+def get_workspace_info(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+):
+    """获取项目基本信息。"""
+    _out(_get(api_url, "getWorkspaceInfo", dict(workspace_id=workspace_id)))
+
+
+@app.command("get-workspace-members")
+def get_workspace_members(
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+):
+    """获取项目成员列表。"""
+    _out(_get(api_url, "getWorkspaceMembers", dict(workspace_id=workspace_id)))
+
+
+# ── Write commands ─────────────────────────────────────────────────────────────
+
+@app.command("create-story")
+def create_story(
+    name: str = typer.Argument(help="需求标题"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    priority: Optional[str] = typer.Option(None),
+    description: Optional[str] = typer.Option(None),
+):
+    """创建需求。"""
+    _out(_post(api_url, "createStory", dict(
+        name=name, workspace_id=workspace_id, owner=owner, status=status,
+        iteration_id=iteration_id, priority=priority, description=description,
+    )))
+
+
+@app.command("update-story")
+def update_story(
+    story_id: str = typer.Argument(help="需求ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    name: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+):
+    """更新需求。"""
+    _out(_put(api_url, "updateStory", dict(
+        id=story_id, workspace_id=workspace_id,
+        name=name, owner=owner, status=status, iteration_id=iteration_id,
+    )))
+
+
+@app.command("create-bug")
+def create_bug(
+    title: str = typer.Argument(help="缺陷标题"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    priority: Optional[str] = typer.Option(None),
+    severity: Optional[str] = typer.Option(None),
+    current_owner: Optional[str] = typer.Option(None),
+    de: Optional[str] = typer.Option(None, help="开发人员"),
+    te: Optional[str] = typer.Option(None, help="测试人员"),
+    iteration_id: Optional[str] = typer.Option(None),
+    description: Optional[str] = typer.Option(None),
+):
+    """创建缺陷。"""
+    _out(_post(api_url, "createBug", dict(
+        title=title, workspace_id=workspace_id, priority=priority,
+        severity=severity, current_owner=current_owner,
+        de=de, te=te, iteration_id=iteration_id, description=description,
+    )))
+
+
+@app.command("update-bug")
+def update_bug(
+    bug_id: str = typer.Argument(help="缺陷ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    title: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    current_owner: Optional[str] = typer.Option(None),
+    priority: Optional[str] = typer.Option(None),
+    severity: Optional[str] = typer.Option(None),
+):
+    """更新缺陷。"""
+    _out(_put(api_url, "updateBug", dict(
+        id=bug_id, workspace_id=workspace_id, title=title, status=status,
+        current_owner=current_owner, priority=priority, severity=severity,
+    )))
+
+
+@app.command("create-task")
+def create_task(
+    name: str = typer.Argument(help="任务名称"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    story_id: Optional[str] = typer.Option(None),
+    iteration_id: Optional[str] = typer.Option(None),
+    description: Optional[str] = typer.Option(None),
+):
+    """创建任务。"""
+    _out(_post(api_url, "createTask", dict(
+        name=name, workspace_id=workspace_id, owner=owner,
+        story_id=story_id, iteration_id=iteration_id, description=description,
+    )))
+
+
+@app.command("update-task")
+def update_task(
+    task_id: str = typer.Argument(help="任务ID"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    name: Optional[str] = typer.Option(None),
+    status: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+):
+    """更新任务。"""
+    _out(_put(api_url, "updateTask", dict(
+        id=task_id, workspace_id=workspace_id,
+        name=name, status=status, owner=owner,
+    )))
+
+
+@app.command("add-timesheet")
+def add_timesheet(
+    entity_type: str = typer.Argument(help="story、bug 或 task"),
+    entity_id: str = typer.Argument(help="对象ID"),
+    spent_date: str = typer.Argument(help="工时日期 YYYY-MM-DD"),
+    timespent: float = typer.Argument(help="工时小时数"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+    owner: Optional[str] = typer.Option(None),
+    memo: Optional[str] = typer.Option(None),
+):
+    """记录工时花费。"""
+    _out(_post(api_url, "addTimesheet", dict(
+        entity_type=entity_type, entity_id=entity_id,
+        spent_date=spent_date, timespent=timespent,
+        workspace_id=workspace_id, owner=owner, memo=memo,
+    )))
+
+
+@app.command("add-comment")
+def add_comment(
+    entity_type: str = typer.Argument(help="story、bug 或 task"),
+    entity_id: str = typer.Argument(help="对象ID"),
+    description: str = typer.Argument(help="评论内容"),
+    api_url: str = typer.Option(_DEFAULT_API_URL, envvar="TAPD_API_URL"),
+    workspace_id: Optional[str] = typer.Option(None),
+):
+    """添加评论。"""
+    _out(_post(api_url, "addComment", dict(
+        entity_type=entity_type, entity_id=entity_id,
+        description=description, workspace_id=workspace_id,
+    )))
+
+
+if __name__ == "__main__":
+    app()