Release

.github/workflows/tests.yml

@@ -13,9 +13,9 @@ jobs:
 
     env:
       GRAPHDB_URL: http://localhost:7200
-      GRAPHDB_REPOSITORY: test-repo
       GRAPHDB_USERNAME: admin
       GRAPHDB_PASSWORD: root
+      GRAPHDB_TEST_REPOSITORY: test-repo
 
     services:
       graphdb:
@@ -58,14 +58,14 @@ jobs:
 
     - name: Create test repository
       run: |
-        cat > repo-config.ttl << 'EOF'
+        cat > repo-config.ttl << EOF
         @prefix rep: <http://www.openrdf.org/config/repository#> .
         @prefix sr: <http://www.openrdf.org/config/repository/sail#> .
         @prefix sail: <http://www.openrdf.org/config/sail#> .
         @prefix owlim: <http://www.ontotext.com/trree/owlim#> .
 
         [] a rep:Repository ;
-           rep:repositoryID "test-repo" ;
+           rep:repositoryID "${GRAPHDB_TEST_REPOSITORY}" ;
            rdfs:label "Test Repository" ;
           rep:repositoryImpl [
               rep:repositoryType "graphdb:SailRepository";

graph_db_interface/__init__.py

@@ -1,17 +1,22 @@
 from .sparql_query import SPARQLQuery
 from .graph_db import GraphDB
 from .utils.graph_db_credentials import GraphDBCredentials
+from .utils.iri import IRI
 from .utils.utils import to_literal
 from .utils.processing import process_bindings_select
 from .utils.pretty_print import format_result
 from .kafka.kafka_manager import KafkaManager
+from .utils.xsd_typemap import XSDToPythonTypes, XSDToPythonMapper
 
 __all__ = [
     "GraphDB",
     "GraphDBCredentials",
+    "IRI",
     "SPARQLQuery",
     "to_literal",
     "process_bindings_select",
     "format_result",
     "KafkaManager",
+    "XSDToPythonTypes",
+    "XSDToPythonMapper",
 ]

graph_db_interface/exceptions.py

@@ -1,52 +1,105 @@
 class GraphDBInterfaceError(Exception):
-    """Base class for exceptions in this module."""
+    """
+    Base exception for the GraphDB interface.
+
+    Serves as the common ancestor for all custom exceptions in this
+    package to allow catching them collectively when desired.
+    """
 
     pass
 
 
 class InvalidRepositoryError(GraphDBInterfaceError):
-    """Exception raised for invalid repository."""
+    """
+    Invalid repository configuration or selection.
+
+    Args:
+        message (str): Explanation of why the repository is invalid.
+    """
 
-    def __init__(self, message: str):
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)
 
 
 class AuthenticationError(GraphDBInterfaceError):
-    """Exception raised for authentication errors."""
+    """
+    Authentication failure when communicating with GraphDB.
+
+    Args:
+        message (str): Details about the authentication error.
+    """
 
-    def __init__(self, message: str):
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)
 
 
 class InvalidQueryError(GraphDBInterfaceError):
-    """Exception raised for invalid SPARQL queries."""
+    """
+    Invalid SPARQL query or update string.
 
-    def __init__(self, message: str):
+    Args:
+        message (str): Description of why the query is invalid.
+    """
+
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)
 
 
 class InvalidInputError(GraphDBInterfaceError):
-    """Exception raised for invalid input."""
+    """
+    Invalid input provided to an interface method.
+
+    Args:
+        message (str): Explanation of the invalid input condition.
+    """
 
-    def __init__(self, message: str):
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)
 
 
 class InvalidIRIError(GraphDBInterfaceError):
-    """Exception raised for invalid IRIs."""
+    """
+    Invalid IRI value or format encountered.
 
-    def __init__(self, message: str):
+    Args:
+        message (str): Description of the IRI validation failure.
+    """
+
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)
-        
-        
+
+
 class GraphDbException(GraphDBInterfaceError):
-    """Exception raised for general GraphDB errors."""
-
-    def __init__(self, message: str):
+    """
+    General error raised for HTTP or runtime issues with GraphDB.
+
+    Args:
+        message (str): The error message returned or constructed for the failure.
+    """
+
+    def __init__(
+        self,
+        message: str,
+    ):
         self.message = message
         super().__init__(self.message)