"""Strict tool scope and pagination/source completeness contracts.""" import copy,json,sys,tempfile,unittest from pathlib import Path sys.path.insert(0,str(Path(__file__).resolve().parent)) from test_nao_quality_tools import FakeApi from nao_quality_tools import QualityTools,QualityToolError class Api(FakeApi): mutation=None def call(self,path,payload=None,method=None): if path=='/api/analysis/investigate': context={k:payload.get(k) for k in ('releaseId','year','month','quarter','department','group','product','projectGroup','category','stage')};context['includeUnassigned']=payload.get('includeUnassigned',False);context['extraFilters']=payload.get('extraFilters',{}) r={'kind':'quality_investigation','action':payload['action'],'context':context,'aggregateComplete':True,'totalRows':205,'categories':[],'lineage':[]} if payload['action']=='source':r['sourceVerification']={'complete':True,'expectedRows':205,'verifiedRows':205,'missingRows':0,'mismatchRows':0} if payload['action']=='rows':r.update(rows=[{'recordId':1}],offset=payload.get('offset',0),returnedRows=1,matchingRows=205,hasMore=True,nextOffset=payload.get('offset',0)+1) if self.mutation:self.mutation(r) return r return super().call(path,payload,method=method) class TestInvestigation(unittest.TestCase): def setUp(self): self.tmp=tempfile.TemporaryDirectory();self.api=Api();self.tools=QualityTools(api_factory=lambda:self.api,evidence_dir=Path(self.tmp.name));self.args={'mode':'investigate','releaseId':'release-a','period':{'year':2026,'month':9},'stage':'bright','action':'source','filters':{'department':'工业电机产业部'}} def tearDown(self):self.tmp.cleanup() def test_both_periods_and_evidence_are_preserved(self): args={**self.args,'comparisonPeriod':{'year':2026,'month':8}};r=self.tools.quality_data(args);self.assertEqual(r['current']['totalRows'],205);self.assertEqual(r['comparison']['context']['month'],8);self.assertTrue(r['evidenceRef'].startswith('Q'));self.assertTrue(Path(r['evidencePath']).exists()) def test_scope_mismatch_refused(self): self.api.mutation=lambda r:r['context'].update(department='其他');self.assertRaises(QualityToolError,self.tools.quality_data,self.args) def test_false_source_completeness_refused(self): self.api.mutation=lambda r:r['sourceVerification'].update(verifiedRows=5);self.assertRaises(QualityToolError,self.tools.quality_data,self.args) def test_bad_pagination_refused(self): self.api.mutation=lambda r:r.update(nextOffset=0);self.assertRaises(QualityToolError,self.tools.quality_data,{**self.args,'action':'rows'}) def test_extra_parameters_never_ignored(self): for extra in ({'sql':'select 1'},{'offset':True},{'fields':['x']*33},{'sourceRevisionId':'../x'},{'sort':'rate_drop'}): with self.subTest(extra=extra):self.assertRaises(QualityToolError,self.tools.quality_data,{**self.args,**extra}) def test_source_only_parameters_rejected_for_other_modes(self): self.assertRaises(QualityToolError,self.tools.quality_data,{**self.args,'mode':'query'}) class CompactEvidenceTests(unittest.TestCase): def test_compression_preserves_full_evidence_and_proof_counts(self): full={"kind":"quality_investigation","action":"source","current":{"totalRows":205,"fieldDictionary":[{"duplicate":True}],"categories":[{"differenceFormalMinusSubitems":5.7822,"fields":[{"field":"x","coverage":{"rows":205,"numericRows":200,"nullOrBlankRows":5,"keyAbsentRows":0,"invalidNumericRows":0,"negativeRows":0,"numericSum":10}}]}],"sourceVerification":{"complete":True,"allSelectedValuesMatchStored":True,"verifiedRows":205,"files":[{"sha256":"original","fields":[{"field":"x"}]}]}}} view=QualityTools._model_view(full) self.assertIn("fields",full["current"]["categories"][0]);self.assertIn("fieldDictionary",full["current"]) self.assertEqual(view["current"]["categories"][0]["fieldCoverage"][0],["x",205,200,5,0,0,0,10]) self.assertEqual(view["current"]["sourceVerification"]["verifiedRows"],205) self.assertEqual(view["current"]["sourceVerification"]["files"][0]["verifiedFields"],["x"]) self.assertEqual(view["current"]["categories"][0]["differenceFormalMinusSubitems"],5.7822) if __name__=='__main__':unittest.main()