ucon 0.6.1__py3-none-any.whl → 0.6.3__py3-none-any.whl

ucon/units.py

@@ -204,6 +204,15 @@ def have(name: str) -> bool:
 _UNIT_REGISTRY: Dict[str, Unit] = {}
 _UNIT_REGISTRY_CASE_SENSITIVE: Dict[str, Unit] = {}
 
+# Priority aliases that must match exactly before prefix decomposition.
+# Prevents ambiguous parses like "min" -> milli-inch instead of minute.
+_PRIORITY_ALIASES: set = {'min'}
+
+# Priority scaled aliases that map to a specific (unit, scale) tuple.
+# Used for medical conventions like "mcg" -> (gram, Scale.micro).
+# Populated by _build_registry() after units are defined.
+_PRIORITY_SCALED_ALIASES: Dict[str, Tuple[Unit, Scale]] = {}
+
 # Scale prefix mapping (shorthand -> Scale)
 # Sorted by length descending for greedy matching
 _SCALE_PREFIXES: Dict[str, Scale] = {
@@ -256,6 +265,9 @@ def _build_registry() -> None:
                     _UNIT_REGISTRY[alias.lower()] = obj
                     _UNIT_REGISTRY_CASE_SENSITIVE[alias] = obj
 
+    # Register priority scaled aliases (medical conventions)
+    _PRIORITY_SCALED_ALIASES['mcg'] = (gram, Scale.micro)  # microgram
+
 
 def _parse_exponent(s: str) -> Tuple[str, float]:
     """
@@ -294,7 +306,10 @@ def _lookup_factor(s: str) -> Tuple[Unit, Scale]:
     """
     Look up a single unit factor, handling scale prefixes.
 
-    Prioritizes prefix+unit interpretation over direct unit lookup.
+    Prioritizes prefix+unit interpretation over direct unit lookup,
+    except for priority aliases (like 'min', 'mcg') which are checked first
+    to avoid ambiguous parses or to handle domain-specific conventions.
+
     This means "kg" returns (gram, Scale.kilo) rather than (kilogram, Scale.one).
 
     Examples:
@@ -303,6 +318,8 @@ def _lookup_factor(s: str) -> Tuple[Unit, Scale]:
     - 'km' -> (meter, Scale.kilo)
     - 'kg' -> (gram, Scale.kilo)
     - 'mL' -> (liter, Scale.milli)
+    - 'min' -> (minute, Scale.one)  # priority alias, not milli-inch
+    - 'mcg' -> (gram, Scale.micro)  # medical convention for microgram
 
     Returns:
         Tuple of (unit, scale).
@@ -310,7 +327,19 @@ def _lookup_factor(s: str) -> Tuple[Unit, Scale]:
     Raises:
         UnknownUnitError: If the unit cannot be resolved.
     """
-    # Try scale prefix + unit first (prioritize decomposition)
+    # Check priority scaled aliases first (e.g., "mcg" -> microgram)
+    if s in _PRIORITY_SCALED_ALIASES:
+        return _PRIORITY_SCALED_ALIASES[s]
+
+    # Check priority aliases (prevents "min" -> milli-inch)
+    if s in _PRIORITY_ALIASES:
+        if s in _UNIT_REGISTRY_CASE_SENSITIVE:
+            return _UNIT_REGISTRY_CASE_SENSITIVE[s], Scale.one
+        s_lower = s.lower()
+        if s_lower in _UNIT_REGISTRY:
+            return _UNIT_REGISTRY[s_lower], Scale.one
+
+    # Try scale prefix + unit (prioritize decomposition)
     # Only case-sensitive matching for remainder (e.g., "fT" = femto-tesla, "ft" = foot)
     for prefix in _SCALE_PREFIXES_SORTED:
         if s.startswith(prefix) and len(s) > len(prefix):

{ucon-0.6.1.dist-info → ucon-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucon
-Version: 0.6.1
+Version: 0.6.3
 Summary: A tool for dimensional analysis: a 'Unit CONverter'
 Home-page: https://github.com/withtwoemms/ucon
 Author: Emmanuel I. Obi

{ucon-0.6.1.dist-info → ucon-0.6.3.dist-info}/RECORD

@@ -5,13 +5,13 @@ ucon/graph.py,sha256=vBIKwppYCAu5sw6R_3zTBlnOk2WmYMClIb6j5kDvJHI,21342
 ucon/maps.py,sha256=-rPMOHylcQYUn62R9IU23bXdCRCRNBhdH3UD4G5IUEk,9123
 ucon/pydantic.py,sha256=64ZR1EYFRnBGHj3VIF5pc3swdAiR2ZlYrgcntdbKN4k,5189
 ucon/quantity.py,sha256=GBxZ_96nocx-8F-usNWGbPvWHRhRgdZzqfH9Sx69iC4,465
-ucon/units.py,sha256=49Xart5orKUKOKs0vIIWoEs9n4jrJBLdyomi9Y4dvqY,16006
+ucon/units.py,sha256=vKHGf5UX-g9t8dKy2IXgutHZD7W9frYdXSef_aPgZgo,17329
 ucon/mcp/__init__.py,sha256=WoFOQ7JeDIzbjjkFIJ0Uv53VVLu-4lrjzG5vpVGGfT4,123
 ucon/mcp/server.py,sha256=uUrdevEaR65Qjh9xn8Q-_IusNjPGxdkLF9iQmiSTs0g,7016
-ucon-0.6.1.dist-info/licenses/LICENSE,sha256=LtimSYBSw1L_X6n1-VEdZRdwuROzPumrMUNX21asFuI,11356
-ucon-0.6.1.dist-info/licenses/NOTICE,sha256=bh4fBOItio3kM4hSNYhqfFpcaAvOoixjD7Du8im-sYA,1079
-ucon-0.6.1.dist-info/METADATA,sha256=IxzC5b5a8THVSZFfx9nr-vtU534Atj5vVT5lruQKdgQ,17397
-ucon-0.6.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ucon-0.6.1.dist-info/entry_points.txt,sha256=jbfLf0FbOulgGa0nM_sRiTNfiCAkJcHnSSK_oj3g0cQ,50
-ucon-0.6.1.dist-info/top_level.txt,sha256=Vv3KDuZ86fmH5yOYLbYap9DbBblK1YUkmlThffF71jA,5
-ucon-0.6.1.dist-info/RECORD,,
+ucon-0.6.3.dist-info/licenses/LICENSE,sha256=LtimSYBSw1L_X6n1-VEdZRdwuROzPumrMUNX21asFuI,11356
+ucon-0.6.3.dist-info/licenses/NOTICE,sha256=bh4fBOItio3kM4hSNYhqfFpcaAvOoixjD7Du8im-sYA,1079
+ucon-0.6.3.dist-info/METADATA,sha256=8GNTOLltkPWCt68V7-dauFzK_e-XngBhCNlVXpBz_rw,17397
+ucon-0.6.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ucon-0.6.3.dist-info/entry_points.txt,sha256=jbfLf0FbOulgGa0nM_sRiTNfiCAkJcHnSSK_oj3g0cQ,50
+ucon-0.6.3.dist-info/top_level.txt,sha256=Vv3KDuZ86fmH5yOYLbYap9DbBblK1YUkmlThffF71jA,5
+ucon-0.6.3.dist-info/RECORD,,