Bump the optional group with 13 updates (#4)

Bumps the optional group with 13 updates:

| Package | From | To |
| --- | --- | --- |
| [markdown](https://github.com/Python-Markdown/markdown) | `3.5` |
`3.5.1` |
| [pydoclint](https://github.com/jsh9/pydoclint) | `0.3.2` | `0.3.8` |
| [black](https://github.com/psf/black) | `23.9.1` | `23.12.0` |
| [isort](https://github.com/pycqa/isort) | `5.12.0` | `5.13.1` |
| [mkdocs-macros-plugin](https://github.com/fralau/mkdocs_macros_plugin)
| `1.0.4` | `1.0.5` |
| [mkdocs-material](https://github.com/squidfunk/mkdocs-material) |
`9.3.1` | `9.5.2` |
| [mkdocstrings[python]](https://github.com/mkdocstrings/mkdocstrings) |
`0.23.0` | `0.24.0` |
| [mypy](https://github.com/python/mypy) | `1.5.1` | `1.7.1` |
| [types-markdown](https://github.com/python/typeshed) | `3.4.2.10` |
`3.5.0.3` |
| [pylint](https://github.com/pylint-dev/pylint) | `3.0.2` | `3.0.3` |
| [pytest](https://github.com/pytest-dev/pytest) | `7.4.2` | `7.4.3` |
| [pytest-mock](https://github.com/pytest-dev/pytest-mock) | `3.11.1` |
`3.12.0` |
| [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) |
`0.21.1` | `0.23.2` |


Updates `markdown` from 3.5 to 3.5.1
- [Release notes](https://github.com/Python-Markdown/markdown/releases)
-
[Changelog](https://github.com/Python-Markdown/markdown/blob/master/docs/changelog.md)
-
[Commits](Python-Markdown/markdown@3.5...3.5.1)

Updates `pydoclint` from 0.3.2 to 0.3.8
- [Release notes](https://github.com/jsh9/pydoclint/releases)
- [Changelog](https://github.com/jsh9/pydoclint/blob/main/CHANGELOG.md)
- [Commits](jsh9/pydoclint@0.3.2...0.3.8)

Updates `black` from 23.9.1 to 23.12.0
- [Release notes](https://github.com/psf/black/releases)
- [Changelog](https://github.com/psf/black/blob/main/CHANGES.md)
- [Commits](psf/black@23.9.1...23.12.0)

Updates `isort` from 5.12.0 to 5.13.1
- [Release notes](https://github.com/pycqa/isort/releases)
- [Changelog](https://github.com/PyCQA/isort/blob/main/CHANGELOG.md)
- [Commits](PyCQA/isort@5.12.0...5.13.1)

Updates `mkdocs-macros-plugin` from 1.0.4 to 1.0.5
- [Release
notes](https://github.com/fralau/mkdocs_macros_plugin/releases)
-
[Changelog](https://github.com/fralau/mkdocs_macros_plugin/blob/master/CHANGELOG.md)
-
[Commits](fralau/mkdocs-macros-plugin@v1.0.4...v1.0.5)

Updates `mkdocs-material` from 9.3.1 to 9.5.2
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
-
[Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
-
[Commits](squidfunk/mkdocs-material@9.3.1...9.5.2)

Updates `mkdocstrings[python]` from 0.23.0 to 0.24.0
- [Release notes](https://github.com/mkdocstrings/mkdocstrings/releases)
-
[Changelog](https://github.com/mkdocstrings/mkdocstrings/blob/main/CHANGELOG.md)
-
[Commits](mkdocstrings/mkdocstrings@0.23.0...0.24.0)

Updates `mypy` from 1.5.1 to 1.7.1
- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
- [Commits](python/mypy@v1.5.1...v1.7.1)

Updates `types-markdown` from 3.4.2.10 to 3.5.0.3
- [Commits](https://github.com/python/typeshed/commits)

Updates `pylint` from 3.0.2 to 3.0.3
- [Release notes](https://github.com/pylint-dev/pylint/releases)
-
[Commits](pylint-dev/pylint@v3.0.2...v3.0.3)

Updates `pytest` from 7.4.2 to 7.4.3
- [Release notes](https://github.com/pytest-dev/pytest/releases)
-
[Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest@7.4.2...7.4.3)

Updates `pytest-mock` from 3.11.1 to 3.12.0
- [Release notes](https://github.com/pytest-dev/pytest-mock/releases)
-
[Changelog](https://github.com/pytest-dev/pytest-mock/blob/main/CHANGELOG.rst)
-
[Commits](pytest-dev/pytest-mock@v3.11.1...v3.12.0)

Updates `pytest-asyncio` from 0.21.1 to 0.23.2
- [Release notes](https://github.com/pytest-dev/pytest-asyncio/releases)
-
[Commits](pytest-dev/pytest-asyncio@v0.21.1...v0.23.2)

Author: llucax

docs/_scripts/macros.py

@@ -27,10 +27,7 @@ def _slugify(text: str) -> str:
     Returns:
         The slugified text.
     """
-    # The type of the return value is not defined for the markdown library.
-    # Also for some reason `mypy` thinks the `toc` module doesn't have a
-    # `slugify_unicode` function, but it definitely does.
-    return toc.slugify_unicode(text, "-")  # type: ignore[attr-defined,no-any-return]
+    return toc.slugify_unicode(text, "-")
 
 
 def _hook_macros_plugin(env: macros.MacrosPlugin) -> None:

mkdocs.yml

@@ -100,7 +100,6 @@ plugins:
       alias_type: redirect
       canonical_version: latest
   - mkdocstrings:
-      custom_templates: templates
       default_handler: python
       handlers:
         python:

pyproject.toml

@@ -51,38 +51,38 @@ dev-flake8 = [
   "flake8 == 6.1.0",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.3",  # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.3.2",
+  "pydoclint == 0.3.8",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 23.9.1", "isort == 5.12.0"]
+dev-formatting = ["black == 23.12.0", "isort == 5.13.1"]
 dev-mkdocs = [
-  "black == 23.9.1",
-  "Markdown==3.5",
+  "black == 23.12.0",
+  "Markdown==3.5.1",
   "mike == 2.0.0",
   "mkdocs-gen-files == 0.5.0",
   "mkdocs-literate-nav == 0.6.1",
-  "mkdocs-macros-plugin == 1.0.4",
-  "mkdocs-material == 9.3.1",
-  "mkdocstrings[python] == 0.23.0",
+  "mkdocs-macros-plugin == 1.0.5",
+  "mkdocs-material == 9.5.2",
+  "mkdocstrings[python] == 0.24.0",
   "frequenz-repo-config[lib] == 0.7.5",
 ]
 dev-mypy = [
-  "mypy == 1.5.1",
-  "types-Markdown == 3.4.2.10",
+  "mypy == 1.7.1",
+  "types-Markdown == 3.5.0.3",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-pymdownx-superfences-filter-lines[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-noxfile = ["nox == 2023.4.22", "frequenz-repo-config[lib] == 0.7.5"]
 dev-pylint = [
-  "pylint == 3.0.2",
+  "pylint == 3.0.3",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-pymdownx-superfences-filter-lines[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 7.4.2",
+  "pytest == 7.4.3",
   "frequenz-repo-config[extra-lint-examples] == 0.7.5",
-  "pytest-mock == 3.11.1",
-  "pytest-asyncio == 0.21.1",
+  "pytest-mock == 3.12.0",
+  "pytest-asyncio == 0.23.2",
   "async-solipsism == 0.5",
 ]
 dev = [

src/frequenz/pymdownx/superfences/filter_lines/__init__.py

@@ -9,7 +9,7 @@
 from typing import Any, NotRequired, Self, Set, TypedDict, cast
 
 import markdown
-from pymdownx.superfences import highlight_validator
+from pymdownx.superfences import SuperFencesBlockPreprocessor, highlight_validator
 
 
 @dataclasses.dataclass(frozen=True, kw_only=True)
@@ -222,7 +222,9 @@ def do_format(
         src = "".join(lines)
 
     # Run through default highlighter
-    return md.preprocessors["fenced_code_block"].highlight(
+    fenced_code_block = md.preprocessors["fenced_code_block"]
+    assert isinstance(fenced_code_block, SuperFencesBlockPreprocessor)
+    return fenced_code_block.highlight(
         src=src,
         class_name=class_name,
         language=language,

tests/test_do_format.py

@@ -8,6 +8,7 @@
 from unittest import mock
 
 import pytest
+from pymdownx.superfences import SuperFencesBlockPreprocessor
 
 from frequenz.pymdownx.superfences.filter_lines import (
     LinesRange,
@@ -21,15 +22,16 @@
 def md_mock() -> Iterator[mock.MagicMock]:
     """Mock the `md` object."""
     md = mock.MagicMock()
-    preprocessor = mock.MagicMock()
-    preprocessor.highlight.side_effect = True
-    md.preprocessors.return_value = {"fenced_code_block": preprocessor}
+    preprocessor = mock.MagicMock(spec=SuperFencesBlockPreprocessor)
+    preprocessor.highlight.return_value = True
+    preprocessors = {"fenced_code_block": preprocessor}
+    md.preprocessors.__getitem__.side_effect = preprocessors.__getitem__
     yield md
 
 
 _SOURCE = """\
 1. This is some text
-2. which have multiple lines
+2. which has multiple lines
 3. and we want to filter some of them
 4. we number them
 5. so we can see which ones are filtered
@@ -98,7 +100,7 @@ class _TestCase:
         options=Options(show_lines=LinesRanges({LinesRange(end=3)})),
         expected_src="""\
 1. This is some text
-2. which have multiple lines
+2. which has multiple lines
 3. and we want to filter some of them
 """,
     ),
@@ -107,7 +109,7 @@ class _TestCase:
         title="Open range with start and end in the middle",
         options=Options(show_lines=LinesRanges({LinesRange(start=2, end=4)})),
         expected_src="""\
-2. which have multiple lines
+2. which has multiple lines
 3. and we want to filter some of them
 4. we number them
 """,
@@ -142,7 +144,7 @@ class _TestCase:
         ),
         expected_src="""\
 1. This is some text
-2. which have multiple lines
+2. which has multiple lines
 4. we number them
 5. so we can see which ones are filtered
 6. and which ones are not