TypedUnit 0.0.3__tar.gz

typedunit-0.0.3/.flake8

@@ -0,0 +1,6 @@
+[flake8]
+max-line-length = 300
+exclude = [".git"]
+count = true
+per-file-ignores =
+    __init__.py: F403, F401

typedunit-0.0.3/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# Specify reviewers for pull requests
+
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    target-branch: "master"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "09:00"

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

@@ -0,0 +1,20 @@
+name: Deploy to PyPi
+
+on:
+  push:
+    branches: [ "master" ]
+    tags:
+      - '*'
+  pull_request:
+    branches: [ "master" ]
+
+permissions:
+    contents: write
+
+jobs:
+  pure_package:
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_pure_package_to_PyPi.yml@master
+    with:
+      python-version: "3.11"
+    secrets:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

typedunit-0.0.3/.github/workflows/deploy_anaconda.yml

@@ -0,0 +1,21 @@
+name: Deploy Conda Packages
+
+on:
+  push:
+    branches: [ "master" ]
+    tags: '*'
+  pull_request:
+    branches: [ "master" ]
+
+permissions:
+    contents: write
+
+jobs:
+  ManyLinux_x86_64:
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_compiled_package_to_anaconda.yml@master
+    with:
+      python-versions: '["3.11", "3.12", "3.13"]'
+      apt-package: ""
+    secrets:
+      ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}
+

typedunit-0.0.3/.github/workflows/deploy_coverage.yml

@@ -0,0 +1,25 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy coverage
+
+on:
+  push:
+    branches: [ "master" ]
+    tags: '*'
+  pull_request:
+    branches: [ "master" ]
+
+
+# Sets permissions of the  GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  ManyLinux_x86_64:
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_coverage.yml@master
+    with:
+      python-version: "3.11"
+      apt-package: xvfb
+    secrets:
+      _GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

typedunit-0.0.3/.github/workflows/deploy_documentation.yml

@@ -0,0 +1,24 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Documentation
+
+on:
+  push:
+    branches: [ "master" ]
+    tags: '*'
+  pull_request:
+    branches: [ "master" ]
+
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  ManyLinux_x86_64:
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_documentation.yml@master
+    with:
+      python-version: "3.11"
+      package-name: "TypedUnit"
+      apt-package: xvfb jq

typedunit-0.0.3/.gitignore

@@ -0,0 +1,28 @@
+# General patterns
+*.DS_store
+*.ipynb_checkpoints*
+*__pycache__*
+*.so
+*.a
+.coverage*
+*.pytest_cache
+htmlcov
+dist
+build
+*.egg*
+*.whl
+CMakeCache.txt
+CMakeFiles
+install_manifest.txt
+cmake_install.cmake
+wheelhouse
+
+# Docs-specific patterns
+docs/source/gallery/*
+!docs/source/gallery/index.rst
+PyOptik/data/**/test*
+PyOptik/data/**/example*
+
+# Override for documentation_build
+!documentation_build
+!documentation_build/**

typedunit-0.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Martin de Sivry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

typedunit-0.0.3/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: TypedUnit
+Version: 0.0.3
+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
+        
+        Copyright (c) 2020 Martin de Sivry
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/MartinPdeS/TypedUnit
+Project-URL: Documentation, https://martinpdes.github.io/TypedUnit/
+Project-URL: Repository, https://github.com/MartinPdeS/TypedUnit.git
+Keywords: typed units,pint,physical quantities
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Development Status :: 4 - Beta
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pint
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Provides-Extra: testing
+Requires-Dist: pytest<9.0,>=7.4; extra == "testing"
+Requires-Dist: pytest-cov<7,>=2; extra == "testing"
+Requires-Dist: pytest-json-report~=1.5; extra == "testing"
+Requires-Dist: flake8==7.3.0; extra == "testing"
+Requires-Dist: coverage~=7.6; extra == "testing"
+Provides-Extra: documentation
+Requires-Dist: numpydoc~=1.8; extra == "documentation"
+Requires-Dist: sphinx>=6; extra == "documentation"
+Requires-Dist: sphinx-gallery~=0.17; extra == "documentation"
+Requires-Dist: sphinx-rtd-theme<4,>=2; extra == "documentation"
+Requires-Dist: pydata-sphinx-theme~=0.15; extra == "documentation"
+Dynamic: license-file
+
+TypedUnits
+===========
+
+|python| |docs| |coverage| |PyPi| |PyPi_download|
+
+**Type-safe physical units for Python**
+
+TypedUnits is a Python library that extends Pint with type safety and validation capabilities. It allows you to create unit-aware types that work seamlessly with Python's type system and provide runtime validation for physical quantities.
+
+**Key Features:**
+
+- **Type Safety**: Use `isinstance()` checks with unit types like `Energy`, `Time`, `Power`
+- **Automatic Validation**: Function decorators for unit validation based on type annotations
+- **Pydantic Integration**: Full compatibility with Pydantic dataclasses and models
+- **Normal Pint Usage**: Keep your existing Pint code - just add type safety on top
+
+----
+
+**Quick Example**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Time, Power, validate, ureg
+
+   # Normal Pint instantiation
+   energy = 100 * ureg.joule
+   time = 10 * ureg.second
+
+   # But now isinstance works!
+   assert isinstance(energy, Energy)  # True
+   assert isinstance(time, Time)      # True
+
+   @validate_units
+   def calculate_power(energy: Energy, time: Time) -> Power:
+       """Function with automatic unit validation."""
+       return (energy / time).to(ureg.watt)
+
+   # This works
+   power = calculate_power(energy, time)
+   print(f"Power: {power}")
+
+   # This fails with clear error message
+   length = 5 * ureg.meter
+   # calculate_power(length, time)  # TypeError: Expected Energy, got Length
+
+----
+
+**Installation**
+
+.. code-block:: bash
+
+   pip install TypedUnits
+
+----
+
+**Basic Usage**
+
+**Unit Type Checking**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Length, Mass, ureg
+
+   # Create quantities the normal way
+   kinetic_energy = 0.5 * 10 * ureg.kilogram * (5 * ureg.meter / ureg.second)**2
+   potential_energy = 10 * ureg.kilogram * 9.81 * ureg.meter / ureg.second**2 * 2 * ureg.meter
+   distance = 100 * ureg.meter
+   mass = 5 * ureg.kilogram
+
+   # Type checking works
+   assert isinstance(kinetic_energy, Energy)
+   assert isinstance(potential_energy, Energy)
+   assert isinstance(distance, Length)
+   assert isinstance(mass, Mass)
+
+**Function Validation**
+
+.. code-block:: python
+
+   from TypedUnits import validate_units, Energy, Time, Power
+
+   @validate_units
+   def calculate_work(power: Power, time: Time) -> Energy:
+       """Calculate work from power and time."""
+       return (power * time).to(ureg.joule)
+
+   power = 1500 * ureg.watt
+   time = 3600 * ureg.second  # 1 hour
+   work = calculate_work(power, time)
+   print(f"Work done: {work.to(ureg.kilowatt_hour)}")
+
+**Pydantic Integration**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Length, Mass
+   from pydantic.dataclasses import dataclass
+
+   @dataclass
+   class Projectile:
+      kinetic_energy: Energy
+      height: Length
+      mass: Mass
+
+   # Automatic validation on creation
+   projectile = Projectile(
+      kinetic_energy=500 * ureg.joule,
+      height=10 * ureg.meter,
+      mass=2 * ureg.kilogram
+   )
+
+----
+
+**Available Unit Types**
+
+TypedUnits includes common physical unit types:
+
+- **Mechanical**: `Energy`, `Power`, `Force`, `Pressure`
+- **Spatial**: `Length`, `Area`, `Volume`, `Angle`
+- **Temporal**: `Time`, `Frequency`
+- **Thermal**: `Temperature`, `ThermalConductivity`
+- **Electrical**: `Current`, `Voltage`, `Resistance`, `Capacitance`
+- **Optical**: `RefractiveIndex`, `Wavelength`, `ElectricField`
+- **Mass**: `Mass`, `Density`, `MolarMass`
+
+----
+
+**Advanced Features**
+
+**Custom Unit Types**
+
+.. code-block:: python
+
+   from TypedUnits import create_unit_type
+
+   # Create your own unit types
+   MagneticField = create_unit_type('MagneticField', '[magnetic_flux_density]')
+
+   field = 1.5 * ureg.tesla
+   assert isinstance(field, MagneticField)
+
+**Flexible Validation**
+
+.. code-block:: python
+
+   from TypedUnits import validate_enhanced
+
+   @validate_enhanced(strict_mode=False, convert_types=True)
+   def flexible_function(energy: Energy, count: int) -> str:
+       """Function with flexible validation options."""
+       return f"Energy per item: {energy / count}"
+
+----
+
+**Requirements**
+
+- Python ≥ 3.8
+- Pint ≥ 0.20
+- Pydantic ≥ 2.0 (optional, for dataclass integration)
+
+----
+
+**Testing**
+
+.. code-block:: bash
+
+   git clone https://github.com/MartinPdeS/TypedUnits.git
+   cd TypedUnits
+   pip install -e ".[testing]"
+   pytest
+
+----
+
+**Contributing**
+
+TypedUnits is open source and contributions are welcome! Whether you're fixing bugs, adding new unit types, or improving documentation, your help is appreciated.
+
+**Author:** `Martin Poinsinet de Sivry-Houle <https://github.com/MartinPdeS>`_
+
+**Email:** `martin.poinsinet-de-sivry@polymtl.ca <mailto:martin.poinsinet-de-sivry@polymtl.ca?subject=TypedUnits>`_
+
+----
+
+.. |python| image:: https://img.shields.io/pypi/pyversions/typedunits.svg
+   :target: https://www.python.org/
+   :alt: Python version
+
+.. |PyPi| image:: https://badge.fury.io/py/TypedUnits.svg
+   :target: https://pypi.org/project/TypedUnits/
+   :alt: PyPi
+
+.. |PyPi_download| image:: https://img.shields.io/pypi/dm/typedunits.svg
+   :target: https://pypistats.org/packages/typedunits
+   :alt: PyPi download statistics
+
+.. |docs| image:: https://github.com/martinpdes/typedunits/actions/workflows/deploy_documentation.yml/badge.svg
+   :target: https://martinpdes.github.io/TypedUnits/
+   :alt: Documentation Status
+
+.. |coverage| image:: https://raw.githubusercontent.com/MartinPdeS/TypedUnits/python-coverage-comment-action-data/badge.svg
+   :target: https://htmlpreview.github.io/?https://github.com/MartinPdeS/TypedUnits/blob/python-coverage-comment-action-data/htmlcov/index.html
+   :alt: Unittest coverage

typedunit-0.0.3/README.rst

@@ -0,0 +1,202 @@
+TypedUnits
+===========
+
+|python| |docs| |coverage| |PyPi| |PyPi_download|
+
+**Type-safe physical units for Python**
+
+TypedUnits is a Python library that extends Pint with type safety and validation capabilities. It allows you to create unit-aware types that work seamlessly with Python's type system and provide runtime validation for physical quantities.
+
+**Key Features:**
+
+- **Type Safety**: Use `isinstance()` checks with unit types like `Energy`, `Time`, `Power`
+- **Automatic Validation**: Function decorators for unit validation based on type annotations
+- **Pydantic Integration**: Full compatibility with Pydantic dataclasses and models
+- **Normal Pint Usage**: Keep your existing Pint code - just add type safety on top
+
+----
+
+**Quick Example**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Time, Power, validate, ureg
+
+   # Normal Pint instantiation
+   energy = 100 * ureg.joule
+   time = 10 * ureg.second
+
+   # But now isinstance works!
+   assert isinstance(energy, Energy)  # True
+   assert isinstance(time, Time)      # True
+
+   @validate_units
+   def calculate_power(energy: Energy, time: Time) -> Power:
+       """Function with automatic unit validation."""
+       return (energy / time).to(ureg.watt)
+
+   # This works
+   power = calculate_power(energy, time)
+   print(f"Power: {power}")
+
+   # This fails with clear error message
+   length = 5 * ureg.meter
+   # calculate_power(length, time)  # TypeError: Expected Energy, got Length
+
+----
+
+**Installation**
+
+.. code-block:: bash
+
+   pip install TypedUnits
+
+----
+
+**Basic Usage**
+
+**Unit Type Checking**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Length, Mass, ureg
+
+   # Create quantities the normal way
+   kinetic_energy = 0.5 * 10 * ureg.kilogram * (5 * ureg.meter / ureg.second)**2
+   potential_energy = 10 * ureg.kilogram * 9.81 * ureg.meter / ureg.second**2 * 2 * ureg.meter
+   distance = 100 * ureg.meter
+   mass = 5 * ureg.kilogram
+
+   # Type checking works
+   assert isinstance(kinetic_energy, Energy)
+   assert isinstance(potential_energy, Energy)
+   assert isinstance(distance, Length)
+   assert isinstance(mass, Mass)
+
+**Function Validation**
+
+.. code-block:: python
+
+   from TypedUnits import validate_units, Energy, Time, Power
+
+   @validate_units
+   def calculate_work(power: Power, time: Time) -> Energy:
+       """Calculate work from power and time."""
+       return (power * time).to(ureg.joule)
+
+   power = 1500 * ureg.watt
+   time = 3600 * ureg.second  # 1 hour
+   work = calculate_work(power, time)
+   print(f"Work done: {work.to(ureg.kilowatt_hour)}")
+
+**Pydantic Integration**
+
+.. code-block:: python
+
+   from TypedUnits import Energy, Length, Mass
+   from pydantic.dataclasses import dataclass
+
+   @dataclass
+   class Projectile:
+      kinetic_energy: Energy
+      height: Length
+      mass: Mass
+
+   # Automatic validation on creation
+   projectile = Projectile(
+      kinetic_energy=500 * ureg.joule,
+      height=10 * ureg.meter,
+      mass=2 * ureg.kilogram
+   )
+
+----
+
+**Available Unit Types**
+
+TypedUnits includes common physical unit types:
+
+- **Mechanical**: `Energy`, `Power`, `Force`, `Pressure`
+- **Spatial**: `Length`, `Area`, `Volume`, `Angle`
+- **Temporal**: `Time`, `Frequency`
+- **Thermal**: `Temperature`, `ThermalConductivity`
+- **Electrical**: `Current`, `Voltage`, `Resistance`, `Capacitance`
+- **Optical**: `RefractiveIndex`, `Wavelength`, `ElectricField`
+- **Mass**: `Mass`, `Density`, `MolarMass`
+
+----
+
+**Advanced Features**
+
+**Custom Unit Types**
+
+.. code-block:: python
+
+   from TypedUnits import create_unit_type
+
+   # Create your own unit types
+   MagneticField = create_unit_type('MagneticField', '[magnetic_flux_density]')
+
+   field = 1.5 * ureg.tesla
+   assert isinstance(field, MagneticField)
+
+**Flexible Validation**
+
+.. code-block:: python
+
+   from TypedUnits import validate_enhanced
+
+   @validate_enhanced(strict_mode=False, convert_types=True)
+   def flexible_function(energy: Energy, count: int) -> str:
+       """Function with flexible validation options."""
+       return f"Energy per item: {energy / count}"
+
+----
+
+**Requirements**
+
+- Python ≥ 3.8
+- Pint ≥ 0.20
+- Pydantic ≥ 2.0 (optional, for dataclass integration)
+
+----
+
+**Testing**
+
+.. code-block:: bash
+
+   git clone https://github.com/MartinPdeS/TypedUnits.git
+   cd TypedUnits
+   pip install -e ".[testing]"
+   pytest
+
+----
+
+**Contributing**
+
+TypedUnits is open source and contributions are welcome! Whether you're fixing bugs, adding new unit types, or improving documentation, your help is appreciated.
+
+**Author:** `Martin Poinsinet de Sivry-Houle <https://github.com/MartinPdeS>`_
+
+**Email:** `martin.poinsinet-de-sivry@polymtl.ca <mailto:martin.poinsinet-de-sivry@polymtl.ca?subject=TypedUnits>`_
+
+----
+
+.. |python| image:: https://img.shields.io/pypi/pyversions/typedunits.svg
+   :target: https://www.python.org/
+   :alt: Python version
+
+.. |PyPi| image:: https://badge.fury.io/py/TypedUnits.svg
+   :target: https://pypi.org/project/TypedUnits/
+   :alt: PyPi
+
+.. |PyPi_download| image:: https://img.shields.io/pypi/dm/typedunits.svg
+   :target: https://pypistats.org/packages/typedunits
+   :alt: PyPi download statistics
+
+.. |docs| image:: https://github.com/martinpdes/typedunits/actions/workflows/deploy_documentation.yml/badge.svg
+   :target: https://martinpdes.github.io/TypedUnits/
+   :alt: Documentation Status
+
+.. |coverage| image:: https://raw.githubusercontent.com/MartinPdeS/TypedUnits/python-coverage-comment-action-data/badge.svg
+   :target: https://htmlpreview.github.io/?https://github.com/MartinPdeS/TypedUnits/blob/python-coverage-comment-action-data/htmlcov/index.html
+   :alt: Unittest coverage

typedunit-0.0.3/TypedUnit/__init__.py

@@ -0,0 +1,9 @@
+try:
+    from ._version import version as __version__  # noqa: F401
+
+except ImportError:
+    __version__ = "0.0.0"
+
+
+from .units import *
+from .helper import validate_units

typedunit-0.0.3/TypedUnit/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.0.3'
+__version_tuple__ = version_tuple = (0, 0, 3)
+
+__commit_id__ = commit_id = 'g60e49e059'