snapquery 0.2.1__tar.gz → 0.2.2__tar.gz

{snapquery-0.2.1 → snapquery-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapquery
-Version: 0.2.1
+Version: 0.2.2
 Summary: Just Query wikidata and other SPARQL endpoints by query name - a frontend to Introduce Named Queries and Named Query Middleware to wikidata and other SPARQL endpoints 
 Project-URL: Home, https://github.com/WolfgangFahl/snapquery
 Project-URL: Documentation, https://wiki.bitplan.com/index.php/snapquery

snapquery-0.2.2/snapquery/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"

{snapquery-0.2.1 → snapquery-0.2.2}/snapquery/samples/endpoints.yaml

@@ -89,6 +89,18 @@ endpoints:
       - wikidata
       - commons
 
+  wikidata-triply:
+    description: TriplyDB mirror.
+    lang: sparql
+    method: POST
+    database: TriplyDB
+    endpoint: https://api.triplydb.com/datasets/wikimedia/wikidata/sparql
+    website: https://triplydb.com/wikimedia/wikidata/sparql
+    calls_per_minute: 30
+    prefix_sets:
+      - rdf
+      - wikidata
+
   wikidata-qlever-dbis:
     description: QLever RWTH Wikidata.
     lang: sparql

{snapquery-0.2.1 → snapquery-0.2.2}/snapquery/version.py

@@ -18,7 +18,7 @@ class Version:
     name = "snapquery"
     version = snapquery.__version__
     date = "2024-05-03"
-    updated = "2025-12-02"
+    updated = "2025-12-03"
     description = "Introduce Named Queries and Named Query Middleware to wikidata"
 
     authors = "Wolfgang Fahl"

snapquery-0.2.2/tests/action_stats.py

@@ -0,0 +1,43 @@
+"""
+Created on 2025-11-23
+
+@author: wf
+"""
+
+
+class ActionStats:
+    """Helper class to track success rates of actions."""
+
+    def __init__(self):
+        self.success_count = 0
+        self.total_count = 0
+        self.current = None
+
+    def add(self, is_success: bool):
+        """adds a single result."""
+        self.current = is_success
+        self.total_count += 1
+        if is_success:
+            self.success_count += 1
+
+    @property
+    def ratio(self) -> float:
+        """Returns the success/total ratio."""
+        ratio = self.success_count / self.total_count if self.total_count > 0 else 0.0
+        return ratio
+
+    def state(self, success_msg, fail_msg) -> str:
+        """
+        return the current state
+        """
+        if self.current:
+            msg = f"✅{success_msg}"
+        else:
+            msg = f"❌: {fail_msg}"
+        return msg
+
+    def __str__(self):
+        """Returns the formatted summary string."""
+        marker = "❌ " if self.success_count < self.total_count else "✅"
+        text = f"{marker}:{self.success_count}/{self.total_count} available"
+        return text

snapquery-0.2.2/tests/test_endpoints.py

@@ -0,0 +1,83 @@
+"""
+Created on 2024-05-03
+ActionStats integrated with Grok4 Free suppport on 2025-12-03
+
+@author: wf
+"""
+
+import requests
+from basemkit.basetest import Basetest
+from lodstorage.sparql import SPARQL
+
+from snapquery.snapquery_core import NamedQueryManager
+from tests.action_stats import ActionStats
+
+
+class TestEndpoints(Basetest):
+    """
+    test endpoint handling according to https://github.com/WolfgangFahl/snapquery/issues/1
+    """
+
+    def setUp(self, debug=True, profile=True):
+        Basetest.setUp(self, debug=debug, profile=profile)
+        self.nqm = NamedQueryManager()
+        self.user_agent = "snapquery-test/1.0 (https://github.com/WolfgangFahl/snapquery)"
+        self.timeout = 10
+        self.minRatio= 0.8
+
+    def testEndpoints(self):
+        """
+        test the endpoint handling
+        """
+        ep_names = list(self.nqm.endpoints.keys())
+        if self.debug:
+            print(ep_names)
+        self.assertGreater(len(ep_names), 0)
+        self.assertIn("wikidata", ep_names)
+
+    def test_website_availability(self):
+        """
+        Test website availability for endpoints (HTTP 200).
+        """
+        stats = ActionStats()
+        for ep in self.nqm.endpoints.values():
+            try:
+                self.assertTrue(hasattr(ep, "website"))
+                resp = requests.get(ep.website, headers={"User-Agent": self.user_agent}, timeout=self.timeout)
+                is_success = (resp.status_code == 200)
+                stats.add(is_success)
+                if self.debug:
+                    if is_success:
+                        print(f"✅ {ep.name} website OK: {ep.website}")
+                    else:
+                        print(f"❌ {ep.name} website failed: {ep.website} (status: {resp.status_code})")
+            except Exception as e:
+                stats.add(False)
+                if self.debug:
+                    print(f"❌ {ep.name} website exception: {str(e)}")
+        msg = f"Websites availability {stats} ({stats.ratio:.1%}), need >=60%"
+        self.assertGreaterEqual(stats.ratio, self.minRatio, msg)
+        if self.debug:
+            print(f"SUMMARY websites: {stats}")
+
+    def test_sparql_availability(self):
+        """
+        Test SPARQL endpoint availability with dummy query: SELECT * WHERE {?s ?p ?o} LIMIT 1.
+        """
+        dummy_query = "SELECT * WHERE { ?s ?p ?o. } LIMIT 1"
+        stats = ActionStats()
+        for ep in self.nqm.endpoints.values():
+            try:
+                sparql = SPARQL.fromEndpointConf(ep)
+                lod = sparql.queryAsListOfDicts(dummy_query)
+                stats.add(True)
+                if self.debug:
+                    print(f"✅ {ep.name} SPARQL OK: {len(lod)} rows from {ep.endpoint}")
+            except Exception as e:
+                stats.add(False)
+                if self.debug:
+                    print(f"❌ {ep.name} SPARQL failed: {ep.endpoint} ({str(e)})")
+        msg = f"SPARQL availability {stats} ({stats.ratio:.1%}), need >=60%"
+        self.assertGreaterEqual(stats.ratio, self.minRatio, msg)
+        if self.debug:
+            print(f"SUMMARY SPARQL: {stats}")

snapquery-0.2.1/snapquery/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.1"

snapquery-0.2.1/tests/test_endpoints.py

@@ -1,61 +0,0 @@
-"""
-Created on 2024-05-03
-
-@author: wf
-"""
-
-import requests
-from basemkit.basetest import Basetest
-from lodstorage.sparql import SPARQL
-
-from snapquery.snapquery_core import NamedQueryManager
-
-
-class TestEndpoints(Basetest):
-    """
-    test endpoint handling according to https://github.com/WolfgangFahl/snapquery/issues/1
-    """
-
-    def setUp(self, debug=True, profile=True):
-        Basetest.setUp(self, debug=debug, profile=profile)
-        self.nqm = NamedQueryManager()
-        self.user_agent = "snapquery-test/1.0 (https://github.com/WolfgangFahl/snapquery)"
-        self.timeout = 10
-
-    def testEndpoints(self):
-        """
-        test the endpoint handling
-        """
-        ep_names = self.nqm.endpoints.keys()
-        if self.debug:
-            print(ep_names)
-        self.assertTrue("wikidata" in ep_names)
-        pass
-
-    def test_website_availability(self):
-        """
-        Test website availability forendpoints (HTTP 200).
-        """
-        for ep in self.nqm.endpoints.values():
-            self.assertTrue(hasattr(ep, "website"))
-            resp = requests.get(ep.website, headers={"User-Agent": self.user_agent}, timeout=self.timeout)
-            self.assertEqual(
-                resp.status_code, 200, f"Website {ep.website} for {ep.name} unavailable (status: {resp.status_code})"
-            )
-            if self.debug:
-                print(f"✅ {ep.name} website OK: {ep.website}")
-
-    def test_sparql_availability(self):
-        """
-        Test SPARQL endpoint availability with dummy query: SELECT * WHERE {?s ?p ?o} LIMIT 1.
-        """
-        dummy_query = "SELECT * WHERE { ?s ?p ?o. } LIMIT 1"
-        for ep in self.nqm.endpoints.values():
-            try:
-                sparql = SPARQL.fromEndpointConf(ep)
-                lod = sparql.queryAsListOfDicts(dummy_query)
-                self.assertGreaterEqual(len(lod), 0, f"SPARQL {ep.endpoint} for {ep.name} returned no results")
-                if self.debug:
-                    print(f"✅ {ep.name} SPARQL OK: {len(lod)} rows from {ep.endpoint}")
-            except Exception as e:
-                self.fail(f"SPARQL check failed for {ep.name}: {str(e)}")