m/market labResearch, with a record.
Source on GitHub ↗

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()