Bump the required group across 1 directory with 12 updates (#1094)

Bumps the required group with 12 updates in the / directory:

| Package | From | To |
| --- | --- | --- |
| [pydoclint](https://github.com/jsh9/pydoclint) | `0.5.6` | `0.5.9` |
| [black](https://github.com/psf/black) | `24.8.0` | `24.10.0` |
| [mkdocs-macros-plugin](https://github.com/fralau/mkdocs_macros_plugin)
| `1.0.5` | `1.3.7` |
| [mkdocs-material](https://github.com/squidfunk/mkdocs-material) |
`9.5.34` | `9.5.43` |
| [mkdocstrings[python]](https://github.com/mkdocstrings/mkdocstrings) |
`0.25.2` | `0.26.2` |
| [mkdocstrings-python](https://github.com/mkdocstrings/python) |
`1.10.9` | `1.12.2` |
| [mypy](https://github.com/python/mypy) | `1.11.2` | `1.13.0` |
| [types-protobuf](https://github.com/python/typeshed) |
`5.27.0.20240626` | `5.28.3.20241030` |
| [nox](https://github.com/wntrblm/nox) | `2024.4.15` | `2024.10.9` |
| [pylint](https://github.com/pylint-dev/pylint) | `3.2.7` | `3.3.1` |
| [pytest](https://github.com/pytest-dev/pytest) | `8.3.2` | `8.3.3` |
| [hypothesis](https://github.com/HypothesisWorks/hypothesis) |
`6.111.2` | `6.116.0` |

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

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

Updates `mkdocs-macros-plugin` from 1.0.5 to 1.3.7
- [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.5...v1.3.7)

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

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

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

Updates `mypy` from 1.11.2 to 1.13.0
- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
- [Commits](python/mypy@v1.11.2...v1.13.0)

Updates `types-protobuf` from 5.27.0.20240626 to 5.28.3.20241030
- [Commits](https://github.com/python/typeshed/commits)

Updates `nox` from 2024.4.15 to 2024.10.9
- [Release notes](https://github.com/wntrblm/nox/releases)
- [Changelog](https://github.com/wntrblm/nox/blob/main/CHANGELOG.md)
-
[Commits](wntrblm/nox@2024.04.15...2024.10.09)

Updates `pylint` from 3.2.7 to 3.3.1
- [Release notes](https://github.com/pylint-dev/pylint/releases)
-
[Commits](pylint-dev/pylint@v3.2.7...v3.3.1)

Updates `pytest` from 8.3.2 to 8.3.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@8.3.2...8.3.3)

Updates `hypothesis` from 6.111.2 to 6.116.0
- [Release
notes](https://github.com/HypothesisWorks/hypothesis/releases)
-
[Commits](HypothesisWorks/hypothesis@hypothesis-python-6.111.2...hypothesis-python-6.116.0)

Author: llucax

RELEASE_NOTES.md

@@ -15,6 +15,8 @@
    actor = ConfigManagingActor(config_files=["config.toml"])
    ```
 
+* The `MovingWindow` now take all arguments as keyword-only to avoid mistakes.
+
 ## New Features
 
 - The `ConfigManagingActor` can now take multiple configuration files as input, allowing to override default configurations with custom configurations.

benchmarks/timeseries/periodic_feature_extractor.py

@@ -35,7 +35,9 @@ async def init_feature_extractor(
     # We only need the moving window to initialize the PeriodicFeatureExtractor class.
     lm_chan = Broadcast[Sample[Quantity]](name="lm_net_power")
     async with MovingWindow(
-        timedelta(seconds=1), lm_chan.new_receiver(), timedelta(seconds=1)
+        size=timedelta(seconds=1),
+        resampled_data_recv=lm_chan.new_receiver(),
+        input_sampling_period=timedelta(seconds=1),
     ) as moving_window:
         await lm_chan.new_sender().send(
             Sample(datetime.now(tz=timezone.utc), Quantity(0))

pyproject.toml

@@ -47,44 +47,44 @@ dev-flake8 = [
   "flake8 == 7.1.1",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.3",  # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.5.6",
+  "pydoclint == 0.5.9",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 24.8.0", "isort == 5.13.2"]
+dev-formatting = ["black == 24.10.0", "isort == 5.13.2"]
 dev-mkdocs = [
-  "black == 24.8.0",
+  "black == 24.10.0",
   "Markdown==3.7",
   "mike == 2.1.3",
   "mkdocs-gen-files == 0.5.0",
   "mkdocs-literate-nav == 0.6.1",
-  "mkdocs-macros-plugin == 1.0.5",
-  "mkdocs-material == 9.5.34",
-  "mkdocstrings[python] == 0.25.2",
-  "mkdocstrings-python == 1.10.9",
+  "mkdocs-macros-plugin == 1.3.7",
+  "mkdocs-material == 9.5.43",
+  "mkdocstrings[python] == 0.26.2",
+  "mkdocstrings-python == 1.12.2",
   "frequenz-repo-config[lib] == 0.10.0",
 ]
 dev-mypy = [
-  "mypy == 1.11.2",
+  "mypy == 1.13.0",
   "types-Markdown == 3.7.0.20240822",
-  "types-protobuf == 5.27.0.20240626",
+  "types-protobuf == 5.28.3.20241030",
   "types-setuptools == 74.0.0.20240831",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-sdk[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
-dev-noxfile = ["nox == 2024.4.15", "frequenz-repo-config[lib] == 0.10.0"]
+dev-noxfile = ["nox == 2024.10.9", "frequenz-repo-config[lib] == 0.10.0"]
 dev-pylint = [
-  "pylint == 3.2.7",
+  "pylint == 3.3.1",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-sdk[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 8.3.2",
+  "pytest == 8.3.3",
   "frequenz-repo-config[extra-lint-examples] == 0.10.0",
   "pytest-mock == 3.14.0",
   "pytest-asyncio == 0.24.0",
   "time-machine == 2.12.0",
   "async-solipsism == 0.7",
-  "hypothesis == 6.111.2",
+  "hypothesis == 6.116.0",
 ]
 dev = [
   "frequenz-sdk[dev-mkdocs,dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",

src/frequenz/sdk/_internal/_channels.py

@@ -153,20 +153,20 @@ def get_or_create(self, message_type: type[T], key: str) -> Broadcast[T]:
 
         entry = self._channels[key]
         if entry.message_type is not message_type:
-            exception = ValueError(
+            error_message = (
                 f"Type mismatch, a channel for key {key!r} exists and the requested "
                 f"message type {message_type} is not the same as the existing "
                 f"message type {entry.message_type}."
             )
             if _logger.isEnabledFor(logging.DEBUG):
                 _logger.debug(
                     "%s at:\n%s",
-                    str(exception),
+                    error_message,
                     # We skip the last frame because it's this method, and limit the
                     # stack to 9 frames to avoid adding too much noise.
                     "".join(traceback.format_stack(limit=10)[:9]),
                 )
-            raise exception
+            raise ValueError(error_message)
 
         return typing.cast(Broadcast[T], entry.channel)
 

src/frequenz/sdk/actor/_background_service.py

@@ -129,7 +129,9 @@ def cancel(self, msg: str | None = None) -> None:
         for task in self._tasks:
             task.cancel(msg)
 
-    async def stop(self, msg: str | None = None) -> None:
+    # We need the noqa because pydoclint can't figure out `rest` is
+    # a `BaseExceptionGroup` instance.
+    async def stop(self, msg: str | None = None) -> None:  # noqa: DOC503
         """Stop this background service.
 
         This method cancels all running tasks spawned by this service and waits for them

src/frequenz/sdk/microgrid/_power_distributing/_component_pool_status_tracker.py

@@ -33,6 +33,7 @@ class ComponentPoolStatusTracker:
 
     def __init__(  # pylint: disable=too-many-arguments
         self,
+        *,
         component_ids: abc.Set[int],
         component_status_sender: Sender[ComponentPoolStatus],
         max_data_age: timedelta,

src/frequenz/sdk/microgrid/_power_distributing/_component_status/_battery_status_tracker.py

@@ -99,6 +99,7 @@ class BatteryStatusTracker(ComponentStatusTracker, BackgroundService):
     @override
     def __init__(  # pylint: disable=too-many-arguments
         self,
+        *,
         component_id: int,
         max_data_age: timedelta,
         max_blocking_duration: timedelta,

src/frequenz/sdk/microgrid/_power_distributing/_component_status/_component_status.py

@@ -85,6 +85,7 @@ class ComponentStatusTracker(BackgroundService, ABC):
     @abstractmethod
     def __init__(  # pylint: disable=too-many-arguments,super-init-not-called
         self,
+        *,
         component_id: int,
         max_data_age: timedelta,
         max_blocking_duration: timedelta,

src/frequenz/sdk/microgrid/_power_distributing/_component_status/_ev_charger_status_tracker.py

@@ -46,6 +46,7 @@ class EVChargerStatusTracker(ComponentStatusTracker, BackgroundService):
     @override
     def __init__(  # pylint: disable=too-many-arguments
         self,
+        *,
         component_id: int,
         max_data_age: timedelta,
         max_blocking_duration: timedelta,

src/frequenz/sdk/microgrid/_power_distributing/_component_status/_pv_inverter_status_tracker.py

@@ -43,6 +43,7 @@ class PVInverterStatusTracker(ComponentStatusTracker, BackgroundService):
     @override
     def __init__(  # pylint: disable=too-many-arguments
         self,
+        *,
         component_id: int,
         max_data_age: timedelta,
         max_blocking_duration: timedelta,