libdev 0.92__tar.gz → 0.93__tar.gz

{libdev-0.92 → libdev-0.93}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libdev
-Version: 0.92
+Version: 0.93
 Summary: Set of standard functions for development
 Home-page: https://github.com/chilleco/lib
 Author: Alex Poloz

{libdev-0.92 → libdev-0.93}/libdev/__init__.py

@@ -2,6 +2,6 @@
 Initializing the Python package
 """
 
-__version__ = "0.92"
+__version__ = "0.93"
 
 __all__ = ("__version__",)

{libdev-0.92 → libdev-0.93}/libdev/num.py

@@ -4,7 +4,21 @@ Numbers functionality
 
 import re
 import math
-from decimal import Decimal
+from decimal import Decimal, ROUND_HALF_UP
+
+
+_SUBSCRIPTS = {
+    "0": "₀",
+    "1": "₁",
+    "2": "₂",
+    "3": "₃",
+    "4": "₄",
+    "5": "₅",
+    "6": "₆",
+    "7": "₇",
+    "8": "₈",
+    "9": "₉",
+}
 
 
 def is_float(value: str) -> bool:
@@ -242,3 +256,75 @@ def to_step(value, step=1, side=False):
         value = int(value)
 
     return value
+
+
+def _to_subscript(n: int) -> str:
+    """Convert an integer n to a string of subscript digits."""
+    return "".join(_SUBSCRIPTS[d] for d in str(n))
+
+
+def compress_zeros(x: int | float, round: int | None = None) -> str | None:
+    """
+    Given a float or decimal‐string x, return a string where
+    runs of leading zeros in the fraction are shown as:
+      one '0' plus a subscript count of the zeros.
+    If `round` is provided, the remaining digits after the zeros
+    are rounded to that many places.
+
+    Examples:
+      compress_zeros(0.00012)           -> '0.0₃12'
+      compress_zeros(0.00012, round=2)  -> '0.0₃12'
+      compress_zeros(0.0123)            -> '0.0123'  (only one leading zero, so unchanged)
+      compress_zeros(0.0123456, round=3)-> '0.0123'
+      compress_zeros(1.000045)          -> '1.0₄45'
+      compress_zeros(-0.0010959999999999997522, round=3)
+                                        -> '-0.0₂11'
+    """
+
+    if x is None:
+        return None
+
+    dec_x = Decimal(str(x))
+    s = format(dec_x, "f")
+
+    # no fractional part
+    if "." not in s:
+        return s
+
+    int_part, frac = s.split(".", 1)
+
+    # count leading zeros in the fractional part
+    zero_run = len(frac) - len(frac.lstrip("0"))
+
+    # If rounding is requested, do it first
+    if round is not None:
+        # ensure at least one zero is counted for quantization
+        places = max(zero_run, 1) + round
+        quant = Decimal(f"1e-{places}")
+        dec_q = dec_x.quantize(quant, rounding=ROUND_HALF_UP)
+        s_q = format(dec_q, "f")
+
+        # if rounding eliminated fractional part
+        if "." not in s_q:
+            return s_q
+
+        int_part_q, frac_q = s_q.split(".", 1)
+        # for zero_run == 0 or 1, we just return the rounded string
+        if zero_run <= 1:
+            return s_q
+
+        # strip any trailing zeros, then compress
+        frac_q = frac_q.rstrip("0")
+        if not frac_q:
+            return int_part_q
+        tail = frac_q[zero_run:]
+        return f"{int_part_q}.0{_to_subscript(zero_run)}{tail}"
+
+    # No rounding: only compress if more than one leading zero
+    if zero_run <= 1:
+        return s
+
+    tail = frac[zero_run:]
+
+    # build compressed form
+    return f"{int_part}.0{_to_subscript(zero_run)}{tail}"

{libdev-0.92 → libdev-0.93}/libdev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libdev
-Version: 0.92
+Version: 0.93
 Summary: Set of standard functions for development
 Home-page: https://github.com/chilleco/lib
 Author: Alex Poloz

{libdev-0.92 → libdev-0.93}/tests/test_num.py

@@ -11,6 +11,7 @@ from libdev.num import (
     to_step,
     add,
     pretty,
+    compress_zeros,
 )
 
 
@@ -155,3 +156,18 @@ def test_pretty():
     assert pretty(123.456, 1) == "123"
     assert pretty(123.456, 1, True) == "+123"
     assert pretty(12345.6, 3, True) == "+12’346"
+
+
+def test_compress_zeros():
+    assert compress_zeros(None) == None
+    assert compress_zeros(0) == "0"
+    assert compress_zeros(0.0) == "0.0"
+    assert compress_zeros(1) == "1"
+    assert compress_zeros(1.0) == "1.0"
+    assert compress_zeros(1.0, round=0) == "1.0"
+    assert compress_zeros(0.00012) == "0.0₃12"
+    assert compress_zeros(0.00012, round=2) == "0.0₃12"
+    assert compress_zeros(0.0123) == "0.0123"
+    assert compress_zeros(0.0123456, round=3) == "0.0123"
+    assert compress_zeros(1.000045) == "1.0₄45"
+    assert compress_zeros(-0.0010959999999999997522, round=3) == "-0.0₂11"