test_module_boundaries.py
1"""Dependency direction and import isolation for the expanded package layout."""23import ast4import importlib.util5from pathlib import Path6import subprocess7import sys8import unittest910ROOT = Path(__file__).resolve().parents[2]111213class ModuleBoundaries(unittest.TestCase):14 def test_package_initializers_keep_core_and_optional_ui_imports_isolated(self):15 program = '''16import sys17import sim_platform.agents18import sim_platform.agents.configuration19import sim_platform.application.use_cases20import sim_platform.application.experiments21import sim_platform.market.prepared22import sim_platform.experiments.execution.timeline23import sim_platform.experiments.execution24import sim_platform.experiments.scheduling25import sim_platform.experiments.scheduling.policy26import sim_platform.agents.hosting27import sim_platform.decisions.agent28import sim_platform.agents.tools.worker29import sim_platform.agents.tools.protocol30import sim_platform.agents.tools.reads31import sim_platform.agents.tools.trading32import sim_platform.agents.tools.server33import sim_platform.persistence.sql34import sim_platform.persistence.sql.repositories35import sim_platform.persistence.sql.migrations36import sim_platform.desktop37import sim_platform.desktop.web38import sim_platform.desktop.workflows39'''40 # Import only package roots: SQL composition above legitimately loads ORM.41 # The UI roots must still remain inert and never bring Qt into the core.42 program += "assert not any(name.startswith('PySide6') for name in sys.modules)\n"43 subprocess.run([sys.executable, '-c', program], cwd=ROOT, check=True)4445 def test_subpackages_follow_their_responsibility_boundaries(self):46 rules = {47 'market/prepared': (48 'sim_platform.application',49 'sim_platform.execution',50 'sim_platform.persistence',51 'sim_platform.agents',52 'PySide6',53 ),54 'experiments/execution/timeline': (55 'sim_platform.application',56 'sim_platform.persistence',57 'sim_platform.agents',58 'PySide6',59 ),60 'experiments/scheduling': (61 'sim_platform.agents',62 'sim_platform.market',63 'sim_platform.execution',64 'sim_platform.persistence',65 'sim_platform.application',66 'sqlalchemy',67 'PySide6',68 ),69 'agents/tools/reads': (70 'sim_platform.agents.tools.trading',71 'sim_platform.agents.tools.server',72 ),73 'models': (74 'sim_platform.agents',75 'sim_platform.market',76 'sim_platform.execution',77 'sim_platform.persistence',78 'sim_platform.application',79 'PySide6',80 ),81 'decisions/policy/live': (82 'sim_platform.agents',83 'sim_platform.application',84 'sim_platform.persistence',85 'sqlalchemy',86 'PySide6',87 ),88 'agents': (89 'sqlalchemy',90 'sqlite3',91 'PySide6',92 'sim_platform.application',93 'sim_platform.persistence',94 'sim_platform.desktop',95 ),96 'application/use_cases': (97 'sqlalchemy',98 'sqlite3',99 'PySide6',100 'sim_platform.persistence',101 'sim_platform.desktop',102 ),103 'persistence': (104 'PySide6',105 'sim_platform.application',106 'sim_platform.desktop',107 'sim_platform.cli',108 'sim_platform.agents',109 ),110 'desktop/workflows': (111 'PySide6',112 'sim_platform.persistence',113 'sqlalchemy',114 ),115 'desktop/web': (116 'sqlalchemy',117 'sqlite3',118 'sim_platform.market',119 ),120 }121 for directory, forbidden in rules.items():122 paths = list((ROOT / 'sim_platform' / directory).rglob('*.py'))123 self.assertTrue(paths, 'boundary check must cover real source: ' + directory)124 for path in paths:125 relative = path.relative_to(ROOT).with_suffix('')126 module = '.'.join(relative.parts)127 package = module.rpartition('.')[0]128 for node in ast.walk(ast.parse(path.read_text())):129 if isinstance(node, ast.Import):130 imports = [alias.name for alias in node.names]131 elif isinstance(node, ast.ImportFrom):132 target = node.module or ''133 if node.level:134 target = importlib.util.resolve_name('.' * node.level + target, package)135 imports = [target]136 else:137 continue138 with self.subTest(path=path.relative_to(ROOT), line=node.lineno):139 self.assertFalse(any(name.startswith(forbidden) for name in imports))140141142if __name__ == '__main__':143 unittest.main()