用途:在 contentstack-management-python 仓库中新增或修改 tests/ 下的测试,排查 API 与 mock 测试失败,改进 tests/cred.py 的使用。
测试套件与路径:单元测试位于 tests/unit/,快速且隔离,是主要 CI 目标;API 测试位于 tests/api/,针对真实 CMA,通过 tests/cred.py 读取 .env;mock 测试位于 tests/mock/**,使用模拟 HTTP 与契约。
常用命令:单元测试 pytest tests/unit/ -v 或 coverage run -m pytest tests/unit/;API 测试 pytest tests/api/ -v;mock 测试 pytest tests/mock/ -v;全量 pytest tests/ -v。
环境配置:tests/cred.py 的 get_credentials() 加载 dotenv,返回 host、tokens 与资源 UID。常见变量包括 HOST、APIKEY、AUTHTOKEN、MANAGEMENT_TOKEN、ORG_UID,以及测试所需的资源 UID。本地运行 API 测试时在仓库根目录放置 .env,切勿提交密钥。
卫生要求:不提交任何密钥,CI 中使用占位符或仅环境变量;除非有意为之,避免在应运行全量套件的路径中保留 pytest.skip 或仅聚焦的测试。
限制:资料未提供更多关于依赖版本、CI 配置或覆盖率阈值的细节。