Skip to content

voiage.ingestion.croissant.CroissantProvider

Convert an offline Croissant descriptor with one CSV RecordSet.

can_handle([positional or keyword] self: None = None, [positional or keyword] descriptor: dict[str, object] = None) -> bool

Recognize the Croissant context rather than a filename convention.

Parameters:

  • self
  • descriptor dict[str, object]

Returns: bool

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

Materialize one explicitly selected local Croissant CSV pair.

Legacy one-record-set/one-distribution descriptors need no selector. A descriptor with more than one local pair must instead identify both a recordSet name and a distribution @id. The selected record set must explicitly link to that distribution through the narrowly supported local-profile distribution member; VOIAGE never guesses a relationship from matching field names.

Parameters:

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

Returns: NormalizedInputBundle