#
#
-# Copyright (C) 2010 Google Inc.
+# Copyright (C) 2010, 2011 Google Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
"""
import itertools
+import operator
try:
+ # pylint: disable=F0401
import functools
except ImportError:
functools = None
+try:
+ # pylint: disable=F0401
+ import roman
+except ImportError:
+ roman = None
+
-def all(seq, pred=bool): # pylint: disable-msg=W0622
- """Returns True if pred(x) is True for every element in the iterable.
+# compat.md5_hash and compat.sha1_hash can be called to generate and md5 and a
+# sha1 hashing modules, under python 2.4, 2.5 and 2.6, even though some changes
+# went on. compat.sha1 is python-version specific and is used for python
+# modules (hmac, for example) which have changed their behavior as well from
+# one version to the other.
+try:
+ # Yes, these don't always exist, that's why we're testing
+ # Yes, we're not using the imports in this module.
+ from hashlib import md5 as md5_hash # pylint: disable=W0611,E0611,F0401
+ from hashlib import sha1 as sha1_hash # pylint: disable=W0611,E0611,F0401
+ # this additional version is needed for compatibility with the hmac module
+ sha1 = sha1_hash
+except ImportError:
+ from md5 import new as md5_hash
+ import sha
+ sha1 = sha
+ sha1_hash = sha.new
- Please note that this function provides a C{pred} parameter which isn't
- available in the version included in Python 2.5 and above.
+
+def _all(seq):
+ """Returns True if all elements in the iterable are True.
"""
- for _ in itertools.ifilterfalse(pred, seq):
+ for _ in itertools.ifilterfalse(bool, seq):
return False
return True
-def any(seq, pred=bool): # pylint: disable-msg=W0622
- """Returns True if pred(x) is True for at least one element in the iterable.
-
- Please note that this function provides a C{pred} parameter which isn't
- available in the version included in Python 2.5 and above.
+def _any(seq):
+ """Returns True if any element of the iterable are True.
"""
- for _ in itertools.ifilter(pred, seq):
+ for _ in itertools.ifilter(bool, seq):
return True
return False
-def partition(seq, pred=bool): # pylint: disable-msg=W0622
+try:
+ # pylint: disable=E0601
+ # pylint: disable=W0622
+ all = all
+except NameError:
+ all = _all
+
+try:
+ # pylint: disable=E0601
+ # pylint: disable=W0622
+ any = any
+except NameError:
+ any = _any
+
+
+def partition(seq, pred=bool): # pylint: disable=W0622
"""Partition a list in two, based on the given predicate.
"""
# Even though we're using Python's built-in "partial" function if available,
# this one is always defined for testing.
-def _partial(func, *args, **keywords): # pylint: disable-msg=W0622
+def _partial(func, *args, **keywords): # pylint: disable=W0622
"""Decorator with partial application of arguments and keywords.
This function was copied from Python's documentation.
def newfunc(*fargs, **fkeywords):
newkeywords = keywords.copy()
newkeywords.update(fkeywords)
- return func(*(args + fargs), **newkeywords) # pylint: disable-msg=W0142
+ return func(*(args + fargs), **newkeywords) # pylint: disable=W0142
newfunc.func = func
newfunc.args = args
partial = _partial
else:
partial = functools.partial
+
+
+def TryToRoman(val, convert=True):
+ """Try to convert a value to roman numerals
+
+ If the roman module could be loaded convert the given value to a roman
+ numeral. Gracefully fail back to leaving the value untouched.
+
+ @type val: integer
+ @param val: value to convert
+ @type convert: boolean
+ @param convert: if False, don't try conversion at all
+ @rtype: string or typeof(val)
+ @return: roman numeral for val, or val if conversion didn't succeed
+
+ """
+ if roman is not None and convert:
+ try:
+ return roman.toRoman(val)
+ except roman.RomanError:
+ return val
+ else:
+ return val
+
+#: returns the first element of a list-like value
+fst = operator.itemgetter(0)
+
+#: returns the second element of a list-like value
+snd = operator.itemgetter(1)