Bump the optional group with 14 updates (#837)

Updates the requirements on
[pydoclint](https://github.com/jsh9/pydoclint),
[polars](https://github.com/pola-rs/polars),
[black](https://github.com/psf/black),
[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),
[types-pygments](https://github.com/python/typeshed),
[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.3 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.3...0.3.8)

Updates `polars` from 0.19.3 to 0.20.2
- [Release notes](https://github.com/pola-rs/polars/releases)
-
[Commits](pola-rs/polars@py-0.19.3...py-0.20.2)

Updates `black` from 23.9.1 to 23.12.1
- [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.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.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.4.4...3.5.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.3
- [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.3)

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.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.3
- [Commits](https://github.com/python/typeshed/commits)

Updates `types-pygments` from 2.16.0.0 to 2.17.0.0
- [Commits](https://github.com/python/typeshed/commits)

Updates `pytest` from 7.4.2 to 7.4.4
- [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.4)

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

Author: llucax

docs/_scripts/macros.py

@@ -29,10 +29,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

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

pyproject.toml

@@ -54,28 +54,28 @@ 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.3",
+  "pydoclint == 0.3.8",
   "pydocstyle == 6.3.0",
 ]
-dev-examples = ["polars == 0.19.3"]
-dev-formatting = ["black == 23.9.1", "isort == 5.12.0"]
+dev-examples = ["polars == 0.20.2"]
+dev-formatting = ["black == 23.12.1", "isort == 5.13.2"]
 dev-mkdocs = [
-  "black == 23.9.1",
-  "Markdown==3.4.4",
+  "black == 23.12.1",
+  "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.3",
+  "mkdocstrings[python] == 0.24.0",
   "frequenz-repo-config[lib] == 0.7.4",
 ]
 dev-mypy = [
-  "mypy == 1.5.1",
+  "mypy == 1.8.0",
   "grpc-stubs == 1.24.12",              # This dependency introduces breaking changes in patch releases
-  "types-Markdown == 3.4.2.10",
+  "types-Markdown == 3.5.0.3",
   "types-PyYAML == 6.0.12.12",
-  "types-Pygments == 2.16.0.0",
+  "types-Pygments == 2.17.0.0",
   "types-colorama == 0.4.15.12",
   "types-protobuf == 4.24.0.4",
   "types-python-dateutil == 2.8.19.14",
@@ -91,10 +91,10 @@ dev-pylint = [
   "frequenz-sdk[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 7.4.2",
+  "pytest == 7.4.4",
   "frequenz-repo-config[extra-lint-examples] == 0.7.4",
-  "pytest-mock == 3.11.1",
-  "pytest-asyncio == 0.21.1",
+  "pytest-mock == 3.12.0",
+  "pytest-asyncio == 0.23.3",
   "time-machine == 2.12.0",
   "async-solipsism == 0.5",
   # For checking docstring code examples

src/frequenz/sdk/timeseries/_resampling.py

@@ -14,6 +14,7 @@
 from collections.abc import AsyncIterator, Callable, Coroutine, Sequence
 from dataclasses import dataclass
 from datetime import datetime, timedelta, timezone
+from typing import cast
 
 from frequenz.channels.util import Timer
 from frequenz.channels.util._timer import _to_microseconds
@@ -501,13 +502,19 @@ async def resample(self, *, one_shot: bool = False) -> None:
             )
 
             self._window_end += self._config.resampling_period
-            exceptions = {
-                source: results[i]
-                for i, source in enumerate(self._resamplers)
-                # CancelledError inherits from BaseException, but we don't want
-                # to catch *all* BaseExceptions here.
-                if isinstance(results[i], (Exception, asyncio.CancelledError))
-            }
+            # We need the cast because mypy is not able to infer that this can only
+            # contain Exception | CancelledError because of the condition in the list
+            # comprehension below.
+            exceptions = cast(
+                dict[Source, Exception | asyncio.CancelledError],
+                {
+                    source: results[i]
+                    for i, source in enumerate(self._resamplers)
+                    # CancelledError inherits from BaseException, but we don't want
+                    # to catch *all* BaseExceptions here.
+                    if isinstance(results[i], (Exception, asyncio.CancelledError))
+                },
+            )
             if exceptions:
                 raise ResamplingError(exceptions)
             if one_shot:

src/frequenz/sdk/timeseries/formula_engine/_formula_engine.py

@@ -54,34 +54,36 @@
 }
 """The dictionary of operator precedence for the shunting yard algorithm."""
 
+
+# The `FormulaEngine*` and `HigherOrderFormulaBuilder*` classes are generic, but
+# `TypeVar`s can't be defined on generic types, so we need to use `# type: ignore` to
+# avoid mypy errors, and they get treated as `FormulaEngine[Any]`, etc.
+#
+# This is not ideal, but it's the best we can do until mypy supports generic types with
+# `TypeVar`s.
 _CompositionType = Union[
-    "FormulaEngine",
-    "HigherOrderFormulaBuilder",
-    "FormulaEngine3Phase",
-    "HigherOrderFormulaBuilder3Phase",
+    "FormulaEngine",  # type: ignore[type-arg]
+    "HigherOrderFormulaBuilder",  # type: ignore[type-arg]
+    "FormulaEngine3Phase",  # type: ignore[type-arg]
+    "HigherOrderFormulaBuilder3Phase",  # type: ignore[type-arg]
 ]
 
 _CompositionType1Phase = Union[
-    "FormulaEngine",
-    "HigherOrderFormulaBuilder",
+    "FormulaEngine",  # type: ignore[type-arg]
+    "HigherOrderFormulaBuilder",  # type: ignore[type-arg]
 ]
 
 _CompositionType3Phase = Union[
-    "FormulaEngine3Phase",
-    "HigherOrderFormulaBuilder3Phase",
+    "FormulaEngine3Phase",  # type: ignore[type-arg]
+    "HigherOrderFormulaBuilder3Phase",  # type: ignore[type-arg]
 ]
 
-# The `FormulaEngine*` and `HigherOrderFormulaBuilder*` classes are generic, but
-# `TypeVar`s can't be defined on generic types, so we need to use `# type: ignore` to
-# avoid mypy errors, and they get treated as `FormulaEngine[Any]`, etc.
-#
-# This is not ideal, but it's the best we can do until mypy supports generic types with
-# `TypeVar`s.
 _GenericEngine = TypeVar(
     "_GenericEngine",
     "FormulaEngine",  # type: ignore
     "FormulaEngine3Phase",  # type: ignore
 )
+
 _GenericHigherOrderBuilder = TypeVar(
     "_GenericHigherOrderBuilder",
     "HigherOrderFormulaBuilder",  # type: ignore

tests/microgrid/test_microgrid_api.py

@@ -102,15 +102,15 @@ def metadata(self) -> meta.Metadata:
     @mock.patch("grpc.aio.insecure_channel")
     async def test_connection_manager(
         self,
-        _: MagicMock,
+        _insecure_channel_mock: MagicMock,
         components: list[list[Component]],
         connections: list[list[Connection]],
         metadata: meta.Metadata,
     ) -> None:
         """Test microgrid api.
 
         Args:
-            _: insecure channel mock from `mock.patch`
+            _insecure_channel_mock: insecure channel mock from `mock.patch`
             components: components
             connections: connections
             metadata: the metadata of the microgrid
@@ -179,15 +179,15 @@ async def test_connection_manager(
     @mock.patch("grpc.aio.insecure_channel")
     async def test_connection_manager_another_method(
         self,
-        _: MagicMock,
+        _insecure_channel_mock: MagicMock,
         components: list[list[Component]],
         connections: list[list[Connection]],
         metadata: meta.Metadata,
     ) -> None:
         """Test if the api was not deallocated.
 
         Args:
-            _: insecure channel mock
+            _insecure_channel_mock: insecure channel mock
             components: components
             connections: connections
             metadata: the metadata of the microgrid