#
# Kiwi: a Framework and Enhanced Widgets for Python
#
# Copyright (C) 2005,2006 Async Open Source
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library 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
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA
#
# Author(s): Johan Dahlin <jdahlin@async.com.br>
#
"""Generic python addons"""
import sys
import warnings
__all__ = ['ClassInittableMetaType', 'ClassInittableObject']
[docs]class ClassInittableObject(object):
"""
I am an object which will call a classmethod called
__class_init__ when I am created.
Subclasses of me will also have __class_init__ called.
Note that __class_init__ is called when the class is created,
eg when the file is imported at the first time.
It's called after the class is created, but before it is put
in the namespace of the module where it is defined.
"""
__metaclass__ = ClassInittableMetaType
def __class_init__(cls, namespace):
"""
Called when the class is created
:param cls: class
:param namespace: namespace for newly created
:type namespace: dict
"""
__class_init__ = classmethod(__class_init__)
class _ForwardedProperty(object):
def __init__(self, attribute):
self._attribute = attribute
def __get__(self, instance, klass):
if instance is None:
return self
return getattr(instance.target, self._attribute)
def __set__(self, instance, value):
if instance is None:
raise TypeError
setattr(instance.target, self._attribute, value)
class AttributeForwarder(ClassInittableObject):
"""
AttributeForwarder is an object which is used to forward certain
attributes to another object.
:cvar attributes: list of attributes to be forwarded
:ivar target: forwarded object
"""
attributes = None
def __class_init__(cls, ns):
if cls.__bases__ == (ClassInittableObject,):
return
if not 'attributes' in ns:
raise TypeError(
"the class variable attributes needs to be set for %s" % (
cls.__name__))
if "target" in ns['attributes']:
raise TypeError("'target' is a reserved attribute")
for attribute in ns['attributes']:
setattr(cls, attribute, _ForwardedProperty(attribute))
__class_init__ = classmethod(__class_init__)
def __init__(self, target):
"""
Create a new AttributeForwarder object.
:param target: object to forward attributes to
"""
self.target = target
# copied from twisted/python/reflect.py
def namedAny(name):
"""Get a fully named package, module, module-global object, or attribute.
:param name:
:returns: object, module or attribute
"""
names = name.split('.')
topLevelPackage = None
moduleNames = names[:]
while not topLevelPackage:
try:
trialname = '.'.join(moduleNames)
topLevelPackage = __import__(trialname)
except ImportError:
# if the ImportError happened in the module being imported,
# this is a failure that should be handed to our caller.
# count stack frames to tell the difference.
import traceback
exc_info = sys.exc_info()
if len(traceback.extract_tb(exc_info[2])) > 1:
try:
# Clean up garbage left in sys.modules.
del sys.modules[trialname]
except KeyError:
# Python 2.4 has fixed this. Yay!
pass
raise exc_info[0], exc_info[1], exc_info[2]
moduleNames.pop()
obj = topLevelPackage
for n in names[1:]:
obj = getattr(obj, n)
return obj
class Settable:
"""
A mixin class for syntactic sugar. Lets you assign attributes by
calling with keyword arguments; for example, C{x(a=b,c=d,y=z)} is the
same as C{x.a=b;x.c=d;x.y=z}. The most useful place for this is
where you don't want to name a variable, but you do want to set
some attributes; for example, C{X()(y=z,a=b)}.
"""
def __init__(self, **kw):
self._attrs = kw.keys()
self._attrs.sort()
for k, v in kw.iteritems():
setattr(self, k, v)
def getattributes(self):
"""
Fetches the attributes used to create this object
:returns: a dictionary with attributes
"""
return self._attrs
def __repr__(self):
return '<%s %s>' % (self.__class__.__name__,
', '.join(
['%s=%r' % (attr, getattr(self, attr)) for attr in self._attrs]))
def qual(klass):
"""
Convert a class to a string representation, which is the name of the module
plut a dot plus the name of the class.
:returns: fully qualified module and class name
"""
return klass.__module__ + '.' + klass.__name__
def clamp(x, low, high):
"""
Ensures that x is between the limits set by low and high.
For example,
* clamp(5, 10, 15) is 10.
* clamp(15, 5, 10) is 10.
* clamp(20, 15, 25) is 20.
:param x: the value to clamp.
:param low: the minimum value allowed.
:param high: the maximum value allowed.
:returns: the clamped value
"""
return min(max(x, low), high)
def slicerange(slice, limit):
"""Takes a slice object and returns a range iterator
:param slice: slice object
:param limit: maximum value allowed
:returns: iterator
"""
return xrange(*slice.indices(limit))
_no_deprecation = False
def deprecationwarn(msg, stacklevel=2):
"""
Prints a deprecation warning
"""
global _no_deprecation
if _no_deprecation:
return
warnings.warn(msg, DeprecationWarning, stacklevel=stacklevel)
def disabledeprecationcall(func, *args, **kwargs):
"""
Disables all deprecation warnings during the function call to func
"""
global _no_deprecation
old = _no_deprecation
_no_deprecation = True
retval = func(*args, **kwargs)
_no_deprecation = old
return retval
class enum(int):
"""
enum is an enumered type implementation in python.
To use it, define an enum subclass like this:
>>> from kiwi.python import enum
>>>
>>> class Status(enum):
>>> OPEN, CLOSE = range(2)
>>> Status.OPEN
'<Status value OPEN>'
All the integers defined in the class are assumed to be enums and
values cannot be duplicated
"""
__metaclass__ = ClassInittableMetaType
#@classmethod
def __class_init__(cls, ns):
cls.names = {} # name -> enum
cls.values = {} # value -> enum
for key, value in ns.items():
if isinstance(value, int):
cls(value, key)
__class_init__ = classmethod(__class_init__)
#@classmethod
def get(cls, value):
"""
Lookup an enum by value
:param value: the value
"""
if not value in cls.values:
raise ValueError("There is no enum for value %d" % (value,))
return cls.values[value]
get = classmethod(get)
def __new__(cls, value, name):
"""
Create a new Enum.
:param value: value of the enum
:param name: name of the enum
"""
if name in cls.names:
raise ValueError("There is already an enum called %s" % (name,))
if value in cls.values:
raise ValueError(
"Error while creating enum %s of type %s, "
"it has already been created as %s" % (
value, cls.__name__, cls.values[value]))
self = super(enum, cls).__new__(cls, value)
self.name = name
cls.values[value] = self
cls.names[name] = self
setattr(cls, name, self)
return self
def __str__(self):
return '<%s value %s>' % (
self.__class__.__name__, self.name)
__repr__ = __str__
def all(seq):
"""
Predict used to check if all items in a seq are True.
:returns: True if all items in seq are True
"""
for item in seq:
if not item:
return False
return True
def any(seq):
"""
Predict used to check if any item in a seq are True.
:returns: True if any item in seq is True
"""
for item in seq:
if item:
return True
return False