triplemodel.io.hydrate

Batch hydration of reference fields from a shared graph.

triplemodel.io.hydrate.hydrate_refs(instances, graph, *field_names, spec=None, validate_type=True, on_duplicate='warn', resolver=None, registry=<triplemodel.terms.registry.LiteralRegistry object>, de_skolemize=None)

Batch-load reference fields from graph, reusing one model per object URI.

Return type:

list[TypeVar(T, bound= BaseModel)]

Parameters:

• instances (list[T])

• graph (RdfGraph)

• field_names (str)

• spec (Mapping[str, type[BaseModel]] | None)

• validate_type (bool)

• on_duplicate (Literal['ignore', 'warn', 'error', 'first'])

• resolver (PredicateResolver | None)

• registry (LiteralRegistry)

• de_skolemize (bool | None)

triplemodel.io.hydrate.model_join(instances, graph, spec, **kwargs)

Hydrate reference fields named in spec (field name → model class).

Return type:

list[TypeVar(T, bound= BaseModel)]

Parameters:

• instances (list[T])

• graph (RdfGraph)

• spec (Mapping[str, type[BaseModel]])

• kwargs (Any)