gocept.pagelet 1.1

内容

• gocept.pagelet
• Changes
  • 1.1 (2019-06-10)
  • 1.0 (2016-04-06)
  • 0.4 (2013-03-28)
  • 0.3 (2009-12-27)
  • 0.2 (2009-12-27)
  • 0.1 (2008-09-20)
• Contributors
• Easy z3c.pagelet registration
  • Setup
  • Template only
  • Class only
  • Class and template

1.1 (2019-06-10)

• 声明支持python 3.5、3.6、3.7、3.8、pypypy和pypy3。
• 用毒物测试。

1.0 (2016-04-06)

• 将bootstrap.py更新为zc.buildout 2.3。
• 使用py.test作为测试运行程序。
• 声明对Python2.7的显式支持。 目前不支持其他python版本。

0.4 (2013-03-28)

• 当使用仅具有模板的zcml注册pagelet时， 模板在repr中呈现，生成的类具有 在调试时了解这个类的用途。
• 更新测试以使用python的doctest而不是弃用 zope.testing.doctest。

0.3 (2009-12-27)

• 使用zope.browserpage和zope.browsermenu而不是 zope.app.publisher。

0.2 (2009-12-27)

• 允许任意数量的上下文元素进行调整。

0.1 (2008-09-20)

• 首次公开发行。

Setup

我们需要一些zcml设置：

>>> import sys
>>> from zope.configuration import xmlconfig
>>> import gocept.pagelet
>>> context = xmlconfig.file('meta.zcml', gocept.pagelet)

Template only

可以将模板用作pagelet。不需要上课：

>>> context = xmlconfig.string("""
... <configure
...     xmlns:gocept="http://namespaces.gocept.com/zcml">
...   <gocept:pagelet
...       name="index.html"
...       for="*"
...       permission="zope.Public"
...       template="test-template.pt"
...       />
... </configure>
... """, context)

我们现在应该有一个页面：

>>> import zope.component
>>> from zope.publisher.browser import TestRequest
>>> pagelet = zope.component.getMultiAdapter(
...     (object, TestRequest()), name='index.html')
>>> pagelet
<gocept.pagelet.zcml.SimplePagelet from .../gocept/pagelet/test-template.pt object at 0x...>
>>> pagelet.__name__
u'index.html'

当我们呈现页面时，使用测试模板：

>>> pagelet.render()
u'Hello from the test template.\n'

Class only

当然，也可以在没有模板的情况下注册类。创建 在模块中初始化并使其可用：

>>> from z3c.pagelet.browser import BrowserPagelet
>>> class MyPagelet(BrowserPagelet):
...     """Custom pagelet"""
...     def render(self):
...         return u"Hello from the custom pagelet."""

把它放在假的包裹里custom：

>>> sys.modules['custom'] = type(
...     'Module', (),
...     {'MyPagelet': MyPagelet})()

通过ZCML提供：

>>> context = xmlconfig.string("""
... <configure
...     xmlns:gocept="http://namespaces.gocept.com/zcml">
...   <gocept:pagelet
...       name="class.html"
...       for="*"
...       permission="zope.Public"
...       class="custom.MyPagelet"
...       />
... </configure>
... """, context)

获取页面：

>>> pagelet = zope.component.getMultiAdapter(
...     (object, TestRequest()), name='class.html')
>>> pagelet
<gocept.pagelet.zcml.MyPagelet object at 0x...>
>>> pagelet.render()
u'Hello from the custom pagelet.'

Class and template

当然也可以同时指定类和模板。所以创造 另一个Pagelet类并注册：

>>> class MyPagelet2(BrowserPagelet):
...     """Custom pagelet"""
...     i_am_very_custom = True
>>> sys.modules['custom'] = type(
...     'Module', (),
...     {'MyPagelet': MyPagelet2})()

通过ZCML提供：

>>> context = xmlconfig.string("""
... <configure
...     xmlns:gocept="http://namespaces.gocept.com/zcml">
...   <gocept:pagelet
...       name="class-template.html"
...       for="*"
...       permission="zope.Public"
...       class="custom.MyPagelet"
...       template="test-template.pt"
...       />
... </configure>
... """, context)

>>> pagelet = zope.component.getMultiAdapter(
...     (object, TestRequest()), name='class-template.html')
>>> pagelet
<gocept.pagelet.zcml.MyPagelet2 object at 0x...>
>>> pagelet.render()
u'Hello from the test template.\n'
>>> pagelet.i_am_very_custom
True