snapquery 0.2.5__tar.gz → 0.2.6__tar.gz

{snapquery-0.2.5 → 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.5 → 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.5 → snapquery-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: snapquery
-Version: 0.2.5
+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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → snapquery-0.2.6}/snapquery/query_parameterizer.py

@@ -3,14 +3,16 @@ Created on 2025-12-16
 
 @author: wf
 """
+
 import os
 import re
 import textwrap
-from typing import Optional, Dict, Any, List
+from typing import Any, Dict, List, Optional
 
 from lodstorage.params import Param
 from lodstorage.query import Query
-from snapquery.snapquery_core import NamedQuerySet, NamedQuery
+
+from snapquery.snapquery_core import NamedQuery, NamedQuerySet
 
 
 class QueryParameterizer:
@@ -26,49 +28,49 @@ class QueryParameterizer:
     # Defaults for specific Scholia Aspects
     # derived from the prompt list
     ASPECT_DEFAULTS = {
-        "author": "Q80",          # Tim Berners-Lee
+        "author": "Q80",  # Tim Berners-Lee
         "authors": "Q80",
-        "award": "Q616568",       # Turing Award
+        "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
+        "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
+        "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
+        "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)
+        "venue": "Q180445",  # Nature (Journal)
         "venues": "Q180445",
         "wikiproject": "Q5562725",
-        "work": "Q13442814",      # Scientific Article
-        "works": "Q13442814"
+        "work": "Q13442814",  # Scientific Article
+        "works": "Q13442814",
     }
 
     def __init__(self, debug: bool = False):
@@ -87,7 +89,7 @@ class QueryParameterizer:
         details = {"type": "string", "default": "Q80"}
 
         # 1. Identify Type based on variable name
-        if var_name in ['q', 'target', 'item', 'person', 'work', 'venue', 'gene', 'disease']:
+        if var_name in ["q", "target", "item", "person", "work", "venue", "gene", "disease"]:
             details["type"] = "WikidataItem"
 
             # 2. Assign Default Value based on Aspect
@@ -95,39 +97,39 @@ class QueryParameterizer:
                 details["default"] = self.ASPECT_DEFAULTS[aspect]
 
             # 3. Fallback defaults if aspect is missing or generic
-            elif var_name == 'person':
+            elif var_name == "person":
                 details["default"] = "Q80"  # Tim Berners-Lee
-            elif var_name == 'work':
+            elif var_name == "work":
                 details["default"] = "Q13442814"
             else:
                 details["default"] = "Q80"
 
-        elif var_name in ['p', 'property']:
+        elif var_name in ["p", "property"]:
             details["type"] = "WikidataProperty"
             details["default"] = "P31"
-        elif var_name in ['limit']:
+        elif var_name in ["limit"]:
             details["type"] = "int"
             details["default"] = 10
-        elif var_name in ['lang', 'language']:
+        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]]:
+    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)
+            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"):
+    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.
 
@@ -136,7 +138,7 @@ class QueryParameterizer:
             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)
+        queries_by_aspect = self.get_queries_by_aspect(query_list)
         # Create directory if it doesn't exist
         os.makedirs(path, exist_ok=True)
 
@@ -150,11 +152,10 @@ class QueryParameterizer:
                     # work around https://github.com/yaml/pyyaml/issues/411
                     if query.sparql:
                         clean_sparql = textwrap.dedent(query.sparql).strip()
-                    yaml_str=query.to_yaml()
+                    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.
@@ -171,11 +172,11 @@ class QueryParameterizer:
             query_list.append(query)
         return query_list
 
-    def get_aspect(self,name:str)->str:
+    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)
+            parts = re.split(r"[-_]", name)
             if parts:
                 aspect = parts[0].lower()
         return aspect
@@ -198,47 +199,32 @@ class QueryParameterizer:
         # 0. Determine Aspect
         # Naming convention: {aspect}-{subname} or {aspect}_{subname}
         # e.g., "venue-curation_missing-author-item" -> "venue"
-        aspect=self.get_aspect(nq.name)
+        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)
+        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
-        )
+        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')
+        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'
-        )
+        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"]
-            )
+            p = Param(name=var, type=details["type"], default_value=details["default"])
             param_list.append(p)
 
         query_obj.param_list = param_list

{snapquery-0.2.5 → 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.5 → 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-legacy-full.wikidata.org/sparql
-    website: https://query-legacy-full.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

{snapquery-0.2.5 → 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,
+        )