Merge branch 'main' into dependabot/pip/ruff-0.14.3

Author: edmondchuc

.github/workflows/validate.yaml

@@ -25,7 +25,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
         os: [ubuntu-latest, macos-latest, windows-latest]
         # This is used for injecting additional tests for a specific python
         # version and OS.

CHANGELOG.md

@@ -1,3 +1,68 @@
+## 2025-10-30 RELEASE 7.4.0
+
+This release addresses a couple of bugs and improves the testing matrix by adding python 3.12, 3.13 and 3.14 to the test matrix.
+
+This is also the first RDFLib release to use MkDocs for documentation.
+
+Pull requests merged:
+
+- chore(v7): upgrade ci and dev/test deps by @edmondchuc in [#3288](https://github.com/RDFLib/rdflib/pull/3288)
+- feat: v7 mkdocs by @edmondchuc in [#3287](https://github.com/RDFLib/rdflib/pull/3287)
+- fix: set changed size when iterating the store's graphs by @edmondchuc in [#3281](https://github.com/RDFLib/rdflib/pull/3281)
+- lazy fix of issue pytest failure on python 3.13.8 - Removing of xfail raise restriction by @WhiteGobo in [#3275](https://github.com/RDFLib/rdflib/pull/3275)
+
+## 2025-10-24 RELEASE 7.3.0
+
+This release delivers several important fixes and enhancements to RDFLib’s Dataset implementation, resolving long-standing issues and improving consistency across serialization and SPARQL operations. It also introduces new deprecation notices for certain Dataset methods and attributes, which will be removed in the next major release. In addition, this version includes a range of improvements to SPARQL result parsing, typing, and literal handling.
+
+### Features
+
+- Added `Dataset.__iadd__` support
+- Dataset's default serialize format is now `trig`
+- Datasets can now add graphs backed by different stores
+
+### Fixes and Improvements
+
+- Fixed an issue where the `RecursiveSerializer` would output undeclared prefixes for predicates that contained the base as a substring
+- Prevented prefix generation for predicates corresponding to the base namespace
+- SPARQL Update now correctly inserts into the default graph
+- Dataset.parse now returns Self
+- N-Quads serialization no longer includes the RDFLib internal default graph identifier
+- Static type checkers can now infer the type of `Term.__new__`
+- Removed automatic date conversion for gYear and gYearMonth literals
+- Optional clauses in SPARQL queries can now bind variables
+- Fixed reevaluation logic in SPARQL Update between update loops
+
+### Maintenance
+
+- Added deprecation notices to certain Dataset methods and attributes
+  - Use Dataset.graphs instead of Dataset.contexts method
+  - Use Dataset.default_graph instead of Dataset.default_context
+  - Deprecate Dataset.identifier entirely.
+- Updated type hints for Graph.open() with SPARQLUpdateStore configuration
+- SPARQL Result Parsing Improvements
+  - Simplified and modernized the SPARQL result parsing system:
+  - These changes maintain backward compatibility while making the SPARQL API more flexible and extensible.
+
+Pull requests merged:
+
+- feat: add Dataset `__iadd__` support by @edmondchuc in [#3268](https://github.com/RDFLib/rdflib/pull/3268)
+- fix: RecursiveSerializer- outputs undeclared prefix for predicates that contains the base as a substring by @edmondchuc in [#3267](https://github.com/RDFLib/rdflib/pull/3267)
+- fix: allow static type checkers to infer term's `__new__` type by @edmondchuc in [#3266](https://github.com/RDFLib/rdflib/pull/3266)
+- fix: SPARQL Update inserts into the default graph by @edmondchuc in [#3265](https://github.com/RDFLib/rdflib/pull/3265)
+- chore: add deprecation notice to Dataset methods and attributes by @edmondchuc in [#3264](https://github.com/RDFLib/rdflib/pull/3264)
+- fix: Dataset.parse now returns Self by @edmondchuc in [#3263](https://github.com/RDFLib/rdflib/pull/3263)
+- fix: dataset nquads serialization including RDFLib internal default graph identifier by @edmondchuc in [#3262](https://github.com/RDFLib/rdflib/pull/3262)
+- patch for reevaluation in sparql modify between update loops. with test by @WhiteGobo in [#3261](https://github.com/RDFLib/rdflib/pull/3261)
+- feat: change dataset's default serialize format to trig by @edmondchuc in [#3260](https://github.com/RDFLib/rdflib/pull/3260)
+- feat: allow adding graphs backed by different stores to the same dataset by @edmondchuc in [#3259](https://github.com/RDFLib/rdflib/pull/3259)
+- fix(v7): remove Literal.toPython date conversion for gYear/gYearMonth (#3115) by @edmondchuc in [#3258](https://github.com/RDFLib/rdflib/pull/3258)
+- sparqls optionals clause can now bind variables. with test. issue 2957 by @WhiteGobo in [#3247](https://github.com/RDFLib/rdflib/pull/3247)
+- fix: skip prefix generation for predicates corresponding to base namespace by @edmondchuc in [#3244](https://github.com/RDFLib/rdflib/pull/3244)
+- Run the example queries agains the local fuseki by @white-gecko in [#3240](https://github.com/RDFLib/rdflib/pull/3240)
+- Adjust the type hint for Graph open to reflect a SPARQLUpdateStore configuration by @white-gecko in [#3239](https://github.com/RDFLib/rdflib/pull/3239)
+- SPARQL result parsing by @white-gecko in [#2796](https://github.com/RDFLib/rdflib/pull/2796)
+
 ## 2025-09-19 RELEASE 7.2.1
 
 A tiny clean up release.
@@ -169,26 +234,12 @@ For the full list of included PRs, see the preparatory PR:
 
 ## 2025-01-10 RELEASE 7.1.2
 
-A minor release that bumped up a few dev dependencies and achieved a few small but notable improvements, particularly with longturtle sorting:
-
-Feature PRs:
-
-* [PR #2963](https://github.com/RDFLib/rdflib/pull/2963) Big typing updates
-* [PR #2964](https://github.com/RDFLib/rdflib/pull/2964) Defined Namesapce warnings fix
-* [PR #2971](https://github.com/RDFLib/rdflib/pull/2971) convert uses of Optional and some Union usage to union operator |
-* [PR #2989](https://github.com/RDFLib/rdflib/pull/2989) Fixed incorrect ASK behaviour for dataset with one element
-* [PR #2997](https://github.com/RDFLib/rdflib/pull/2997) sort longturtle blank nodes
-* [PR #3008](https://github.com/RDFLib/rdflib/pull/3008) deterministic longturtle serialisation using RDF canonicalization + n-triples sort
-* [PR #3012](https://github.com/RDFLib/rdflib/pull/3012) Dataset documentation improvements
-
-Dependency bumps:
+A minor release that inadvertently removed support for Python 3.8. This release 
+how now been deleted.
 
-* ruff from 0.71 -> 0.8.6
-* orjson  3.10.10 -> 
-* pytest-cov to 6.0.0
-* coverage to 7.6.10
-* pytest to 8.3.4
-* poetry to 2.0.0
+All the improved features initially made available in this release that were 
+compatible with Python 3.8 have been preserved in the 7.1.3 release. The main 
+additions to 7.1.2 not preserved in 7.1.3 are updated type hints.
 
 ## 2024-10-17 RELEASE 7.1.1
 

CITATION.cff

@@ -72,7 +72,7 @@ authors:
 - family-names: "Stuart"
   given-names: "Veyndan"
 title: "RDFLib"
-version: 7.2.1
-date-released: 2025-09-19
+version: 7.4.0
+date-released: 2025-10-30
 url: "https://github.com/RDFLib/rdflib"
 doi: 10.5281/zenodo.6845245

README.md

@@ -45,6 +45,8 @@ Help with maintenance of all of the RDFLib family of packages is always welcome
 ## Versions & Releases
 
 * `main` branch in this repository is the current unstable release - version 8 alpha
+* `7.4.0` a few small fixes, add test matrix for active python versions, and move v7 documentation to MkDocs
+* `7.3.0` many fixes and usability improvements, particularly for the Dataset class. See changelog for details
 * `7.2.1` tiny clean up release, relaxes Python version requirement
 * `7.2.0` general fixes and usability improvements, see changelog for details
 * `7.1.4` tidy-up release, possibly last 7.x release

Taskfile.yml

@@ -272,7 +272,7 @@ tasks:
 
   pip-compile:
     cmds:
-      - cmd: "{{.PIP_COMPILE}} --quiet --annotate --emit-options --no-strip-extras --resolver=backtracking {{.CLI_ARGS}}"
+      - cmd: "{{.PIP_COMPILE}} --quiet --annotate --emit-options --resolver=backtracking --no-strip-extras {{.CLI_ARGS}}"
 
   docker:prepare:
     cmds:

admin/README.md

@@ -3,3 +3,11 @@
 Tools to assist with RDFlib releases, like extracting all merged PRs from GitHub since last release and printing them into MArkdown lists.
 
 To make a release of RDFLib, see the [Developer's Guide](https://rdflib.readthedocs.io/en/latest/developers.html).
+
+## PR Changelog Summary
+
+An alternative to the `get_merged_prs.py` script is to use the GitHub CL to get the list of PRs and pipe it into the `pr_markdown.py` script. The following command retrieves the list of PRs merged since the last release (`2025-09-19`) from a particular branch (`7.x`).
+
+```bash
+gh api '/search/issues?q=repo:rdflib/rdflib+is:pr+is:merged+base:7.x+merged:>2025-10-24&per_page=100' | jq '{total_count, incomplete_results, items: [.items[] | {number, title, pull_request_merged_at: .pull_request.merged_at, pull_request_url: .pull_request.html_url, username: .user.login}]}' | poetry run python admin/pr_markdown.py
+```

admin/pr_markdown.py

@@ -0,0 +1,28 @@
+import json
+import sys
+from dataclasses import dataclass
+
+
+@dataclass
+class PR:
+    number: int
+    title: str
+    pull_request_merged_at: str
+    pull_request_url: str
+    username: str
+
+    def __repr__(self):
+        return f"{self.title} by @{self.username} in [#{self.number}]({self.pull_request_url})"
+
+
+try:
+    json_data = json.load(sys.stdin)
+    prs = [PR(**pr) for pr in json_data["items"]]
+    for pr in prs:
+        print(f"- {pr}")
+except json.JSONDecodeError as e:
+    print(f"Error parsing JSON: {e}")
+    sys.exit(1)
+except Exception as e:
+    print(f"Error: {e}")
+    sys.exit(1)

docs/CONTRIBUTING.md

@@ -88,8 +88,8 @@ Some ways in which you can contribute to RDFLib are:
 
 ## Technical contributions
 
-If you would like to make technical contributions to RDFLIb, the _main_ way to do
-this is via creating Pull Requests to fix bugs or add features.
+Contributions that involve changes to the RDFLib repository have to be made with
+pull requests and should follow the [RDFLib developers guide](./developers.md).
 
 Please read the [RDFLib developers guide](./developers.md) for this.
 

docs/developers.md

@@ -430,13 +430,13 @@ RDFLib 5.0.0 maintained compatibility with Python versions 2.7, 3.4, 3.5, 3.6, 3
 
 Create a release-preparation pull request with the following changes:
 
-* Updated version and date in `CITATION.cff`.
-* Updated copyright year in the `LICENSE` file.
-* Updated copyright year in the `docs/conf.py` file.
-* Updated main branch version and current version in the `README.md` file.
-* Updated version in the `pyproject.toml` file.
-* Updated `__date__` in the `rdflib/__init__.py` file.
-* Accurate `CHANGELOG.md` entry for the release.
+* Updated version and date in [`CITATION.cff`](../CITATION.cff).
+* Updated copyright year in the [`LICENSE`](../LICENSE) file.
+* Updated copyright year in the [`mkdocs.yml`](../mkdocs.yml) file.
+* Updated main branch version and current version in the [`README.md`](../README.md) file.
+* Updated version in the [`pyproject.toml`](../pyproject.toml) file.
+* Updated `__date__` in the [`rdflib/__init__.py`](../rdflib/__init__.py) file.
+* Updated [`CHANGELOG.md`](../CHANGELOG.md) entry for the release with admin tools as described in [`admin/README.md`](../admin/README.md).
 
 Once the PR is merged, switch to the main branch, build the release and upload it to PyPI:
 

docs/index.md

@@ -56,6 +56,7 @@ If you are familiar with RDF and are looking for details on how RDFLib handles i
 * [Upgrade 6 to 7](upgrade6to7.md)
 * [Upgrade 5 to 6](upgrade5to6.md)
 * [Upgrade 4 to 5](upgrade4to5.md)
+* [Security Considerations](security_considerations.md)
 
 ## Versioning
 
@@ -73,6 +74,8 @@ Given a version number `MAJOR.MINOR.PATCH`, increment the:
     * [Developers guide](developers.md)
     * [Documentation guide](docs.md)
 * [Code of Conduct](CODE_OF_CONDUCT.md)
+* [Persisting N3 Terms](persisting_n3_terms.md)
+* [Type Hints](type_hints.md)
 * [Decisions](decisions.md)
 
 ## Source Code