snapquery 0.1.0__tar.gz → 0.2.0__tar.gz

{snapquery-0.1.0 → snapquery-0.2.0}/.github/workflows/build.yml

@@ -19,7 +19,7 @@ jobs:
     strategy:
       matrix:
         #os: [ubuntu-latest, macos-latest, windows-latest]
-        #python-version: [ '3.9', '3.10', '3.11', '3.12' ]
+        #python-version: [ '3.10', '3.11', '3.12', '3.13' ]
         # simplified build matrix to avoid rate limits
         os: [ubuntu-latest]
         python-version: ['3.11']

{snapquery-0.1.0 → snapquery-0.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: snapquery
-Version: 0.1.0
-Summary: snapquery: Introduce Named Queries and Named Query Middleware to wikidata
+Version: 0.2.0
+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
 Project-URL: Source, https://github.com/WolfgangFahl/snapquery
@@ -26,13 +26,14 @@ Classifier: Topic :: Software Development :: User Interfaces
 Requires-Python: >=3.10
 Requires-Dist: mwoauth>=0.4.0
 Requires-Dist: nameparser>=1.1.3
-Requires-Dist: ngwidgets>=0.28.0
-Requires-Dist: nicegui[plotly]
-Requires-Dist: py-3rdparty-mediawiki>=0.15.4
-Requires-Dist: py-ez-wikidata>=0.3.1
-Requires-Dist: pybasemkit>=0.0.3
-Requires-Dist: pylodstorage>=0.16.4
-Requires-Dist: pyopensourceprojects>=0.1.2
+Requires-Dist: ngwidgets>=0.30.0
+Requires-Dist: nicegui[plotly]==2.24.2
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: py-3rdparty-mediawiki>=0.18.1
+Requires-Dist: py-ez-wikidata>=0.3.2
+Requires-Dist: pybasemkit>=0.1.3
+Requires-Dist: pylodstorage>=0.18.5
+Requires-Dist: pyopensourceprojects>=0.3.0
 Requires-Dist: python-slugify>=8.0.4
 Requires-Dist: ratelimit>=2.2.1
 Requires-Dist: requests
@@ -56,14 +57,14 @@ comparison across various backends and over time.
 This tool is designed to assist users in curating and collaborating on queries, ensuring their continued functionality
 over time. Developers and data consumers can access data conveniently through APIs, streamlining their workflow.
 
+| | |
+  | :--- | :--- |
+  | **PyPi** | [![PyPI Status](https://img.shields.io/pypi/v/snapquery.svg)](https://pypi.python.org/pypi/snapquery/) [![License](https://img.shields.io/github/license/WolfgangFahl/snapquery.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![pypi](https://img.shields.io/pypi/pyversions/snapquery)](https://pypi.org/project/snapquery/) [![format](https://img.shields.io/pypi/format/snapquery)](https://pypi.org/project/snapquery/) [![downloads](https://img.shields.io/pypi/dd/snapquery)](https://pypi.org/project/snapquery/) |
+  | **GitHub** | [![Github Actions Build](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml) [![Release](https://img.shields.io/github/v/release/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/releases) [![Contributors](https://img.shields.io/github/contributors/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/graphs/contributors) [![Last Commit](https://img.shields.io/github/last-commit/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/commits/) [![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues) [![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues/?q=is%3Aissue+is%3Aclosed) |
+  | **Code** | [![style-black](https://img.shields.io/badge/%20style-black-000000.svg)](https://github.com/psf/black) [![imports-isort](https://img.shields.io/badge/%20imports-isort-%231674b1)](https://pycqa.github.io/isort/) |
+  | **Docs** | [![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/snapquery/) [![formatter-docformatter](https://img.shields.io/badge/%20formatter-docformatter-fedcba.svg)](https://github.com/PyCQA/docformatter) [![style-google](https://img.shields.io/badge/%20style-google-3666d6.svg)](https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings) |
+
 [![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions)
-[![pypi](https://img.shields.io/pypi/pyversions/snapquery)](https://pypi.org/project/snapquery/)
-[![Github Actions Build](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml)
-[![PyPI Status](https://img.shields.io/pypi/v/snapquery.svg)](https://pypi.python.org/pypi/snapquery/)
-[![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues)
-[![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues/?q=is%3Aissue+is%3Aclosed)
-[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/snapquery/)
-[![License](https://img.shields.io/github/license/WolfgangFahl/snapquery.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 ## Demos
 
 * [wikimedia toolhub](https://toolhub.wikimedia.org/tools/snapquery)

{snapquery-0.1.0 → snapquery-0.2.0}/README.md

@@ -12,14 +12,14 @@ comparison across various backends and over time.
 This tool is designed to assist users in curating and collaborating on queries, ensuring their continued functionality
 over time. Developers and data consumers can access data conveniently through APIs, streamlining their workflow.
 
+| | |
+  | :--- | :--- |
+  | **PyPi** | [![PyPI Status](https://img.shields.io/pypi/v/snapquery.svg)](https://pypi.python.org/pypi/snapquery/) [![License](https://img.shields.io/github/license/WolfgangFahl/snapquery.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![pypi](https://img.shields.io/pypi/pyversions/snapquery)](https://pypi.org/project/snapquery/) [![format](https://img.shields.io/pypi/format/snapquery)](https://pypi.org/project/snapquery/) [![downloads](https://img.shields.io/pypi/dd/snapquery)](https://pypi.org/project/snapquery/) |
+  | **GitHub** | [![Github Actions Build](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml) [![Release](https://img.shields.io/github/v/release/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/releases) [![Contributors](https://img.shields.io/github/contributors/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/graphs/contributors) [![Last Commit](https://img.shields.io/github/last-commit/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/commits/) [![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues) [![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues/?q=is%3Aissue+is%3Aclosed) |
+  | **Code** | [![style-black](https://img.shields.io/badge/%20style-black-000000.svg)](https://github.com/psf/black) [![imports-isort](https://img.shields.io/badge/%20imports-isort-%231674b1)](https://pycqa.github.io/isort/) |
+  | **Docs** | [![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/snapquery/) [![formatter-docformatter](https://img.shields.io/badge/%20formatter-docformatter-fedcba.svg)](https://github.com/PyCQA/docformatter) [![style-google](https://img.shields.io/badge/%20style-google-3666d6.svg)](https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings) |
+
 [![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions)
-[![pypi](https://img.shields.io/pypi/pyversions/snapquery)](https://pypi.org/project/snapquery/)
-[![Github Actions Build](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/snapquery/actions/workflows/build.yml)
-[![PyPI Status](https://img.shields.io/pypi/v/snapquery.svg)](https://pypi.python.org/pypi/snapquery/)
-[![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues)
-[![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/snapquery.svg)](https://github.com/WolfgangFahl/snapquery/issues/?q=is%3Aissue+is%3Aclosed)
-[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/snapquery/)
-[![License](https://img.shields.io/github/license/WolfgangFahl/snapquery.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 ## Demos
 
 * [wikimedia toolhub](https://toolhub.wikimedia.org/tools/snapquery)

{snapquery-0.1.0 → snapquery-0.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "snapquery"
-description = "snapquery: Introduce Named Queries and Named Query Middleware to wikidata"
+description = "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 "
 keywords = [ "nicegui", "wikidata","SPARQL","query","middleware","qlever","blazegraph"]
 home-page = "https://github.com/WolfgangFahl/snapquery"
 authors = [
@@ -22,13 +22,13 @@ dependencies = [
 	# https://pypi.org/project/pybasemkit/
 	# https://github.com/WolfgangFahl/pybasemkit
 	# Python base module kit: YAML/JSON I/O, structured logging, CLI tooling, shell execution, and remote pydevd debug support.
-	"pybasemkit>=0.0.3",
+	"pybasemkit>=0.1.3",
 	# https://github.com/WolfgangFahl/nicegui_widgets
-	"ngwidgets>=0.28.0",
+	"ngwidgets>=0.30.0",
     # https://pypi.org/project/pyLodStorage/
-    "pyLodStorage>=0.16.4",
+    "pyLodStorage>=0.18.5",
     # https://pypi.org/project/py-3rdparty-mediawiki/
-    "py-3rdparty-mediawiki>=0.15.4",
+    "py-3rdparty-mediawiki>=0.18.1",
     "wikitextparser",
     "requests",
     # https://pypi.org/project/python-slugify/
@@ -40,14 +40,18 @@ dependencies = [
     #"mwoauth@git+https://github.com/mediawiki-utilities/python-mwoauth"
     #https://pypi.org/project/tqdm/
     "tqdm>=4.66.4",
-    "nicegui[plotly]",
+    #https://pypi.org/project/pandas/
+    "pandas>=2.3.3",
+    # https://pypi.org/project/nicegui/
+    # force pin of nicegui
+    "nicegui[plotly]==2.24.2",
     # py_ez_wikidata
     # https://github.com/WolfgangFahl/py_ez_wikidata
-    "py_ez_wikidata>=0.3.1",
+    "py_ez_wikidata>=0.3.2",
     # https://pypi.org/project/nameparser/
     "nameparser>=1.1.3",
     # https://github.com/WolfgangFahl/pyOpenSourceProjects
-    "pyOpenSourceProjects>=0.1.2"
+    "pyOpenSourceProjects>=0.3.0"
 ]
 
 requires-python = ">=3.10"

snapquery-0.2.0/snapquery/__init__.py

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

{snapquery-0.1.0 → snapquery-0.2.0}/snapquery/authorization.py

@@ -16,6 +16,7 @@ class UserRights:
     """
     the rights of a single user
     """
+
     name: str
     rights: str
 
@@ -25,10 +26,11 @@ class Authorization:
     """
     Authorization check.
     """
-    user_rights: dict[str,UserRights] = field(default_factory=dict)
+
+    user_rights: dict[str, UserRights] = field(default_factory=dict)
 
     @classmethod
-    def load(cls,yaml_path:str=None) -> "Authorization":
+    def load(cls, yaml_path: str = None) -> "Authorization":
         """
         Load user rights from a YAML file, ensuring the file exists.
         """
@@ -49,4 +51,4 @@ class Authorization:
         if user_right is None:
             return False
         ok = rights in user_right.rights
-        return ok
+        return ok

snapquery-0.2.0/snapquery/github_access.py

@@ -0,0 +1,46 @@
+"""
+GitHub API client for accessing repository contents.
+
+Created on 2025-12-02
+@author: wf
+"""
+import requests
+
+class GitHub:
+    """
+    A simple GitHub API client for accessing repository contents.
+    """
+
+    def __init__(self, owner: str, repo: str, token: str = None):
+        """
+        Initialize GitHub client.
+
+        Args:
+            owner: Repository owner (username or organization)
+            repo: Repository name
+            token: Optional GitHub API token for authentication
+        """
+        self.owner = owner
+        self.repo = repo
+        self.token = token
+        self.base_url = f"https://api.github.com/repos/{owner}/{repo}"
+
+    def get_contents(self, path: str = ""):
+        """
+        Get contents of a directory or file from the repository.
+
+        Args:
+            path: Path within the repository
+
+        Returns:
+            List of dictionaries for directories, or content for files
+        """
+        url = f"{self.base_url}/contents/{path}"
+        headers = {"Accept": "application/vnd.github.v3+json"}
+
+        if self.token:
+            headers["Authorization"] = f"token {self.token}"
+
+        response = requests.get(url, headers=headers)
+        response.raise_for_status()
+        return response.json()

snapquery-0.2.0/snapquery/prefix_merger.py

@@ -0,0 +1,99 @@
+"""
+Created 2024
+
+@author: tholzheim
+
+Move to separate module in 2025-12-01 by wf
+"""
+
+import logging
+from enum import Enum
+
+from lodstorage.prefix_config import PrefixConfigs
+from lodstorage.prefixes import Prefixes
+from lodstorage.query import Endpoint, Query
+
+from snapquery.sparql_analyzer import SparqlAnalyzer
+
+
+class QueryPrefixMerger(Enum):
+    """
+    SPARQL Query prefix merger
+    """
+
+    RAW = "raw"
+    SIMPLE_MERGER = "simple merger"
+    ANALYSIS_MERGER = "analysis merger"
+
+    @classmethod
+    def _missing_(cls, key):
+        logging.warning(f"Invalid QueryPrefixMerger key: {key}, defaulting to SIMPLE_MERGER")
+        merger = cls.default_merger()
+        return merger
+
+    @classmethod
+    def default_merger(cls) -> "QueryPrefixMerger":
+        merger = cls.SIMPLE_MERGER
+        return merger
+
+    @classmethod
+    def get_by_name(cls, name: str) -> "QueryPrefixMerger":
+        merger_map = {merger.name: merger.value for merger in QueryPrefixMerger}
+        merger_value = merger_map.get(name, None)
+        merger = QueryPrefixMerger(merger_value)
+        return merger
+
+    @classmethod
+    def merge_prefixes(
+        cls,
+        query: Query,
+        endpoint: Endpoint,
+        merger: "QueryPrefixMerger",
+    ) -> str:
+        """
+        Merge prefixes with the given merger
+        Args:
+            query (Query):
+            endpoint (Endpoint):
+            merger (QueryPrefixMerger):
+
+        Returns:
+            merged query
+        """
+        sparql_query = query.query
+        if merger == QueryPrefixMerger.SIMPLE_MERGER:
+            sparql_query = cls.simple_prefix_merger(sparql_query, endpoint)
+        elif merger == QueryPrefixMerger.ANALYSIS_MERGER:
+            sparql_query = cls.analysis_prefix_merger(sparql_query)
+        return sparql_query
+
+    @classmethod
+    def simple_prefix_merger(cls, query_str: str, endpoint: Endpoint) -> str:
+        """
+        Simple prefix merger
+        Args:
+            query_str (str): the query string
+            endpoint (Endpoint): the endpoint
+
+        Returns:
+            merged query
+        """
+        prefixes_str = endpoint.get_prefixes(PrefixConfigs.get_instance())
+        if not prefixes_str.strip():
+            return
+
+        merged_query = Prefixes.merge_prefixes(query_str, prefixes_str)
+        return merged_query
+
+    @classmethod
+    def analysis_prefix_merger(cls, query_str: str) -> str:
+        """
+        Analysis prefix merger
+        Args:
+            query_str
+
+        Returns:
+            merged query
+        """
+        merged_query = SparqlAnalyzer.add_missing_prefixes(query_str)
+        return merged_query

{snapquery-0.1.0 → snapquery-0.2.0}/snapquery/qimport.py

@@ -5,12 +5,11 @@ Created on 2024-05-05
 """
 
 import glob
-import json
 import os
 
 from tqdm import tqdm
 
-from snapquery.snapquery_core import NamedQueryManager, NamedQuerySet, NamedQuery
+from snapquery.snapquery_core import NamedQuery, NamedQueryManager, NamedQuerySet
 from snapquery.wd_short_url import ShortUrl
 
 
@@ -63,7 +62,7 @@ class QueryImport:
         Returns:
             NamedQuerySet: A NamedQuerySet object containing the imported NamedQuery objects.
         """
-        nq_set = NamedQuerySet.load_from_json_file(json_file)
+        nq_set = NamedQuerySet.load_from_json_file(json_file) # @UndefinedVariable
         iterable = (
             tqdm(
                 nq_set.queries,
@@ -90,7 +89,7 @@ class QueryImport:
         self,
         short_url: ShortUrl,
         domain: str,
-        namespace:str,
+        namespace: str,
     ) -> NamedQuery | None:
         """
         Read and process a single short URL, optionally enriching it with LLM-generated metadata.

{snapquery-0.1.0 → snapquery-0.2.0}/snapquery/qimport_view.py

@@ -5,14 +5,15 @@ Created on 2024-05-05
 """
 
 from lodstorage.query import Query, QuerySyntaxHighlight
-from nicegui import ui, background_tasks
+from nicegui import background_tasks, ui
 
 from snapquery.models.person import Person
+from snapquery.person_selector import PersonSelector, PersonView
 from snapquery.qimport import QueryImport
 from snapquery.snapquery_core import NamedQuery
-from snapquery.person_selector import PersonSelector, PersonView
 from snapquery.wd_short_url import ShortUrl
 
+
 class QueryImportView:
     """
     display Query Import UI
@@ -24,7 +25,7 @@ class QueryImportView:
     ):
         self.person = None
         self.solution = solution
-        self.domain="wikidata.org"
+        self.domain = "wikidata.org"
         self.namespace = "short_url"
         self.name = ""
         self.url = ""
@@ -32,12 +33,12 @@ class QueryImportView:
         self.description = ""
         self.comment = ""
         self.query = None
-        self.allow_importing_from_url=self.solution.user_has_llm_right
+        self.allow_importing_from_url = self.solution.user_has_llm_right
         if self.solution:
             self.qimport = QueryImport()
             self.nqm = self.solution.nqm
 
-    def on_select_person(self,person: Person=None):
+    def on_select_person(self, person: Person = None):
         """
         react on a person having been selected
 

{snapquery-0.1.0 → snapquery-0.2.0}/snapquery/qlever.py

@@ -30,12 +30,11 @@ class QLeverUrl(ShortUrl):
         Returns:
             str: The SPARQL query extracted from the short URL.
         """
-        self.fetch_final_url()
+        self.fetch_final_url(self.short_url)
         if self.url:
             try:
-                response = requests.get(self.url)
-                response.raise_for_status()
-                soup = BeautifulSoup(response.content, "html.parser")
+                text=self.get_wikitext(self.url)
+                soup = BeautifulSoup(text, "html.parser")
                 query_element = soup.find("textarea", {"id": "query"})
                 if query_element and query_element.text:
                     self.sparql = query_element.text.strip()

{snapquery-0.1.0 → snapquery-0.2.0}/snapquery/query_annotate.py

@@ -9,9 +9,9 @@ import re
 from pathlib import Path
 from typing import Optional
 
+from basemkit.yamlable import lod_storable
 from bs4 import BeautifulSoup, ResultSet
 from lodstorage.query import Query, QuerySyntaxHighlight
-from basemkit.yamlable import lod_storable
 
 from snapquery.models.sparql_components import SPARQLLanguage
 
@@ -248,6 +248,4 @@ class FunctionStat:
     count: int = 0
 
 
-QUERY_ITEM_STATS: Stats = Stats.load_from_yaml_file(
-    Path(__file__).parent.joinpath("samples", "query_stats.yaml")
-)
+QUERY_ITEM_STATS: Stats = Stats.load_from_yaml_file(Path(__file__).parent.joinpath("samples", "query_stats.yaml"))

snapquery-0.2.0/snapquery/samples/endpoints.yaml

@@ -0,0 +1,103 @@
+# Default SPARQL endpoints for snapquery tool
+# 2022-02-14 tholzheim
+# 2025-12-01 new format with prefix-sets
+endpoints:
+  wikidata:
+    description: |
+      Wikimedia Wikidata Query Service (legacy full).
+      Stable but high-load; prefer -main/-scholarly.
+    lang: sparql
+    endpoint: https://query.wikidata.org/sparql
+    website: https://query.wikidata.org
+    database: blazegraph
+    method: POST
+    calls_per_minute: 30
+    auto_update: true
+    data_seeded: 2012-10-29
+    uptime_days: 4500
+    mtriples: 22000
+    prefix_sets:
+      - rdf
+      - wikidata
+      - blazegraph
+      - commons
+
+  wikidata-main:
+    description: WDQS Graph Split — main (non-scholarly).
+    lang: sparql
+    endpoint: https://query-main.wikidata.org/sparql
+    website: https://query-main.wikidata.org/
+    database: blazegraph
+    method: POST
+    calls_per_minute: 30
+    auto_update: true
+    data_seeded: 2025-01-01
+    uptime_days: 200
+    mtriples: 8580
+    prefix_sets:
+      - rdf
+      - wikidata
+      - blazegraph
+      - commons
+
+  wikidata-scholarly:
+    description: WDQS Graph Split — scholarly.
+    lang: sparql
+    endpoint: https://query-scholarly.wikidata.org/sparql
+    website: https://query-scholarly.wikidata.org/
+    database: blazegraph
+    method: POST
+    calls_per_minute: 30
+    auto_update: true
+    data_seeded: 2025-01-01
+    uptime_days: 200
+    mtriples: 8730
+    prefix_sets:
+      - rdf
+      - wikidata
+      - blazegraph
+      - commons
+
+  wikidata-dbis:
+    description: RWTH Aachen full Wikidata mirror (stable).
+    lang: sparql
+    endpoint: https://wdqs.wikidata.dbis.rwth-aachen.de/sparql
+    website: https://wdqs.wikidata.dbis.rwth-aachen.de/
+    database: blazegraph
+    method: POST
+    calls_per_minute: 30
+    auto_update: false
+    data_seeded: 2025-06-01
+    uptime_days: 1
+    mtriples: 17029
+    prefix_sets:
+      - rdf
+      - wikidata
+      - blazegraph
+      - commons
+
+  dblp:
+    description: DBLP official (qlever - reliable).
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://sparql.dblp.org/sparql
+    website: https://sparql.dblp.org
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - dblp
+      - datacite
+      - litre
+
+  gov:
+    description: GOV Genealogy (stable).
+    lang: sparql
+    endpoint: https://gov-sparql.genealogy.net/dataset/sparql
+    website: https://gov-sparql.genealogy.net/
+    database: gov-genealogy
+    method: POST
+    calls_per_minute: 30
+    prefix_sets:
+      - rdf
+      - gov

snapquery-0.2.0/snapquery/samples/endpoints_optional.yaml

@@ -0,0 +1,98 @@
+# Optional SPARQL endpoints for snapquery
+# WF 2025-12-01 - new format
+# state nees to be checked
+endpoints:
+  wikidata-openlinksw:
+    description: OpenLink Virtuoso demo (unstable).
+    lang: sparql
+    endpoint: https://wikidata.demo.openlinksw.com/sparql
+    website: https://wikidata.demo.openlinksw.com/sparql
+    database: virtuoso
+    method: POST
+    calls_per_minute: 20
+    prefix_sets:
+      - rdf
+      - wikidata
+
+  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:
+    description: QLever Freiburg Wikidata.
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://qlever.cs.uni-freiburg.de/api/wikidata
+    website: https://qlever.cs.uni-freiburg.de/wikidata
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - wikidata
+      - commons
+
+  wikidata-qlever-dbis:
+    description: QLever RWTH Wikidata.
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://qlever-api.wikidata.dbis.rwth-aachen.de/
+    website: https://qlever.wikidata.dbis.rwth-aachen.de/wikidata
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - wikidata
+
+  wikidata-scatter:
+    description: Scatter experimental.
+    lang: sparql
+    endpoint: https://query-direct2.orbopengraph.com/bigdata/namespace/wdq/sparql
+    website: https://scatter.red/
+    database: blazegraph
+    method: GET
+    calls_per_minute: 20
+    prefix_sets:
+      - rdf
+      - wikidata
+
+  orkg:
+    description: ORKG (rate-limited).
+    lang: sparql
+    endpoint: https://orkg.org/triplestore
+    website: https://orkg.org/sparql
+    database: virtuoso
+    prefix_sets:
+      - rdf
+      - orkg
+
+  dblp-qlever:
+    description: DBLP QLever Freiburg.
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://qlever.cs.uni-freiburg.de/api/dblp
+    website: https://qlever.cs.uni-freiburg.de/dblp
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - dblp
+
+  dblp-trier:
+    description: DBLP Trier mirror.
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://archimedes.uni-trier.de/sparql
+    website: https://archimedes.uni-trier.de
+    calls_per_minute: 30
+    prefix_sets:
+      - rdf
+      - dblp