Feature : ajoute un utilitaire générique pour télécharger un fichier distant (pur standard lib)

gpf_entrepot_toolbelt/utils/get_file_informations.py

@@ -14,6 +14,8 @@
 # Standard library
 import hashlib
 import logging
+from math import floor
+from math import log as math_log
 from pathlib import Path
 from typing import Any
 
@@ -32,6 +34,37 @@ logger = logging.getLogger(__name__)
 # ##################################
 
 
+def convert_octets(octets: int) -> str:
+    """Convert a mount of octets in readable size.
+
+    Args:
+        octets: mount of octets to convert
+
+    Returns:
+        size in a human readable format: ko, Mo, etc.
+
+    Example:
+
+    .. code-block:: python
+
+        >>> convert_octets(1024)
+        1 ko
+        >>> from pathlib import Path
+        >>> convert_octets(Path(my_file.txt).stat().st_size)
+    """
+    # check zero
+    if octets == 0:
+        return "0 octet"
+
+    # conversion
+    size_name = ("octets", "Ko", "Mo", "Go", "To", "Po")
+    i = int(floor(math_log(octets, 1024)))
+    p = pow(1024, i)
+    s = round(octets / p, 2)
+
+    return f"{s} {size_name[i]}"
+
+
 def md5_update_from_file(filename: str | Path, hash_, chunksize: int = 8192) -> Any:
     """Update hash with file content.