2008-04-27 16:54:37 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
2008-06-19 09:21:21 +00:00
|
|
|
# vi:si:et:sw=4:sts=4:ts=4
|
2008-04-28 07:48:13 +00:00
|
|
|
import math
|
2008-04-27 16:54:37 +00:00
|
|
|
import re
|
|
|
|
|
|
|
|
def to36(q):
|
2008-06-19 09:21:21 +00:00
|
|
|
"""
|
2008-07-05 14:37:59 +00:00
|
|
|
Converts an integer to base 36 (a useful scheme for human-sayable IDs
|
|
|
|
like 'fuck' (739172), 'shit' (1329077) or 'hitler' (1059538851)).
|
2008-06-19 09:21:21 +00:00
|
|
|
|
|
|
|
>>> to36(35)
|
|
|
|
'z'
|
|
|
|
>>> to36(119292)
|
|
|
|
'2k1o'
|
|
|
|
>>> int(to36(939387374), 36)
|
|
|
|
939387374
|
|
|
|
>>> to36(0)
|
|
|
|
'0'
|
|
|
|
>>> to36(-393)
|
|
|
|
Traceback (most recent call last):
|
|
|
|
...
|
|
|
|
ValueError: must supply a positive integer
|
|
|
|
"""
|
|
|
|
if q < 0: raise ValueError, "must supply a positive integer"
|
|
|
|
letters = "0123456789abcdefghijklmnopqrstuvwxyz"
|
|
|
|
converted = []
|
|
|
|
while q != 0:
|
|
|
|
q, r = divmod(q, 36)
|
|
|
|
converted.insert(0, letters[r])
|
|
|
|
return "".join(converted) or '0'
|
2008-04-27 16:54:37 +00:00
|
|
|
|
|
|
|
def from36(q):
|
2008-06-19 09:21:21 +00:00
|
|
|
return int(q, 36)
|
2008-04-27 16:54:37 +00:00
|
|
|
|
2008-07-06 09:42:41 +00:00
|
|
|
def intValue(strValue, default=u''):
|
|
|
|
"""
|
|
|
|
>>> intValue('abc23')
|
|
|
|
u'23'
|
|
|
|
|
|
|
|
>>> intValue(' abc23')
|
|
|
|
u'23'
|
|
|
|
|
|
|
|
>>> intValue('ab')
|
|
|
|
u''
|
|
|
|
"""
|
2008-06-19 09:21:21 +00:00
|
|
|
try:
|
|
|
|
val = re.compile('(\d+)').findall(unicode(strValue).strip())[0]
|
|
|
|
except:
|
|
|
|
val = default
|
|
|
|
return val
|
2008-04-27 16:54:37 +00:00
|
|
|
|
2008-07-06 09:42:41 +00:00
|
|
|
def floatValue(strValue, default=u''):
|
|
|
|
"""
|
|
|
|
>>> floatValue('abc23.4')
|
|
|
|
u'23.4'
|
|
|
|
|
|
|
|
>>> floatValue(' abc23.4')
|
|
|
|
u'23.4'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-07-06 09:42:41 +00:00
|
|
|
>>> floatValue('ab')
|
|
|
|
u''
|
|
|
|
"""
|
2008-06-19 09:21:21 +00:00
|
|
|
try:
|
|
|
|
val = re.compile('([\d.]+)').findall(unicode(strValue).strip())[0]
|
|
|
|
except:
|
|
|
|
val = default
|
|
|
|
return val
|
2008-04-27 16:54:37 +00:00
|
|
|
|
2008-04-28 07:48:13 +00:00
|
|
|
def formatNumber(number, longName, shortName):
|
2008-06-19 09:21:21 +00:00
|
|
|
"""
|
|
|
|
Return the number in a human-readable format (23 KB, 23.4 MB, 23.42 GB)
|
|
|
|
|
|
|
|
>>> formatNumber(123, 'Byte', 'B')
|
|
|
|
'123 Bytes'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-06-19 09:21:21 +00:00
|
|
|
>>> formatNumber(1234, 'Byte', 'B')
|
|
|
|
'1 KB'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-06-19 09:21:21 +00:00
|
|
|
>>> formatNumber(1234567, 'Byte', 'B')
|
|
|
|
'1.2 MB'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-06-19 09:21:21 +00:00
|
|
|
>>> formatNumber(1234567890, 'Byte', 'B')
|
|
|
|
'1.15 GB'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-06-19 09:21:21 +00:00
|
|
|
>>> formatNumber(1234567890123456789, 'Byte', 'B')
|
|
|
|
'1,096.5166 PB'
|
2008-05-05 18:12:27 +00:00
|
|
|
|
2008-06-19 09:21:21 +00:00
|
|
|
"""
|
|
|
|
if number < 1024:
|
|
|
|
return '%s %s%s' % (formatThousands(number), longName, number != 1 and 's' or '')
|
|
|
|
prefix = ['K', 'M', 'G', 'T', 'P']
|
|
|
|
for i in range(5):
|
|
|
|
if number < math.pow(1024, i + 2) or i == 4:
|
|
|
|
n = number / math.pow(1024, i + 1)
|
|
|
|
return '%s %s%s' % (formatThousands('%.*f' % (i, n)), prefix[i], shortName)
|
2008-04-28 09:25:52 +00:00
|
|
|
|
|
|
|
def formatThousands(number, separator = ','):
|
2008-06-19 09:21:21 +00:00
|
|
|
"""
|
|
|
|
Return the number with separators (1,000,000)
|
|
|
|
|
|
|
|
>>> formatThousands(1)
|
|
|
|
'1'
|
|
|
|
>>> formatThousands(1000)
|
|
|
|
'1,000'
|
|
|
|
>>> formatThousands(1000000)
|
|
|
|
'1,000,000'
|
|
|
|
"""
|
|
|
|
string = str(number).split('.')
|
|
|
|
l = []
|
|
|
|
for i, character in enumerate(reversed(string[0])):
|
|
|
|
if i and (not (i % 3)):
|
|
|
|
l.insert(0, separator)
|
|
|
|
l.insert(0, character)
|
|
|
|
string[0] = ''.join(l)
|
|
|
|
return '.'.join(string)
|
2008-04-28 07:48:13 +00:00
|
|
|
|
|
|
|
def formatBits(number):
|
2008-06-19 09:21:21 +00:00
|
|
|
return formatNumber(number, 'bit', 'b')
|
2008-04-27 16:54:37 +00:00
|
|
|
|
|
|
|
def formatBytes(number):
|
2008-06-19 09:21:21 +00:00
|
|
|
return formatNumber(number, 'byte', 'B')
|
2008-04-27 16:54:37 +00:00
|
|
|
|
2008-04-28 07:48:13 +00:00
|
|
|
def formatPixels(number):
|
2008-06-19 09:21:21 +00:00
|
|
|
return formatNumber(number, 'pixel', 'px')
|
2008-04-28 07:48:13 +00:00
|
|
|
|
2008-06-19 14:23:08 +00:00
|
|
|
def formatCurrency(amount, currency="$"):
|
|
|
|
if amount:
|
|
|
|
temp = "%.2f" % amount
|
|
|
|
profile=re.compile(r"(\d)(\d\d\d[.,])")
|
|
|
|
while 1:
|
|
|
|
temp, count = re.subn(profile,r"\1,\2",temp)
|
|
|
|
if not count:
|
|
|
|
break
|
|
|
|
if temp.startswith('-'):
|
|
|
|
return "-"+ currency + temp[1:-3]
|
|
|
|
return currency + temp[:-3]
|
|
|
|
else:
|
|
|
|
return ""
|
|
|
|
|
2008-04-27 16:54:37 +00:00
|
|
|
def plural(amount, unit, plural='s'):
|
2008-06-19 09:21:21 +00:00
|
|
|
'''
|
|
|
|
>>> plural(1, 'unit')
|
|
|
|
'1 unit'
|
|
|
|
>>> plural(2, 'unit')
|
|
|
|
'2 units'
|
|
|
|
'''
|
|
|
|
if abs(amount) != 1:
|
|
|
|
if plural == 's':
|
|
|
|
unit = unit + plural
|
|
|
|
else: unit = plural
|
|
|
|
return "%s %s" % (formatThousands(amount), unit)
|
2008-04-27 16:54:37 +00:00
|
|
|
|
2008-07-02 14:32:30 +00:00
|
|
|
def formatDuration(ms, verbosity=0, years=True, hours=True, milliseconds=True):
|
2008-07-02 14:16:44 +00:00
|
|
|
'''
|
2008-07-02 15:07:49 +00:00
|
|
|
verbosity
|
|
|
|
0: D:HH:MM:SS
|
|
|
|
1: Dd Hh Mm Ss
|
|
|
|
2: D days H hours M minutes S seconds
|
|
|
|
years
|
|
|
|
True: 366 days are 1 year 1 day
|
|
|
|
False: 366 days are 366 days
|
|
|
|
hours
|
|
|
|
True: 30 seconds are 00:00:30
|
|
|
|
False: 30 seconds are 00:30
|
|
|
|
milliseconds
|
|
|
|
True: always display milliseconds
|
|
|
|
False: never display milliseconds
|
|
|
|
>>> formatDuration(1000 * 60 * 60 * 24 * 366)
|
|
|
|
'1:001:00:00:00.000'
|
2008-07-02 15:10:45 +00:00
|
|
|
>>> formatDuration(1000 * 60 * 60 * 24 * 366, years=False)
|
2008-07-02 15:07:49 +00:00
|
|
|
'366:00:00:00.000'
|
|
|
|
>>> formatDuration(1000 * 60 * 60 * 24 * 365 + 2003, verbosity=2)
|
|
|
|
'1 year 2 seconds 3 milliseconds'
|
|
|
|
>>> formatDuration(1000 * 30, hours=False, milliseconds=False)
|
|
|
|
'00:30'
|
2008-07-02 14:16:44 +00:00
|
|
|
'''
|
|
|
|
if years:
|
|
|
|
y = int(ms / 31536000000)
|
|
|
|
d = int(ms % 31536000000 / 86400000)
|
|
|
|
else:
|
|
|
|
d = int(ms / 86400000)
|
|
|
|
h = int(ms % 86400000 / 3600000)
|
|
|
|
m = int(ms % 3600000 / 60000)
|
|
|
|
s = int(ms % 60000 / 1000)
|
|
|
|
ms = ms % 1000
|
|
|
|
if verbosity == 0:
|
|
|
|
if years and y:
|
|
|
|
duration = "%d:%03d:%02d:%02d:%02d" % (y, d, h, m, s)
|
|
|
|
elif d:
|
|
|
|
duration = "%d:%02d:%02d:%02d" % (d, h, m, s)
|
|
|
|
elif hours or h:
|
|
|
|
duration = "%02d:%02d:%02d" % (h, m, s)
|
|
|
|
else:
|
|
|
|
duration = "%02d:%02d" % (m, s)
|
|
|
|
if milliseconds:
|
|
|
|
duration += ".%03d" % ms
|
|
|
|
else:
|
|
|
|
if verbosity == 1:
|
2008-07-02 14:26:20 +00:00
|
|
|
durations = ["%sd" % d, "%sh" % h, "%sm" % m, "%ss" % s]
|
|
|
|
if years:
|
|
|
|
durations.insert(0, "%sy" % y)
|
2008-07-02 14:16:44 +00:00
|
|
|
if milliseconds:
|
2008-07-02 14:26:20 +00:00
|
|
|
durations.append("%sms" % ms)
|
2008-07-02 14:16:44 +00:00
|
|
|
else:
|
2008-07-02 14:26:20 +00:00
|
|
|
durations = [plural(d, 'day'), plural(h,'hour'),
|
2008-07-02 14:16:44 +00:00
|
|
|
plural(m, 'minute'), plural(s, 'second')]
|
2008-07-02 14:26:20 +00:00
|
|
|
if years:
|
|
|
|
durations.insert(0, plural(y, 'year'))
|
2008-07-02 14:16:44 +00:00
|
|
|
if milliseconds:
|
2008-07-02 14:26:20 +00:00
|
|
|
durations.append(plural(ms, 'millisecond'))
|
2008-07-02 14:16:44 +00:00
|
|
|
durations = filter(lambda x: not x.startswith('0'), durations)
|
|
|
|
duration = ' '.join(durations)
|
|
|
|
return duration
|
|
|
|
|
2008-06-19 14:41:53 +00:00
|
|
|
def ms2runtime(ms, shortenLong=False):
|
2008-07-02 14:16:44 +00:00
|
|
|
# deprecated - use formatDuration
|
2008-06-19 09:21:21 +00:00
|
|
|
'''
|
|
|
|
>>> ms2runtime(5000)
|
|
|
|
'5 seconds'
|
|
|
|
>>> ms2runtime(500000)
|
|
|
|
'8 minutes 20 seconds'
|
|
|
|
>>> ms2runtime(50000000)
|
|
|
|
'13 hours 53 minutes 20 seconds'
|
|
|
|
>>> ms2runtime(50000000-20000)
|
|
|
|
'13 hours 53 minutes'
|
|
|
|
'''
|
2008-07-06 10:10:19 +00:00
|
|
|
if shortenLong and ms > 1000 * 60 * 60 * 24 * 464:
|
|
|
|
return formatDuration(ms, verbosity=1, milliseconds=False)
|
|
|
|
return formatDuration(ms, verbosity=2, milliseconds=False)
|
2008-04-27 17:17:29 +00:00
|
|
|
|
2008-06-20 13:46:13 +00:00
|
|
|
def ms2playtime(ms, hours=False):
|
2008-07-02 14:16:44 +00:00
|
|
|
# deprecated - use formatDuration
|
2008-06-19 09:21:21 +00:00
|
|
|
'''
|
|
|
|
>>> ms2playtime(5000)
|
|
|
|
'00:05'
|
|
|
|
>>> ms2playtime(500000)
|
|
|
|
'08:20'
|
|
|
|
>>> ms2playtime(50000000)
|
|
|
|
'13:53:20'
|
|
|
|
'''
|
2008-07-06 10:10:19 +00:00
|
|
|
return formatDuration(ms, hours=False, years=False, milliseconds=False)
|
2008-04-27 17:17:29 +00:00
|
|
|
|
|
|
|
def ms2time(ms):
|
2008-07-02 14:16:44 +00:00
|
|
|
# deprecated - use formatDuration
|
2008-06-19 09:21:21 +00:00
|
|
|
'''
|
|
|
|
>>> ms2time(44592123)
|
|
|
|
'12:23:12.123'
|
|
|
|
'''
|
2008-07-06 10:10:19 +00:00
|
|
|
return formatDuration(ms, years=False)
|
2008-04-27 17:17:29 +00:00
|
|
|
|
|
|
|
def time2ms(timeString):
|
2008-06-19 09:21:21 +00:00
|
|
|
'''
|
|
|
|
>>> time2ms('12:23:12.123')
|
|
|
|
44592123
|
|
|
|
'''
|
|
|
|
ms = 0.0
|
|
|
|
p = timeString.split(':')
|
|
|
|
for i in range(len(p)):
|
|
|
|
ms = ms * 60 + float(p[i])
|
|
|
|
return int(ms * 1000)
|
2008-04-27 17:17:29 +00:00
|
|
|
|
|
|
|
def shiftTime(offset, timeString):
|
2008-06-19 09:21:21 +00:00
|
|
|
newTime = time2ms(timeString) + offset
|
|
|
|
return ms2time(newTime)
|
2008-04-27 17:17:29 +00:00
|
|
|
|