xloft 0.4.5__py3-none-any.whl → 0.4.7__py3-none-any.whl

xloft/human.py

@@ -7,10 +7,32 @@ The module contains the following functions:
 
 from __future__ import annotations
 
+__all__ = (
+    "to_human_size",
+    "get_cache_human_size",
+)
+
 import math
 
+# To caching the results from to_human_size method.
+_cache_human_size: dict[int, str] = {}
+
+
+def get_cache_human_size() -> dict[int, str]:
+    """Get a copy of variable _cach_human_size.
+
+    Hint: To tests.
+    """
+    return _cache_human_size.copy()
+
+
+def clean_cache_human_size() -> None:
+    """Reset of variable _cach_human_size."""
+    global _cache_human_size  # noqa: PLW0603
+    _cache_human_size = {}
+
 
-def to_human_size(size: int) -> str:
+def to_human_size(n_bytes: int) -> str:
     """Convert number of bytes to readable format.
 
     Examples:
@@ -23,15 +45,20 @@ def to_human_size(size: int) -> str:
         1023.999 KB
 
     Args:
-        size: The number of bytes.
+        n_bytes: The number of bytes.
 
     Returns:
         Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
     """
-    idx: int = math.floor(math.log(size) / math.log(1024))
+    result: str | None = _cache_human_size.get(n_bytes)
+    if result is not None:
+        return result
+    idx: int = math.floor(math.log(n_bytes) / math.log(1024))
     ndigits: int = [0, 3, 6, 9, 12][idx]
-    human_size: int | float = size if size < 1024 else abs(round(size / pow(1024, idx), ndigits))
+    human_size: int | float = n_bytes if n_bytes < 1024 else abs(round(n_bytes / pow(1024, idx), ndigits))
     order = ["bytes", "KB", "MB", "GB", "TB"][idx]
     if math.modf(human_size)[0] == 0.0:
         human_size = int(human_size)
-    return f"{human_size} {order}"
+    result = f"{human_size} {order}"
+    _cache_human_size[n_bytes] = result
+    return result

{xloft-0.4.5.dist-info → xloft-0.4.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xloft
-Version: 0.4.5
+Version: 0.4.7
 Summary: (XLOFT) X-Library of tools
 Project-URL: Homepage, https://github.com/kebasyaty/xloft
 Project-URL: Repository, https://github.com/kebasyaty/xloft

{xloft-0.4.5.dist-info → xloft-0.4.7.dist-info}/RECORD

@@ -1,10 +1,10 @@
 xloft/__init__.py,sha256=UL4IR8EcFjgWoQFayl6FrK2u8QmZytGCwa_E1jDiCmE,475
 xloft/errors.py,sha256=hZcmF0QVVdvE5oM1jsXymRk_pPGgDSnUDM9wx9zJAYQ,895
-xloft/human.py,sha256=odRbUF_58YuFWC_VQeRDZ-6ifHDiiAH2HNb5G5K6JIM,1106
+xloft/human.py,sha256=WQbVOKpOvzGot-c7f3xitbS05JUIQmj3dreGtRV6GA0,1792
 xloft/namedtuple.py,sha256=a_l3bZF-L2I7MGxuF2CXzAHgNai-Vyj6SY1ODwxs7TU,6856
 xloft/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xloft/quantum.py,sha256=ZkFqqFROC9j5JbwJmej3yL9VJcqElPrrimFTz0Pe3Mk,4679
-xloft-0.4.5.dist-info/METADATA,sha256=0cAqqMXQdh5I_DMw9Rm5UU6agFU13OlYlyOpNpYZIgc,7241
-xloft-0.4.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-xloft-0.4.5.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
-xloft-0.4.5.dist-info/RECORD,,
+xloft-0.4.7.dist-info/METADATA,sha256=n2eO_R6lJ7VedihIUh4TiLYdDS9CaJR36hQxZyxpYw4,7241
+xloft-0.4.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+xloft-0.4.7.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
+xloft-0.4.7.dist-info/RECORD,,