tuner-testkit 4.0.0__tar.gz

tuner_testkit-4.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tuner-testkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tuner_testkit-4.0.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: tuner-testkit
+Version: 4.0.0
+Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
+Author: tuner-testkit contributors
+License-Expression: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2
+Provides-Extra: db
+Requires-Dist: pymysql>=1.2.0; extra == "db"
+Requires-Dist: pymssql>=2.3.0; extra == "db"
+Requires-Dist: psycopg[binary]>=3.2; extra == "db"
+Requires-Dist: sqlalchemy>=2.0; extra == "db"
+Provides-Extra: api
+Requires-Dist: requests>=2.33.1; extra == "api"
+Provides-Extra: web-ui
+Requires-Dist: playwright>=1.54.0; extra == "web-ui"
+Provides-Extra: phone-ui
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1.0; extra == "excel"
+Provides-Extra: fake
+Requires-Dist: faker>=37.0.0; extra == "fake"
+Provides-Extra: mock
+Requires-Dist: fastapi>=0.115.0; extra == "mock"
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == "mock"
+Requires-Dist: httpx>=0.28.0; extra == "mock"
+Provides-Extra: recorder
+Requires-Dist: playwright>=1.54.0; extra == "recorder"
+Requires-Dist: mitmproxy>=11.1.3; extra == "recorder"
+Provides-Extra: test
+Requires-Dist: pytest>=9.0.3; extra == "test"
+Requires-Dist: openpyxl>=3.1.0; extra == "test"
+Requires-Dist: httpx>=0.28.0; extra == "test"
+Provides-Extra: bdd
+Requires-Dist: behave>=1.2.6; extra == "bdd"
+Requires-Dist: playwright>=1.54.0; extra == "bdd"
+Requires-Dist: behave-html-pretty-formatter>=1.16.1; extra == "bdd"
+Provides-Extra: dev
+Requires-Dist: pymysql>=1.2.0; extra == "dev"
+Requires-Dist: pymssql>=2.3.0; extra == "dev"
+Requires-Dist: psycopg[binary]>=3.2; extra == "dev"
+Requires-Dist: sqlalchemy>=2.0; extra == "dev"
+Requires-Dist: requests>=2.33.1; extra == "dev"
+Requires-Dist: pydantic>=2; extra == "dev"
+Requires-Dist: faker>=37.0.0; extra == "dev"
+Requires-Dist: openpyxl>=3.1.0; extra == "dev"
+Requires-Dist: fastapi>=0.115.0; extra == "dev"
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == "dev"
+Requires-Dist: httpx>=0.28.0; extra == "dev"
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Requires-Dist: behave>=1.2.6; extra == "dev"
+Requires-Dist: playwright>=1.54.0; extra == "dev"
+Requires-Dist: behave-html-pretty-formatter>=1.16.1; extra == "dev"
+Requires-Dist: mitmproxy>=11.1.3; extra == "dev"
+Dynamic: license-file
+
+# tuner-testkit
+
+发行名 **`tuner-testkit`**，导入名 **`tuner_testkit`**。给被测系统（SUT）测试仓提供公共运行库与 CLI（db / API / Web UI / 录制 / mock），以及 Cursor/git **DNA**（rules、skills、hooks）。
+
+业务资产（page/api objects、action words、features）留在**各项目仓**的 `packages/` 与 `tests/`，不进本包。平台发新版本后，下游用 `uv` 按需升级，不必再整树拷贝运行库。
+
+---
+
+## 标准作业流程
+
+### 1. 安装 `tuner-testkit`
+
+还没有任何项目仓时，先把 CLI 装到工具环境：
+
+```bash
+uv tool install "tuner-testkit[db,api]"
+```
+
+需要 headed 录制或 Playwright 时加上对应 extra（见下方 extras）。已有项目仓则在该仓根目录：
+
+```bash
+uv add "tuner-testkit[db,api]>=4.0.0"
+uv sync
+```
+
+入口命令是 `tuner-init`、`tuner-dna`、`tuner-recorder` 等（`tuner-*`），**没有** `tuner-testkit` 这个 script。
+
+### 2. 初始化测试仓
+
+```bash
+tuner-init scaffold ../my-sut-tests
+cd ../my-sut-tests
+uv sync
+```
+
+`scaffold` 会铺六层目录、写入依赖 `tuner-testkit` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。不要用 `tuner-testkit init repo`。
+
+Web UI / 合录按需再加 extra：
+
+```bash
+uv add "tuner-testkit[web-ui]"
+uv add "tuner-testkit[recorder]"
+```
+
+### 3. 开始写业务
+
+在**项目仓**里写，不要改 site-packages 里的 kit：
+
+| 你写什么 | 放哪里 |
+| --- | --- |
+| 页面 / 接口资产 | `packages/page_objects/`、`packages/api_objects/` |
+| 业务动作 | `packages/action_words/` |
+| BDD / pytest | `tests/features/`、`tests/pytest/` |
+| 知识（DDL、用例） | `assets/` |
+| 本仓私有工具 | `apps/`（`python -m apps.<name>`） |
+
+代码里 `from tuner_testkit.db import …` / `from tuner_testkit.page_test import …`。密钥只放本机 `config/env_local.py` 或环境变量（`TUNER_ENV`、`TUNER_DB_<ALIAS>_*`），**不要提交**。
+
+录制产物同样写到项目仓 `packages/`，不会写进 venv。
+
+### 4. 升级已发布的 kit
+
+平台把新版本推上 PyPI 之后，在项目仓改依赖并同步 DNA——**两步都要做**：
+
+```bash
+# 改版本：直接改 pyproject.toml，或
+uv add "tuner-testkit[db,api]==4.1.0"
+uv sync
+
+# Cursor 不会读 site-packages 里的 rule/skill，必须再铺进本仓并提交
+tuner-dna sync
+git add -A && git commit
+```
+
+只跑 `uv add` / `uv sync` 只会更新运行库与 CLI；AI 约束和 git hooks 仍停留在旧 DNA。检查是否与当前安装的 kit 一致：
+
+```bash
+tuner-dna check
+```
+
+一个 wheel 不能「只升 web-ui、钉死旧 db」。`[phone-ui]` 为预留空 extra，4.0 未实现。
+
+---
+
+## extras
+
+| extra | 内容 |
+| --- | --- |
+| （默认 wheel） | `config` / `logging`、`tuner-init`、`tuner-dna`、`tuner-dump-ddl` 等 |
+| `[db]` | MySQL / SQL Server / PostgreSQL |
+| `[api]` | `api_test`（HTTP 客户端） |
+| `[web-ui]` | `page_test` + Playwright |
+| `[phone-ui]` | 预留，无实现 |
+| `[recorder]` | 合录 / 仅 UI / mitmproxy 代理 |
+| `[mock]` | 按冻结的 api_objects 回放 |
+| `[excel]` / `[fake]` | 表格 / 假数据 |
+| `[bdd]` / `[test]` / `[dev]` | behave / pytest / 开发全集 |
+
+CLI 与 `python -m tuner_testkit.…` 等价，例如 `tuner-recorder`、`tuner-page-recorder`、`tuner-api-recorder`、`tuner-mock-server`。
+
+---
+
+## 安全
+
+不得把 token、cookie、Authorization、密码、session 写入仓库（含 capture 与 api_objects）。凭证只允许运行时注入。
+
+---
+
+## 本仓库（平台源码）
+
+克隆后在仓库根目录开发 kit 本身：
+
+```powershell
+uv venv
+uv sync --extra dev
+```
+
+下游迁移清单见 [`docs/changelog/TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

tuner_testkit-4.0.0/README.md

@@ -0,0 +1,118 @@
+# tuner-testkit
+
+发行名 **`tuner-testkit`**，导入名 **`tuner_testkit`**。给被测系统（SUT）测试仓提供公共运行库与 CLI（db / API / Web UI / 录制 / mock），以及 Cursor/git **DNA**（rules、skills、hooks）。
+
+业务资产（page/api objects、action words、features）留在**各项目仓**的 `packages/` 与 `tests/`，不进本包。平台发新版本后，下游用 `uv` 按需升级，不必再整树拷贝运行库。
+
+---
+
+## 标准作业流程
+
+### 1. 安装 `tuner-testkit`
+
+还没有任何项目仓时，先把 CLI 装到工具环境：
+
+```bash
+uv tool install "tuner-testkit[db,api]"
+```
+
+需要 headed 录制或 Playwright 时加上对应 extra（见下方 extras）。已有项目仓则在该仓根目录：
+
+```bash
+uv add "tuner-testkit[db,api]>=4.0.0"
+uv sync
+```
+
+入口命令是 `tuner-init`、`tuner-dna`、`tuner-recorder` 等（`tuner-*`），**没有** `tuner-testkit` 这个 script。
+
+### 2. 初始化测试仓
+
+```bash
+tuner-init scaffold ../my-sut-tests
+cd ../my-sut-tests
+uv sync
+```
+
+`scaffold` 会铺六层目录、写入依赖 `tuner-testkit` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。不要用 `tuner-testkit init repo`。
+
+Web UI / 合录按需再加 extra：
+
+```bash
+uv add "tuner-testkit[web-ui]"
+uv add "tuner-testkit[recorder]"
+```
+
+### 3. 开始写业务
+
+在**项目仓**里写，不要改 site-packages 里的 kit：
+
+| 你写什么 | 放哪里 |
+| --- | --- |
+| 页面 / 接口资产 | `packages/page_objects/`、`packages/api_objects/` |
+| 业务动作 | `packages/action_words/` |
+| BDD / pytest | `tests/features/`、`tests/pytest/` |
+| 知识（DDL、用例） | `assets/` |
+| 本仓私有工具 | `apps/`（`python -m apps.<name>`） |
+
+代码里 `from tuner_testkit.db import …` / `from tuner_testkit.page_test import …`。密钥只放本机 `config/env_local.py` 或环境变量（`TUNER_ENV`、`TUNER_DB_<ALIAS>_*`），**不要提交**。
+
+录制产物同样写到项目仓 `packages/`，不会写进 venv。
+
+### 4. 升级已发布的 kit
+
+平台把新版本推上 PyPI 之后，在项目仓改依赖并同步 DNA——**两步都要做**：
+
+```bash
+# 改版本：直接改 pyproject.toml，或
+uv add "tuner-testkit[db,api]==4.1.0"
+uv sync
+
+# Cursor 不会读 site-packages 里的 rule/skill，必须再铺进本仓并提交
+tuner-dna sync
+git add -A && git commit
+```
+
+只跑 `uv add` / `uv sync` 只会更新运行库与 CLI；AI 约束和 git hooks 仍停留在旧 DNA。检查是否与当前安装的 kit 一致：
+
+```bash
+tuner-dna check
+```
+
+一个 wheel 不能「只升 web-ui、钉死旧 db」。`[phone-ui]` 为预留空 extra，4.0 未实现。
+
+---
+
+## extras
+
+| extra | 内容 |
+| --- | --- |
+| （默认 wheel） | `config` / `logging`、`tuner-init`、`tuner-dna`、`tuner-dump-ddl` 等 |
+| `[db]` | MySQL / SQL Server / PostgreSQL |
+| `[api]` | `api_test`（HTTP 客户端） |
+| `[web-ui]` | `page_test` + Playwright |
+| `[phone-ui]` | 预留，无实现 |
+| `[recorder]` | 合录 / 仅 UI / mitmproxy 代理 |
+| `[mock]` | 按冻结的 api_objects 回放 |
+| `[excel]` / `[fake]` | 表格 / 假数据 |
+| `[bdd]` / `[test]` / `[dev]` | behave / pytest / 开发全集 |
+
+CLI 与 `python -m tuner_testkit.…` 等价，例如 `tuner-recorder`、`tuner-page-recorder`、`tuner-api-recorder`、`tuner-mock-server`。
+
+---
+
+## 安全
+
+不得把 token、cookie、Authorization、密码、session 写入仓库（含 capture 与 api_objects）。凭证只允许运行时注入。
+
+---
+
+## 本仓库（平台源码）
+
+克隆后在仓库根目录开发 kit 本身：
+
+```powershell
+uv venv
+uv sync --extra dev
+```
+
+下游迁移清单见 [`docs/changelog/TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

tuner_testkit-4.0.0/pyproject.toml

@@ -0,0 +1,109 @@
+[project]
+name = "tuner-testkit"
+version = "4.0.0"
+description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "tuner-testkit contributors"}]
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic>=2",
+]
+
+[project.optional-dependencies]
+db = [
+    "pymysql>=1.2.0",
+    "pymssql>=2.3.0",
+    "psycopg[binary]>=3.2",
+    "sqlalchemy>=2.0",
+]
+api = [
+    "requests>=2.33.1",
+]
+web-ui = [
+    "playwright>=1.54.0",
+]
+# Reserved extra name for a future mobile stack (not implemented in 4.0).
+phone-ui = []
+excel = [
+    "openpyxl>=3.1.0",
+]
+fake = [
+    "faker>=37.0.0",
+]
+mock = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "httpx>=0.28.0",
+]
+recorder = [
+    "playwright>=1.54.0",
+    "mitmproxy>=11.1.3",
+]
+test = [
+    "pytest>=9.0.3",
+    "openpyxl>=3.1.0",
+    "httpx>=0.28.0",
+]
+bdd = [
+    "behave>=1.2.6",
+    "playwright>=1.54.0",
+    "behave-html-pretty-formatter>=1.16.1",
+]
+dev = [
+    "pymysql>=1.2.0",
+    "pymssql>=2.3.0",
+    "psycopg[binary]>=3.2",
+    "sqlalchemy>=2.0",
+    "requests>=2.33.1",
+    "pydantic>=2",
+    "faker>=37.0.0",
+    "openpyxl>=3.1.0",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "httpx>=0.28.0",
+    "pytest>=9.0.3",
+    "behave>=1.2.6",
+    "playwright>=1.54.0",
+    "behave-html-pretty-formatter>=1.16.1",
+    "mitmproxy>=11.1.3",
+]
+
+[project.scripts]
+tuner-config = "tuner_testkit.config:main"
+tuner-recorder = "tuner_testkit.apps.recorder.cli:main"
+tuner-page-recorder = "tuner_testkit.apps.page_recorder.cli:main"
+tuner-api-recorder = "tuner_testkit.apps.api_recorder.cli:main"
+tuner-dump-ddl = "tuner_testkit.apps.dump_ddl:main"
+tuner-mock-server = "tuner_testkit.apps.mock_server.cli:main"
+tuner-dna = "tuner_testkit.apps.dna.cli:main"
+tuner-init = "tuner_testkit.apps.init_repo.__main__:main"
+tuner-index-ai = "tuner_testkit.apps.index_ai.__main__:main"
+tuner-index-platform = "tuner_testkit.apps.index_platform.__main__:main"
+tuner-fake = "tuner_testkit.fake.cli:main"
+tuner-page-test = "tuner_testkit.page_test.__main__:main"
+tuner-action-words = "tuner_testkit.action_words.__main__:main"
+
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+include = ["tuner_testkit*"]
+
+[tool.setuptools.package-data]
+"tuner_testkit.apps.dna" = ["dna_payload/**/*"]
+
+[tool.setuptools.cmdclass]
+build_py = "tuner_testkit.apps.dna.build.BuildPyWithDna"
+sdist = "tuner_testkit.apps.dna.build.SdistWithDna"
+
+[tool.tuner-testkit]
+page_objects = "packages/page_objects"
+api_objects = "packages/api_objects"
+mocks = "data/mocks"
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["packages/tests", "tuner_testkit"]

tuner_testkit-4.0.0/setup.cfg

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

tuner_testkit-4.0.0/tuner_testkit/__init__.py

@@ -0,0 +1,5 @@
+"""tuner-testkit — shared test runtime (db, api_test, page_test, recorders, DNA)."""
+
+from __future__ import annotations
+
+__version__ = "4.0.0"

tuner_testkit-4.0.0/tuner_testkit/action_words/__init__.py

@@ -0,0 +1,48 @@
+"""Action Words — 统一管理自动化测试资产的最小业务动作层。
+
+设计目标（见 docs/spec/action-words-syntax.md）：
+
+- 每个 action word 是一个独立可运行的业务动作（DB 造数 / DB 断言 /
+  接口请求 / 接口断言 / 页面操作 / 页面断言），入参经 pydantic 强类型
+  声明并带样例，可 CLI 一键执行，也可被 behave / pytest 步骤直接调用；
+- 接口类 word 只做冻结 ``packages/api_objects`` 资产的引用与编排，
+  不重复定义请求契约；
+- DB 类 word 统一走 ``tuner_testkit.db.DbClient``（经类元数据 ``datasource``
+  声明目标库），造数结果按表登记 ``cleanup``，供测试夹具精确清理。
+
+CLI::
+
+    uv run python -m tuner_testkit.action_words list
+    uv run python -m tuner_testkit.action_words describe <word_id>
+    uv run python -m tuner_testkit.action_words run <word_id> --params '{...}'
+    uv run python -m tuner_testkit.action_words catalog --out report/action_words_catalog.json
+"""
+from __future__ import annotations
+
+from tuner_testkit.action_words.base import (
+    ActionCategory,
+    ActionResult,
+    ActionWord,
+    TableRows,
+)
+from tuner_testkit.action_words.context import ActionContext
+from tuner_testkit.action_words.registry import (
+    discover,
+    export_catalog,
+    get,
+    list_all,
+    register,
+)
+
+__all__ = [
+    "ActionCategory",
+    "ActionContext",
+    "ActionResult",
+    "ActionWord",
+    "TableRows",
+    "discover",
+    "export_catalog",
+    "get",
+    "list_all",
+    "register",
+]

tuner_testkit-4.0.0/tuner_testkit/action_words/__main__.py

@@ -0,0 +1,111 @@
+"""Action Words CLI — 列出 / 查看 / 一键运行 / 导出目录。
+
+用法::
+
+    uv run python -m tuner_testkit.action_words list
+    uv run python -m tuner_testkit.action_words describe db_seed.create_example
+    uv run python -m tuner_testkit.action_words run db_seed.create_example --params "{...}"
+    uv run python -m tuner_testkit.action_words run db_seed.create_example --params-file p.json
+    uv run python -m tuner_testkit.action_words run db_seed.create_example --example
+    uv run python -m tuner_testkit.action_words catalog --out report/action_words_catalog.json
+
+``run`` 未提供 ``--params`` 时使用 ``{}``（即全部默认值）；``--example``
+使用 word 自带的 ``example_params`` 样例运行。
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from tuner_testkit.action_words import ActionContext, export_catalog, get, list_all
+
+
+def _print_json(data: object) -> None:
+    print(json.dumps(data, ensure_ascii=False, indent=2, default=str))
+
+
+def _cmd_list(_args: argparse.Namespace) -> int:
+    rows = [
+        {"word_id": cls.word_id, "name": cls.name, "category": str(cls.category)}
+        for cls in list_all()
+    ]
+    _print_json(rows)
+    return 0
+
+
+def _cmd_describe(args: argparse.Namespace) -> int:
+    _print_json(get(args.word_id).describe())
+    return 0
+
+
+def _cmd_run(args: argparse.Namespace) -> int:
+    cls = get(args.word_id)
+    if args.example:
+        raw = dict(cls.example_params)
+    elif args.params_file:
+        raw = json.loads(Path(args.params_file).read_text(encoding="utf-8"))
+    else:
+        raw = json.loads(args.params or "{}")
+
+    with ActionContext(username=args.username, password=args.password) as ctx:
+        try:
+            result = cls(ctx).run_from_dict(raw)
+        except AssertionError as exc:
+            _print_json({"ok": False, "error": str(exc)})
+            return 1
+    _print_json(result.model_dump(mode="json"))
+    return 0 if result.ok else 1
+
+
+def _cmd_catalog(args: argparse.Namespace) -> int:
+    catalog = export_catalog()
+    if args.out:
+        out = Path(args.out)
+        out.parent.mkdir(parents=True, exist_ok=True)
+        out.write_text(
+            json.dumps(catalog, ensure_ascii=False, indent=2, default=str),
+            encoding="utf-8",
+        )
+        print(f"catalog written: {out} ({len(catalog)} words)")
+    else:
+        _print_json(catalog)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8")
+
+    parser = argparse.ArgumentParser(prog="python -m tuner_testkit.action_words")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("list", help="列出全部已注册 action words")
+
+    p_desc = sub.add_parser("describe", help="查看某个 word 的元数据 / 入参 schema / 样例")
+    p_desc.add_argument("word_id")
+
+    p_run = sub.add_parser("run", help="一键运行某个 word")
+    p_run.add_argument("word_id")
+    p_run.add_argument("--params", help="JSON 入参字符串（默认 {}）")
+    p_run.add_argument("--params-file", help="JSON 入参文件路径")
+    p_run.add_argument("--example", action="store_true", help="使用 example_params 样例运行")
+    p_run.add_argument("--username", help="接口登录用户名（覆盖环境变量/配置）")
+    p_run.add_argument("--password", help="接口登录密码（覆盖环境变量/配置）")
+
+    p_cat = sub.add_parser("catalog", help="导出全量目录 JSON（平台化数据源）")
+    p_cat.add_argument("--out", help="输出文件路径；缺省打印到 stdout")
+
+    args = parser.parse_args(argv)
+    handlers = {
+        "list": _cmd_list,
+        "describe": _cmd_describe,
+        "run": _cmd_run,
+        "catalog": _cmd_catalog,
+    }
+    return handlers[args.command](args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tuner_testkit-4.0.0/tuner_testkit/action_words/_internal/__init__.py

@@ -0,0 +1,5 @@
+"""action_words 内部共用工具（id 生成 / 随机业务值 / 批量插入 / API 辅助 / 轮询）。
+
+仅供 packages.action_words 内部使用；外部调用方请走各 action word 的
+``run`` / ``run_from_dict`` 入口。
+"""

tuner_testkit-4.0.0/tuner_testkit/action_words/_internal/api.py

@@ -0,0 +1,56 @@
+"""API 辅助 — 冻结 api_objects 的动态加载与登录换 token。
+
+登录资产模块由环境变量 ``TEST_LOGIN_API_MODULE`` /
+``TEST_LOGIN_API_ATTR`` 配置（默认未设置时明确报错），避免模板硬编码
+业务路由目录。含连字符的包路径（如 ``packages.api_objects.prod-api.login``）
+同样经 :func:`load_api` 按名加载。
+"""
+from __future__ import annotations
+
+import importlib
+import os
+from typing import Any
+
+
+def load_api(module_path: str, attr: str) -> Any:
+    """按模块路径与属性名加载一个冻结的 APIModel 资产。"""
+    return getattr(importlib.import_module(module_path), attr)
+
+
+def login_token(username: str, password: str) -> str:
+    """调用冻结的 login 接口资产换取 bearer token。
+
+    配置（环境变量）：
+      - ``TEST_LOGIN_API_MODULE`` — 如 ``tuner_testkit.api_objects.auth_api.login``
+      - ``TEST_LOGIN_API_ATTR`` — 如 ``login_post_v1``（默认 ``login_post_v1``）
+    """
+    module = (os.getenv("TEST_LOGIN_API_MODULE") or "").strip()
+    attr = (os.getenv("TEST_LOGIN_API_ATTR") or "login_post_v1").strip()
+    if not module:
+        raise RuntimeError(
+            "未配置登录 API Object：请设置环境变量 TEST_LOGIN_API_MODULE "
+            "（及可选 TEST_LOGIN_API_ATTR），指向冻结的 login 资产；"
+            "或向 ActionContext 显式传入 bearer_token。"
+        )
+    login_model = load_api(module, attr)
+    resp = login_model.set_json({"username": username, "password": password}).execute()
+    token = _extract_token(resp)
+    if not token:
+        keys = sorted(resp.json.keys()) if isinstance(resp.json, dict) else type(resp.json)
+        raise RuntimeError(f"登录响应中未找到 token（响应顶层键: {keys}）")
+    return token
+
+
+def _extract_token(resp: Any) -> str | None:
+    payload = resp.json if isinstance(resp.json, dict) else {}
+    for candidate in (payload.get("token"), payload.get("access_token")):
+        if candidate:
+            return str(candidate)
+    data = payload.get("data")
+    if isinstance(data, dict):
+        for key in ("token", "access_token", "accessToken"):
+            if data.get(key):
+                return str(data[key])
+    if isinstance(data, str) and data:
+        return data
+    return None