Bump the optional group with 12 updates (#10)

Updates the requirements on
[pydoclint](https://github.com/jsh9/pydoclint),
[isort](https://github.com/pycqa/isort),
[markdown](https://github.com/Python-Markdown/markdown),
[mkdocs-macros-plugin](https://github.com/fralau/mkdocs_macros_plugin),
[mkdocs-material](https://github.com/squidfunk/mkdocs-material),
[mkdocstrings[python]](https://github.com/mkdocstrings/mkdocstrings),
[mypy](https://github.com/python/mypy),
[types-markdown](https://github.com/python/typeshed),
[pylint](https://github.com/pylint-dev/pylint),
[pytest](https://github.com/pytest-dev/pytest),
[pytest-mock](https://github.com/pytest-dev/pytest-mock) and
[pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) to permit
the latest version.

Updates `pydoclint` from 0.3.2 to 0.4.1
- [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.4.1)

Updates `isort` from 5.12.0 to 5.13.2
- [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.2)

Updates `markdown` from 3.4.4 to 3.5.2
- [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.4.4...3.5.2)

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.11
- [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.11)

Updates `mkdocstrings[python]` from 0.23.0 to 0.24.1
- [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.1)

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

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

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

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

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.5
- [Release notes](https://github.com/pytest-dev/pytest-asyncio/releases)
-
[Commits](pytest-dev/pytest-asyncio@v0.21.1...v0.23.5)

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:

pyproject.toml

@@ -53,38 +53,38 @@ dev-flake8 = [
   "flake8 == 7.0.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.4.1",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 24.2.0", "isort == 5.12.0"]
+dev-formatting = ["black == 24.2.0", "isort == 5.13.2"]
 dev-mkdocs = [
   "black == 24.2.0",
-  "Markdown==3.4.4",
+  "Markdown==3.5.2",
   "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.11",
+  "mkdocstrings[python] == 0.24.1",
   "frequenz-repo-config[lib] == 0.9.1",
 ]
 dev-mypy = [
-  "mypy == 1.5.1",
-  "types-Markdown == 3.4.2.10",
+  "mypy == 1.8.0",
+  "types-Markdown == 3.5.0.20240129",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-microgrid[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-noxfile = ["nox == 2023.4.22", "frequenz-repo-config[lib] == 0.9.1"]
 dev-pylint = [
-  "pylint == 3.0.2",
+  "pylint == 3.1.0",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-microgrid[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 8.0.0",
+  "pytest == 8.0.2",
   "frequenz-repo-config[extra-lint-examples] == 0.9.1",
-  "pytest-mock == 3.11.1",
-  "pytest-asyncio == 0.21.1",
+  "pytest-mock == 3.12.0",
+  "pytest-asyncio == 0.23.5",
   "async-solipsism == 0.5",
 ]
 dev = [