rics.translation.fetching.support#

Supporting functions for implementations.

Functions

from_records(instr, known_placeholders, records)

Create PlaceholderTranslations instance from records.

select_placeholders(instr, known_placeholders)

Select from a subset of known placeholders.
from_records(instr: FetchInstruction[SourceType, IdType], known_placeholders: Collection[str], records: Sequence[Sequence[Any]]) → PlaceholderTranslations[source]#

Create PlaceholderTranslations instance from records.

Convenience method meant for use by implementations.

Parameters

  • instr – A fetch instruction.

  • known_placeholders – Known placeholders for the instr.source.

  • records – Records produced from the instruction.

Returns

Placeholder translation elements.

Raises

ImplementationError – If the underlying Fetcher does not return enough IDs.

select_placeholders(instr: FetchInstruction[SourceType, IdType], known_placeholders: Collection[str]) → List[str][source]#

Select from a subset of known placeholders.

Parameters

  • instr – Instruction object with placeholders.

  • known_placeholders – A collection of known placeholders.

Returns

As many known placeholders from instr as possible.