gui.adapt Namespace Reference

Classes
class	AdaptationError
class	LiskovViolation

Functions
def	registerAdapterFactory (objtype, protocol, factory)
def	unregisterAdapterFactory (objtype, protocol)
def	_adapt_by_registry (obj, protocol, alternate)
def	adapt (obj, protocol, alternate=AdaptationError)

Variables
dictionary	_adapter_factory_registry = {}

Function Documentation

_adapt_by_registry()

def gui.adapt._adapt_by_registry (   obj,   protocol,   alternate  )

private

Definition at line 33 of file adapt.py.

def _adapt_by_registry(obj, protocol, alternate):
        factory = _adapter_factory_registry.get((type(obj), protocol))
        if factory is None:
            adapter = alternate
        else:
            adapter = factory(obj, protocol, alternate)
        if adapter is AdaptationError:
            raise AdaptationError(obj)
        else:
            return adapter
 
 

Referenced by gui.adapt.adapt().

adapt()

def gui.adapt.adapt	(		obj,
			protocol,
			alternate = AdaptationError
	)

Definition at line 45 of file adapt.py.

def adapt(obj, protocol, alternate=AdaptationError):
 
        t = type(obj)
 
        # (a) first check to see if object has the exact protocol
        if t is protocol:
           return obj
 
        try:
            # (b) next check if t.__conform__ exists & likes protocol
            conform = getattr(t, '__conform__', None)
            if conform is not None:
                result = conform(obj, protocol)
                if result is not None:
                    return result
 
            # (c) then check if protocol.__adapt__ exists & likes obj
            adapt = getattr(type(protocol), '__adapt__', None)
            if adapt is not None:
                result = adapt(protocol, obj)
                if result is not None:
                    return result
        except LiskovViolation:
            pass
        else:
            # (d) check if object is instance of protocol
            try:
               if isinstance(obj, protocol):
                   return obj
            except:
               pass
 
        # (e) last chance: try the registry
        return _adapt_by_registry(obj, protocol, alternate)

References gui.adapt._adapt_by_registry(), and gui.adapt.adapt().

Referenced by gui.adapt.adapt().

registerAdapterFactory()

def gui.adapt.registerAdapterFactory	(		objtype,
			protocol,
			factory
	)

Definition at line 27 of file adapt.py.

def registerAdapterFactory(objtype, protocol, factory):
        _adapter_factory_registry[objtype, protocol] = factory
 

unregisterAdapterFactory()

def gui.adapt.unregisterAdapterFactory	(		objtype,
			protocol
	)

Definition at line 30 of file adapt.py.

def unregisterAdapterFactory(objtype, protocol):
        del _adapter_factory_registry[objtype, protocol]
 

Variable Documentation

_adapter_factory_registry

dictionary gui.adapt._adapter_factory_registry = {}

private

Definition at line 25 of file adapt.py.