示例规范 - 您的蓝图标题

https://blueprints.launchpad.net/neutron/+spec/reorganize-unit-test-tree

重新组织单元测试树的结构,使其与代码树的结构保持一致。

问题描述

目前单元测试模块(neutron/test/unit/*)的组织方式不一致。很难找到给定模块的单元测试,这使得确定代码是否经过充分测试变得困难。同时,也没有明确的指导方针来确定新测试应该放在哪里,从而确保问题持续存在。

提议的变更

neutron/tests/unit 子树的模块结构应该更改,以镜像代码树的结构。

  • 路径结构应该相同。这意味着位于路径

    neutron/[路径]

    下的模块,其测试模块应该位于以下位置

    neutron/tests/unit/[路径]

    例如,‘neutron/scheduler’ 的测试模块应该在 ‘neutron/tests/unit/scheduler’ 处。

  • 测试模块的名称应与被测模块的名称对应,并在名称前加上 ‘test_’。例如,模块 ‘neutron/scheduler/dhcp_agent_scheduler.py’ 意味着测试模块 ‘neutron/tests/unit/scheduler/test_dhcp_agent_scheduler.py’。

应该记录此要求,以便新的更改遵循此方案。

数据模型影响

REST API 影响

安全影响

通知影响

其他最终用户影响

性能影响

IPv6 影响

其他部署者影响

开发人员影响

补丁作者和审查者需要确保新的更改保持单元测试树结构的一致性。

社区影响

备选方案

实现

负责人

主要负责人

marun

工作项

  • 重新组织测试树

依赖项

测试

Tempest 测试

功能测试

API 测试

文档影响

用户文档

开发人员文档

单元测试树的所需结构应记录在树内开发者文档中。

参考资料

[1] https://pytest.cn/latest/goodpractises.html