# HG changeset patch
# User Pascal Volk <neverseen@users.sourceforge.net>
# Date 1297390275 0
# Node ID fb2ba1456bc5a88fa81cdeff2c01ba410309e56f
# Parent  ffce67e3c6eb8f6d39f15d973f62f81807d302ce
VMM/common: Added function human_size().

diff -r ffce67e3c6eb -r fb2ba1456bc5 VirtualMailManager/common.py
--- a/VirtualMailManager/common.py	Thu Feb 10 23:36:31 2011 +0000
+++ b/VirtualMailManager/common.py	Fri Feb 11 02:11:15 2011 +0000
@@ -67,6 +67,20 @@
     return binary
 
 
+def human_size(size):
+    """Converts the `size` in bytes in human readable format."""
+    if not isinstance(size, (long, int)) or size < 1:
+        raise TypeError("'size' must be a long or int and greater than 0.")
+    unit_limit = (('T', 1 << 40), ('G', 1 << 30), ('M', 1 << 20),
+                  ('k', 1 << 10), ('b', 1))
+    for unit, limit in unit_limit:
+        if size >= limit:
+            if unit != 'b':
+                return '%.2f%s' % (size / float(limit), unit)
+            else:
+                return '%u%s' % (size / limit, unit)
+
+
 def size_in_bytes(size):
     """Converts the string `size` to a long (size in bytes).