From 37fa37b3b42af9750b143bf13b4cb273052237e7 Mon Sep 17 00:00:00 2001 From: Donato Meoli Date: Mon, 19 Oct 2026 23:26:19 +0200 Subject: [PATCH 1/2] pymdown-extensions below 12 under Python 3.10, where mkdocstrings stops at 1.0.6, which fails with it The documentation is built under Python 3.10 (docs/environment.yml), where the last mkdocstrings is 1.0.6, whose Highlighter does not pass the md argument that the Highlight of pymdown-extensions 12 requires, so that mkdocs build failed since pymdown-extensions 12 was released. Under a later Python mkdocstrings 1.0.8 works with it, and the bound does not apply. --- docs/release_notes.md | 2 +- pyproject.toml | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/release_notes.md b/docs/release_notes.md index 03d0329..821b174 100644 --- a/docs/release_notes.md +++ b/docs/release_notes.md @@ -8,7 +8,7 @@ ### Minor Changes and Bug Fixes -* +* Keep `pymdown-extensions` below 12 under Python 3.10, the Python of the documentation build, where `mkdocstrings` stops at 1.0.6, which fails with it (`Highlight.__init__() missing 1 required positional argument: 'md'`) ## Version v0.0.14 diff --git a/pyproject.toml b/pyproject.toml index 495a5fd..a64a7f0 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -53,6 +53,8 @@ docs=[ "mkdocs-jupyter>=0.24", "mkdocs-autorefs>=0.5", "pymdown-extensions>=10.0", + # mkdocstrings 1.0.6, the last one for Python 3.10, fails with 12.0 + "pymdown-extensions<12; python_version < '3.11'", "scikit-learn", "libsvm-official", ] From 8aa12ae886cf316af09bdbf2ae1c2e9aefb325e0 Mon Sep 17 00:00:00 2001 From: Donato Meoli Date: Mon, 19 Oct 2026 23:26:30 +0200 Subject: [PATCH 2/2] PR number in the release notes --- docs/release_notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release_notes.md b/docs/release_notes.md index 821b174..55d7ae3 100644 --- a/docs/release_notes.md +++ b/docs/release_notes.md @@ -8,7 +8,7 @@ ### Minor Changes and Bug Fixes -* Keep `pymdown-extensions` below 12 under Python 3.10, the Python of the documentation build, where `mkdocstrings` stops at 1.0.6, which fails with it (`Highlight.__init__() missing 1 required positional argument: 'md'`) +* Keep `pymdown-extensions` below 12 under Python 3.10, the Python of the documentation build, where `mkdocstrings` stops at 1.0.6, which fails with it (`Highlight.__init__() missing 1 required positional argument: 'md'`). See [PR #127](https://github.com/SPSUnipi/pySMSpp/pull/127) ## Version v0.0.14