| """The public API is a promise: everything advertised is importable, once.""" |
|
|
| import importlib |
| import inspect |
|
|
| import tiny_computer_agent as tca |
|
|
|
|
| def test_everything_in_all_is_reachable_from_the_package_root(): |
| missing = [name for name in tca.__all__ if not hasattr(tca, name)] |
| assert missing == [], f"advertised but not exported: {missing}" |
|
|
|
|
| def test_all_is_sorted_and_free_of_duplicates(): |
| assert tca.__all__ == sorted(tca.__all__), "keep __all__ alphabetical" |
| assert len(tca.__all__) == len(set(tca.__all__)), "no duplicate exports" |
|
|
|
|
| def test_no_public_callable_in_a_module_is_missing_from_all(): |
| """A capability a user cannot import is a capability they cannot use.""" |
| modules = ["actions", "act", "observe", "perception", "brain", "models", "loop", |
| "safety", "desktop", "demo", "trace", |
| |
| "diff", "gates", "runner", "skills", "watchdog", "audit"] |
| unexported = [] |
| for name in modules: |
| module = importlib.import_module(f"tiny_computer_agent.{name}") |
| for attr, obj in vars(module).items(): |
| if attr.startswith("_") or getattr(obj, "__module__", "") != module.__name__: |
| continue |
| if attr in tca.__all__ or attr.endswith(("Error", "Unavailable", "Violation")): |
| continue |
| unexported.append(f"{name}.{attr}") |
| assert unexported == [], f"public names not exported from the package root: {unexported}" |
|
|
|
|
| def test_the_documented_entry_points_are_callable(): |
| for name in ["doctor", "run_checks", "display_available", "build_agent", |
| "make_detector", "make_model_brain", "benchmark", "score"]: |
| assert callable(getattr(tca, name)), name |
|
|
