frequenz-quantities 1.0.1__tar.gz → 1.0.2__tar.gz

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: frequenz-quantities
-Version: 1.0.1
+Version: 1.0.2
 Summary: Types for holding quantities with units
 Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-quantities-python/
 Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-quantities-python/releases
 Project-URL: Issues, https://github.com/frequenz-floss/frequenz-quantities-python/issues
@@ -12,7 +12,6 @@ Project-URL: Support, https://github.com/frequenz-floss/frequenz-quantities-pyth
 Keywords: frequenz,python,lib,library,quantities,unit,conversion
 Classifier: Development Status :: 3 - Alpha
 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
@@ -20,47 +19,48 @@ Classifier: Typing :: Typed
 Requires-Python: <4,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typing-extensions<5,>=4.6.0
+Requires-Dist: typing-extensions<5,>=4.12.0
 Provides-Extra: dev-flake8
 Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
+Requires-Dist: flake8-datetimez==26.8.1; 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.7.3; extra == "dev-flake8"
+Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.9.1; 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"
+Requires-Dist: black==26.5.1; extra == "dev-formatting"
+Requires-Dist: isort==9.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.9; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-material==9.6.18; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==0.30.0; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.18.2; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.5; extra == "dev-mkdocs"
+Requires-Dist: Markdown==3.10.3; extra == "dev-mkdocs"
+Requires-Dist: black==26.5.1; extra == "dev-mkdocs"
+Requires-Dist: mike==2.2.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-gen-files==0.6.1; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-literate-nav==0.6.3; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-macros-plugin==1.5.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-material==9.7.7; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==1.0.6; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==2.0.7; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.17.1; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.8.0.20250809; extra == "dev-mypy"
+Requires-Dist: mypy==2.3.1; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.10.2.20260712; extra == "dev-mypy"
 Requires-Dist: frequenz-quantities[dev-mkdocs,dev-noxfile,dev-pytest,marshmallow]; 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"
+Requires-Dist: nox==2026.8.17; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-quantities[dev-mkdocs,dev-noxfile,dev-pytest,marshmallow]; extra == "dev-pylint"
 Provides-Extra: dev-pytest
-Requires-Dist: pytest==8.4.1; extra == "dev-pytest"
-Requires-Dist: pylint==3.3.8; 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.13; extra == "dev-pytest"
+Requires-Dist: pytest==9.1.1; extra == "dev-pytest"
+Requires-Dist: pylint==4.0.8; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.19.0; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
+Requires-Dist: pytest-asyncio==1.4.0; extra == "dev-pytest"
+Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"
+Requires-Dist: hypothesis==6.165.10; extra == "dev-pytest"
 Requires-Dist: frequenz-quantities[marshmallow]; extra == "dev-pytest"
 Provides-Extra: marshmallow
-Requires-Dist: marshmallow<5,>=3.0.0; extra == "marshmallow"
+Requires-Dist: marshmallow<5,>=4; extra == "marshmallow"
 Requires-Dist: marshmallow-dataclass<9,>=8.0.0; extra == "marshmallow"
 Provides-Extra: dev
 Requires-Dist: frequenz-quantities[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest,marshmallow]; extra == "dev"
@@ -85,6 +85,53 @@ converting one of them.
 Quantities store the value in a base unit, and then provide methods to get that
 quantity as a particular unit.
 
+## Installation
+
+### Using `pip`
+
+```bash
+python3 -m pip install frequenz-quantities
+```
+
+### Using `pyproject.toml`
+
+Add this to your `pyproject.toml` file:
+
+```toml
+[project]
+dependencies = [
+    "frequenz-quantities >= 1.0.0, < 2"
+]
+```
+
+> [!NOTE]
+> We recommend pinning the dependency to the latest version for programs,
+> like `"frequenz-quantities == 1.0.0"`, and specifying a version range
+> spanning one major version for libraries, like `"frequenz-quantities >= 1.0.0, < 2"`.
+> We follow [semver](https://semver.org/).
+
+## Quick Start
+
+```python
+from frequenz.quantities import Power, Current, Voltage
+
+# Create quantities using unit-specific constructors
+power = Power.from_watts(1500.0)
+current = Current.from_amperes(10.0)
+voltage = Voltage.from_volts(230.0)
+
+# Perform operations between quantities
+total_power = power + Power.from_kilowatts(2.0)
+print(f"Total power: {total_power}")  # Total power: 3500 W
+
+# Convert to different units
+print(f"Power in kW: {total_power.as_kilowatts()}")  # Power in kW: 3.5
+
+# Type safety prevents invalid operations
+# This would raise a TypeError:
+# invalid = power + current  # Can't add power and current!
+```
+
 ## Documentation
 
 For more information on how to use this library and examples, please check the

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/README.md

@@ -17,6 +17,53 @@ converting one of them.
 Quantities store the value in a base unit, and then provide methods to get that
 quantity as a particular unit.
 
+## Installation
+
+### Using `pip`
+
+```bash
+python3 -m pip install frequenz-quantities
+```
+
+### Using `pyproject.toml`
+
+Add this to your `pyproject.toml` file:
+
+```toml
+[project]
+dependencies = [
+    "frequenz-quantities >= 1.0.0, < 2"
+]
+```
+
+> [!NOTE]
+> We recommend pinning the dependency to the latest version for programs,
+> like `"frequenz-quantities == 1.0.0"`, and specifying a version range
+> spanning one major version for libraries, like `"frequenz-quantities >= 1.0.0, < 2"`.
+> We follow [semver](https://semver.org/).
+
+## Quick Start
+
+```python
+from frequenz.quantities import Power, Current, Voltage
+
+# Create quantities using unit-specific constructors
+power = Power.from_watts(1500.0)
+current = Current.from_amperes(10.0)
+voltage = Voltage.from_volts(230.0)
+
+# Perform operations between quantities
+total_power = power + Power.from_kilowatts(2.0)
+print(f"Total power: {total_power}")  # Total power: 3500 W
+
+# Convert to different units
+print(f"Power in kW: {total_power.as_kilowatts()}")  # Power in kW: 3.5
+
+# Type safety prevents invalid operations
+# This would raise a TypeError:
+# invalid = power + current  # Can't add power and current!
+```
+
 ## Documentation
 
 For more information on how to use this library and examples, please check the

frequenz_quantities-1.0.2/RELEASE_NOTES.md

@@ -0,0 +1,6 @@
+# Frequenz Quantities Library Release Notes
+
+## Upgrading
+
+- The minimum `typing-extensions` version was bumped to 4.12.0. Consumers may need to upgrade it too.
+- The `marshmallow` optional dependency now requires version 4 or later. Consumers pinned to marshmallow 3.x must upgrade.

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/pyproject.toml

@@ -3,9 +3,9 @@
 
 [build-system]
 requires = [
-  "setuptools == 80.9.0",
-  "setuptools_scm[toml] == 9.2.0",
-  "frequenz-repo-config[lib] == 0.13.5",
+  "setuptools == 84.0.0",
+  "setuptools_scm[toml] == 10.2.1",
+  "frequenz-repo-config[lib] == 0.19.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -13,7 +13,8 @@ build-backend = "setuptools.build_meta"
 name = "frequenz-quantities"
 description = "Types for holding quantities with units"
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
+license-files = ["LICENSE"]
 keywords = [
   "frequenz",
   "python",
@@ -26,14 +27,13 @@ keywords = [
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
   "Topic :: Software Development :: Libraries",
   "Typing :: Typed",
 ]
 requires-python = ">= 3.11, < 4"
-dependencies = ["typing-extensions >= 4.6.0, < 5"]
+dependencies = ["typing-extensions >= 4.12.0, < 5"]
 dynamic = ["version"]
 
 [[project.authors]]
@@ -43,49 +43,50 @@ email = "floss@frequenz.com"
 [project.optional-dependencies]
 dev-flake8 = [
   "flake8 == 7.3.0",
+  "flake8-datetimez == 26.8.1",
   "flake8-docstrings == 1.7.0",
-  "flake8-pyproject == 1.2.3", # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.7.3",
+  "flake8-pyproject == 1.2.4", # For reading the flake8 config from pyproject.toml
+  "pydoclint == 0.9.1",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 25.1.0", "isort == 6.0.1"]
+dev-formatting = ["black == 26.5.1", "isort == 9.0.1"]
 dev-mkdocs = [
-  "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.9",
-  "mkdocs-material == 9.6.18",
-  "mkdocstrings[python] == 0.30.0",
-  "mkdocstrings-python == 1.18.2",
-  "frequenz-repo-config[lib] == 0.13.5",
+  "Markdown == 3.10.3",
+  "black == 26.5.1",
+  "mike == 2.2.0",
+  "mkdocs-gen-files == 0.6.1",
+  "mkdocs-literate-nav == 0.6.3",
+  "mkdocs-macros-plugin == 1.5.0",
+  "mkdocs-material == 9.7.7",
+  "mkdocstrings[python] == 1.0.6",
+  "mkdocstrings-python == 2.0.7",
+  "frequenz-repo-config[lib] == 0.19.0",
 ]
 dev-mypy = [
-  "mypy == 1.17.1",
-  "types-Markdown == 3.8.0.20250809",
+  "mypy == 2.3.1",
+  "types-Markdown == 3.10.2.20260712",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-quantities[dev-mkdocs,dev-noxfile,dev-pytest,marshmallow]",
 ]
-dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[lib] == 0.13.5"]
+dev-noxfile = ["nox == 2026.8.17", "frequenz-repo-config[lib] == 0.19.0"]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
   # For checking the noxfile, docs/ script, and tests
   "frequenz-quantities[dev-mkdocs,dev-noxfile,dev-pytest,marshmallow]",
 ]
 dev-pytest = [
-  "pytest == 8.4.1",
-  "pylint == 3.3.8", # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.13.5",
-  "pytest-mock == 3.14.1",
-  "pytest-asyncio == 1.1.0",
-  "async-solipsism == 0.8",
-  "hypothesis == 6.138.13",
+  "pytest == 9.1.1",
+  "pylint == 4.0.8", # We need this to check for the examples
+  "frequenz-repo-config[extra-lint-examples] == 0.19.0",
+  "pytest-mock == 3.15.1",
+  "pytest-asyncio == 1.4.0",
+  "async-solipsism == 0.9",
+  "hypothesis == 6.165.10",
   "frequenz-quantities[marshmallow]",
 ]
 
 marshmallow = [
-  "marshmallow >= 3.0.0, < 5",
+  "marshmallow >= 4, < 5",
   "marshmallow-dataclass >= 8.0.0, < 9",
 ]
 
@@ -126,6 +127,9 @@ check-yield-types = false
 arg-type-hints-in-docstring = false
 arg-type-hints-in-signature = true
 allow-init-docstring = true
+check-class-attributes = true
+check-style-mismatch = true
+require-inline-class-var-docs = true
 
 [tool.pylint.similarities]
 ignore-comments = ['yes']
@@ -158,13 +162,15 @@ disable = [
 ]
 
 [tool.pytest.ini_options]
-addopts = "-W=all -Werror -Wdefault::DeprecationWarning -Wdefault::PendingDeprecationWarning -vv"
+addopts = "-W=all -Werror -Wdefault::DeprecationWarning -Wdefault::PendingDeprecationWarning"
 testpaths = ["tests", "src"]
+asyncio_debug = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
 [tool.mypy]
+enable_error_code = ["exhaustive-match"]
 explicit_package_bases = true
 namespace_packages = true
 # This option disables mypy cache, and it is sometimes useful to enable it if

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/__init__.py

@@ -3,7 +3,7 @@
 
 """Types for holding quantities with units.
 
-This library provide types for holding quantities with units. The main goal is to avoid
+This library provides types for holding quantities with units. The main goal is to avoid
 mistakes while working with different types of quantities, for example avoiding adding
 a length to a time.
 
@@ -13,7 +13,7 @@ units, like adding a power in Joules to a power in Watts without converting one
 Quantities store the value in a base unit, and then provide methods to get that quantity
 as a particular unit. They can only be constructed using special constructors with the
 form `Quantity.from_<unit>`, for example
-[`Power.from_watts(10.0)`][frequenz.quantities.Power.from_watts].
+[`Power.from_watts(10.0)`][.Power.from_watts].
 
 Internally quantities store values as `float`s, so regular [float issues and limitations
 apply](https://docs.python.org/3/tutorial/floatingpoint.html), although some of them are
@@ -24,19 +24,17 @@ the quantity.
 
 This library provides the following types:
 
-- [ApparentPower][frequenz.quantities.ApparentPower]: A quantity representing apparent
-  power.
-- [Current][frequenz.quantities.Current]: A quantity representing an electric current.
-- [Energy][frequenz.quantities.Energy]: A quantity representing energy.
-- [Frequency][frequenz.quantities.Frequency]: A quantity representing frequency.
-- [Percentage][frequenz.quantities.Percentage]: A quantity representing a percentage.
-- [Power][frequenz.quantities.Power]: A quantity representing power.
-- [ReactivePower][frequenz.quantities.ReactivePower]: A quantity representing reactive
-  power.
-- [Temperature][frequenz.quantities.Temperature]: A quantity representing temperature.
-- [Voltage][frequenz.quantities.Voltage]: A quantity representing electric voltage.
-
-There is also the unitless [Quantity][frequenz.quantities.Quantity] class. All
+- [`ApparentPower`][.ApparentPower]: A quantity representing apparent power.
+- [`Current`][.Current]: A quantity representing an electric current.
+- [`Energy`][.Energy]: A quantity representing energy.
+- [`Frequency`][.Frequency]: A quantity representing frequency.
+- [`Percentage`][.Percentage]: A quantity representing a percentage.
+- [`Power`][.Power]: A quantity representing power.
+- [`ReactivePower`][.ReactivePower]: A quantity representing reactive power.
+- [`Temperature`][.Temperature]: A quantity representing temperature.
+- [`Voltage`][.Voltage]: A quantity representing electric voltage.
+
+There is also the unitless [`Quantity`][.Quantity] class. All
 quantities are subclasses of this class and it can be used as a base to create new
 quantities. Using the `Quantity` class directly is discouraged, as it doesn't provide
 any unit conversion methods.
@@ -80,13 +78,12 @@ Example:
     ```
 
 This library also provides an [**experimental** module with marshmallow fields and
-a base schema][frequenz.quantities.experimental.marshmallow] to serialize and
+a base schema][.experimental.marshmallow] to serialize and
 deserialize quantities using the marshmallow library. To use it, you need to make sure
 to install this package with the `marshmallow` optional dependencies (e.g.
 `pip install frequenz-quantities[marshmallow]`).
 """
 
-
 from ._apparent_power import ApparentPower
 from ._current import Current
 from ._energy import Energy

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_apparent_power.py

@@ -25,7 +25,7 @@ class ApparentPower(
         6: "MVA",
     },
 ):
-    """A apparent power quantity.
+    """An apparent power quantity.
 
     Objects of this type are wrappers around `float` values and are immutable.
 
@@ -118,34 +118,34 @@ class ApparentPower(
 
     @overload
     def __mul__(self, scalar: float, /) -> Self:
-        """Scale this power by a scalar.
+        """Scale this apparent power by a scalar.
 
         Args:
-            scalar: The scalar by which to scale this power.
+            scalar: The scalar by which to scale this apparent power.
 
         Returns:
-            The scaled power.
+            The scaled apparent power.
         """
 
     @overload
     def __mul__(self, percent: Percentage, /) -> Self:
-        """Scale this power by a percentage.
+        """Scale this apparent power by a percentage.
 
         Args:
-            percent: The percentage by which to scale this power.
+            percent: The percentage by which to scale this apparent power.
 
         Returns:
-            The scaled power.
+            The scaled apparent power.
         """
 
     def __mul__(self, other: float | Percentage, /) -> Self:
-        """Return a power or energy from multiplying this power by the given value.
+        """Scale this apparent power by a scalar or percentage.
 
         Args:
-            other: The scalar, percentage or duration to multiply by.
+            other: The scalar or percentage by which to scale this apparent power.
 
         Returns:
-            A power or energy.
+            The scaled apparent power.
         """
         from ._percentage import Percentage  # pylint: disable=import-outside-toplevel
 
@@ -165,58 +165,58 @@ class ApparentPower(
     # https://github.com/python/mypy/issues/4985#issuecomment-389692396
     @overload  # type: ignore[override]
     def __truediv__(self, other: float, /) -> Self:
-        """Divide this power by a scalar.
+        """Divide this apparent power by a scalar.
 
         Args:
-            other: The scalar to divide this power by.
+            other: The scalar to divide this apparent power by.
 
         Returns:
-            The divided power.
+            The divided apparent power.
         """
 
     @overload
     def __truediv__(self, other: Self, /) -> float:
-        """Return the ratio of this power to another.
+        """Return the ratio of this apparent power to another.
 
         Args:
-            other: The other power.
+            other: The other apparent power.
 
         Returns:
-            The ratio of this power to another.
+            The ratio of this apparent power to another.
         """
 
     @overload
     def __truediv__(self, current: Current, /) -> Voltage:
-        """Return a voltage from dividing this power by the given current.
+        """Return a voltage from dividing this apparent power by the given current.
 
         Args:
             current: The current to divide by.
 
         Returns:
-            A voltage from dividing this power by the a current.
+            A voltage from dividing this apparent power by a current.
         """
 
     @overload
     def __truediv__(self, voltage: Voltage, /) -> Current:
-        """Return a current from dividing this power by the given voltage.
+        """Return a current from dividing this apparent power by the given voltage.
 
         Args:
             voltage: The voltage to divide by.
 
         Returns:
-            A current from dividing this power by a voltage.
+            A current from dividing this apparent power by a voltage.
         """
 
     def __truediv__(
         self, other: float | Self | Current | Voltage, /
     ) -> Self | float | Voltage | Current:
-        """Return a current or voltage from dividing this power by the given value.
+        """Return a scaled apparent power, ratio, voltage, or current.
 
         Args:
-            other: The scalar, power, current or voltage to divide by.
+            other: The scalar, apparent power, current or voltage to divide by.
 
         Returns:
-            A current or voltage from dividing this power by the given value.
+            A scaled apparent power, a ratio, a voltage, or a current.
         """
         from ._current import Current  # pylint: disable=import-outside-toplevel
         from ._voltage import Voltage  # pylint: disable=import-outside-toplevel

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_current.py

@@ -3,7 +3,6 @@
 
 """Types for holding quantities with units."""
 
-
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Self, overload

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_energy.py

@@ -3,7 +3,6 @@
 
 """Types for holding quantities with units."""
 
-
 from __future__ import annotations
 
 from datetime import timedelta
@@ -97,10 +96,10 @@ class Energy(
         return self._base_value / 1e6
 
     def __mul__(self, other: float | Percentage) -> Self:
-        """Scale this energy by a percentage.
+        """Scale this energy by a scalar or percentage.
 
         Args:
-            other: The percentage by which to scale this energy.
+            other: The scalar or percentage by which to scale this energy.
 
         Returns:
             The scaled energy.
@@ -163,13 +162,13 @@ class Energy(
     def __truediv__(
         self, other: float | Self | timedelta | Power, /
     ) -> Self | float | Power | timedelta:
-        """Return a power or duration from dividing this energy by the given value.
+        """Return a scaled energy, ratio, power, or duration.
 
         Args:
             other: The scalar, energy, power or duration to divide by.
 
         Returns:
-            A power or duration from dividing this energy by the given value.
+            A scaled energy, a ratio, a power, or a duration.
         """
         from ._power import Power  # pylint: disable=import-outside-toplevel
 

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_frequency.py

@@ -3,7 +3,6 @@
 
 """Types for holding quantities with units."""
 
-
 from datetime import timedelta
 from typing import Self
 

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_percentage.py

@@ -3,7 +3,6 @@
 
 """Types for holding quantities with units."""
 
-
 from typing import Self
 
 from ._quantity import NoDefaultConstructible, Quantity

{frequenz_quantities-1.0.1 → frequenz_quantities-1.0.2}/src/frequenz/quantities/_power.py

@@ -3,7 +3,6 @@
 
 """Types for holding quantities with units."""
 
-
 from __future__ import annotations
 
 from datetime import timedelta
@@ -203,7 +202,7 @@ class Power(
             current: The current to divide by.
 
         Returns:
-            A voltage from dividing this power by the a current.
+            A voltage from dividing this power by a current.
         """
 
     @overload