memphis.config

adapter

>>> class IObject(interface.Interface):
...     pass

>>> class IObject1(interface.Interface):
...     pass

>>> class IAdapted(interface.Interface):
...     pass

>>> class IAdapted1(interface.Interface):
...     pass

Registering function as adapter:

>>> config.begin()

>>> @config.adapter(IObject)
... @interface.implementer(IAdapted)
... def adaptObject(ob):
...     return Content(IAdapted)

>>> reGrok()

>>> print sm.queryAdapter(Content(IObject), IAdapted)
None

>>> config.commit()

>>> print sm.queryAdapter(Content(IObject), IAdapted)
Content<IAdapted>

>>> del sys.modules[__name__].adaptObject
>>> catesting.tearDown()

It's possible to register function as different adapter:

>>> config.begin()

>>> @config.adapter(IObject)
... @config.adapter(IObject1)
... @interface.implementer(IAdapted)
... def adaptObject(ob):
...     return Content(IAdapted)

>>> reGrok()

>>> print sm.queryAdapter(Content(IObject), IAdapted)
None
>>> print sm.queryAdapter(Content(IObject), IAdapted)
None

>>> config.commit()

>>> print sm.queryAdapter(Content(IObject), IAdapted)
Content<IAdapted>
>>> print sm.queryAdapter(Content(IObject1), IAdapted)
Content<IAdapted>

>>> del sys.modules[__name__].adaptObject
>>> catesting.tearDown()

Registering class as adapter:

>>> config.begin()

>>> class IObject2(interface.Interface):
...     pass

>>> class ContentAdapter(Content):
...     interface.implements(IAdapted)
...     config.adapts(IObject2, 'test')
...
...     def __init__(self, content):
...         self.content = content
...         self.iface = IAdapted

>>> reGrok()

>>> print sm.queryAdapter(Content(IObject2), IAdapted, 'test')
None

>>> config.commit()

>>> print sm.queryAdapter(Content(IObject2), IAdapted, 'test')
Content<IAdapted>

>>> catesting.tearDown()

If configuration context is not set adapters are registered immidietly:

>>> @config.adapter(IObject)
... @interface.implementer(IAdapted)
... def adaptObject(ob):
...     return Content(IAdapted)

>>> reGrok()

>>> print sm.queryAdapter(Content(IObject), IAdapted)
Content<IAdapted>

>>> catesting.tearDown()

Registering function as adapter:

>>> config.registerAdapter(adaptObject)
>>> print sm.queryAdapter(Content(IObject), IAdapted)
Content<IAdapted>

>>> catesting.tearDown()

utility

>>> config.begin()

>>> ob = Content(IObject)
>>> config.registerUtility(ob, IObject, 'test')

>>> print sm.queryUtility(IObject, 'test')
None

>>> config.commit()

>>> ob is sm.queryUtility(IObject, 'test')
True

>>> ob = Content(IObject1)
>>> config.registerUtility(ob, IObject1, 'test1')

>>> ob is sm.queryUtility(IObject1, 'test1')
True

>>> catesting.tearDown()

class as utility

>>> config.begin()

>>> class ContentUtility(object):
...     config.utility(IObject, 'test')

>>> reGrok()

>>> print sm.queryUtility(IObject, 'test')
None

>>> config.commit()

>>> sm.queryUtility(IObject, 'test')
<memphis.config.TESTS.ContentUtility ...>

>>> del sys.modules[__name__].ContentUtility
>>> catesting.tearDown()

config action

It's possible to run any function on config commit, and rerun function each time config is reinitialized (testing support):

>>> def testFunc():
...     print "My test function"

>>> config.begin()

>>> _ = config.action(testFunc, __discriminator=('test',), __order=10)

>>> reGrok()

>>> config.commit()
My test function

>>> reGrok()
My test function

Without discriminator configAction executed immidietly.

>>> del locals()['memphis.config.directives.action']

>>> config.begin()

>>> def testFunc1():
...     print "My test1 function"

>>> _ = config.action(testFunc1)

>>> reGrok()
My test1 function

>>> config.commit()
My test function

reGrok() My test function My test1 function

0.6 (2011-06-29)

• Added different memphis initialization procedure.
• Change api for action directive. discriminator renamed to __discriminator, actionOrder renamed to __order.

0.5 (2011-06-20)

• Fix registerIn directives, organize all registrations by module.

0.4 (2011-06-19)

• Added 'registerIn' module directive, it allows to redirect all registrations to different Components object.
• Added ability to load grokkers before other code. Usefull if package implements grokkers and uses them at the same time.
• Re-register objectEventNodify handler rather than just register. This fixes bug with event been send two times.
• Action directive accepts custom __info attribute instead of default getInfo.

0.3 (2011-06-02)

• Allow to redefine context of 'action' directive by passing frame object as '__frame' parameter.

0.1 (2011-05-27)

• Initial release