snapquery 0.2.4__tar.gz → 0.2.6__tar.gz

{snapquery-0.2.4 → snapquery-0.2.6}/.github/workflows/build.yml

@@ -22,7 +22,7 @@ jobs:
         #python-version: [ '3.10', '3.11', '3.12', '3.13' ]
         # simplified build matrix to avoid rate limits
         os: [ubuntu-latest]
-        python-version: ['3.11']
+        python-version: ['3.10']
 
     steps:
     - uses: actions/checkout@v4

{snapquery-0.2.4 → snapquery-0.2.6}/CITATION.cff

@@ -29,7 +29,8 @@ authors:
 #    orcid: 'https://orcid.org/0000-0003-0250-9655'
 identifiers:
   - type: doi
-    value: 10.5281/zenodo.17802425
+    value: 10.5281/zenodo.17802424
+    description: Concept DOI (all versions) on Zenodo
 repository-code: 'https://github.com/WolfgangFahl/snapquery'
 url: 'https://snapquery.bitplan.com'
 abstract: >-
@@ -45,5 +46,3 @@ keywords:
   - Query Set
   - FAIR
 license: Apache-2.0
-version: v0.2.2
-date-released: '2025-12-03'

{snapquery-0.2.4 → snapquery-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: snapquery
-Version: 0.2.4
+Version: 0.2.6
 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
@@ -32,8 +32,8 @@ 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.6
-Requires-Dist: pylodstorage>=0.18.6
-Requires-Dist: pyopensourceprojects>=0.4.1
+Requires-Dist: pylodstorage>=0.19.9
+Requires-Dist: pyopensourceprojects>=0.5.0
 Requires-Dist: python-slugify>=8.0.4
 Requires-Dist: ratelimit>=2.2.1
 Requires-Dist: requests
@@ -65,10 +65,24 @@ The technology behind the backend knowlede graphs such as RDF, SPARQL, SQL, CSV,
 | :--- | :--- |
 | **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/) |
+| **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/) [![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions) |
 | **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) |
-[![DOI](https://zenodo.org/badge/795424154.svg)](https://doi.org/10.5281/zenodo.17802424)
-[![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions)
+| **Cite** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17802424.svg)](https://doi.org/10.5281/zenodo.17802424) |
+
+## Cite as
+
+If you use snapquery in your research, please cite it via its Zenodo concept DOI
+(which always resolves to the latest version):
+
+> Fahl, W., Holzheim, T., Hoyt, C. T., Priskorn, D., & Willighagen, E.
+> *SnapQuery — FAIR Management of Query Sets to Mitigate Query Rot in Knowledge Graphs.*
+> Zenodo. https://doi.org/10.5281/zenodo.17802424
+
+Machine-readable metadata is available in [`CITATION.cff`](./CITATION.cff);
+GitHub's "Cite this repository" button and Zenodo pick it up automatically.
+For a specific release, use the version DOI shown on the corresponding
+[Zenodo record](https://doi.org/10.5281/zenodo.17802424).
+
 ## Demos
 
 * [wikimedia toolhub](https://toolhub.wikimedia.org/tools/snapquery)

{snapquery-0.2.4 → snapquery-0.2.6}/README.md

@@ -20,10 +20,24 @@ The technology behind the backend knowlede graphs such as RDF, SPARQL, SQL, CSV,
 | :--- | :--- |
 | **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/) |
+| **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/) [![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions) |
 | **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) |
-[![DOI](https://zenodo.org/badge/795424154.svg)](https://doi.org/10.5281/zenodo.17802424)
-[![Join the discussion at https://github.com/WolfgangFahl/snapquery/discussions](https://img.shields.io/github/discussions/WolfgangFahl/snapquery)](https://github.com/WolfgangFahl/snapquery/discussions)
+| **Cite** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17802424.svg)](https://doi.org/10.5281/zenodo.17802424) |
+
+## Cite as
+
+If you use snapquery in your research, please cite it via its Zenodo concept DOI
+(which always resolves to the latest version):
+
+> Fahl, W., Holzheim, T., Hoyt, C. T., Priskorn, D., & Willighagen, E.
+> *SnapQuery — FAIR Management of Query Sets to Mitigate Query Rot in Knowledge Graphs.*
+> Zenodo. https://doi.org/10.5281/zenodo.17802424
+
+Machine-readable metadata is available in [`CITATION.cff`](./CITATION.cff);
+GitHub's "Cite this repository" button and Zenodo pick it up automatically.
+For a specific release, use the version DOI shown on the corresponding
+[Zenodo record](https://doi.org/10.5281/zenodo.17802424).
+
 ## Demos
 
 * [wikimedia toolhub](https://toolhub.wikimedia.org/tools/snapquery)

{snapquery-0.2.4 → snapquery-0.2.6}/pyproject.toml

@@ -26,7 +26,7 @@ dependencies = [
 	# https://github.com/WolfgangFahl/nicegui_widgets
 	"ngwidgets>=0.30.3",
     # https://pypi.org/project/pyLodStorage/
-    "pyLodStorage>=0.18.6",
+    "pyLodStorage>=0.19.9",
     # https://pypi.org/project/py-3rdparty-mediawiki/
     "py-3rdparty-mediawiki>=0.18.1",
     "wikitextparser",
@@ -51,7 +51,7 @@ dependencies = [
     # https://pypi.org/project/nameparser/
     "nameparser>=1.1.3",
     # https://github.com/WolfgangFahl/pyOpenSourceProjects
-    "pyOpenSourceProjects>=0.4.1"
+    "pyOpenSourceProjects>=0.5.0"
 ]
 
 requires-python = ">=3.10"

snapquery-0.2.6/snapquery/__init__.py

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

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/github_access.py

@@ -23,7 +23,7 @@ class GitHub:
         repo: str,
         branch: Optional[str] = None,
         token: Optional[str] = None,
-        session: Optional[requests.Session] = None
+        session: Optional[requests.Session] = None,
     ):
         """
         Initialize GitHub client.
@@ -39,7 +39,6 @@ class GitHub:
         self.repo = repo
         self.branch = branch
 
-
         self.base_url = f"https://api.github.com/repos/{owner}/{repo}"
 
         # Use provided token or read from file
@@ -48,7 +47,6 @@ class GitHub:
         # 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:
@@ -92,7 +90,6 @@ class GitHub:
         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.

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/pid_lookup.py

@@ -32,13 +32,14 @@ class PersonLookup:
         self.wikidata_search = WikidataSearch()
         self.dblp_person_lookup = DblpPersonLookup(self.nqm)
 
-    def suggest_from_wikidata(self, search_name: str, limit: int = 10) -> List[Person]:
+    def suggest_from_wikidata(self, search_name: str, limit: int = 10, endpoint_name: str = "wikidata") -> List[Person]:
         """
         Suggest persons using WikidataSearch.
 
         Args:
             search_name (str): The name to search for suggestions.
             limit (int): The maximum number of results to return.
+            endpoint_name (str): the endpoint to query, default wikidata.
 
         Returns:
             List[Person]: A list of suggested persons from Wikidata.
@@ -88,6 +89,7 @@ WHERE
         person_lod, stats = self.nqm.execute_query(
             named_query=named_query,
             params_dict=params_dict,
+            endpoint_name=endpoint_name,
             limit=limit,
             with_stats=False,
         )

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/prefix_merger.py

@@ -78,11 +78,10 @@ class QueryPrefixMerger(Enum):
         Returns:
             merged query
         """
+        merged_query = query_str
         prefixes_str = endpoint.get_prefixes(PrefixConfigs.get_instance())
-        if not prefixes_str.strip():
-            return
-
-        merged_query = Prefixes.merge_prefixes(query_str, prefixes_str)
+        if prefixes_str.strip():
+            merged_query = Prefixes.merge_prefixes(query_str, prefixes_str)
         return merged_query
 
     @classmethod

snapquery-0.2.6/snapquery/query_parameterizer.py

@@ -0,0 +1,232 @@
+"""
+Created on 2025-12-16
+
+@author: wf
+"""
+
+import os
+import re
+import textwrap
+from typing import Any, Dict, List, Optional
+
+from lodstorage.params import Param
+from lodstorage.query import Query
+
+from snapquery.snapquery_core import NamedQuery, NamedQuerySet
+
+
+class QueryParameterizer:
+    """
+    Parameterizer for Scholia Query Sets.
+    Transforms Jinja2-based Scholia templates into standard
+    LoDStorage Parameterized Queries.
+    """
+
+    # Replacement for Scholia's label macro
+    LABEL_SERVICE = 'SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en". }'
+
+    # Defaults for specific Scholia Aspects
+    # derived from the prompt list
+    ASPECT_DEFAULTS = {
+        "author": "Q80",  # Tim Berners-Lee
+        "authors": "Q80",
+        "award": "Q616568",  # Turing Award
+        "catalogue": "Q2463660",  # British Library catalogue
+        "chemical": "Q18216",  # Aspirin
+        "cito": "Q1054942",  # citation intent
+        "clinical": "Q12136",  # Common Cold (disease context)
+        "complex": "Q417724",  # Protein complex
+        "countries": "Q183",  # Germany
+        "country": "Q183",
+        "dataset": "Q1172284",  # Data set
+        "disease": "Q12136",  # Common Cold
+        "event": "Q2020153",  # WWW Conference
+        "gene": "Q7191",  # p53
+        "index": "Q1",  # Universe (generic fallback)
+        "language": "Q1860",  # English
+        "lexeme": "Q151326",  # Word
+        "license": "Q20007257",  # CC BY 4.0
+        "location": "Q64",  # Berlin
+        "ontology": "Q324254",  # Ontology
+        "organization": "Q95",  # Google
+        "organizations": "Q95",
+        "pathway": "Q26487",  # Metabolic pathway
+        "podcast": "Q24634210",  # The Ozymandias Project
+        "printer": "Q11226",  # Printer (the device/person)
+        "project": "Q5562725",  # WikiProject
+        "property": "P31",  # Instance of
+        "protein": "Q11060",  # Green fluorescent protein
+        "publisher": "Q203019",  # Elsevier
+        "retraction": "Q45263695",  # Retracted paper example
+        "series": "Q245209",  # Book series
+        "software": "Q28865",  # Python
+        "sponsor": "Q95",  # Google
+        "taxon": "Q140",  # Lion
+        "topic": "Q21198",  # Computer Science
+        "topics": "Q21198",
+        "use": "Q1",
+        "uses": "Q1",
+        "venue": "Q180445",  # Nature (Journal)
+        "venues": "Q180445",
+        "wikiproject": "Q5562725",
+        "work": "Q13442814",  # Scientific Article
+        "works": "Q13442814",
+    }
+
+    def __init__(self, debug: bool = False):
+        self.debug = debug
+
+    def _infer_param_details(self, var_name: str, aspect: Optional[str] = None) -> Dict[str, Any]:
+        """
+        Heuristics to determine type and default value based on variable name
+        and the query aspect (category).
+
+        Args:
+            var_name: The variable name found in the jinja template (e.g. 'q', 'target').
+            aspect: The scholia aspect derived from the query name (e.g. 'venue', 'author').
+        """
+        # Global Default
+        details = {"type": "string", "default": "Q80"}
+
+        # 1. Identify Type based on variable name
+        if var_name in ["q", "target", "item", "person", "work", "venue", "gene", "disease"]:
+            details["type"] = "WikidataItem"
+
+            # 2. Assign Default Value based on Aspect
+            if aspect and aspect in self.ASPECT_DEFAULTS:
+                details["default"] = self.ASPECT_DEFAULTS[aspect]
+
+            # 3. Fallback defaults if aspect is missing or generic
+            elif var_name == "person":
+                details["default"] = "Q80"  # Tim Berners-Lee
+            elif var_name == "work":
+                details["default"] = "Q13442814"
+            else:
+                details["default"] = "Q80"
+
+        elif var_name in ["p", "property"]:
+            details["type"] = "WikidataProperty"
+            details["default"] = "P31"
+        elif var_name in ["limit"]:
+            details["type"] = "int"
+            details["default"] = 10
+        elif var_name in ["lang", "language"]:
+            details["type"] = "string"
+            details["default"] = "en"
+
+        return details
+
+    def get_queries_by_aspect(self, query_list: List[Query]) -> Dict[str, List[Query]]:
+        """
+        get queries by aspect
+        """
+        queries_by_aspect = {}
+        for query in query_list:
+            aspect = self.get_aspect(query.name)
+            if aspect in self.ASPECT_DEFAULTS:
+                if aspect not in queries_by_aspect:
+                    queries_by_aspect[aspect] = []
+                queries_by_aspect[aspect].append(query)
+        return queries_by_aspect
+
+    def store_query_list(self, query_list: List[Query], tag: str, path: str = "/tmp/queries"):
+        """
+        Store query list sorted by aspect into separate YAML files.
+
+        Args:
+            query_list (List[Query]): List of Query objects with aspect metadata.
+            tag (str): Tag to include in filename.
+            path (str): Directory path where YAML files will be stored.
+        """
+        queries_by_aspect = self.get_queries_by_aspect(query_list)
+        # Create directory if it doesn't exist
+        os.makedirs(path, exist_ok=True)
+
+        # Store each aspect's queries in a separate YAML file
+        for aspect, queries in sorted(queries_by_aspect.items()):
+            filename = f"{tag}_{aspect}_queries.yaml"
+            filepath = os.path.join(path, filename)
+
+            with open(filepath, "w", encoding="utf-8") as f:
+                for query in queries:
+                    # work around https://github.com/yaml/pyyaml/issues/411
+                    if query.sparql:
+                        clean_sparql = textwrap.dedent(query.sparql).strip()
+                    yaml_str = query.to_yaml()
+                    f.write(yaml_str)
+            pass
+
+    def parameterize_query_set(self, query_set: NamedQuerySet) -> List[Query]:
+        """
+        Parameterize the given query set to produce a list of LoDStorage queries.
+
+        Args:
+            query_set (NamedQuerySet): The set of named queries to transform.
+
+        Returns:
+            List[Query]: A list of transformed LoDStorage Query objects.
+        """
+        query_list = []
+        for nq in query_set.queries:
+            query = self.parameterize_query(nq)
+            query_list.append(query)
+        return query_list
+
+    def get_aspect(self, name: str) -> str:
+        aspect = None
+        if name:
+            # Split by hyphen first, as that is the standard separator in the example
+            parts = re.split(r"[-_]", name)
+            if parts:
+                aspect = parts[0].lower()
+        return aspect
+
+    def parameterize_query(self, nq: NamedQuery) -> Query:
+        """
+        Parameterize a single named query.
+
+        1. Identifies the "Aspect" from the query name (e.g. 'venue-...' -> 'venue').
+        2. Cleans Jinja2 specific imports.
+        3. Replaces Scholia Macros with standard SPARQL.
+        4. Detects variables and creates Param objects using aspect-specific defaults.
+
+        Args:
+            nq (NamedQuery): The named query input.
+
+        Returns:
+            Query: The transformed LoDStorage Query object.
+        """
+        # 0. Determine Aspect
+        # Naming convention: {aspect}-{subname} or {aspect}_{subname}
+        # e.g., "venue-curation_missing-author-item" -> "venue"
+        aspect = self.get_aspect(nq.name)
+
+        raw_sparql = nq.sparql
+
+        # 1. Remove Jinja imports
+        # e.g., {% import 'sparql-helpers.sparql' as sparql_helpers -%}
+        txt = re.sub(r"\{%\s*import\s*.*?%\}", "", raw_sparql, flags=re.DOTALL)
+
+        # 2. Replace Label/Description Macros
+        # Matches: {{ sparql_helpers.labels(["?mol"], languages) }}
+        txt = re.sub(r"\{\{\s*sparql_helpers\.(labels|descriptions).*?\}\}", self.LABEL_SERVICE, txt, flags=re.DOTALL)
+
+        # 3. Detect Variables to build Param list
+        found_vars = set(re.findall(r"\{\{\s*([a-zA-Z0-9_]+)\s*\}\}", txt))
+        found_vars.discard("sparql_helpers")
+
+        # Create lodstorage Query object
+        clean_sparql = txt.strip()
+
+        query_obj = Query(name=nq.name, query=clean_sparql, title=nq.title, description=nq.description, lang="sparql")
+
+        # 4. Attach Parameters with Aspect context
+        param_list = []
+        for var in sorted(found_vars):
+            details = self._infer_param_details(var, aspect=aspect)
+            p = Param(name=var, type=details["type"], default_value=details["default"])
+            param_list.append(p)
+
+        query_obj.param_list = param_list
+
+        return query_obj

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/query_set_cmd.py

@@ -4,19 +4,20 @@ Created on 2025-12-04
 @author: wf
 """
 
-from argparse import ArgumentParser, Namespace
 import sys
+from argparse import ArgumentParser, Namespace
 
 from basemkit.base_cmd import BaseCmd
+from tqdm import tqdm
+
 from snapquery.qlever import QLever
 from snapquery.query_set_tool import QuerySetTool
-from snapquery.scholia import ScholiaQueries, GitHubQueries
+from snapquery.scholia import GitHubQueries, ScholiaQueries
 from snapquery.sib_sparql_examples import SibSparqlExamples
 from snapquery.snapquery_core import NamedQueryManager
 from snapquery.version import Version
 from snapquery.wd_page_query_extractor import WikidataQueryExtractor
 from snapquery.wd_short_url import ShortUrl
-from tqdm import tqdm
 
 
 class QuerySetCmdVersion(Version):
@@ -214,7 +215,6 @@ class QuerySetCmd(BaseCmd):
             self._handle_random_short_urls(args)
             return True
 
-
         return False
 
     def _handle_convert(self, args: Namespace) -> None:
@@ -263,13 +263,12 @@ class QuerySetCmd(BaseCmd):
             extension=args.github_extension,
             domain=args.domain,
             namespace=args.namespace,
-            debug=args.debug
+            debug=args.debug,
         )
 
         gh_queries.extract_queries(limit=args.limit, show_progress=args.progress)
         self._output_dataset(gh_queries.named_query_set, args)
 
-
     def _handle_scholia(self, args: Namespace) -> None:
         """
         Handle the standard Scholia import workflow using defaults.
@@ -292,12 +291,11 @@ class QuerySetCmd(BaseCmd):
             repo="scholia",
             branch="qlever",
             namespace="named_queries_qlever",
-            debug=args.debug
+            debug=args.debug,
         )
         scholia_qlever.extract_queries(limit=args.limit, show_progress=args.progress)
         self._output_dataset(scholia_qlever.named_query_set, args)
 
-
     def _handle_wikidata_examples(self, args: Namespace) -> None:
         """
         Handle the Wikidata Examples import workflow.

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/samples/endpoints.yaml

@@ -4,23 +4,9 @@
 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
+      abstract name of the Wikidata endpoint, an alias resolved to a concrete entry;
+      a host redirects it in ~/.pylodstorage/endpoints.yaml, e.g. to a local copy
+    alias: wikidata-main
 
   wikidata-main:
     description: WDQS Graph Split — main (non-scholarly).
@@ -89,6 +75,30 @@ endpoints:
       - wikidata
       - commons
 
+  wikidata-next:
+    description: Wikimedia QLever Wikidata full graph (query-next).
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://query-next.wikidata.org/sparql
+    website: https://query-next.wikidata.org/
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - wikidata
+
+  wikidata-scholarly-next:
+    description: Wikimedia QLever Wikidata scholarly graph (query-scholarly-next).
+    lang: sparql
+    method: POST
+    database: qlever
+    endpoint: https://query-scholarly-next.wikidata.org/sparql
+    website: https://query-scholarly-next.wikidata.org/
+    calls_per_minute: 60
+    prefix_sets:
+      - rdf
+      - wikidata
+
   wikidata-triply:
     description: TriplyDB mirror.
     lang: sparql
@@ -113,6 +123,23 @@ endpoints:
       - rdf
       - wikidata
 
+  wikidata-openlink:
+    description: |
+      OpenLink Wikidata Truthy instance (LOD Cloud demo).
+      Optimized for property path queries and transitive closure.
+      https://www.openlinksw.com/data/html/about-wikidata-truthy-2025-11.html
+    lang: sparql
+    endpoint: https://truthy.demo.openlinksw.com/sparql
+    website: https://truthy.demo.openlinksw.com
+    database: virtuoso
+    method: POST
+    calls_per_minute: 30
+    data_seeded: 2025-11-01
+    prefix_sets:
+      - rdf
+      - wikidata
+      - commons
+
   dblp:
     description: DBLP official (qlever - reliable).
     lang: sparql

{snapquery-0.2.4 → snapquery-0.2.6}/snapquery/scholia.py

@@ -5,13 +5,16 @@ Created on 2024-05-04
 
 @author: wf
 """
+
+from typing import Optional
+
 import requests
 from tqdm import tqdm
-from typing import Optional
 
 from snapquery.github_access import GitHub
 from snapquery.snapquery_core import NamedQuery, NamedQueryManager, NamedQuerySet
 
+
 class GitHubQueries:
     """
     A general class to handle the extraction and management of queries
@@ -29,7 +32,7 @@ class GitHubQueries:
         domain: Optional[str] = None,
         namespace: Optional[str] = None,
         target_graph: str = "wikidata",
-        debug: bool = False
+        debug: bool = False,
     ):
         """
         Constructor
@@ -138,6 +141,7 @@ class ScholiaQueries(GitHubQueries):
     """
     Specific implementation for Scholia Queries with configurable repo/owner/branch.
     """
+
     def __init__(
         self,
         nqm: NamedQueryManager,
@@ -146,7 +150,7 @@ class ScholiaQueries(GitHubQueries):
         branch: Optional[str] = None,
         domain: str = "scholia.toolforge.org",
         namespace: str = "named_queries",
-        debug: bool = False
+        debug: bool = False,
     ):
         super().__init__(
             nqm=nqm,
@@ -157,5 +161,5 @@ class ScholiaQueries(GitHubQueries):
             extension=".sparql",
             domain=domain,
             namespace=namespace,
-            debug=debug
-        )
+            debug=debug,
+        )