gocept.registration 0.3.0

注册用户

注册由注册实用程序管理

>>> from gocept.registration.registrations import Registrations
>>> registrations = Registrations()

现在我们可以通过传递用户的电子邮件地址和一些附加数据来注册用户

>>> peter = registrations.register('peter@example.com', {'name': u'Peter'})
>>> peter
<gocept.registration.registrations.Registration object at 0x...>

所有注册都有一个哈希值，匿名标识它们，以及附加的电子邮件和数据

>>> peter.hash
'<SHA-HASH>'
>>> peter.email
'peter@example.com'
>>> peter.data
{'name': u'Peter'}

Peter的注册包含在由哈希值标识的实用程序中

>>> registrations[peter.hash]
<gocept.registration.registrations.Registration object at 0x...>

Peter现在可以使用给他提供的哈希值确认他的注册

>>> registrations.confirm(peter.hash)

确认注册后，它不再存储在实用程序中

>>> registrations[peter.hash]
Traceback (most recent call last):
KeyError: '<SHA-HASH>'

自定义注册对象

在调用register方法时，我们还可以可选地传递一个工厂来构造注册。这在子类化Registration类时很有用。

>>> from gocept.registration.registrations import Registration
>>> class MyRegistration(Registration):
...     def __init__(self, hash, email, data):
...         assert data.has_key('agentNumber'), 'missing agent number!'
...         super(MyRegistration, self).__init__(hash, email, data)

>>> registrations.register('james@bond.com',
...                        {'name': u'James Bond'},
...                        factory=MyRegistration)
Traceback (most recent call last):
...
AssertionError: missing agent number!
>>> registrations.register('james@bond.com',
...                        {'name': u'James Bond',
...                         'agentNumber': u'007'},
...                        factory=MyRegistration)
<MyRegistration object at ...>

应用程序钩子

应用程序可以钩入两个钩子来自定义注册过程

• 注册对象的ObjectAddedEvent，以及

• 当用户确认他的注册时的RegistrationConfirmedEvent

让我们注册这两个事件的订阅者以演示每个事件在哪里被调用

>>> def registered(event):
...     print event, event.object
>>> import zope.component
>>> from zope.app.container.interfaces import IObjectAddedEvent
>>> zope.component.provideHandler(registered, (IObjectAddedEvent,))

>>> chuck = registrations.register('chuck@example.com', {'name': u'LeChuck'})
<zope.app.container.contained.ObjectAddedEvent object at 0x...>
<gocept.registration.registrations.Registration object at 0x...>

>>> def confirmed(event):
...     print event, event.registration
>>> from gocept.registration.interfaces import IRegistrationConfirmed
>>> zope.component.provideHandler(confirmed, (IRegistrationConfirmed,))

>>> registrations.confirm(chuck.hash)
<gocept.registration.interfaces.RegistrationConfirmedEvent object at 0x...>
<gocept.registration.registrations.Registration object at 0x...>

让我们再次清理那些注册

>>> from zope.app.testing import placelesssetup
>>> placelesssetup.tearDown()

确认电子邮件

发送注册电子邮件分为两部分：创建电子邮件本身和发送它。

更改