snapquery 0.1.0__tar.gz → 0.2.1__tar.gz

{snapquery-0.1.0 → snapquery-0.2.1}/.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.1}/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.1
+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.1}/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.1}/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.1/snapquery/__init__.py

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

{snapquery-0.1.0 → snapquery-0.2.1}/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.1/snapquery/github_access.py

@@ -0,0 +1,119 @@
+"""
+GitHub API client for accessing repository contents.
+
+Created on 2025-12-02
+@author: wf
+"""
+import json
+from  pathlib import Path
+from typing import List, Dict, Any, Optional, Union
+
+import requests
+
+
+class GitHub:
+    """
+    A simple GitHub API client for accessing repository contents.
+    """
+
+    def __init__(self, owner: str, repo: str, token: Optional[str] = None, session: Optional[requests.Session] = None):
+        """
+        Initialize GitHub client.
+
+        Args:
+            owner: Repository owner (username or organization)
+            repo: Repository name
+            token: Optional GitHub API token for authentication
+            session: Optional custom requests.Session
+        """
+        self.owner = owner
+        self.repo = repo
+        self.token = token
+        self.base_url = f"https://api.github.com/repos/{owner}/{repo}"
+        # Use provided token or read from file (compatible with GitHubApi)
+        self.token = token if token is not None else self._read_token()
+
+        # Use custom session or create new one
+        self.session = session or requests.Session()
+
+
+
+    def _headers(self) -> Dict[str, str]:
+        headers = {"Accept": "application/vnd.github.v3+json"}
+        if self.token:
+            headers["Authorization"] = f"token {self.token}"
+        return headers
+
+    def _read_token(self) -> Optional[str]:
+        """
+        Read GitHub token from ~/.github/access_token.json
+        (compatible with GitHubApi token storage format).
+
+        Returns:
+            GitHub token or None if not found
+        """
+        token_path = Path.home() / ".github" / "access_token.json"
+        if token_path.exists():
+            try:
+                with open(token_path, 'r') as f:
+                    data = json.load(f)
+                    return data.get("access_token")
+            except (json.JSONDecodeError, OSError):
+                pass
+        return None
+
+
+    def get_contents(self, path: str = "") -> Union[List[Dict[str, Any]], Dict[str, Any]]:
+        """
+        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}"
+        response = self.session.get(url, headers=self._headers(), timeout=30)
+        response.raise_for_status()
+        return response.json()
+
+    def list_files_recursive(self, path: str = "", suffix: Optional[str] = None) -> List[Dict[str, Any]]:
+        """
+        Recursively list files under a given path. Optionally filter by file suffix.
+
+        Args:
+            path: starting path within the repository
+            suffix: optional filename suffix filter, e.g., ".ttl"
+
+        Returns:
+            A flat list of GitHub content item dicts for files.
+        """
+        items = self.get_contents(path)
+        if isinstance(items, dict):
+            items = [items]
+
+        files: List[Dict[str, Any]] = []
+        for item in items:
+            item_type = item.get("type")
+            item_path = item.get("path", "")
+            if item_type == "file":
+                if suffix is None or item_path.endswith(suffix):
+                    files.append(item)
+            elif item_type == "dir":
+                files.extend(self.list_files_recursive(item_path, suffix=suffix))
+        return files
+
+    def download(self, download_url: str) -> str:
+        """
+        Download raw file content via a download_url.
+
+        Args:
+            download_url: The GitHub-provided raw download URL
+
+        Returns:
+            The text content of the file
+        """
+        response = self.session.get(download_url, headers=self._headers(), timeout=30)
+        response.raise_for_status()
+        return response.text

snapquery-0.2.1/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.1}/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.1}/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.1}/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.1}/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.1/snapquery/samples/endpoints.yaml

@@ -0,0 +1,128 @@
+# 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
+
+  wikidata-qlever:
+    description: QLever Freiburg Wikidata.
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://qlever.dev/api/wikidata
+    website: https://qlever.dev/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
+
+  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