Source code

Download source archive ↓

src/rdflib/plugins/serializers/nquads.py

1from __future__ import annotations
2
3import warnings
4from typing import IO, Any, Optional
5
6from rdflib.graph import DATASET_DEFAULT_GRAPH_ID, ConjunctiveGraph, Graph
7from rdflib.plugins.serializers.nt import _quoteLiteral
8from rdflib.serializer import Serializer
9from rdflib.term import Literal
10
11__all__ = ["NQuadsSerializer"]
12
13
14class NQuadsSerializer(Serializer):
15    """NQuads RDF graph serializer."""
16
17    def __init__(self, store: Graph):
18        if not store.context_aware:
19            raise Exception(
20                "NQuads serialization only makes " "sense for context-aware stores!"
21            )
22
23        super(NQuadsSerializer, self).__init__(store)
24        self.store: ConjunctiveGraph
25
26    def serialize(
27        self,
28        stream: IO[bytes],
29        base: Optional[str] = None,
30        encoding: Optional[str] = None,
31        **kwargs: Any,
32    ) -> None:
33        if base is not None:
34            warnings.warn("NQuadsSerializer does not support base.")
35        if encoding is not None and encoding.lower() != self.encoding.lower():
36            warnings.warn(
37                "NQuadsSerializer does not use custom encoding. "
38                f"Given encoding was: {encoding}"
39            )
40        encoding = self.encoding
41        for context in self.store.contexts():
42            for triple in context:
43                stream.write(
44                    _nq_row(triple, context.identifier).encode(encoding, "replace")
45                )
46        stream.write("\n".encode("latin-1"))
47
48
49def _nq_row(triple, context):
50    graph_name = context.n3() if context and context != DATASET_DEFAULT_GRAPH_ID else ""
51    if isinstance(triple[2], Literal):
52        return "%s %s %s %s .\n" % (
53            triple[0].n3(),
54            triple[1].n3(),
55            _quoteLiteral(triple[2]),
56            graph_name,
57        )
58    else:
59        return "%s %s %s %s .\n" % (
60            triple[0].n3(),
61            triple[1].n3(),
62            triple[2].n3(),
63            graph_name,
64        )