Added comments as suggested by reviewer

EMMC-ASBL · Oct 14, 2024 · 05ad6b8 · 05ad6b8
1 parent cd102fb
commit 05ad6b8
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 1 deletion.
diff --git a/tripper/interface.py b/tripper/interface.py
@@ -24,7 +24,7 @@ class ITriplestore(Protocol):
 
     ```python
 
-    # Whether the backend perfers SPQRQL queries instead calling the
+    # Whether the backend perfers SPQRQL queries instead of using the
     # triples() method.
     prefer_sparql = True
 

diff --git a/tripper/triplestore.py b/tripper/triplestore.py
@@ -544,6 +544,15 @@ def list_databases(cls, backend: str, **kwargs):
         doc=(
             "Whether the backend prefer SPARQL over the triples() interface. "
             "Is None if not specified by the backend."
+            "\n\n"
+            "Even though Tripper requires that the Triplestore.triples() is "
+            "implemented, we have to use Triplestore.query() for some "
+            "backends in some cases (like fuseki when working on RDF lists) "
+            "because of the issue with blank nodes getting renamed. "
+            "\n\n"
+            "The purpose of this property is to allow a user of tripper to "
+            "automatically select the most appropriate interface depending "
+            "on the current backend."
         ),
     )