python-cc 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

pcc/__init__.py

@@ -1,3 +1,27 @@
-from .api import module, build, BuildArtifact, Module
+"""Top-level ``pcc`` package exports.
 
-__all__ = ["module"]
+Keep package import side effects minimal so subpackages such as
+``pcc.py_frontend`` can be imported without pulling the full C
+evaluator / llvmlite stack into the process.
+"""
+from __future__ import annotations
+
+__all__ = ["module", "build", "BuildArtifact", "Module"]
+
+
+def __getattr__(name: str):
+    if name in __all__:
+        from .api import BuildArtifact, Module, build, module
+
+        exports = {
+            "module": module,
+            "build": build,
+            "BuildArtifact": BuildArtifact,
+            "Module": Module,
+        }
+        return exports[name]
+    raise AttributeError(f"module 'pcc' has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted(list(globals().keys()) + __all__)

pcc/__main__.py

@@ -1,3 +1,5 @@
-if __name__ == '__main__':
-    from .pcc import main
-    main()
+from pcc.cli_bootstrap import bootstrap_cli_sys_argv_exit
+
+
+if __name__ == "__main__":
+    bootstrap_cli_sys_argv_exit()

pcc/backend/__init__.py

@@ -88,6 +88,14 @@ def _normalize_backend_name(value: str | None) -> str:
     return candidate
 
 
+def backend_request_allows_unimplemented(requested: str | None = None) -> bool:
+    """Return True when a request explicitly opts into an experimental backend."""
+    raw = requested
+    if raw is None:
+        raw = os.environ.get(_ENV_BACKEND)
+    return _normalize_backend_name(raw) == "self"
+
+
 def resolve_backend(
     requested: str | None = None,
     *,