Add a base config schema that provides quantities support

This schema is provided to use as a default, and might be extended in
the future to support more commonly used fields that are not provided
by marshmallow by default.

To use the quantity schema we need to bump the `frequenz-quantities`
dependency and add the optional `marshmallow` dependency.

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

pyproject.toml

@@ -31,7 +31,7 @@ dependencies = [
   # (plugins.mkdocstrings.handlers.python.import)
   "frequenz-client-microgrid >= 0.6.0, < 0.7.0",
   "frequenz-channels >= 1.4.0, < 2.0.0",
-  "frequenz-quantities >= 1.0.0rc3, < 2.0.0",
+  "frequenz-quantities[marshmallow] >= 1.0.0, < 2.0.0",
   "networkx >= 2.8, < 4",
   "numpy >= 1.26.4, < 2",
   "typing_extensions >= 4.6.1, < 5",

src/frequenz/sdk/config/__init__.py

@@ -3,12 +3,14 @@
 
 """Configuration management."""
 
+from ._base_schema import BaseConfigSchema
 from ._logging_actor import LoggerConfig, LoggingConfig, LoggingConfigUpdatingActor
 from ._manager import ConfigManager, InvalidValueForKeyError
 from ._managing_actor import ConfigManagingActor
 from ._util import load_config
 
 __all__ = [
+    "BaseConfigSchema",
     "ConfigManager",
     "ConfigManagingActor",
     "InvalidValueForKeyError",

src/frequenz/sdk/config/_base_schema.py

@@ -0,0 +1,10 @@
+# License: MIT
+# Copyright © 2024 Frequenz Energy-as-a-Service GmbH
+
+"""Base schema for configuration classes."""
+
+from frequenz.quantities.experimental.marshmallow import QuantitySchema
+
+
+class BaseConfigSchema(QuantitySchema):
+    """A base schema for configuration classes."""

src/frequenz/sdk/config/_manager.py

@@ -16,6 +16,7 @@
 from typing_extensions import override
 
 from ..actor._background_service import BackgroundService
+from ._base_schema import BaseConfigSchema
 from ._managing_actor import ConfigManagingActor
 from ._util import DataclassT, load_config
 
@@ -139,7 +140,7 @@ def new_receiver(  # pylint: disable=too-many-arguments
         /,
         *,
         skip_unchanged: bool = True,
-        base_schema: type[Schema] | None = None,
+        base_schema: type[Schema] | None = BaseConfigSchema,
         marshmallow_load_kwargs: dict[str, Any] | None = None,
     ) -> Receiver[DataclassT | Exception | None]:
         """Create a new receiver for receiving the configuration for a particular key.
@@ -387,7 +388,7 @@ def _load_config(
     config_class: type[DataclassT],
     *,
     key: str | Sequence[str],
-    base_schema: type[Schema] | None = None,
+    base_schema: type[Schema] | None = BaseConfigSchema,
     marshmallow_load_kwargs: dict[str, Any] | None = None,
 ) -> DataclassT | InvalidValueForKeyError | ValidationError | None:
     """Try to load a configuration and log any validation errors."""