Merge branch 'master' into master

Author: chrisjsewell

.github/workflows/test-formats.yml

@@ -19,10 +19,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
@@ -43,10 +43,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip

.github/workflows/tests.yml

@@ -14,27 +14,27 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - uses: pre-commit/action@v3.0.1
 
   tests:
 
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13"]
         sphinx: [">=8,<9"]
         os: [ubuntu-latest]
         include:
-        - os: ubuntu-latest
-          python-version: "3.10"
-          sphinx: ">=7,<8"
+        # - os: ubuntu-latest
+        #   python-version: "3.11"
+        #   sphinx: ">=7,<8"
         - os: windows-latest
-          python-version: "3.10"
-          sphinx: ">=7,<8"
+          python-version: "3.11"
+          sphinx: ">=8,<9"
 
     runs-on: ${{ matrix.os }}
 
@@ -56,7 +56,7 @@ jobs:
         pytest --cov=myst_parser --cov-report=xml --cov-report=term-missing
         coverage xml
     - name: Upload to Codecov
-      if: github.repository == 'executablebooks/MyST-Parser' && matrix.python-version == 3.10 && matrix.os == 'ubuntu-latest'
+      if: github.repository == 'executablebooks/MyST-Parser' && matrix.python-version == 3.11 && matrix.os == 'ubuntu-latest'
       uses: codecov/codecov-action@v4
       with:
         token: ${{ secrets.CODECOV_TOKEN }}
@@ -78,10 +78,10 @@ jobs:
     steps:
     - name: Checkout source
       uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - name: Install setup
       run: |
         python -m pip install --upgrade pip
@@ -133,10 +133,10 @@ jobs:
     steps:
     - name: Checkout source
       uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - name: install flit
       run: |
         pip install flit~=3.4
@@ -156,10 +156,10 @@ jobs:
     steps:
     - name: Checkout source
       uses: actions/checkout@v4
-    - name: Set up Python 3.10
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.11"
     - name: install flit and tomlkit
       run: |
         pip install flit~=3.4 tomlkit

.pre-commit-config.yaml

@@ -13,28 +13,28 @@ exclude: >
 repos:
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
     - id: check-json
     - id: check-yaml
     - id: end-of-file-fixer
     - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.4
+    rev: v0.14.6
     hooks:
-    - id: ruff
+    - id: ruff-check
       args: [--fix]
     - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.14.0
+    rev: v1.18.2
     hooks:
     - id: mypy
       args: [--config-file=pyproject.toml]
       additional_dependencies:
       - types-urllib3
-      - sphinx~=7.4
+      - sphinx~=8.2
       - markdown-it-py~=3.0
       - mdit-py-plugins~=0.4.0
       files: >

.readthedocs.yml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.11"
 
 python:
   install:

docs/conf.py

@@ -54,7 +54,7 @@
 suppress_warnings = ["myst.strikethrough"]
 
 intersphinx_mapping = {
-    "python": ("https://docs.python.org/3.10", None),
+    "python": ("https://docs.python.org/3.11", None),
     "sphinx": ("https://www.sphinx-doc.org/en/master", None),
     "markdown_it": ("https://markdown-it-py.readthedocs.io/en/latest", None),
 }
@@ -200,6 +200,8 @@
     "https://www.sphinx-doc.org/en/master",
     "https://markdown-it-py.readthedocs.io/en/latest",
 ]
+# TODO failing
+tippy_enable_wikitips = False
 
 # -- LaTeX output -------------------------------------------------
 

myst_parser/_docs.py

@@ -211,7 +211,7 @@ def run(self):
 :Name: `{name}`
 :Description: {content}
 :Arguments: {klass.required_arguments} required, {klass.optional_arguments} optional
-:Content: {'yes' if klass.has_content else 'no'}
+:Content: {"yes" if klass.has_content else "no"}
 :Options:
 """
         if klass.option_spec:

myst_parser/config/main.py

@@ -64,7 +64,7 @@ def check_url_schemes(inst: "MdParserConfig", field: dc.Field, value: Any) -> No
     if isinstance(value, list | tuple):
         if not all(isinstance(v, str) for v in value):
             raise TypeError(f"'{field.name}' is not a list of strings: {value!r}")
-        value = {v: None for v in value}
+        value = dict.fromkeys(value)
 
     if not isinstance(value, dict):
         raise TypeError(f"'{field.name}' is not a dictionary: {value!r}")
@@ -522,8 +522,7 @@ def merge_file_level(
     if "html_meta" in topmatter:
         warning(
             MystWarnings.MD_TOPMATTER,
-            "top-level 'html_meta' key is deprecated, "
-            "place under 'myst' key instead",
+            "top-level 'html_meta' key is deprecated, place under 'myst' key instead",
         )
         updates["html_meta"] = topmatter["html_meta"]
     if "substitutions" in topmatter:

myst_parser/inventory.py

@@ -80,7 +80,7 @@ def to_sphinx(inv: InventoryType) -> SphinxInventoryType:
     for domain_name, obj_types in inv["objects"].items():
         for obj_type, refs in obj_types.items():
             for refname, refdata in refs.items():
-                objs.setdefault(f"{domain_name}:{obj_type}", {})[refname] = (
+                objs.setdefault(f"{domain_name}:{obj_type}", {})[refname] = (  # type: ignore[assignment]
                     inv["name"],
                     inv["version"],
                     refdata["loc"],

myst_parser/mdit_to_docutils/base.py

@@ -976,8 +976,7 @@ def render_link_path(self, token: SyntaxTreeNode) -> None:
     def render_link_project(self, token: SyntaxTreeNode) -> None:
         """Render a link token like `<project:...>`."""
         destination = cast(str, token.attrGet("href") or "")
-        if destination.startswith("project:"):
-            destination = destination[8:]
+        destination = destination.removeprefix("project:")
         if destination.startswith("#"):
             return self.render_link_anchor(token, destination)
         self.create_warning(
@@ -1796,13 +1795,13 @@ def run_directive(
             )
             return [error_msg]
 
-        assert isinstance(
-            result, list
-        ), f'Directive "{name}" must return a list of nodes.'
+        assert isinstance(result, list), (
+            f'Directive "{name}" must return a list of nodes.'
+        )
         for i in range(len(result)):
-            assert isinstance(
-                result[i], nodes.Node
-            ), f'Directive "{name}" returned non-Node object (index {i}): {result[i]}'
+            assert isinstance(result[i], nodes.Node), (
+                f'Directive "{name}" returned non-Node object (index {i}): {result[i]}'
+            )
         return result
 
     def render_substitution_inline(self, token: SyntaxTreeNode) -> None:

myst_parser/mdit_to_docutils/sphinx_.py

@@ -72,8 +72,7 @@ def _handle_relative_docs(self, destination: str) -> str:
 
     def render_link_project(self, token: SyntaxTreeNode) -> None:
         destination = cast(str, token.attrGet("href") or "")
-        if destination.startswith("project:"):
-            destination = destination[8:]
+        destination = destination.removeprefix("project:")
         if destination.startswith("#"):
             return self.render_link_anchor(token, destination)
 
@@ -108,8 +107,7 @@ def render_link_project(self, token: SyntaxTreeNode) -> None:
 
     def render_link_path(self, token: SyntaxTreeNode) -> None:
         destination = self.md.normalizeLinkText(cast(str, token.attrGet("href") or ""))
-        if destination.startswith("path:"):
-            destination = destination[5:]
+        destination = destination.removeprefix("path:")
         destination = self._handle_relative_docs(destination)
         explicit = (token.info != "auto") and (len(token.children or []) > 0)
         wrap_node = addnodes.download_reference(