jcv-dev
5df0be1f5c
Close the remaining places where an extension point was hardcoded, and expose a stable public import surface for every app. - files: register_storage_backend(...) / STORAGE_BACKENDS[name]["CLASS"]; unknown backends now fail loudly instead of silently using local - files: PipelineStepRegistry + @pipeline_step; PIPELINE_EXECUTOR setting - billing: INVOICE_PDF_BUILDER setting - security: TWO_FACTOR_SERVICE / TWO_FACTOR_RECOVERY_SERVICE settings - all app packages expose lazy public exports (PEP 562); infrasynth.shared re-exports its primitives eagerly - README documents the per-module extension-point table - tests/test_extensibility.py pins each hook plus the public surface
65 lines
1.9 KiB
Python
65 lines
1.9 KiB
Python
"""Public surface of ``infrasynth.files``.
|
|
|
|
The exports are resolved lazily (PEP 562) so importing this package never
|
|
triggers Django model imports before the app registry is ready. Import from
|
|
here::
|
|
|
|
from infrasynth.files import FileService, get_storage_backend, PipelineStepRegistry
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from importlib import import_module
|
|
from typing import Any
|
|
|
|
__all__ = [
|
|
"FileCategory",
|
|
"FileService",
|
|
"PipelineExecution",
|
|
"PipelineExecutor",
|
|
"PipelineStepRegistry",
|
|
"ProcessingPipeline",
|
|
"ScanResult",
|
|
"StoredFile",
|
|
"VirusScanner",
|
|
"get_pipeline_executor",
|
|
"get_scanner",
|
|
"get_storage_backend",
|
|
"pipeline_step",
|
|
"register_storage_backend",
|
|
"save_file",
|
|
]
|
|
|
|
# public name -> module (relative to the ``infrasynth`` package) that defines it
|
|
_EXPORTS: dict[str, str] = {
|
|
"FileCategory": "files.models",
|
|
"FileService": "files.services",
|
|
"PipelineExecution": "files.models",
|
|
"PipelineExecutor": "files.processing",
|
|
"PipelineStepRegistry": "files.processing",
|
|
"ProcessingPipeline": "files.models",
|
|
"ScanResult": "files.scanner",
|
|
"StoredFile": "files.models",
|
|
"VirusScanner": "files.scanner",
|
|
"get_pipeline_executor": "files.processing",
|
|
"get_scanner": "files.scanner",
|
|
"get_storage_backend": "files.storage",
|
|
"pipeline_step": "files.processing",
|
|
"register_storage_backend": "files.storage",
|
|
"save_file": "files.storage",
|
|
}
|
|
|
|
|
|
def __getattr__(name: str) -> Any:
|
|
module_path = _EXPORTS.get(name)
|
|
if module_path is not None:
|
|
return getattr(import_module(f"infrasynth.{module_path}"), name)
|
|
# Let ``infrasynth.<app>.<submodule>`` resolve as usual.
|
|
try:
|
|
return import_module(f"{__name__}.{name}")
|
|
except ModuleNotFoundError as exc:
|
|
raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from exc
|
|
|
|
|
|
def __dir__() -> list[str]:
|
|
return sorted(set(__all__) | set(globals()))
|