quantiphy 2.21__tar.gz → 2.22__tar.gz

{quantiphy-2.21 → quantiphy-2.22}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2016-2025 Kenneth S. Kundert
+Copyright (c) 2016-2026 Kenneth S. Kundert
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{quantiphy-2.21 → quantiphy-2.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantiphy
-Version: 2.21
+Version: 2.22
 Summary: physical quantities (numbers with units)
 Keywords: quantities,physical quantity,units,SI scale factors,engineering notation,mks,cgs
 Author: Ken Kundert
@@ -28,8 +28,8 @@ QuantiPhy — Physical Quantities
 |downloads| |build status| |coverage| |rtd status| |pypi version| |anaconda version| |python version|
 
 | Author: Ken Kundert
-| Version: 2.21
-| Released: 2025-12-25
+| Version: 2.22
+| Released: 2026-06-27
 |
 
 

{quantiphy-2.21 → quantiphy-2.22}/README.rst

@@ -4,8 +4,8 @@ QuantiPhy — Physical Quantities
 |downloads| |build status| |coverage| |rtd status| |pypi version| |anaconda version| |python version|
 
 | Author: Ken Kundert
-| Version: 2.21
-| Released: 2025-12-25
+| Version: 2.22
+| Released: 2026-06-27
 |
 
 

{quantiphy-2.21 → quantiphy-2.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quantiphy"
-version = "2.21"
+version = "2.22"
 description = "physical quantities (numbers with units)"
 readme = "README.rst"
 keywords = [

{quantiphy-2.21 → quantiphy-2.22}/quantiphy/quantiphy.py

@@ -22,7 +22,7 @@ Documentation can be found at https://quantiphy.readthedocs.io.
 """
 
 # MIT License {{{1
-# Copyright (C) 2016-2025 Kenneth S. Kundert
+# Copyright (C) 2016-2026 Kenneth S. Kundert
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -375,8 +375,8 @@ def add_constant(value, alias=None, unit_systems=None):
 
 
 # Globals {{{1
-__version__ = '2.21'
-__released__ = '2025-12-25'
+__version__ = '2.22'
+__released__ = '2026-06-27'
 
 # These mappings are only used when reading numbers
 # The key for these mappings must be a single character
@@ -499,6 +499,8 @@ DEFAULTS = dict(
     output_sf = 'TGMkmunpfa',
     plus = '+',
     prec = 4,
+    preferred_quantities = {},
+    _preferred_quantities = {},  # transposed version of preferred_quantities
     preferred_units = {},
     _preferred_units = {},  # transposed version of preferred_units
     radix = '.',
@@ -967,6 +969,14 @@ class Quantity(float):
             full precision is not required. Default is 4.
         :type prec: int or str
 
+        :arg dict preferred_quantities:
+            A dictionary that is used when looking up the preferred quantity when
+            instantiating.  For example, if *preferred_quantities* contains the entry:
+            {Decibels: “dB dBV dBA dBm dBc”} where *Decibels* is a subclass of
+            *Quantity*, then when instantiating a quantity with units “dB”, “dBV”,
+            “dBA”, “dBm”, or “dBc”, the quantity returned would have *Decibels*
+            as its class.
+
         :arg dict preferred_units:
             A dictionary that is used when looking up the preferred units when
             rendering.  For example, if *preferred_units* contains the entry:
@@ -1092,13 +1102,21 @@ class Quantity(float):
         if isinstance(kwargs.get('known_units'), str):
             kwargs['known_units'] = kwargs['known_units'].split()
 
+        # split preferred_quantities
+        if 'preferred_quantities' in kwargs:
+            kwargs['_preferred_quantities'] = {
+                unit : quantity
+                for quantity, units in kwargs['preferred_quantities'].items()
+                for unit in units.split()
+            }
+
         # split preferred_units
         if 'preferred_units' in kwargs:
-            _preferred_units = {}
-            for preferred_unit, undesired in kwargs['preferred_units'].items():
-                for each in undesired.split():
-                    _preferred_units[each] = preferred_unit
-            kwargs['_preferred_units'] = _preferred_units
+            kwargs['_preferred_units'] = {
+                unit : preferred
+                for preferred, units in kwargs['preferred_units'].items()
+                for unit in units.split()
+            }
 
         # check for unknown output scale factors
         if kwargs.get('output_sf'):
@@ -1715,7 +1733,13 @@ class Quantity(float):
 
         # create the underlying data structure and add attributes {{{3
         try:
-            self = float.__new__(cls, number)
+            preferred_quantities = cls._preferences["_preferred_quantities"]
+            preferred_quantity = preferred_quantities[units]
+            assert issubclass(preferred_quantity, cls)
+        except (AttributeError, KeyError):
+            preferred_quantity = cls
+        try:
+            self = float.__new__(preferred_quantity, number)
         except TypeError:
             raise InvalidNumber(number)
         if units:
@@ -2971,7 +2995,8 @@ class Quantity(float):
             end = match.start(0)
             number = match.group(0)
             try:
-                number = Quantity(number).render(**kwargs)
+                q = cls.__new__(cls, number)
+                number = q.render(**kwargs)
             except ValueError:  # pragma: no cover
                 # something unexpected happened
                 # but this is not essential, so ignore it
@@ -3020,7 +3045,8 @@ class Quantity(float):
             end = match.start(0)
             number = match.group(0)
             try:
-                number = Quantity(number).render(**kwargs)
+                q = cls.__new__(cls, number)
+                number = q.render(**kwargs)
             except ValueError:  # pragma: no cover
                 # something unexpected happened
                 # but this is not essential, so ignore it
@@ -3864,3 +3890,5 @@ def binary(value, units, params=None, *args, **kwargs):
 
     """
     return Quantity(value, units=units, params=params).binary(*args, **kwargs)
+
+# vim: set sw=4 sts=4 tw=80 fo=ntcqwa12 et spell:

{quantiphy-2.21 → quantiphy-2.22}/quantiphy/quantiphy.pyi

@@ -119,6 +119,7 @@ class Quantity(float):
         show_label: bool | str = ...,
         strip_zeros: bool = ...,
         strip_radix: bool = ...,
+        spacer: str | bool = ...,
         scale: str | float | tuple[float | Quantity, str] | Callable = ...,
         negligible: float = ...,
     ) -> str: ...