Add `Graph.add_many` to add an iterable of triples

[multimeric]

This is such a common case that I think it would be nice to simplify it. For example, I propose:

from rdflib import Graph, BNode, SDO

graph = Graph()
entity = BNode()

graph.add_many([
    (entity, SDO.name, Literal("The Entity")),
    (entity, SDO.description, Literal("Description of the entity"))
])

[ajnelson-nist]

For reference and possible typing inspiration, the type signatures for the two executemany variants in Python's sqlite3 are here and here, as of their last update a few weeks ago.

[edmondchuc]

Is your proposal different to Graph.addN?

rdflib/rdflib/graph.py

Lines 633 to 643 in 91c8cbc

	def addN(self: _GraphT, quads: Iterable[_QuadType]) -> _GraphT: # noqa: N802
	"""Add a sequence of triple with context"""
	self.__store.addN(
	(s, p, o, c)
	for s, p, o, c in quads
	if isinstance(c, Graph)
	and c.identifier is self.identifier
	and _assertnode(s, p, o)
	)
	return self

[multimeric]

Yes. That takes quads which include a fourth element which is a context graph. Honestly not even sure what that's for, but it's different from my use case which is adding multiple triples.

[edmondchuc]

I think Graph.addN requires quads rather than triples to support Dataset subclassing Graph, and because of how the Store interface is integrated into Graph. As a result, Graph often needs to handle quads, which leads to some LSP-related design issues. For more background context, see this issue #2022.

That said, if you're okay with adding many statements to a graph, you can use addN:

from rdflib import Graph, BNode, SDO, Literal

graph = Graph()
entity = BNode()

graph.addN([
    (entity, SDO.name, Literal("The Entity"), graph),
    (entity, SDO.description, Literal("Description of the entity"), graph)
])

We might not be able to address the LSP issues soon but perhaps we can improve the API for Graph.addN to accept triples instead of quads in a future major release #3302.

[multimeric]

Yep, I think updating addN (weird camelCase usage incidentally?) to support triples would work just as well.