人工智能AI AgentAgent 编排低代码AI 技能RAG【免费下载链接】nexentNexent 是一个开源智能体SDK和平台能够将描述流程的自然语言转化为完整的多模态服务 —— 无需编排无需复杂拖拉拽。基于 MCP 工具生态系统构建Nexent 提供灵活的模型集成、可扩展的数据处理和强大的知识库管理。我们的目标很简单将数据、模型和工具整合到一个智能中心中让任何人都能轻松地将 Nexent 集成到项目中使日常工作流程更智能、更互联。项目地址https://gitcode.com/ModelEngine/nexent点击查看免费下载本文基于 Nexent 仓库中维护 Legacy UT 套件的 Skill 文档.agents/skills/nexent-python-tests/SKILL.md系统讲解test/backend、test/sdk、test/ext_components三个目录下的 Python 单元测试如何组织、如何编写、如何运行读者可以完整掌握 lookup-site mock 原则、异步测试与 fixture 隔离策略以及从窄范围验证到全量 runner 的回归执行方案。一、定位Legacy UT 套件与 D1-D5 体系的边界Nexent 仓库中存在两套并行的测试资产边界必须严格遵守维度Legacy UT本文主题D1-D5 需求驱动体系覆盖目录test/backend、test/sdk、test/ext_componentstest/automation/d1~test/automation/d5组织方式按实现模块划分的单元测试需求/Bug → Feature → D1-D5 Case 的追踪链编号规则不分配正式 D1-D5 Case ID使用如CMSR-D1-001的稳定 Case ID清单登记不加入test/manifests/d1-d5.yaml登记于 manifest并生成 Excel 基线当前test/backend、test/sdk、test/ext_components下共有 500 余个test_*.py文件约 545 个全部属于 Legacy UT。仓库中 D1-D5 体系的真实样例如 manifest 文件其条目带有case_id、contract_hash与implementation等结构化字段——Legacy UT 文件绝不能以这种形式被登记或计入功能基线。新的 D1-D5 工作应使用nexent-test-assetsSkill而不是改动 Legacy 套件。这一边界的意义在于单元测试的隔离性不能替代真实服务的功能验证。Legacy UT 证明的是代码逻辑在给定 mock 下正确而线上行为的验收仍属于 D1-D5 自动化与人工验收的职责。二、测试基建pytest.ini与conftest.py在动任何 fixture 或 import 结构之前Skill 明确要求先检查三个东西邻近测试文件、test/conftest.py、test/pytest.ini。以下逐一说明它们实际承担的职责。2.1test/pytest.ini异步默认与本地专用标记pytest.ini 全文很短但决定了整个套件的运行语义[pytest] # Automatically detect and handle async test functions asyncio_mode auto # Create a new event loop for each test function to ensure isolation asyncio_default_fixture_loop_scope function filterwarnings # Disable all warnings ignore # Custom markers markers local_only: marks tests that require external resources (API keys, network) and should only run locally (deselect with -m not local_only)三个关键配置asyncio_mode autopytest-asyncio 自动识别async def测试函数无需逐个添加pytest.mark.asyncioSkill 中第 5 步提到的该标记仍然适用于显式标注场景。asyncio_default_fixture_loop_scope function每个测试函数创建独立事件循环保证异步 fixture 之间的隔离。local_onlymarker标记需要 API key、网络等外部资源的测试CI 场景可用pytest -m not local_only排除。2.2test/conftest.py路径注入、包元数据修复与全局 mocktest/conftest.py 是理解整套 Legacy 测试如何零真实依赖运行的关键它做了以下几件事1. 双根路径注入L24-L33。将backend/与sdk/目录插入sys.path使测试既能以from backend.xxx import ...导入也能以from sdk.xxx import ...导入——这正是后文lookup-site 取决于实际 import 路径这一原则的基础。2. 包元数据修复L36-L77。许多测试模块会在收集阶段用轻量 stub 替换consts、services等包的sys.modules条目导致后续真实子模块导入失败。_restore_project_package_metadata()会重建这些包的__path__、__package__与ModuleSpec并通过pytest_collectstart钩子和一个autousefixture_restore_project_packages在每次收集与每次测试执行前双重修复。这是理解为什么 conftest 不能随便改的核心它维护着 mock 包与真实包之间的脆弱平衡。3. 可选 SDK stub。当环境未安装xlrd时注入一个宽容的_XlrdProxy模块L95-L128使evaluation_set_excel_utils的.xls解析路径可以正常导入单测文件内部可替换为更丰富的 fake。4. 结构化 supabase mockL205-L268。backend.utils.auth_utils在模块加载期执行from supabase.lib.client_options import SyncClientOptions。如果测试文件只是简单地把sys.modules[supabase]换成裸MagicMock该 import 会失败并连带使所有传递性导入user_service的测试在收集阶段崩溃。install_supabase_mock()因此构造了带lib、lib.client_options、SyncClientOptions属性的包形 mock配合autousefixture_supabase_mock在每个测试体执行前重装防御单个测试文件的覆盖。5. 自建mockerfixtureL171-L192。Skill 要求使用 pytest-mock 风格而 conftest 用_MiniMocker实现了兼容 APImocker.patch/mocker.patch.object/mocker.patch.dictfixture 结束自动stopall()。6. 环境默认值。统一把TMP/TMPDIR/TEMP指向仓库内.pytest-tmp并覆写tempfile.tempdir同时为 MinIO、Elasticsearch、PostgreSQL 设置setdefault环境变量如MINIO_ENDPOINThttp://localhost:9000、POSTGRES_DBtest_db保证测试不会意外触碰真实服务配置。此外test/common/test_mocks.py 提供bootstrap_test_env()lru_cache的会话级环境自举与setup_common_mocks()等共享工具避免各测试文件重复编写数据库/存储 mock。三、编写测试的七步工作流以下逐条对应 Skill 文档的七个步骤并结合仓库中的真实用例说明执行方式。步骤 1先确定被测单元与行为再检查基建改 fixture 或 import 结构之前先看邻近测试文件如何组织再读test/conftest.py与test/pytest.ini。例如要测backend.services.a2a_client_service可参考同目录的 test_a2a_client_service.py它按行为拆成TestA2AClientServiceExceptions、TestA2AClientServiceInit、TestExtractAgentUrl等多个类import 放在各测试方法内部最大限度规避模块加载期的全局副作用。步骤 2命名与文件组织约束只用 pytestpytest 断言、fixtures、pytest-mock风格 mock文件与函数以test_开头测试类以Test开头单文件控制在 500 行以内超限时按功能拆分为test_module_feature.py拆分产生的包目录必须包含__init__.pytest/backend、test/sdk各级目录均已如此。仓库中的真实案例test/backend/agents/下同时存在test_create_agent_info.py数千行历史主文件与test_create_agent_info_workbench_coverage.py——后者就是按功能拆分出来的配套文件。步骤 3mock 协作方且必须 patch查找点这是整套规范中最容易被违反的一条mock 的对象是协作方collaborator绝不真正调用外部接口、客户端或服务patch 的目标必须是完全限定的查找点——即被测试模块实际 import 该名字的位置而不是依赖的定义模块。Skill 给出的示例若backend.services.example_service通过from provider import fetch引入fetch则应 patchbackend.services.example_service.fetch若运行时该模块实际以services.example_service加载就使用那条真实路径。切忌从无关示例中照抄路径。仓库中的实践印证了这一原则。test_config_sync_service.py 开头即注释说明在导入 backend 之前 patch boto3 及其他依赖并选择在 botocore 的查找点下手# This prevents real AWS/MinIO/Elasticsearch calls during import patch(botocore.client.BaseClient._make_api_call, return_value{}).start() patch(nexent.storage.storage_client_factory.create_storage_client_from_config, return_valuestorage_client_mock).start()它同时展示了另一种手段对database.client等模块直接用types.ModuleType构造 stub 写入sys.modules再手动维护包属性链接database_package上挂回client。两种手段运行时 patch 与sys.modules预置 stub都遵循同一准则让被 import 的名字指向 mock。步骤 4隔离外部 I/O用 fixture 复位可变状态用 fixture 重置可变状态当作用域内每个测试都需要该重置时标记autouseTrue——conftest 中的_restore_project_packages、_supabase_mock就是标准示范不要 mock 掉被测行为本身。判断标准断言所观察的行为如果依赖某个 mock 的返回值说明 mock 过界了。步骤 5成功/错误流、边界与异步对变更后的成功流、错误流和边界条件写具体、可观察的断言协作方抛错用side_effect。真实用例见 test_memory_transparent_proxy.pyhook AsyncMock(side_effectRuntimeError(hook failed))参数变体用pytest.mark.parametrize。如 test_create_agent_info.py 中对多分支场景的批量展开异步测试在asyncio_mode auto下可直接写async def需要显式标注时再加pytest.mark.asyncio异步协作方必须使用 awaitable mockAsyncMock。例如 test_create_agent_info.py 中initialize_tools_on_startupAsyncMock(),若用MagicMock代替AsyncMockawait mock()会直接报错或语义失真。步骤 6导入顺序与注释语言import 按标准库 → 第三方 → 项目分组注释与 docstring 一律使用英文仓库现有测试文件均遵循如test_a2a_client_service.py中 Test class for A2A Client Service exceptions. 的 docstring 风格。步骤 7先窄后宽地运行Skill 要求从仓库根目录、在可用的 backend 环境下先跑窄范围测试例如文档给出的命令形态pytest test/backend/apps/test_agent_app.py -v当前test/backend/apps/目录中实际存在的文件为test_memory_record_app.py、test_memory_provider_app.py、test_memory_dreaming_app.py可按同一形态选取真实存在的文件执行如pytest test/backend/apps/test_memory_record_app.py -v。必要时可叠加-m not local_only排除依赖外部资源的用例。范围扩大后全量回归使用仓库既有 runnerpython test/run_all_test.pyrun_all_test.py 的实现比简单跑一遍 pytest复杂得多值得了解其行为目标目录默认收集test/backend、test/sdk、test/ext_components下所有test_*.py环境变量NEXENT_PYTEST_WORKERS并发文件数默认auto取 CPU 数与文件数的较小值可设具体数字或off、NEXENT_PYTEST_FILE_TIMEOUT单文件超时默认 600 秒超时按 returncode 124 记失败、NEXENT_PYTEST_TARGETS空格分隔限定本次运行的目录/文件前置检查缺失pytest-cov、coverage、pytest-asyncio时直接报错退出按文件执行每个文件以独立子进程运行python -m pytest file -q --covbackend --covsdk --cov-branch --disable-warningscoverage 数据写入.coverage.index结果聚合解析各文件N passed / M failed摘要输出 Pass Rate失败文件附带 short summary 与截断的输出最后coverage combine合并并生成coverage_html/、coverage.xml报告任一文件失败或 coverage 失败则进程返回非零。四、结果汇报与验证边界工作流的收尾要求如实报告执行过的命令、结果与环境故障如缺包、端口不可达。Skill 特别强调单元测试的隔离性不替代 live-service 功能检查与真实模型验收——Legacy UT 通过只证明实现层逻辑端到端行为仍需 D1-D5 自动化套件或人工验收覆盖。五、要点速查实践点规则仓库依据套件边界不分配 D1-D5 ID、不入 manifest、不计入基线manifest 示例异步默认asyncio_mode auto每测试独立事件循环pytest.inimock 目标patch 查找点而非定义模块config_sync 测试异步 mock协作方必须AsyncMock用例文件规模500 行超限按test_module_feature.py拆分test/backend/agents/目录结构本地专用用例-m not local_only排除pytest.ini全量回归python test/run_all_test.py支持 workers/timeout/targets 三个环境变量runner遵循这套规范新增或修复的单元测试既能通过 CI 的窄范围验证也能安全地并入run_all_test.py的全量回归与覆盖率统计同时与 D1-D5 正式测试资产体系保持清晰边界。赞分享人工智能AI AgentAgent 编排低代码AI 技能RAG【免费下载链接】nexentNexent 是一个开源智能体SDK和平台能够将描述流程的自然语言转化为完整的多模态服务 —— 无需编排无需复杂拖拉拽。基于 MCP 工具生态系统构建Nexent 提供灵活的模型集成、可扩展的数据处理和强大的知识库管理。我们的目标很简单将数据、模型和工具整合到一个智能中心中让任何人都能轻松地将 Nexent 集成到项目中使日常工作流程更智能、更互联。项目地址https://gitcode.com/ModelEngine/nexent点击查看免费下载相关推荐Flet 单元测试实战用 uv 与 pytest 运行 Python SDK 测试套件Flet 单元测试实战用 uv 与 pytest 运行 Python SDK 测试套件 本指南聚焦 Flet 开源仓库中 Python 框架部分的单元测试体系前端跨平台桌面应用移动开发django-oscar 测试套件运行指南pytest 工作流、tox 多版本矩阵与测试目录规范django oscar 测试套件运行指南pytest 工作流、tox 多版本矩阵与测试目录规范 本文是 django oscar基于 Django 的领域后端电商Open3D Python 单元测试指南基于 pytest 的安装、运行与测试套件深度解析Open3D Python 单元测试指南基于 pytest 的安装、运行与测试套件深度解析 导读 本文以 python/test/readme.md http计算机视觉图形学3D渲染科学计算创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
首尾+随机访问)
