testreqstatus

pip install testreqstatus

用法

1. 为测试名称建立一组对应的需求

   {
     "DMS356": [
       "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline"
     ],
     "DMS373": [
       "romancal.regtest.test_mos_pipeline.test_hlp_mosaic_pipeline"
     ],
     "DMS374": [
       "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline"
     ],
     "DMS400": [
       "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline"
     ]
   }
   

[!TIP]要从带有@metrics_logger装饰器的现有测试中提取测试需求，请使用RequirementTests.from_test_directory()

from testreqstatus import RequirementTests

requirements = RequirementTests.from_test_directory("~/projects/romancal/")
requirements.to_file("test_requirements.json")

2. 运行测试并生成JUnitXML结果文件

   <?xml version="1.0" encoding="utf-8"?>
   <testsuites>
     <testsuite name="pytest" errors="0" failures="0" skipped="0" tests="2" time="2021.550" timestamp="2024-08-23T00:23:01.454354" hostname="spacetelescope-runner-2ls89-rrbf2">
       <testcase classname="romancal.regtest.test_mos_pipeline" name="test_level3_mos_pipeline" time="677.728">
       </testcase>
       <testcase classname="romancal.regtest.test_mos_pipeline" name="test_hlp_mosaic_pipeline" time="486.642">
       </testcase>
     </testsuite>
   </testsuites>
   

3. 使用RequirementTestResults.requirements_by_test_result检索每个测试及其对应需求的状态

   from testreqstatus import RequirementTestResults
   
   results = RequirementTestResults(
       test_requirements="examples/test_requirements.json",
       test_results="examples/results.xml",
   )
   
   print(results.requirements_by_test_result)
   

   {
     "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline": {
       "status": "PASS",
       "requirements": [
         "DMS356",
         "DMS374",
         "DMS400"
       ]
     },
     "romancal.regtest.test_mos_pipeline.test_hlp_mosaic_pipeline": {
       "status": "PASS",
       "requirements": [
         "DMS373"
       ]
     }
   }
   

[!TIP]您还可以使用RequirementTestResults.test_results_by_requirement获取反向映射（需求和它们的对应测试状态）

print(results.test_results_by_requirement)

{
  "DMS356": {
    "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline": "PASS"
  },
  "DMS373": {
    "romancal.regtest.test_mos_pipeline.test_hlp_mosaic_pipeline": "PASS"
  },
  "DMS374": {
    "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline": "PASS"
  },
  "DMS400": {
    "romancal.regtest.test_mos_pipeline.test_level3_mos_pipeline": "PASS"
  }
}