voiage.ingestion.registry.ProviderRegistry

A deterministic registry populated only by the application caller.

Methods

ingest

ingest([positional or keyword] self: None = None, [positional or keyword] descriptor_path: Path = None, [keyword-only] policy: SourceAccessPolicy | None = None, [keyword-only] selection: SourceSelection | None = None) -> NormalizedInputBundle

Choose exactly one recognizer and convert its descriptor.

Parameters:

• self
• descriptor_path Path
• policy SourceAccessPolicy | None (default: None)
• selection SourceSelection | None (default: None)

Returns: NormalizedInputBundle

inspect

inspect([positional or keyword] self: None = None, [positional or keyword] descriptor_path: Path = None) -> dict[str, object]

Return deterministic provider diagnostics without materializing data.

Inspection is deliberately metadata-only: it reads the descriptor, reports the matching provider and its declared capabilities, and never resolves resources or imports optional providers.

Parameters:

• self
• descriptor_path Path

Returns: dict[str, object]

capabilities_for

capabilities_for([positional or keyword] self: None = None, [positional or keyword] provider_id: str = None) -> ProviderCapabilities

Return the declared support profile for one registered provider.

Parameters:

• self
• provider_id str

Returns: ProviderCapabilities