1.0.0.0 code

Author: Marco Ratta

pyproject.toml

@@ -15,7 +15,8 @@ keywords = [
     "rdflib",
     "sematic web",
     "knowledge graphs",
-    "linked data"
+    "linked data",
+    "networkx"
 ]
 authors = [
   {name = "Marco Ratta", email = "marco.ratta1@open.ac.uk"},

src/pysparql_anything/__init__.py

@@ -2,14 +2,16 @@
 Manages the package's namespace, helps the installation process of the API.
 
 Author: Marco Ratta
-Date: 16/12/2023
+Last Modified: 23/06/2025
 """
 
 import requests
 from github import Github
 from github.GithubException import RateLimitExceededException
 from pysparql_anything import utilities
-from pysparql_anything.__about__ import __SparqlAnything__, __uri__, __version__
+from pysparql_anything.__about__ import (
+     __SparqlAnything__, __uri__, __version__
+)
 
 # Checks if SPARQL Anything is not installed. Installs it if so.
 try:
@@ -33,5 +35,9 @@
     print(f' A {type(exc)} exception has been raised. \n'
           + 'Installation unsuccessful!!!')
     raise
+
 # Launches the JVM
-from pysparql_anything.sparql_anything import SparqlAnything
+import pysparql_anything.sparql_anything
+
+# Type Aliases
+SparqlAnything = pysparql_anything.sparql_anything.SparqlAnything

src/pysparql_anything/cli.py

@@ -1,15 +1,17 @@
 """
 This module contains the CLI for the SPARQL Anything tool.
 
-Author: Marco ratta
-Date: 18/06/2025
+Author: Marco Ratta
+Last Modified: 23/06/2025
 """
 
 from argparse import ArgumentParser, SUPPRESS
 from pysparql_anything.args_handlers import transform_cli_args
 from pysparql_anything.sparql_anything_reflection import (
     SPARQLAnythingReflection
 )
+from pysparql_anything.__about__ import __SparqlAnything__
+from pysparql_anything.utilities import remove_jar
 
 
 def setup_parser(a_parser: ArgumentParser) -> ArgumentParser:
@@ -91,6 +93,9 @@ def setup_parser(a_parser: ArgumentParser) -> ArgumentParser:
     a_parser.add_argument(
         "-e", "--explain", help="OPTIONAL - Explain query execution"
     )
+    a_parser.add_argument(
+        "--uninstall", help="Uninstalls PySPARQL-Anything from the system."
+    )
     return a_parser
 
 
@@ -105,7 +110,12 @@ def main() -> None:
     parser = setup_parser(parser)
     # Process the arguments for the Java main class.
     args = parser.parse_args()
-    java_args = transform_cli_args(args)
-    # Run the query
-    sa = SPARQLAnythingReflection(java_args[0])
-    sa.main(java_args[1])
+    if 'uninstall' in args:
+        print(f'Uninstalling SPARQL-Anything {__SparqlAnything__} JAR.')
+        remove_jar()
+        print(f"SPARQL Anything {__SparqlAnything__} JAR sucessfully removed.")
+    else:
+        java_args = transform_cli_args(args)
+        # Run the query
+        sa = SPARQLAnythingReflection(java_args[0])
+        sa.main(java_args[1])

src/pysparql_anything/sparql_anything_reflection.py

@@ -5,7 +5,7 @@
 to Python users.
 
 Author: Marco Ratta
-Date: 18/12/2023
+Last Modified: 22/06/2025
 """
 
 from collections.abc import Sequence
@@ -57,7 +57,7 @@ def __init__(
             self.System = autoclass("java.lang.System")
             # Redirect Java STDERR
             self.err_bs = self.BAOS()
-            self.err_ps = self.PrintStream(self.err_bs, False)
+            self.err_ps = self.PrintStream(self.err_bs, True)
             self.System.setErr(self.err_ps)
             # Create the SPARQLAnything class object
             self.reflection = autoclass(__jarMainPath__)
@@ -98,13 +98,17 @@ def call_main(self, args: list[str]) -> SPARQLAnythingQueryOutput:
         """
         # Capture STDOUT locally
         baos = self.BAOS()
-        ps = self.PrintStream(baos, False)
+        ps = self.PrintStream(baos, True)
         old_ps = self.System.out
         self.System.setOut(ps)
         # Call Sparql Anything main method
-        self.reflection.main(args)
+        try:
+            self.reflection.main(args)
+        except Exception as e:
+            self.System.setOut(old_ps)
+            self.err_bs.reset()
+            raise e
         # Put things back
-        self.System.out.flush()
         self.System.setOut(old_ps)
         # Convert streams to strings
         sa_output = baos.toString()

src/pysparql_anything/utilities.py

@@ -4,7 +4,7 @@
 Interacts with the SPARQL Anything GitHub repository.
 
 Author: Marco Ratta
-Date: 29/02/2024
+Last Modified: 23/06/2025
 """
 
 import os
@@ -28,7 +28,7 @@ def has_jar():
     return False
 
 
-def get_release_uri(ghub: Github, uri: str, version: str) -> str:
+def get_release_url(ghub: Github, uri: str, version: str) -> str:
     """
     Retrieves the download url for latest SPARQL Anything release.\n
     Args:\n
@@ -43,12 +43,12 @@ def get_release_uri(ghub: Github, uri: str, version: str) -> str:
     """
     try:
         repo = ghub.get_repo(uri)
-        release  = repo.get_release(version)
-        jar = None
+        release = repo.get_release(version)
+        url = ""
         for asset in release.assets:
             if asset.name == f'sparql-anything-{version}.jar':
-                jar = asset
-        return jar.browser_download_url
+                url = asset.browser_download_url
+        return url
     except RateLimitExceededException as exc:
         print('WARNING !!! get_release_url() raised a '
               + f'{type(exc)} exception and passed it on.')
@@ -73,7 +73,7 @@ def download_sparql_anything(ghub: Github, uri: str, version: str) -> None:
         path2jar = os.path.join(
             get_module_path(), f'sparql-anything-{version}.jar'
         )
-        dl_link = get_release_uri(ghub, uri, version)
+        dl_link = get_release_url(ghub, uri, version)
         request = requests.get(dl_link, stream=True, timeout=10.0)
         length = int(request.headers.get('content-length', 0))
         with open(path2jar, 'wb') as jar:
@@ -123,16 +123,13 @@ def get_path2jar():
     return path
 
 
-def remove_sparql_anything():
+def remove_jar():
     """
     Removes the SPARQL Anything jar from the installation folder.\n
     Raises:\n
         FileNotFoundError.
     """
     try:
         os.remove(get_path2jar())
-        print("SPARQL Anything sucessfully removed")
     except FileNotFoundError as err:
-        print('WARNING !!! remove_sparql_anything() raised a '
-              + f'{type(err)} exception and re-raised it.')
-        raise
+        raise err