import json import pathlib import sys import unittest from argparse import Namespace ROOT = pathlib.Path(__file__).resolve().parents[2] sys.path.insert(0, str(ROOT / "scripts")) import generate_operator_docs class OperatorDocsGenerationTest(unittest.TestCase): def test_builtin_handler_hints_come_from_declarative_catalog(self): catalog_path = ROOT / "internal" / "api" / "builtin_operators_catalog.json" catalog = json.loads(catalog_path.read_text(encoding="utf-8")) hints = generate_operator_docs.load_builtin_handler_hints(str(catalog_path)) builtin_ids = [str(item["id"]) for item in catalog if str(item.get("type", "")).strip() == "builtin"] self.assertGreater(len(builtin_ids), 20) self.assertEqual( hints["operator-builtin-mongodb-write"], ("backend/operators/builtin/mongodb_write/operator.py", "builtin_mongodb_write"), ) self.assertEqual( hints["operator-builtin-model-inference"], ("backend/operators/builtin/model_inference/operator.py", "builtin_model_inference"), ) self.assertEqual(sorted(hints), sorted(builtin_ids)) def test_default_operator_payload_comes_from_local_catalog(self): args = Namespace(input_json="", api_base_url="") payload, source = generate_operator_docs.load_operator_payload(args) items = generate_operator_docs.operator_items_from_payload(payload) self.assertEqual(source, "internal/api/builtin_operators_catalog.json") self.assertGreater(len(items), 20) self.assertTrue(any(item.get("name") == "视频质检" for item in items)) def test_operator_payload_source_must_be_explicitly_unique(self): args = Namespace(input_json="operators.json", api_base_url="http://api.example.test") with self.assertRaisesRegex(SystemExit, "set only one"): generate_operator_docs.load_operator_payload(args) if __name__ == "__main__": unittest.main()