New tool to convert some content to human readable strings

tools/human.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+
+# Nemubot is a modulable IRC bot, built around XML configuration files.
+# Copyright (C) 2012  Mercier Pierre-Olivier
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+import math
+
+def size(size, unit=True):
+    """Convert a given byte size to an more human readable way
+
+    Argument:
+    size -- the size to convert
+    unit -- append the unit at the end of the string
+    """
+
+    if size <= 0:
+        return "0 B" if unit else "0"
+
+    units = ['B','KiB','MiB','GiB','TiB','PiB','EiB','ZiB','YiB']
+    p = math.floor(math.log(size, 2) / 10)
+
+    if unit:
+        return "%.3f %s" % (size / math.pow(1024,p), units[int(p)])
+    else:
+        return "%.3f" % (size / math.pow(1024,p))