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 )