Create helpers.py

utils/helpers.py

@@ -0,0 +1,34 @@
+# filename: utils/helpers.py
+
+import math
+
+def format_bytes(size_bytes: int) -> str:
+    """Converts a size in bytes to a human-readable string."""
+    if not isinstance(size_bytes, int) or size_bytes <= 0:
+        return "0 B"
+    size_name = ("B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB")
+    i = min(int(math.log(size_bytes, 1024)), len(size_name) - 1)
+    p = math.pow(1024, i)
+    s = round(size_bytes / p, 2)
+    return f"{s} {size_name[i]}"
+
+def create_progress_bar(progress: float) -> str:
+    """Creates a text-based progress bar string.
+    
+    Args:
+        progress: A float between 0.0 and 1.0.
+    
+    Returns:
+        A string representing the progress bar e.g., '[█████░░░░░] 50%'
+    """
+    if not (0.0 <= progress <= 1.0):
+        progress = 0.0
+        
+    bar_length = 10
+    filled_length = int(bar_length * progress)
+    
+    bar = '█' * filled_length + '░' * (bar_length - filled_length)
+    percentage = f"{progress:.0%}"
+    
+    return f"[{bar}] {percentage}"
+