triplemodel.io.ops

Thin helpers over pyoxigraph-backed graph operations for TripleModel.

triplemodel.io.ops.merge_graphs(*graphs)[source]

Return a new graph containing the union of graphs.

Return type:: RdfGraph
Parameters:: graphs (RdfGraph)

triplemodel.io.ops.graph_value(graph, subject, predicate, model_cls, field_name, *, on_duplicate='first', resolver=None, registry=<triplemodel.terms.registry.LiteralRegistry object>)[source]

Return a single object for a functional-property field, if present.

Return type:

Union[str, int, float, bool, date, datetime, Decimal, UUID, None]

Parameters:

graph (RdfGraph)
subject (str)
predicate (str)
model_cls (type[T])
field_name (str)
on_duplicate (Literal['ignore', 'warn', 'error', 'first'])
resolver (PredicateResolver | None)
registry (LiteralRegistry)

triplemodel.io.ops.graph_set(graph, subject, predicate, value, *, registry=<triplemodel.terms.registry.LiteralRegistry object>)[source]

Set objects for (subject, predicate) using remove-then-add semantics.

Return type:

None

Parameters:

graph (RdfGraph)
subject (str)
predicate (str)
value (str | int | float | bool | date | datetime | Decimal | UUID | Enum | NamedNode | BlankNode | Literal | None)
registry (LiteralRegistry)

triplemodel.io.ops.graph_set_many(graph, subject, predicate, values, *, registry=<triplemodel.terms.registry.LiteralRegistry object>)[source]

Set multiple objects for (subject, predicate) (remove-then-add).

Return type:

None

Parameters:

graph (RdfGraph)
subject (NamedNode | BlankNode | Literal)
predicate (str)
values (list[str | int | float | bool | date | datetime | Decimal | UUID | Enum | NamedNode | BlankNode | Literal])
registry (LiteralRegistry)

triplemodel.io.ops.objects_for_field(graph, uri, model_cls, field_name, *, resolver=None, registry=<triplemodel.terms.registry.LiteralRegistry object>)[source]

Return all RDF objects for a model field’s predicate.

Return type:

list[Union[str, int, float, bool, date, datetime, Decimal, UUID]]

Parameters:

graph (RdfGraph)
uri (str)
model_cls (type[BaseModel])
field_name (str)
resolver (PredicateResolver | None)
registry (LiteralRegistry)