phaethon 0.2.2__tar.gz → 0.2.3__tar.gz

{phaethon-0.2.2/src/phaethon.egg-info → phaethon-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phaethon
-Version: 0.2.2
+Version: 0.2.3
 Summary: Unit-Safe Data Pipeline Schema and Semantic Data Transformation
 Author-email: Zahraan Dzakii Tsaqiif <zahraandzakiits@gmail.com>
 License: MIT
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 <div align="center">
 
-<h1>Phaethon — Unit-Safe Data Pipeline Schema</h1>
+<h1>Phaethon — Unit-Safe Data Pipeline Schema & Semantic Data Transformation</h1>
 
 <p>
 <img src="https://img.shields.io/badge/MADE_WITH-PYTHON-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python">
@@ -46,7 +46,7 @@ Dynamic: license-file
 </p>
 
 <p>
-<i>Normalize messy heterogeneous units and enforce physical integrity before your data hits ML or production systems.</i>
+<i>Translate raw bytes into meaningful domain concepts, normalize messy units, and enforce physical integrity before your data hits ML or production systems.</i>
 </p>
 
 </div>
@@ -145,6 +145,19 @@ class ColdChainPipeline(ptn.Schema):
         return clean_df
 ```
 
+---
+
+## ⚖️ Absolute Precision: 100% Parity with Pint
+
+Phaethon doesn't just parse strings quickly; it calculates physical reality flawlessly. From quantum scales (`eV`) to astronomical masses (`M_jup`), the core engine retains absolute `float64` precision without underflow truncation.
+
+We enforce **100% mathematical parity** against the industry-standard `Pint` library using brutal, property-based automated testing (`hypothesis`). 
+
+* **Empirical Accuracy:** Phaethon achieves zero-deviation parity across hundreds of randomized, bidirectional cross-dimensional conversions.
+* **Superior Vocabulary:** Phaethon natively parses **65+ specialized units** (e.g., historical mass, regional volumes, astrophysical constants) that standard libraries fail to recognize or fatally misinterpret due to string hyphenation bugs.
+
+> *Transparency Note: You can audit and run the rigorous O(N) Hub-and-Spoke accuracy tests yourself via the `benchmarks/test_pint_parity.py` script included in this repository.*
+
 ---
 ## 🏎️ The Fluent API (Quick Inline Conversions)
 

{phaethon-0.2.2 → phaethon-0.2.3}/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<h1>Phaethon — Unit-Safe Data Pipeline Schema</h1>
+<h1>Phaethon — Unit-Safe Data Pipeline Schema & Semantic Data Transformation</h1>
 
 <p>
 <img src="https://img.shields.io/badge/MADE_WITH-PYTHON-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python">
@@ -10,7 +10,7 @@
 </p>
 
 <p>
-<i>Normalize messy heterogeneous units and enforce physical integrity before your data hits ML or production systems.</i>
+<i>Translate raw bytes into meaningful domain concepts, normalize messy units, and enforce physical integrity before your data hits ML or production systems.</i>
 </p>
 
 </div>
@@ -109,6 +109,19 @@ class ColdChainPipeline(ptn.Schema):
         return clean_df
 ```
 
+---
+
+## ⚖️ Absolute Precision: 100% Parity with Pint
+
+Phaethon doesn't just parse strings quickly; it calculates physical reality flawlessly. From quantum scales (`eV`) to astronomical masses (`M_jup`), the core engine retains absolute `float64` precision without underflow truncation.
+
+We enforce **100% mathematical parity** against the industry-standard `Pint` library using brutal, property-based automated testing (`hypothesis`). 
+
+* **Empirical Accuracy:** Phaethon achieves zero-deviation parity across hundreds of randomized, bidirectional cross-dimensional conversions.
+* **Superior Vocabulary:** Phaethon natively parses **65+ specialized units** (e.g., historical mass, regional volumes, astrophysical constants) that standard libraries fail to recognize or fatally misinterpret due to string hyphenation bugs.
+
+> *Transparency Note: You can audit and run the rigorous O(N) Hub-and-Spoke accuracy tests yourself via the `benchmarks/test_pint_parity.py` script included in this repository.*
+
 ---
 ## 🏎️ The Fluent API (Quick Inline Conversions)
 

{phaethon-0.2.2 → phaethon-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "phaethon"
-version = "0.2.2"
+version = "0.2.3"
 description = "Unit-Safe Data Pipeline Schema and Semantic Data Transformation"
 readme = "README.md"
 requires-python = ">=3.8"

{phaethon-0.2.2 → phaethon-0.2.3}/src/phaethon/__init__.py

@@ -63,7 +63,7 @@ del _bootstrap_units
 
 from . import u
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 __all__ = [
     "u",
     "baseof",

{phaethon-0.2.2 → phaethon-0.2.3}/src/phaethon/core/engine.py

@@ -54,7 +54,7 @@ class _ConversionBuilder:
         
         self._options = {
             "mode": "float64",
-            "prec": 9,
+            "prec": None,
             "roundin": "half_even",
             "output": "raw", 
             "sigfigs": None,
@@ -273,7 +273,10 @@ class _ConversionBuilder:
                 else:
                     final_value = converted_value
             else:
-                final_value = round(converted_value, prec)
+                if prec is not None:
+                    final_value = round(converted_value, prec)
+                else:
+                    final_value = float(converted_value)
         else:
             raise ConversionError(f"Computation mode '{mode}' is not recognized. Use 'decimal' or 'float64'.")
 
@@ -372,8 +375,10 @@ class _ConversionBuilder:
             if sigfigs and isinstance(final_value, Decimal):
                 decimal_places = max(sigfigs - (final_value.adjusted() + 1), 0)
                 val_str = f"{final_value:.{decimal_places}f}"
+            elif prec is not None:
+                val_str = format(final_value, f'.{prec}f')
             else:
-                val_str = format(final_value, 'f')
+                val_str = str(final_value)
 
         if not scinote and '.' in val_str:
             val_str = val_str.rstrip('0')

{phaethon-0.2.2 → phaethon-0.2.3}/src/phaethon/core/registry.py

@@ -1,6 +1,7 @@
-from typing import Dict, List, Type, Optional, Set, Any, Union
+from typing import Dict, List, Type, Optional, Set, Any, Union, TYPE_CHECKING, overload, Literal
 from ..exceptions import UnitNotFoundError, DimensionMismatchError, AmbiguousUnitError
-import numpy as np
+if TYPE_CHECKING:
+    from .base import BaseUnit
 
 _DIMENSIONAL_DNA = {
     frozenset({('length', 1), ('time', -1)}): 'speed',
@@ -93,7 +94,7 @@ class UnitRegistry:
             
         return candidates[0]
 
-    def baseof(self, dimension: str) -> Type:
+    def baseof(self, dimension: str) -> Type['BaseUnit']:
         dimension = dimension.lower().strip()
         for candidates in self._units.values():
             for cls in candidates:
@@ -144,7 +145,7 @@ class UnitRegistry:
 default_ureg = UnitRegistry()
 
 
-def baseof(dimension: str) -> Type:
+def baseof(dimension: str) -> Type['BaseUnit']:
     """
     Retrieves the base unit class (the absolute reference point) for a dimension.
     Args:
@@ -162,17 +163,19 @@ def dims() -> List[str]:
     """
     return default_ureg.dims()
 
-def unitsin(dimension: str, ascls: bool = False) -> List[Union[str, Type]]:
+@overload
+def unitsin(dimension: str, ascls: Literal[False] = ...) -> List[str]: ...
+
+@overload
+def unitsin(dimension: str, ascls: Literal[True]) -> List[Type['BaseUnit']]: ...
+
+def unitsin(dimension: str, ascls: bool = False) -> Union[List[str], List[Type['BaseUnit']]]:
     """
     Retrieves units associated with a specific dimension.
     
     Args:
         dimension: The dimension name (e.g., 'mass').
         ascls: If True, returns the actual Class objects instead of strings.
-        
-    
-    >>> phaethon.unitsin('mass') -> ['g', 'kg', 'lb', ...]
-    >>> phaethon.unitsin('mass', ascls=True) -> [<class 'Gram'>, <class 'Kilogram'>, ...]
     """
     return default_ureg.unitsin(dimension, ascls=ascls)
 

{phaethon-0.2.2 → phaethon-0.2.3}/src/phaethon/units/mass.py

@@ -29,7 +29,7 @@ class Kilogram(MassUnit):
 
 class Gram(MassUnit):
     symbol = "g"
-    aliases = ["gram", "grams", "gm", "gms", "G", "gr"]
+    aliases = ["gram", "grams", "gm", "gms", "G"]
     base_multiplier = 1e-3
 
 class Milligram(MassUnit):
@@ -184,7 +184,7 @@ class AtomicMassUnit(MassUnit):
     base_multiplier = _const.ATOMIC_MASS_UNIT_KG
 
 class PlanckMass(MassUnit):
-    symbol = "m_p"
+    symbol = "m_P"
     aliases = ["planckmass", "planck-mass", "planck mass"]
     base_multiplier = _const.PLANCK_MASS_KG
 

{phaethon-0.2.2 → phaethon-0.2.3/src/phaethon.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phaethon
-Version: 0.2.2
+Version: 0.2.3
 Summary: Unit-Safe Data Pipeline Schema and Semantic Data Transformation
 Author-email: Zahraan Dzakii Tsaqiif <zahraandzakiits@gmail.com>
 License: MIT
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 <div align="center">
 
-<h1>Phaethon — Unit-Safe Data Pipeline Schema</h1>
+<h1>Phaethon — Unit-Safe Data Pipeline Schema & Semantic Data Transformation</h1>
 
 <p>
 <img src="https://img.shields.io/badge/MADE_WITH-PYTHON-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python">
@@ -46,7 +46,7 @@ Dynamic: license-file
 </p>
 
 <p>
-<i>Normalize messy heterogeneous units and enforce physical integrity before your data hits ML or production systems.</i>
+<i>Translate raw bytes into meaningful domain concepts, normalize messy units, and enforce physical integrity before your data hits ML or production systems.</i>
 </p>
 
 </div>
@@ -145,6 +145,19 @@ class ColdChainPipeline(ptn.Schema):
         return clean_df
 ```
 
+---
+
+## ⚖️ Absolute Precision: 100% Parity with Pint
+
+Phaethon doesn't just parse strings quickly; it calculates physical reality flawlessly. From quantum scales (`eV`) to astronomical masses (`M_jup`), the core engine retains absolute `float64` precision without underflow truncation.
+
+We enforce **100% mathematical parity** against the industry-standard `Pint` library using brutal, property-based automated testing (`hypothesis`). 
+
+* **Empirical Accuracy:** Phaethon achieves zero-deviation parity across hundreds of randomized, bidirectional cross-dimensional conversions.
+* **Superior Vocabulary:** Phaethon natively parses **65+ specialized units** (e.g., historical mass, regional volumes, astrophysical constants) that standard libraries fail to recognize or fatally misinterpret due to string hyphenation bugs.
+
+> *Transparency Note: You can audit and run the rigorous O(N) Hub-and-Spoke accuracy tests yourself via the `benchmarks/test_pint_parity.py` script included in this repository.*
+
 ---
 ## 🏎️ The Fluent API (Quick Inline Conversions)