TypedUnit 0.2.9__tar.gz → 0.2.13__tar.gz

typedunit-0.2.9/.github/workflows/deploy_anaconda.yml → typedunit-0.2.13/.github/workflows/deploy_release.yml

@@ -1,4 +1,4 @@
-name: Publish Conda package
+name: Publish release
 
 on:
   push:
@@ -8,10 +8,19 @@ permissions:
   contents: read
 
 jobs:
-  publish:
+  pypi:
+    name: Publish to PyPI
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_pure_package_to_PyPi.yml@a01969bc5af90666281f9d37acffdf6a4629763a
+    with:
+      python-version: "3.11"
+      test-command: python -c 'import TypedUnit; print(TypedUnit.__version__)'
+    secrets:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+
+  conda:
+    name: Publish Conda package
     uses: MartinPdeS/MPSActions/.github/workflows/publish_compiled_package_to_anaconda.yml@a01969bc5af90666281f9d37acffdf6a4629763a
     with:
-      # One noarch archive supports all declared Python versions; test it on 3.14.
       python_versions: '["3.14"]'
       os_list: '["ubuntu-latest"]'
       package_name: typedunit

{typedunit-0.2.9 → typedunit-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TypedUnit
-Version: 0.2.9
+Version: 0.2.13
 Summary: A package wrapping pint for handling typed units in Python.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License

{typedunit-0.2.9 → typedunit-0.2.13}/TypedUnit/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.9'
-__version_tuple__ = version_tuple = (0, 2, 9)
+__version__ = version = '0.2.13'
+__version_tuple__ = version_tuple = (0, 2, 13)
 
-__commit_id__ = commit_id = 'g9964b9a87'
+__commit_id__ = commit_id = 'g62984b710'

{typedunit-0.2.9 → typedunit-0.2.13}/TypedUnit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TypedUnit
-Version: 0.2.9
+Version: 0.2.13
 Summary: A package wrapping pint for handling typed units in Python.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License

{typedunit-0.2.9 → typedunit-0.2.13}/TypedUnit.egg-info/SOURCES.txt

@@ -9,10 +9,9 @@ README.rst
 pyproject.toml
 pytest.ini
 .github/dependabot.yml
-.github/workflows/deploy_PyPi.yml
-.github/workflows/deploy_anaconda.yml
 .github/workflows/deploy_coverage.yml
 .github/workflows/deploy_documentation.yml
+.github/workflows/deploy_release.yml
 .github/workflows/quality.yml
 .github/workflows/tests.yml
 TypedUnit/__init__.py
@@ -42,9 +41,15 @@ docs/source/index.rst
 docs/source/references.rst
 docs/source/sg_execution_times.rst
 docs/source/theory.rst
+docs/source/units.rst
 docs/source/_static/default.css
 docs/source/_static/layout.css
 docs/source/_static/thumbnail.png
+docs/source/guide/concepts.rst
+docs/source/guide/installation.rst
+docs/source/guide/pint.rst
+docs/source/guide/quickstart.rst
+docs/source/guide/validation.rst
 tests/__init__.py
 tests/test_0.py
 tools/next_release_version.py

{typedunit-0.2.9 → typedunit-0.2.13}/TypedUnit.egg-info/scm_file_list.json

@@ -3,10 +3,9 @@
     ".coveragerc",
     ".flake8",
     ".github/dependabot.yml",
-    ".github/workflows/deploy_PyPi.yml",
-    ".github/workflows/deploy_anaconda.yml",
     ".github/workflows/deploy_coverage.yml",
     ".github/workflows/deploy_documentation.yml",
+    ".github/workflows/deploy_release.yml",
     ".github/workflows/quality.yml",
     ".github/workflows/tests.yml",
     ".gitignore",
@@ -34,10 +33,16 @@
     "docs/source/_static/thumbnail.png",
     "docs/source/code.rst",
     "docs/source/conf.py",
+    "docs/source/guide/concepts.rst",
+    "docs/source/guide/installation.rst",
+    "docs/source/guide/pint.rst",
+    "docs/source/guide/quickstart.rst",
+    "docs/source/guide/validation.rst",
     "docs/source/index.rst",
     "docs/source/references.rst",
     "docs/source/sg_execution_times.rst",
     "docs/source/theory.rst",
+    "docs/source/units.rst",
     "pyproject.toml",
     "pytest.ini",
     "tests/__init__.py",

{typedunit-0.2.9 → typedunit-0.2.13}/TypedUnit.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.2.9",
+  "tag": "0.2.13",
   "distance": 0,
-  "node": "g9964b9a8787fb1ce626019fed4845bc103a77d37",
+  "node": "g62984b7107a5152593ca6d295cea17ff1a3a6ecc",
   "dirty": true,
   "branch": "HEAD",
   "node_date": "2026-10-20"

typedunit-0.2.13/docs/source/code.rst

@@ -0,0 +1,20 @@
+.. _source_code:
+
+API reference
+=============
+
+The reference below is generated from the public modules. See the user guide
+for examples and design explanations.
+
+.. automodule:: TypedUnit
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: TypedUnit.helper
+   :members:
+   :show-inheritance:
+
+.. automodule:: TypedUnit.units
+   :members:
+   :show-inheritance:

{typedunit-0.2.9 → typedunit-0.2.13}/docs/source/conf.py

@@ -22,6 +22,7 @@ globals().update(
         version=version,
         logo=logo,
         favicon=logo,
+        html_theme_options={"show_nav_level": 1},
         sphinx_gallery_conf={
             "default_thumb_file": thumbnail,
             "within_subsection_order": FileNameSortKey,

typedunit-0.2.13/docs/source/guide/concepts.rst

@@ -0,0 +1,37 @@
+Core concepts
+=============
+
+TypedUnit has three complementary pieces.
+
+Dimensional types
+-----------------
+
+Classes such as ``Length`` and ``Voltage`` are lightweight marker types. They
+do not wrap or copy a quantity:
+
+.. code-block:: python
+
+   distance = 2 * ureg.kilometer
+   isinstance(distance, Length)       # True
+   isinstance(distance, Mass)         # False
+
+Pint still owns arithmetic, conversion, formatting, and NumPy integration.
+
+The shared registry
+-------------------
+
+Import ``ureg`` from TypedUnit rather than constructing a second registry.
+It includes domain units such as ``particle``, ``event``, ``photoelectron``,
+and ``sqrt_hertz``.
+
+Derived annotation types
+------------------------
+
+Unit classes can describe derived dimensions:
+
+.. code-block:: python
+
+   EnergyPerTime = Energy / Time
+   isinstance(2 * ureg.watt, EnergyPerTime)  # True
+
+These expressions describe dimensions; use Pint expressions for calculations.

typedunit-0.2.13/docs/source/guide/installation.rst

@@ -0,0 +1,21 @@
+Installation
+============
+
+.. code-block:: console
+
+   $ python -m pip install TypedUnit
+
+TypedUnit supports Python 3.10 and newer. Pydantic is optional; install it
+separately when using Pydantic models or dataclasses.
+
+For a development checkout:
+
+.. code-block:: console
+
+   $ git clone https://github.com/MartinPdeS/TypedUnit.git
+   $ cd TypedUnit
+   $ python -m pip install -e ".[testing,documentation]"
+   $ pytest
+
+The package exposes one application-wide registry, :data:`TypedUnit.ureg`.
+Use it when creating quantities so dimensional checks remain consistent.

typedunit-0.2.13/docs/source/guide/pint.rst

@@ -0,0 +1,24 @@
+Working with Pint
+=================
+
+TypedUnit is a thin layer over Pint. A quantity remains a normal
+``pint.Quantity`` and can be converted, indexed, or used with NumPy.
+
+.. code-block:: python
+
+   from TypedUnit import Length, ureg
+
+   diameter = 30 * ureg.centimeter
+   area = (diameter / 2) ** 2 * 3.14159
+   assert isinstance(diameter, Length)
+   print(area.to(ureg.square_meter))
+
+Dimensionality is the source of truth: metres and kilometres are both
+``Length``. Avoid mixing registries; use the shared ``TypedUnit.ureg`` at
+integration boundaries when external libraries return quantities.
+
+TypedUnit classes are markers, not constructors. Create values with Pint:
+
+.. code-block:: python
+
+   energy = 3 * ureg.joule

typedunit-0.2.13/docs/source/guide/quickstart.rst

@@ -0,0 +1,27 @@
+Quick start
+===========
+
+Create quantities as you would with Pint, and use TypedUnit classes where
+physical meaning matters:
+
+.. code-block:: python
+
+   from TypedUnit import Energy, Power, Time, ureg, validate_units
+
+   energy = 100 * ureg.joule
+   duration = 10 * ureg.second
+
+   assert isinstance(energy, Energy)
+   assert isinstance(duration, Time)
+
+   @validate_units
+   def average_power(energy: Energy, duration: Time) -> Power:
+       return (energy / duration).to(ureg.watt)
+
+   print(average_power(energy, duration))  # 10.0 watt
+
+Passing ``5 * ureg.meter`` as ``energy`` raises an error before the function
+body runs. Conversion remains explicit: ``energy.to(ureg.kilojoule)``.
+
+TypedUnit checks dimensionality, not the display unit. Joules and kilowatt
+hours are both ``Energy``; metres are not.

typedunit-0.2.13/docs/source/guide/validation.rst

@@ -0,0 +1,40 @@
+Validating function inputs
+==========================
+
+Decorate a function after adding TypedUnit annotations:
+
+.. code-block:: python
+
+   from TypedUnit import Energy, Time, validate_units, ureg
+
+   @validate_units
+   def energy_rate(energy: Energy, time: Time, label: str = "run"):
+       return energy / time, label
+
+Only parameters annotated with a TypedUnit class are checked. Ordinary
+annotations such as ``str`` and ``int`` are not runtime-validated, and return
+values are not checked.
+
+Optional and collection inputs
+------------------------------
+
+``Optional`` unit values and homogeneous lists or tuples are supported:
+
+.. code-block:: python
+
+   from typing import Optional
+   from TypedUnit import Length, Time, validate_units, ureg
+
+   @validate_units
+   def summarize(points: list[Length], elapsed: Optional[Time] = None):
+       return len(points), elapsed
+
+Invalid values raise ``ValueError`` with the parameter name and, for a
+collection, its index. A required ``None`` is rejected as well.
+
+Pydantic
+--------
+
+TypedUnit classes can be used as annotations in Pydantic dataclasses or
+models. Use ``@validate_units`` on calculation functions that accept those
+fields when an explicit function boundary is useful.

typedunit-0.2.13/docs/source/index.rst

@@ -0,0 +1,93 @@
+**Date**: |today|, **Version**: |version|
+
+TypedUnit documentation
+=======================
+
+TypedUnit adds readable, runtime-checkable physical quantity types to Pint.
+It keeps Pint's quantity objects and operations while giving APIs a vocabulary
+for physical meaning such as ``Length``, ``Energy``, and ``Frequency``.
+
+Start here
+----------
+
+A typical TypedUnit workflow has three small steps:
+
+#. Create values with the shared :data:`TypedUnit.ureg` registry.
+#. Annotate boundaries with the dimensional type that the value represents.
+#. Add :func:`TypedUnit.validate_units` where runtime validation is useful.
+
+This keeps unit conversion and arithmetic in Pint while making interfaces
+self-documenting and checking dimensional mistakes close to their source.
+
+.. code-block:: python
+
+   from TypedUnit import Energy, ureg, validate_units
+
+   @validate_units
+   def efficiency(input_energy: Energy, output_energy: Energy) -> float:
+       return (output_energy / input_energy).to_base_units().magnitude
+
+   input_energy = 2 * ureg.kilojoule
+   output_energy = 500 * ureg.joule
+   print(efficiency(input_energy, output_energy))
+
+Choose a path
+-------------
+
+* New to TypedUnit? Read :doc:`guide/installation` and :doc:`guide/quickstart`.
+* Designing an API? See :doc:`guide/concepts` and :doc:`guide/validation`.
+* Integrating with Pint or NumPy? Read :doc:`guide/pint`.
+* Looking for a type or helper? Open :doc:`units` and :doc:`code`.
+* Want runnable examples? Browse :doc:`gallery/index`.
+
+What TypedUnit provides
+-----------------------
+
+TypedUnit supplies a shared registry, dimensional marker classes, and an
+optional validation decorator. Marker classes describe what a value means;
+they do not replace Pint quantities or introduce a second unit system.
+
+The package is intentionally small at integration boundaries. Existing Pint
+quantities can be passed through TypedUnit annotations, converted normally,
+and used with NumPy. Applications can adopt the annotations incrementally,
+starting with public functions and configuration models.
+
+Compatibility notes
+-------------------
+
+Use :data:`TypedUnit.ureg` throughout an application. Quantities created by a
+second Pint registry may have compatible dimensions but are different runtime
+objects, which can make validation and comparisons surprising. Convert values
+at library boundaries and keep registry ownership explicit.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Learn
+
+    guide/installation
+    guide/quickstart
+    guide/concepts
+    guide/validation
+    guide/pint
+    theory
+
+.. toctree::
+    :maxdepth: 2
+    :caption: API reference
+
+    units
+    code
+    references
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Examples
+
+    gallery/index
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

typedunit-0.2.13/docs/source/references.rst

@@ -0,0 +1,11 @@
+.. _references:
+
+References
+===========
+
+* `Pint documentation <https://pint.readthedocs.io/>`_ — quantities,
+  dimensionality, conversion, and registries.
+* `Python typing documentation <https://docs.python.org/3/library/typing.html>`_
+  — annotation syntax used by the validator.
+* `Pydantic documentation <https://docs.pydantic.dev/>`_ — model and dataclass
+  validation when Pydantic is installed.

typedunit-0.2.13/docs/source/theory.rst

@@ -0,0 +1,12 @@
+.. _theory:
+
+Theoretical background
+======================
+
+TypedUnit separates values from meaning. Pint stores a magnitude and unit and
+performs dimensional arithmetic. TypedUnit maps selected Pint dimensionalities
+to Python classes, allowing the same meaning to appear in annotations and
+runtime checks without changing the quantity object.
+
+For practical usage, start with :doc:`guide/quickstart` and
+:doc:`guide/validation`.

typedunit-0.2.13/docs/source/units.rst

@@ -0,0 +1,35 @@
+Unit types
+==========
+
+All public unit classes are re-exported from ``TypedUnit``.
+
+.. list-table:: Common types
+   :header-rows: 1
+   :widths: 28 36 36
+
+   * - Type
+     - Dimension
+     - Typical units
+   * - ``Length`` / ``Area`` / ``Volume``
+     - length / length squared / volume
+     - meter, square_meter, liter
+   * - ``Mass`` / ``Time`` / ``Frequency``
+     - mass / time / inverse time
+     - kilogram, second, hertz
+   * - ``Velocity`` / ``FlowRate``
+     - length per time / liter per second
+     - meter / second, liter / second
+   * - ``Energy`` / ``Power``
+     - energy / energy per time
+     - joule, watt
+   * - ``Voltage`` / ``Current`` / ``Resistance``
+     - potential / current / resistance
+     - volt, ampere, ohm
+   * - ``Temperature`` / ``Angle``
+     - temperature / angle
+     - kelvin, degree
+   * - ``Dimensionless`` / ``AnyUnit``
+     - no dimensions / any dimensionality
+     - dimensionless / any Pint quantity
+
+See :doc:`code` for the complete generated class reference.

typedunit-0.2.9/.github/workflows/deploy_PyPi.yml

@@ -1,18 +0,0 @@
-name: Publish to PyPI
-
-on:
-  push:
-    tags: ["v*"]
-
-permissions:
-  contents: read
-
-jobs:
-  publish:
-    uses: MartinPdeS/MPSActions/.github/workflows/publish_pure_package_to_PyPi.yml@a01969bc5af90666281f9d37acffdf6a4629763a
-    with:
-      python-version: "3.11"
-      # The reusable workflow wraps this command in double quotes.
-      test-command: python -c 'import TypedUnit; print(TypedUnit.__version__)'
-    secrets:
-      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

typedunit-0.2.9/docs/source/code.rst

@@ -1,7 +0,0 @@
-.. _source_code:
-
-Source Code
-===========
-
-This section provides an overview of the primary classes used in the `FiberFusing` package. Each class includes detailed descriptions of its members and inherited members, organized by their source order for easy reference.
-

typedunit-0.2.9/docs/source/index.rst

@@ -1,13 +0,0 @@
-**Date**: |today|, **Version**: |version|
-
-
-.. include:: ../../README.rst
-    :start-line: 0
-
-.. toctree::
-    :hidden:
-
-    theory
-    code
-    gallery/index
-    references

typedunit-0.2.9/docs/source/references.rst

@@ -1,6 +0,0 @@
-.. _references:
-
-References
-===========
-
-

typedunit-0.2.9/docs/source/theory.rst

@@ -1,5 +0,0 @@
-.. _theory:
-
-Theoretical background
-======================
-