frequenz-core 1.0.2__tar.gz → 1.1.0__tar.gz

frequenz_core-1.1.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: frequenz-core
+Version: 1.1.0
+Summary: Core utilities to complement Python's standard library
+Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
+License: MIT
+Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-core-python/
+Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-core-python/releases
+Project-URL: Issues, https://github.com/frequenz-floss/frequenz-core-python/issues
+Project-URL: Repository, https://github.com/frequenz-floss/frequenz-core-python
+Project-URL: Support, https://github.com/frequenz-floss/frequenz-core-python/discussions/categories/support
+Keywords: asyncio,collections,core,datetime,frequenz,lib,library,math,python,stdlib,typing
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-extensions<5,>=4.13.0
+Provides-Extra: dev-flake8
+Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
+Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
+Requires-Dist: flake8-pyproject==1.2.3; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.6.6; extra == "dev-flake8"
+Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
+Provides-Extra: dev-formatting
+Requires-Dist: black==25.1.0; extra == "dev-formatting"
+Requires-Dist: isort==6.0.1; extra == "dev-formatting"
+Provides-Extra: dev-mkdocs
+Requires-Dist: Markdown==3.8.2; extra == "dev-mkdocs"
+Requires-Dist: black==25.1.0; extra == "dev-mkdocs"
+Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-material==9.6.16; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==0.30.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==1.17.0; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.13.5; extra == "dev-mkdocs"
+Provides-Extra: dev-mypy
+Requires-Dist: mypy==1.17.1; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.8.0.20250708; extra == "dev-mypy"
+Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
+Provides-Extra: dev-noxfile
+Requires-Dist: nox==2025.5.1; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.13.5; extra == "dev-noxfile"
+Provides-Extra: dev-pylint
+Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
+Provides-Extra: dev-pytest
+Requires-Dist: pytest==8.4.1; extra == "dev-pytest"
+Requires-Dist: pylint==3.3.7; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.5; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.14.1; extra == "dev-pytest"
+Requires-Dist: pytest-asyncio==1.1.0; extra == "dev-pytest"
+Requires-Dist: async-solipsism==0.8; extra == "dev-pytest"
+Requires-Dist: hypothesis==6.138.2; extra == "dev-pytest"
+Provides-Extra: dev
+Requires-Dist: frequenz-core[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
+Dynamic: license-file
+
+# Frequenz Core Library
+
+[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
+[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
+[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
+
+## Introduction
+
+Core utilities to complement Python's standard library. This library provides
+essential building blocks for Python applications, including mathematical
+utilities, datetime constants, typing helpers, strongly-typed identifiers, and
+module introspection tools.
+
+The `frequenz-core` library is designed to be lightweight, type-safe, and
+follow modern Python best practices. It fills common gaps in the standard
+library with utilities that are frequently needed across different projects.
+
+## Supported Platforms
+
+The following platforms are officially supported (tested):
+
+- **Python:** 3.11
+- **Operating System:** Ubuntu Linux 20.04
+- **Architectures:** amd64, arm64
+
+## Installation
+
+You can install the library from PyPI using pip:
+
+```bash
+python -m pip install frequenz-core
+```
+
+Or add it to your project's dependencies in `pyproject.toml`:
+
+```toml
+[project]
+dependencies = [
+    "frequenz-core >= 1.0.2, < 2",
+]
+```
+
+> [!NOTE]
+> We recommend pinning the dependency to the latest version for programs,
+> like `"frequenz-core == 1.0.2"`, and specifying a version range spanning
+> one major version for libraries, like `"frequenz-core >= 1.0.2, < 2"`.
+> We follow [semver](https://semver.org/).
+
+## Quick Start
+
+Here's a quick overview of the main functionality:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+from frequenz.core.datetime import UNIX_EPOCH
+from frequenz.core.module import get_public_module_name
+
+# Math utilities
+print(is_close_to_zero(1e-10))  # True - check if float is close to zero
+interval = Interval(1, 10)
+print(5 in interval)  # True - check if value is in range
+
+# Datetime utilities
+print(UNIX_EPOCH)  # 1970-01-01 00:00:00+00:00
+
+# Module utilities
+public_name = get_public_module_name("my.package._private.module")
+print(public_name)  # "my.package"
+```
+
+## Code Examples
+
+### Math Utilities
+
+The math module provides utilities for floating-point comparisons and interval
+checking:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+
+# Robust floating-point zero comparison
+assert is_close_to_zero(1e-10)  # True
+assert not is_close_to_zero(0.1)  # False
+
+# Interval checking with inclusive bounds
+numbers = Interval(0, 100)
+assert 50 in numbers  # True
+assert not (150 in numbers)  # False - 150 is outside the interval
+
+# Unbounded intervals
+positive = Interval(0, None)  # [0, ∞]
+assert 1000 in positive  # True
+```
+
+### `Enum` with deprecated members
+
+Define enums with deprecated members that raise deprecation warnings when
+accessed:
+
+```python
+from frequenz.core.enum import Enum, DeprecatedMember
+
+class TaskStatus(Enum):
+   OPEN = 1
+   IN_PROGRESS = 2
+   PENDING = DeprecatedMember(1, "PENDING is deprecated, use OPEN instead")
+   DONE = DeprecatedMember(3, "DONE is deprecated, use FINISHED instead")
+   FINISHED = 4
+
+status1 = TaskStatus.PENDING  # Warns: "PENDING is deprecated, use OPEN instead"
+assert status1 is TaskStatus.OPEN
+```
+
+### Typing Utilities
+
+Disable class constructors to enforce factory pattern usage:
+
+```python
+from frequenz.core.typing import disable_init
+
+@disable_init
+class ApiClient:
+    @classmethod
+    def create(cls, api_key: str) -> "ApiClient":
+        # Factory method with validation
+        instance = cls.__new__(cls)
+        # Custom initialization logic here
+        return instance
+
+# This will raise TypeError:
+# client = ApiClient()  # ❌ TypeError
+
+# Use factory method instead:
+client = ApiClient.create("my-api-key")  # ✅ Works
+```
+
+### Strongly-Typed IDs
+
+Create type-safe identifiers for different entities:
+
+```python
+from frequenz.core.id import BaseId
+
+class UserId(BaseId, str_prefix="USR"):
+    pass
+
+class OrderId(BaseId, str_prefix="ORD"):
+    pass
+
+user_id = UserId(123)
+order_id = OrderId(456)
+
+print(f"User: {user_id}")  # User: USR123
+print(f"Order: {order_id}")  # Order: ORD456
+
+# Type safety prevents mixing different ID types
+def process_user(user_id: UserId) -> None:
+    print(f"Processing user: {user_id}")
+
+process_user(user_id)  # ✅ Works
+# process_user(order_id)  # ❌ Type error
+```
+
+## Documentation
+
+For information on how to use this library, please refer to the
+[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
+
+## Contributing
+
+If you want to know how to build this project and contribute to it, please
+check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_core-1.1.0/README.md

@@ -0,0 +1,172 @@
+# Frequenz Core Library
+
+[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
+[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
+[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
+
+## Introduction
+
+Core utilities to complement Python's standard library. This library provides
+essential building blocks for Python applications, including mathematical
+utilities, datetime constants, typing helpers, strongly-typed identifiers, and
+module introspection tools.
+
+The `frequenz-core` library is designed to be lightweight, type-safe, and
+follow modern Python best practices. It fills common gaps in the standard
+library with utilities that are frequently needed across different projects.
+
+## Supported Platforms
+
+The following platforms are officially supported (tested):
+
+- **Python:** 3.11
+- **Operating System:** Ubuntu Linux 20.04
+- **Architectures:** amd64, arm64
+
+## Installation
+
+You can install the library from PyPI using pip:
+
+```bash
+python -m pip install frequenz-core
+```
+
+Or add it to your project's dependencies in `pyproject.toml`:
+
+```toml
+[project]
+dependencies = [
+    "frequenz-core >= 1.0.2, < 2",
+]
+```
+
+> [!NOTE]
+> We recommend pinning the dependency to the latest version for programs,
+> like `"frequenz-core == 1.0.2"`, and specifying a version range spanning
+> one major version for libraries, like `"frequenz-core >= 1.0.2, < 2"`.
+> We follow [semver](https://semver.org/).
+
+## Quick Start
+
+Here's a quick overview of the main functionality:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+from frequenz.core.datetime import UNIX_EPOCH
+from frequenz.core.module import get_public_module_name
+
+# Math utilities
+print(is_close_to_zero(1e-10))  # True - check if float is close to zero
+interval = Interval(1, 10)
+print(5 in interval)  # True - check if value is in range
+
+# Datetime utilities
+print(UNIX_EPOCH)  # 1970-01-01 00:00:00+00:00
+
+# Module utilities
+public_name = get_public_module_name("my.package._private.module")
+print(public_name)  # "my.package"
+```
+
+## Code Examples
+
+### Math Utilities
+
+The math module provides utilities for floating-point comparisons and interval
+checking:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+
+# Robust floating-point zero comparison
+assert is_close_to_zero(1e-10)  # True
+assert not is_close_to_zero(0.1)  # False
+
+# Interval checking with inclusive bounds
+numbers = Interval(0, 100)
+assert 50 in numbers  # True
+assert not (150 in numbers)  # False - 150 is outside the interval
+
+# Unbounded intervals
+positive = Interval(0, None)  # [0, ∞]
+assert 1000 in positive  # True
+```
+
+### `Enum` with deprecated members
+
+Define enums with deprecated members that raise deprecation warnings when
+accessed:
+
+```python
+from frequenz.core.enum import Enum, DeprecatedMember
+
+class TaskStatus(Enum):
+   OPEN = 1
+   IN_PROGRESS = 2
+   PENDING = DeprecatedMember(1, "PENDING is deprecated, use OPEN instead")
+   DONE = DeprecatedMember(3, "DONE is deprecated, use FINISHED instead")
+   FINISHED = 4
+
+status1 = TaskStatus.PENDING  # Warns: "PENDING is deprecated, use OPEN instead"
+assert status1 is TaskStatus.OPEN
+```
+
+### Typing Utilities
+
+Disable class constructors to enforce factory pattern usage:
+
+```python
+from frequenz.core.typing import disable_init
+
+@disable_init
+class ApiClient:
+    @classmethod
+    def create(cls, api_key: str) -> "ApiClient":
+        # Factory method with validation
+        instance = cls.__new__(cls)
+        # Custom initialization logic here
+        return instance
+
+# This will raise TypeError:
+# client = ApiClient()  # ❌ TypeError
+
+# Use factory method instead:
+client = ApiClient.create("my-api-key")  # ✅ Works
+```
+
+### Strongly-Typed IDs
+
+Create type-safe identifiers for different entities:
+
+```python
+from frequenz.core.id import BaseId
+
+class UserId(BaseId, str_prefix="USR"):
+    pass
+
+class OrderId(BaseId, str_prefix="ORD"):
+    pass
+
+user_id = UserId(123)
+order_id = OrderId(456)
+
+print(f"User: {user_id}")  # User: USR123
+print(f"Order: {order_id}")  # Order: ORD456
+
+# Type safety prevents mixing different ID types
+def process_user(user_id: UserId) -> None:
+    print(f"Processing user: {user_id}")
+
+process_user(user_id)  # ✅ Works
+# process_user(order_id)  # ❌ Type error
+```
+
+## Documentation
+
+For information on how to use this library, please refer to the
+[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
+
+## Contributing
+
+If you want to know how to build this project and contribute to it, please
+check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_core-1.1.0/RELEASE_NOTES.md

@@ -0,0 +1,21 @@
+# Frequenz Core Library Release Notes
+
+## New Features
+
+- A new `frequenz.core.enum` module was added, providing a drop-in replacement `Enum` that supports deprecating members.
+
+   Example:
+
+   ```python
+   from frequenz.core.enum import Enum, DeprecatedMember
+
+   class TaskStatus(Enum):
+       OPEN = 1
+       IN_PROGRESS = 2
+       PENDING = DeprecatedMember(1, "PENDING is deprecated, use OPEN instead")
+       DONE = DeprecatedMember(3, "DONE is deprecated, use FINISHED instead")
+       FINISHED = 4
+
+   status1 = TaskStatus.PENDING  # Warns: "PENDING is deprecated, use OPEN instead"
+   assert status1 is TaskStatus.OPEN
+   ```

{frequenz_core-1.0.2 → frequenz_core-1.1.0}/pyproject.toml

@@ -5,7 +5,7 @@
 requires = [
   "setuptools == 80.9.0",
   "setuptools_scm[toml] == 8.3.1",
-  "frequenz-repo-config[lib] == 0.13.4",
+  "frequenz-repo-config[lib] == 0.13.5",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -46,7 +46,7 @@ email = "floss@frequenz.com"
 
 [project.optional-dependencies]
 dev-flake8 = [
-  "flake8 == 7.2.0",
+  "flake8 == 7.3.0",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.3", # For reading the flake8 config from pyproject.toml
   "pydoclint == 0.6.6",
@@ -54,37 +54,37 @@ dev-flake8 = [
 ]
 dev-formatting = ["black == 25.1.0", "isort == 6.0.1"]
 dev-mkdocs = [
-  "Markdown == 3.8",
+  "Markdown == 3.8.2",
   "black == 25.1.0",
   "mike == 2.1.3",
   "mkdocs-gen-files == 0.5.0",
   "mkdocs-literate-nav == 0.6.2",
   "mkdocs-macros-plugin == 1.3.7",
-  "mkdocs-material == 9.6.14",
-  "mkdocstrings[python] == 0.29.1",
-  "mkdocstrings-python == 1.16.11",
-  "frequenz-repo-config[lib] == 0.13.4",
+  "mkdocs-material == 9.6.16",
+  "mkdocstrings[python] == 0.30.0",
+  "mkdocstrings-python == 1.17.0",
+  "frequenz-repo-config[lib] == 0.13.5",
 ]
 dev-mypy = [
-  "mypy == 1.16.0",
-  "types-Markdown == 3.8.0.20250415",
+  "mypy == 1.17.1",
+  "types-Markdown == 3.8.0.20250708",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
-dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[lib] == 0.13.4"]
+dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[lib] == 0.13.5"]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
   # For checking the noxfile, docs/ script, and tests
   "frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 8.3.5",
+  "pytest == 8.4.1",
   "pylint == 3.3.7", # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.13.4",
+  "frequenz-repo-config[extra-lint-examples] == 0.13.5",
   "pytest-mock == 3.14.1",
-  "pytest-asyncio == 0.26.0",
-  "async-solipsism == 0.7",
-  "hypothesis == 6.132.0",
+  "pytest-asyncio == 1.1.0",
+  "async-solipsism == 0.8",
+  "hypothesis == 6.138.2",
 ]
 dev = [
   "frequenz-core[dev-mkdocs,dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",

{frequenz_core-1.0.2 → frequenz_core-1.1.0}/src/frequenz/core/datetime.py

@@ -1,7 +1,7 @@
 # License: MIT
 # Copyright © 2024 Frequenz Energy-as-a-Service GmbH
 
-"""Timeseries basic types."""
+"""Date and time utilities."""
 
 from datetime import datetime, timezone
 from typing import Final

frequenz_core-1.1.0/src/frequenz/core/enum.py

@@ -0,0 +1,207 @@
+# License: MIT
+# Copyright © 2025 Frequenz Energy-as-a-Service GmbH
+
+"""Enum utilities with support for deprecated members.
+
+This module provides an [`Enum`][frequenz.core.enum.Enum] base class that extends the
+standard library's [`enum.Enum`][] to support marking certain members as deprecated.
+
+See the [class documentation][frequenz.core.enum.Enum] for details and examples.
+"""
+
+from __future__ import annotations
+
+import enum
+import warnings
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, ClassVar, Self, TypeVar, cast
+
+# Note: This module contains more casts and uses of Any than what's typically
+# ideal. This is because type hinting EnumType and Enum subclasses is quite
+# challenging, as there is a lot of special behavior in `mypy` for these classes.
+#
+# The resulting enum should be treated as a regular enum by mypy, so hopefully everthing
+# still works as expected.
+
+EnumT = TypeVar("EnumT", bound=enum.Enum)
+"""Type variable for enum types."""
+
+
+class DeprecatedMemberWarning(DeprecationWarning):
+    """Warning category for deprecated enum members."""
+
+
+class DeprecatedMember:
+    """Marker used in enum class bodies to declare deprecated members.
+
+    Please read the [`Enum`][frequenz.core.enum.Enum] documentation for details and
+    examples.
+    """
+
+    # Using slots is just an optimization to make the class more lightweight and avoid
+    # the creation of a `__dict__` for each instance and its corresponding lookup.
+    __slots__ = ("value", "message")
+
+    def __init__(self, value: Any, message: str) -> None:
+        """Initialize this instance."""
+        self.value = value
+        self.message = message
+
+
+class DeprecatingEnumType(enum.EnumType):
+    """Enum metaclass that supports `DeprecatedMember` wrappers.
+
+    Tip:
+        Normally it is not necessary to use this class directly, use
+        [`Enum`][frequenz.core.enum.Enum] instead.
+
+    Behavior:
+
+    - In the class body, members may be declared as `NAME = DeprecatedMember(value, msg)`.
+    - During class creation, these wrappers are replaced with `value` so that
+      a normal enum member or alias is created by [`EnumType`][enum.EnumType].
+    - The deprecated names are recorded so that:
+
+        * `MyEnum.NAME` warns (attribute access by name)
+        * `MyEnum["NAME"]` warns (lookup by name)
+        * `MyEnum(value)` warns **only if** the resolved member has **no**
+            non-deprecated aliases (all names for that member are deprecated).
+    """
+
+    def __new__(  # pylint: disable=too-many-locals
+        mcs,
+        name: str,
+        bases: tuple[type[EnumT], ...],
+        classdict: Mapping[str, Any],
+        **kw: Any,
+    ) -> type[EnumT]:
+        """Create the new enum class, rewriting `DeprecatedMember` instances."""
+        deprecated_names: dict[str, str] = {}
+        prepared = super().__prepare__(name, bases, **kw)
+
+        # Unwrap DeprecatedMembers and record them as deprecated
+        for key, value in classdict.items():
+            if isinstance(value, DeprecatedMember):
+                deprecated_names[key] = value.message
+                prepared[key] = value.value
+            else:
+                prepared[key] = value
+
+        cls = cast(type[EnumT], super().__new__(mcs, name, bases, prepared, **kw))
+
+        # Build alias groups: member -> list of names
+        member_to_names: dict[EnumT, list[str]] = {}
+        member: EnumT
+        for member_name, member in cls.__members__.items():
+            member_to_names.setdefault(member, []).append(member_name)
+
+        warned_by_member: dict[EnumT, str] = {}
+        for member, names in member_to_names.items():
+            # warn on value only if all alias names are deprecated
+            deprecated_aliases = [n for n in names if n in deprecated_names]
+            if deprecated_aliases and len(deprecated_aliases) == len(names):
+                warned_by_member[member] = deprecated_names[deprecated_aliases[0]]
+
+        # Inject maps quietly
+        type.__setattr__(cls, "__deprecated_names__", deprecated_names)
+        type.__setattr__(cls, "__deprecated_value_map__", warned_by_member)
+
+        return cls
+
+    @staticmethod
+    def _name_map(cls_: type[Any]) -> Mapping[str, str]:
+        """Map from member names to deprecation messages."""
+        return cast(
+            Mapping[str, str],
+            type.__getattribute__(cls_, "__dict__").get("__deprecated_names__", {}),
+        )
+
+    @staticmethod
+    def _value_map(cls_: type[Any]) -> Mapping[Any, str]:
+        """Map from enum members to deprecation messages."""
+        return cast(
+            Mapping[Any, str],
+            type.__getattribute__(cls_, "__dict__").get("__deprecated_value_map__", {}),
+        )
+
+    def __getattribute__(cls, name: str) -> Any:
+        """Resolve `name` to a member, warning if the member is deprecated."""
+        if name in ("__deprecated_names__", "__deprecated_value_map__"):
+            return type.__getattribute__(cls, name)
+        deprecated = DeprecatingEnumType._name_map(cls)
+        if name in deprecated:
+            warnings.warn(deprecated[name], DeprecatedMemberWarning, stacklevel=2)
+        return super().__getattribute__(name)
+
+    def __getitem__(cls, name: str) -> Any:
+        """Resolve `name` to a member, warning if the member is deprecated."""
+        deprecated = DeprecatingEnumType._name_map(cls)
+        if name in deprecated:
+            warnings.warn(deprecated[name], DeprecatedMemberWarning, stacklevel=2)
+        return super().__getitem__(name)
+
+    def __call__(cls, value: Any, *args: Any, **kwargs: Any) -> Any:
+        """Resolve `value` to a member, warning if the member is purely deprecated."""
+        member = super().__call__(value, *args, **kwargs)
+        value_map: Mapping[Any, str] = DeprecatingEnumType._value_map(cls)
+        msg = value_map.get(member)
+        if msg is not None:
+            warnings.warn(msg, DeprecatedMemberWarning, stacklevel=2)
+        return member
+
+
+if TYPE_CHECKING:
+    # Make type checkers treat it as a plain Enum (so member checks work), if we don't
+    # do this, mypy will consider the resulting enum completely dynamic and never
+    # complain if an unexisting member is accessed.
+
+    # pylint: disable-next=missing-class-docstring
+    class Enum(enum.Enum):  # noqa
+        __deprecated_names__: ClassVar[Mapping[str, str]]
+        __deprecated_value_map__: ClassVar[Mapping[Enum, str]]
+
+else:
+
+    class Enum(enum.Enum, metaclass=DeprecatingEnumType):
+        """Base class for enums that support DeprecatedMember.
+
+        This class extends the standard library's [`enum.Enum`][] to support marking
+        certain members as deprecated. Deprecated members can be accessed, but doing so
+        will emit a [`DeprecationWarning`][], specifically
+        a [`DeprecatedMemberWarning`][frequenz.core.enum.DeprecatedMemberWarning].
+
+        To declare a deprecated member, use the
+        [`DeprecatedMember`][frequenz.core.enum.DeprecatedMember] wrapper in the class body.
+
+        When using the enum constructor (i.e. `MyEnum(value)`), a warning is only emitted if
+        the resolved member has no non-deprecated aliases. If there is at least one
+        non-deprecated alias for the member, no warning is emitted.
+
+        Example:
+            ```python
+            from frequenz.core.enum import Enum, DeprecatedMember
+
+            class TaskStatus(Enum):
+                OPEN = 1
+                IN_PROGRESS = 2
+                PENDING = DeprecatedMember(1, "PENDING is deprecated, use OPEN instead")
+                DONE = DeprecatedMember(3, "DONE is deprecated, use FINISHED instead")
+                FINISHED = 4
+
+            # Accessing deprecated members:
+            status1 = TaskStatus.PENDING  # Warns: "PENDING is deprecated, use OPEN instead"
+            assert status1 is TaskStatus.OPEN
+
+            status2 = TaskStatus["DONE"]  # Warns: "DONE is deprecated, use FINISHED instead"
+            assert status2 is TaskStatus.FINISHED
+
+            status3 = TaskStatus(1)  # No warning, resolves to OPEN which has a non-deprecated alias
+            assert status3 is TaskStatus.OPEN
+
+            status4 = TaskStatus(3)  # Warns: "DONE is deprecated, use FINISHED instead"
+            assert status4 is TaskStatus.FINISHED
+            ```
+        """
+
+        __deprecated_names__: ClassVar[Mapping[str, str]]
+        __deprecated_value_map__: ClassVar[Mapping[Self, str]]

frequenz_core-1.1.0/src/frequenz_core.egg-info/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: frequenz-core
+Version: 1.1.0
+Summary: Core utilities to complement Python's standard library
+Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
+License: MIT
+Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-core-python/
+Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-core-python/releases
+Project-URL: Issues, https://github.com/frequenz-floss/frequenz-core-python/issues
+Project-URL: Repository, https://github.com/frequenz-floss/frequenz-core-python
+Project-URL: Support, https://github.com/frequenz-floss/frequenz-core-python/discussions/categories/support
+Keywords: asyncio,collections,core,datetime,frequenz,lib,library,math,python,stdlib,typing
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-extensions<5,>=4.13.0
+Provides-Extra: dev-flake8
+Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
+Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
+Requires-Dist: flake8-pyproject==1.2.3; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.6.6; extra == "dev-flake8"
+Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
+Provides-Extra: dev-formatting
+Requires-Dist: black==25.1.0; extra == "dev-formatting"
+Requires-Dist: isort==6.0.1; extra == "dev-formatting"
+Provides-Extra: dev-mkdocs
+Requires-Dist: Markdown==3.8.2; extra == "dev-mkdocs"
+Requires-Dist: black==25.1.0; extra == "dev-mkdocs"
+Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-material==9.6.16; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==0.30.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==1.17.0; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.13.5; extra == "dev-mkdocs"
+Provides-Extra: dev-mypy
+Requires-Dist: mypy==1.17.1; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.8.0.20250708; extra == "dev-mypy"
+Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
+Provides-Extra: dev-noxfile
+Requires-Dist: nox==2025.5.1; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.13.5; extra == "dev-noxfile"
+Provides-Extra: dev-pylint
+Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
+Provides-Extra: dev-pytest
+Requires-Dist: pytest==8.4.1; extra == "dev-pytest"
+Requires-Dist: pylint==3.3.7; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.5; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.14.1; extra == "dev-pytest"
+Requires-Dist: pytest-asyncio==1.1.0; extra == "dev-pytest"
+Requires-Dist: async-solipsism==0.8; extra == "dev-pytest"
+Requires-Dist: hypothesis==6.138.2; extra == "dev-pytest"
+Provides-Extra: dev
+Requires-Dist: frequenz-core[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
+Dynamic: license-file
+
+# Frequenz Core Library
+
+[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
+[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
+[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
+
+## Introduction
+
+Core utilities to complement Python's standard library. This library provides
+essential building blocks for Python applications, including mathematical
+utilities, datetime constants, typing helpers, strongly-typed identifiers, and
+module introspection tools.
+
+The `frequenz-core` library is designed to be lightweight, type-safe, and
+follow modern Python best practices. It fills common gaps in the standard
+library with utilities that are frequently needed across different projects.
+
+## Supported Platforms
+
+The following platforms are officially supported (tested):
+
+- **Python:** 3.11
+- **Operating System:** Ubuntu Linux 20.04
+- **Architectures:** amd64, arm64
+
+## Installation
+
+You can install the library from PyPI using pip:
+
+```bash
+python -m pip install frequenz-core
+```
+
+Or add it to your project's dependencies in `pyproject.toml`:
+
+```toml
+[project]
+dependencies = [
+    "frequenz-core >= 1.0.2, < 2",
+]
+```
+
+> [!NOTE]
+> We recommend pinning the dependency to the latest version for programs,
+> like `"frequenz-core == 1.0.2"`, and specifying a version range spanning
+> one major version for libraries, like `"frequenz-core >= 1.0.2, < 2"`.
+> We follow [semver](https://semver.org/).
+
+## Quick Start
+
+Here's a quick overview of the main functionality:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+from frequenz.core.datetime import UNIX_EPOCH
+from frequenz.core.module import get_public_module_name
+
+# Math utilities
+print(is_close_to_zero(1e-10))  # True - check if float is close to zero
+interval = Interval(1, 10)
+print(5 in interval)  # True - check if value is in range
+
+# Datetime utilities
+print(UNIX_EPOCH)  # 1970-01-01 00:00:00+00:00
+
+# Module utilities
+public_name = get_public_module_name("my.package._private.module")
+print(public_name)  # "my.package"
+```
+
+## Code Examples
+
+### Math Utilities
+
+The math module provides utilities for floating-point comparisons and interval
+checking:
+
+```python
+from frequenz.core.math import is_close_to_zero, Interval
+
+# Robust floating-point zero comparison
+assert is_close_to_zero(1e-10)  # True
+assert not is_close_to_zero(0.1)  # False
+
+# Interval checking with inclusive bounds
+numbers = Interval(0, 100)
+assert 50 in numbers  # True
+assert not (150 in numbers)  # False - 150 is outside the interval
+
+# Unbounded intervals
+positive = Interval(0, None)  # [0, ∞]
+assert 1000 in positive  # True
+```
+
+### `Enum` with deprecated members
+
+Define enums with deprecated members that raise deprecation warnings when
+accessed:
+
+```python
+from frequenz.core.enum import Enum, DeprecatedMember
+
+class TaskStatus(Enum):
+   OPEN = 1
+   IN_PROGRESS = 2
+   PENDING = DeprecatedMember(1, "PENDING is deprecated, use OPEN instead")
+   DONE = DeprecatedMember(3, "DONE is deprecated, use FINISHED instead")
+   FINISHED = 4
+
+status1 = TaskStatus.PENDING  # Warns: "PENDING is deprecated, use OPEN instead"
+assert status1 is TaskStatus.OPEN
+```
+
+### Typing Utilities
+
+Disable class constructors to enforce factory pattern usage:
+
+```python
+from frequenz.core.typing import disable_init
+
+@disable_init
+class ApiClient:
+    @classmethod
+    def create(cls, api_key: str) -> "ApiClient":
+        # Factory method with validation
+        instance = cls.__new__(cls)
+        # Custom initialization logic here
+        return instance
+
+# This will raise TypeError:
+# client = ApiClient()  # ❌ TypeError
+
+# Use factory method instead:
+client = ApiClient.create("my-api-key")  # ✅ Works
+```
+
+### Strongly-Typed IDs
+
+Create type-safe identifiers for different entities:
+
+```python
+from frequenz.core.id import BaseId
+
+class UserId(BaseId, str_prefix="USR"):
+    pass
+
+class OrderId(BaseId, str_prefix="ORD"):
+    pass
+
+user_id = UserId(123)
+order_id = OrderId(456)
+
+print(f"User: {user_id}")  # User: USR123
+print(f"Order: {order_id}")  # Order: ORD456
+
+# Type safety prevents mixing different ID types
+def process_user(user_id: UserId) -> None:
+    print(f"Processing user: {user_id}")
+
+process_user(user_id)  # ✅ Works
+# process_user(order_id)  # ❌ Type error
+```
+
+## Documentation
+
+For information on how to use this library, please refer to the
+[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
+
+## Contributing
+
+If you want to know how to build this project and contribute to it, please
+check out the [Contributing Guide](CONTRIBUTING.md).

{frequenz_core-1.0.2 → frequenz_core-1.1.0}/src/frequenz_core.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ pyproject.toml
 src/frequenz/core/__init__.py
 src/frequenz/core/conftest.py
 src/frequenz/core/datetime.py
+src/frequenz/core/enum.py
 src/frequenz/core/id.py
 src/frequenz/core/math.py
 src/frequenz/core/module.py

{frequenz_core-1.0.2 → frequenz_core-1.1.0}/src/frequenz_core.egg-info/requires.txt

@@ -4,7 +4,7 @@ typing-extensions<5,>=4.13.0
 frequenz-core[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]
 
 [dev-flake8]
-flake8==7.2.0
+flake8==7.3.0
 flake8-docstrings==1.7.0
 flake8-pyproject==1.2.3
 pydoclint==0.6.6
@@ -15,34 +15,34 @@ black==25.1.0
 isort==6.0.1
 
 [dev-mkdocs]
-Markdown==3.8
+Markdown==3.8.2
 black==25.1.0
 mike==2.1.3
 mkdocs-gen-files==0.5.0
 mkdocs-literate-nav==0.6.2
 mkdocs-macros-plugin==1.3.7
-mkdocs-material==9.6.14
-mkdocstrings[python]==0.29.1
-mkdocstrings-python==1.16.11
-frequenz-repo-config[lib]==0.13.4
+mkdocs-material==9.6.16
+mkdocstrings[python]==0.30.0
+mkdocstrings-python==1.17.0
+frequenz-repo-config[lib]==0.13.5
 
 [dev-mypy]
-mypy==1.16.0
-types-Markdown==3.8.0.20250415
+mypy==1.17.1
+types-Markdown==3.8.0.20250708
 frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-noxfile]
 nox==2025.5.1
-frequenz-repo-config[lib]==0.13.4
+frequenz-repo-config[lib]==0.13.5
 
 [dev-pylint]
 frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-pytest]
-pytest==8.3.5
+pytest==8.4.1
 pylint==3.3.7
-frequenz-repo-config[extra-lint-examples]==0.13.4
+frequenz-repo-config[extra-lint-examples]==0.13.5
 pytest-mock==3.14.1
-pytest-asyncio==0.26.0
-async-solipsism==0.7
-hypothesis==6.132.0
+pytest-asyncio==1.1.0
+async-solipsism==0.8
+hypothesis==6.138.2

frequenz_core-1.0.2/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.4
-Name: frequenz-core
-Version: 1.0.2
-Summary: Core utilities to complement Python's standard library
-Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
-License: MIT
-Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-core-python/
-Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-core-python/releases
-Project-URL: Issues, https://github.com/frequenz-floss/frequenz-core-python/issues
-Project-URL: Repository, https://github.com/frequenz-floss/frequenz-core-python
-Project-URL: Support, https://github.com/frequenz-floss/frequenz-core-python/discussions/categories/support
-Keywords: asyncio,collections,core,datetime,frequenz,lib,library,math,python,stdlib,typing
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Typing :: Typed
-Requires-Python: <4,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typing-extensions<5,>=4.13.0
-Provides-Extra: dev-flake8
-Requires-Dist: flake8==7.2.0; extra == "dev-flake8"
-Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
-Requires-Dist: flake8-pyproject==1.2.3; extra == "dev-flake8"
-Requires-Dist: pydoclint==0.6.6; extra == "dev-flake8"
-Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
-Provides-Extra: dev-formatting
-Requires-Dist: black==25.1.0; extra == "dev-formatting"
-Requires-Dist: isort==6.0.1; extra == "dev-formatting"
-Provides-Extra: dev-mkdocs
-Requires-Dist: Markdown==3.8; extra == "dev-mkdocs"
-Requires-Dist: black==25.1.0; extra == "dev-mkdocs"
-Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-material==9.6.14; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==0.29.1; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.16.11; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.4; extra == "dev-mkdocs"
-Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.16.0; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.8.0.20250415; extra == "dev-mypy"
-Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
-Provides-Extra: dev-noxfile
-Requires-Dist: nox==2025.5.1; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.13.4; extra == "dev-noxfile"
-Provides-Extra: dev-pylint
-Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
-Provides-Extra: dev-pytest
-Requires-Dist: pytest==8.3.5; extra == "dev-pytest"
-Requires-Dist: pylint==3.3.7; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.4; extra == "dev-pytest"
-Requires-Dist: pytest-mock==3.14.1; extra == "dev-pytest"
-Requires-Dist: pytest-asyncio==0.26.0; extra == "dev-pytest"
-Requires-Dist: async-solipsism==0.7; extra == "dev-pytest"
-Requires-Dist: hypothesis==6.132.0; extra == "dev-pytest"
-Provides-Extra: dev
-Requires-Dist: frequenz-core[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
-Dynamic: license-file
-
-# Frequenz Core Library
-
-[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
-[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
-[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
-
-## Introduction
-
-Core utilities to complement Python's standard library.
-
-## Documentation
-
-For information on how to use this library, please refer to the
-[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
-
-## Supported Platforms
-
-The following platforms are officially supported (tested):
-
-- **Python:** 3.11
-- **Operating System:** Ubuntu Linux 20.04
-- **Architectures:** amd64, arm64
-
-## Contributing
-
-If you want to know how to build this project and contribute to it, please
-check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_core-1.0.2/README.md

@@ -1,27 +0,0 @@
-# Frequenz Core Library
-
-[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
-[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
-[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
-
-## Introduction
-
-Core utilities to complement Python's standard library.
-
-## Documentation
-
-For information on how to use this library, please refer to the
-[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
-
-## Supported Platforms
-
-The following platforms are officially supported (tested):
-
-- **Python:** 3.11
-- **Operating System:** Ubuntu Linux 20.04
-- **Architectures:** amd64, arm64
-
-## Contributing
-
-If you want to know how to build this project and contribute to it, please
-check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_core-1.0.2/RELEASE_NOTES.md

@@ -1,17 +0,0 @@
-# Frequenz Core Library Release Notes
-
-## Summary
-
-<!-- Here goes a general summary of what this release is about -->
-
-## Upgrading
-
-<!-- Here goes notes on how to upgrade from previous versions, including deprecations and what they should be replaced with -->
-
-## New Features
-
-<!-- Here goes the main new features and examples or instructions on how to use them -->
-
-## Bug Fixes
-
-* `BaseId` will now log instead of raising a warning when a duplicate prefix is detected. This is to fix [a problem with code examples](https://github.com/frequenz-floss/frequenz-repo-config-python/issues/421) being tested using sybil and the class being imported multiple times, which caused the exception to be raised. We first tried to use `warn()` but that complicated the building process for all downstream projects, requiring them to add an exception for exactly this warning.

frequenz_core-1.0.2/src/frequenz_core.egg-info/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.4
-Name: frequenz-core
-Version: 1.0.2
-Summary: Core utilities to complement Python's standard library
-Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
-License: MIT
-Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-core-python/
-Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-core-python/releases
-Project-URL: Issues, https://github.com/frequenz-floss/frequenz-core-python/issues
-Project-URL: Repository, https://github.com/frequenz-floss/frequenz-core-python
-Project-URL: Support, https://github.com/frequenz-floss/frequenz-core-python/discussions/categories/support
-Keywords: asyncio,collections,core,datetime,frequenz,lib,library,math,python,stdlib,typing
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Typing :: Typed
-Requires-Python: <4,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typing-extensions<5,>=4.13.0
-Provides-Extra: dev-flake8
-Requires-Dist: flake8==7.2.0; extra == "dev-flake8"
-Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
-Requires-Dist: flake8-pyproject==1.2.3; extra == "dev-flake8"
-Requires-Dist: pydoclint==0.6.6; extra == "dev-flake8"
-Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
-Provides-Extra: dev-formatting
-Requires-Dist: black==25.1.0; extra == "dev-formatting"
-Requires-Dist: isort==6.0.1; extra == "dev-formatting"
-Provides-Extra: dev-mkdocs
-Requires-Dist: Markdown==3.8; extra == "dev-mkdocs"
-Requires-Dist: black==25.1.0; extra == "dev-mkdocs"
-Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-material==9.6.14; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==0.29.1; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.16.11; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.4; extra == "dev-mkdocs"
-Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.16.0; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.8.0.20250415; extra == "dev-mypy"
-Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
-Provides-Extra: dev-noxfile
-Requires-Dist: nox==2025.5.1; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.13.4; extra == "dev-noxfile"
-Provides-Extra: dev-pylint
-Requires-Dist: frequenz-core[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
-Provides-Extra: dev-pytest
-Requires-Dist: pytest==8.3.5; extra == "dev-pytest"
-Requires-Dist: pylint==3.3.7; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.4; extra == "dev-pytest"
-Requires-Dist: pytest-mock==3.14.1; extra == "dev-pytest"
-Requires-Dist: pytest-asyncio==0.26.0; extra == "dev-pytest"
-Requires-Dist: async-solipsism==0.7; extra == "dev-pytest"
-Requires-Dist: hypothesis==6.132.0; extra == "dev-pytest"
-Provides-Extra: dev
-Requires-Dist: frequenz-core[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
-Dynamic: license-file
-
-# Frequenz Core Library
-
-[![Build Status](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-core-python/actions/workflows/ci.yaml)
-[![PyPI Package](https://img.shields.io/pypi/v/frequenz-core)](https://pypi.org/project/frequenz-core/)
-[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-core-python/)
-
-## Introduction
-
-Core utilities to complement Python's standard library.
-
-## Documentation
-
-For information on how to use this library, please refer to the
-[documentation](https://frequenz-floss.github.io/frequenz-core-python/).
-
-## Supported Platforms
-
-The following platforms are officially supported (tested):
-
-- **Python:** 3.11
-- **Operating System:** Ubuntu Linux 20.04
-- **Architectures:** amd64, arm64
-
-## Contributing
-
-If you want to know how to build this project and contribute to it, please
-check out the [Contributing Guide](CONTRIBUTING.md).