Ubuntu中文论坛

发表于： **2005-10-12 23:14**

leal 写了： Just run it （只待运行了）或者不译？
Views 视图？或不译？

不译吧！我觉得译了反而没有了原来的味道，还有点别扭！呵呵

发表于： **2005-10-12 23:17**

真得学到了不少东东！
谢谢leal兄了！

发表于： **2005-10-12 23:20**

Here is our interfaces.py:
这里是我们的interfaces.py:

下面就是我们的interfaces.py：

Our first interface IMark has two attributes, one is the URL of the site and the other one is the description. Please note, IMark is not a class even though we used Python's class definition. We inherited from Interface to make it an interface. Second one is a container interface, which is an extended IContainer interface. By using this container interface we can persist our data (instances of IMark implementations). We will put all objects of IMark in a container object of IBookMarker. We will implement IMark along with IMarkContained as a constraint interface. So that IMark object will be only contained in an IBookMarker object.
我们的第一个接口IMark有两个属性，一个是站点的URL，另一个是它的描述。请注意，IMark不是一个类，尽管我们使用了Python的类定义。我们继承了Interface，从而使之成了一个 interface（接口）。第二个是一个容器接口，它是一个扩展的Icontainer接口。通过使用这个容器接口我们可以保存我们的数据（IMark 的实例）。我们将IMark的所有对象放到IBookMarker的一个容器对象里。我们连同IMarkContained（作为一个约束接口）一起来实现IMark。所以IMark对象只能包含在IBookMarker对象中。

IMark继承自Interface，因此是个接口。

IContainer

我们可以使用这个容器接口来保存我们的数据（IMark实现的实例）（因为IMark是接口，所以先要实现之，即concrete class，然后再创建concrete class的实例，即对象）。…… 由此IMark对象将只能被包含在……

_________________

发表于： **2005-10-13 8:26**

leal 写了：原文地址Zope3 In 30 Minutes

中国Zope用户组上的一些信息

zope3 是下一代的zope，正在组织翻译Zope3宝典。

不过目前只翻译了标题。

我已经看到了，不过他们已经翻得差不多了，只是没有放出来而已，而且好象任务也已经有人认领。

发表于： **2005-10-13 8:28**

哦这样啊，呵呵我只看表面了。

发表于： **2005-10-13 9:54**

Unit Testing
单元测试

Now create tests.py and put the following code there:
现在创建tests.py文件，输入下列语句：

代码：全选

import unittest
from zope.testing.doctestunit import DocTestSuite

from zope.app.container.tests.test_icontainer import TestSampleContainer

from boom.bookmarker import BookMarker, Mark


class BookMarkerContainerTest(TestSampleContainer):
  
    def makeBookMarkerObject(self):
        return BookMarker()

def test_suite():
    return unittest.TestSuite((
        DocTestSuite('boom.bookmarker'),
        unittest.makeSuite(BookMarkerContainerTest),
        ))
          
if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

Actually, we are not written any unit tests here, but this will make our doc tests working automatically.
实际上我们在这里并没有编写任何的单元测试，不过它会自动对我们的文档进行测试

To run the unit test:
然后运行单元测试

代码：全选

$ cd $HOME/myzope/lib
$ ../bin/test -vpu --dir boom

发表于： **2005-10-13 10:16**

Real coding!
正式编码

Now let's move on to the implementation (bookmarker.py):
现在让我们继续去实现（bookmarker.py）

代码：全选

__docformat__ = 'restructuredtext'

from zope.interface import implements
from zope.app.container.btree import BTreeContainer
from zope.app.container.contained import Contained

from boom.interfaces import IMark, IMarkContained, IBookMarker

class Mark(Contained):
    """Implementation of IMark

    Make sure that the `Mark` implements the `IMark` interface::

      >>> from zope.interface.verify import verifyClass
      >>> verifyClass(IMark, Mark)
      True

    Make sure that the `Mark` implements the `IMarkContained` interface:

      >>> from zope.interface.verify import verifyClass
      >>> verifyClass(IMarkContained, Mark)
      True

    An example of checking the url of Mark::

      >>> mk = Mark()
      >>> mk.url
      u'http://www.zope.org'
      >>> mk.url = u'http://www.python.org'
      >>> mk.url
      u'http://www.python.org'
  
    An example of checking the description of Mark::

      >>> mk = Mark()
      >>> mk.description
      u''
      >>> mk.description = u'Zope Project Web Site'
      >>> mk.description
      u'Zope Project Web Site'
    """

    implements(IMark, IMarkContained)

    url = u"http://www.zope.org"
    description = u""


class BookMarker(BTreeContainer):
    """Implementation of IBookMarker using B-Tree Container

    Make sure that the `BookMarker` implements the `IBookMarker` interface::

      >>> from zope.interface.verify import verifyClass
      >>> verifyClass(IBookMarker, BookMarker)
      True

    An example of changing the name of BookMarker::

      >>> bm = BookMarker()
      >>> bm.name
      u''
      >>> bm.name = u'MyBookMarker'
      >>> bm.name
      u'MyBookMarker'
    """

    implements(IBookMarker)

    name = u""

We have written doctests along with the implementations. Doctests are accompanied with examples, so it is called example driven unit testing.
我们已经在实现的同时也编写了Doctests，该Doctests是同例子一起的，所以这种实现方式我们称之为事例驱动单元测试

发表于： **2005-10-13 10:35**

Configuration
配置

Now configuration (save in configure.zcml):
现在编写配置（保存在configure.zcml文件中）：

代码：全选

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:browser="http://namespaces.zope.org/browser">

  <interface
      interface=".interfaces.IBookMarker"
      type="zope.app.content.interfaces.IContentType"
      />

  <content class=".bookmarker.BookMarker">
    <implements
        interface="zope.app.annotation.interfaces.IAttributeAnnotatable"
        />
    <implements
        interface="zope.app.container.interfaces.IContentContainer" 
        />
    <factory
        id="boom.bookmarker.BookMarker"
        description="Book Marker" 
        />
    <require
        permission="zope.ManageContent"
        interface=".interfaces.IBookMarker"
        />
    <require
        permission="zope.ManageContent"
        set_schema=".interfaces.IBookMarker"
        />
  </content>

  <interface
      interface=".interfaces.IMark"
      type="zope.app.content.interfaces.IContentType"
      />

  <content class=".bookmarker.Mark">
    <implements
        interface="zope.app.annotation.interfaces.IAttributeAnnotatable"
        />
    <factory
        id="boom.bookmarker.Mark"
        description="A book mark." 
        />
    <require
        permission="zope.ManageContent"
        interface=".interfaces.IMark"/>
    <require
        permission="zope.ManageContent"
        set_schema=".interfaces.IMark"
        />
  </content>

  <browser:addform
      label="Add Book Marker"
      name="AddBookMarker.html"
      schema="boom.interfaces.IBookMarker"
      content_factory="boom.bookmarker.BookMarker"
      fields="name"
      permission="zope.ManageContent"
      />

  <browser:addMenuItem
      class=".bookmarker.BookMarker"
      title="Book Marker"
      permission="zope.ManageContent"
      view="AddBookMarker.html"
      />

  <browser:editform
      schema="boom.interfaces.IBookMarker"
      for="boom.interfaces.IBookMarker"
      label="Change Book Marker"
      name="edit.html"
      permission="zope.ManageContent"
      menu="zmi_views" title="Edit" 
      />

<browser:containerViews
    for="boom.interfaces.IBookMarker"
    index="zope.View"
    contents="zope.View"
    add="zope.ManageContent"
    />

<browser:addform
    label="Add Mark"
    name="AddMark.html"
    schema="boom.interfaces.IMark"
    content_factory="boom.bookmarker.Mark"
    fields="url description"
    permission="zope.ManageContent"
    />

<browser:addMenuItem
    class="boom.bookmarker.Mark"
    title="Mark"
    description="URL of Website"
    permission="zope.ManageContent"
    view="AddMark.html"
    />

<browser:editform
    schema="boom.interfaces.IMark"
    for="boom.interfaces.IMark"
    label="Change Mark"
    fields="url description"
    name="edit.html"
    permission="zope.ManageContent"
    menu="zmi_views" title="Edit" 
    />

<browser:page
    name="marks.html"
    for="boom.interfaces.IBookMarker"
    class=".browser.BookMarks"
    template="marks.pt"
    permission="zope.Public"
    menu="zmi_views"
    title="Marks"
    />

</configure>

Is it self explanatory? "no...!" then ok! we will discuss Zope Configuration Markup Language (ZCML) briefly later. Actually, if you are familiar with ZCML this configuartion will be more than self explanatory. It will give you an overall idea about the entire application. Now you might think, it is not Pythonic ${L_SMILIES_SAD}$ Hey! think twice!.
它能不言自明（即能够自我解释，XML之类的标记语言都有这个特点）吗？“不...!”好吧，我们将稍后简单的谈谈Zope Configuration Markup Language（ZCML，Zope配置标记语言）。实际上，如果你对ZCML熟悉的话，你会发现这个配置不止是不言自明，它将带给你的是对整个应用的总体思路。现在你可能在想，这并不Pythonic嘛 ${L_SMILIES_SAD}$ ，嗨！再想想！

发表于： **2005-10-13 10:42**

Just run it

As the last step to work our application, put the following line in:$HOME/myzope/etc/package-icludes/boom-configure.zcml:
最后一步就是要让我们的应用运行起来，在文件$HOME/myzope/etc/package-icludes/boom-configure.zcml中插入下列行：

代码：全选

<include package="boom"/>

Now you registered your package.
现在你已经注册了你的包。

Run zope again, then open your browser, add a BookMarker and few book marks.
重新启动Zope，然后打开你的浏览器，添加一个BookMarker和一些书签。

Now you want to arrange your your book marks in a better way, don't you?. For the time being, just relax, then we will create a view for book marks.
现在，你不想让你的书签排列得更好点吗？先暂时休息一下，之后我们将为书签创建一个视图。

发表于： **2005-10-13 10:47**

Views
视图

Now create a file named browser.py with following code:
现在新建一个名为browser.py的文件，并输入下列代码：

代码：全选

from boom.interfaces import IMark

class BookMarks:

    def __init__(self, context, request, base_url=''):
        self.context = context
        self.request = request
        self.base_url = base_url

    def listMarks(self):
        marks = []
        for name, child in self.context.items():
            if IMark.providedBy(child):
                info = {}
                info['url'] = child.url
                info['description'] = child.description
                marks.append(info)
        return marks

Then one template (marks.pt):
然后创建一个模板（marks.pt）

代码：全选

<html metal:use-macro="views/standard_macros/view">
  <body>
    <div metal:fill-slot="body">

      <div class="row">
        <div class="label">Book Marks:</div>
        <br/><br/>
          <li tal:repeat="item view/listMarks">

            <a href="" tal:attributes="href item/url">
               <span tal:content="item/url">Link</span>
            </a>
            <pre tal:content="item/description">Description</pre>
            <br/>

          </li>
      </div>

    </div>
  </body>
</html>

Now by clicking on "Marks" tab you can see all book marks.
现在点击一下“Marks”标签，你就可以看到所有的书签了。

Ok! this is not the end, just the beginning of your study.
好的！这样可不能算是结束，这仅仅是你学习的开始。

发表于： **2005-10-13 10:51**

Functional testing
功能测试

Let's finish our example writing a functional test for view (ftests.py):
让我们为视图写一个功能测试来结束我们的例子（ftests.py）

代码：全选

import unittest
from zope.app.testing.functional import BrowserTestCase

class BookMarksTest(BrowserTestCase):

    def testMarksListing(self):
        pass


def test_suite():
    return unittest.TestSuite((
        unittest.makeSuite(BookMarksTest),
        ))

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

To run the functional test:
然后运行该功能测试：

代码：全选

$ cd $HOME/myzope/lib
$ ../bin/test -vpf --dir boom

发表于： **2005-10-13 11:03**

Now what?
现在学什么？

Now you can start learning Zope3 in detail, using Zope3 book. Also join zope3-users mailing list.
现在你可以通过Zope3 Book开始详细学习Zope3了。也可以加入到zope3-user邮件列表里。

There is a good Zope3 quick start guide by Benji York: http://www.benjiyork.com/quick_start/
这里有Benji York写的一个不错的Zope3快速入门指南： http://www.benjiyork.com/quick_start/
A good introductory book is also available in print, visit: http://worldcookery.com/
还有一本已出版的介绍性图书，很不错，请访问： http://worldcookery.com/

Just one more thing: I want to improve this document, so don't hesitate to write your feedback to: baiju.m.mail AT gmail.com
还有一点：我想不断完善这份文档，因此有何意见/建议千万别犹豫，请发送到： baiju.m.mail@gmail.com

发表于： **2005-10-13 11:54**

Is it self explanatory? "no...!" then ok! we will discuss Zope Configuration Markup Language (ZCML) briefly later. Actually, if you are familiar with ZCML this configuartion will be more than self explanatory. It will give you an overall idea about the entire application. Now you might think, it is not Pythonic Sad Hey! think twice!.
是对它本身的说明吗？“不...!”好吧，我们将稍后简单的谈谈Zope Configuration Markup Language（ZCML）。实际上，如果你对ZCML熟悉的话，你会发现这个配置不止是对自身的一个说明，它将带给你的是对整个应用的总体思路。现在你可能在想，这并不Pythonic嘛Sad，嗨！再想想！

它能不言自明（即能够自我解释，XML之类的标记语言都有这个特点）吗？“不...!”好吧，我们将稍后简单的谈谈Zope Configuration Markup Language（ZCML，Zope配置标记语言）。实际上，如果你对ZCML熟悉的话，你会发现这个配置不止是不言自明，它将带给你的是对整个应用的总体思路。现在你可能在想，这并不Pythonic嘛

，嗨！再想想！

发表于： **2005-10-13 11:57**

As the last step to work our application, put the following line in:$HOME/myzope/etc/package-icludes/boom-configure.zcml:
最后一步就是要让我们的应用运行起来，将下列行插入文件$HOME/myzope/etc/package-icludes/boom-configure.zcml中：
代码:
<include package="boom"/>

在文件$HOME/myzope/etc/package-icludes/boom-configure.zcml中插入下列行：

Now you want to arrange your your book marks in a better way, don't you?. For the time being, just relax, then we will create a view for book marks.
现在，你不想让你的书签排列得更好点吗？请先放松一下，然后我们来为书签创建一个视图

…………，暂时休息一下先，之后我们将为书签……

发表于： **2005-10-13 11:58**

Now create a file named browser.py with following code:
现在用下列语句来创建一个browser.py文件：

现在新建一个名为browser.py的文件，并输入下列代码：

Then one template (marks.pt):
然后是一个模板（marks.pt）

然后创建一个模板……

Ubuntu中文论坛

三十分钟学会Zope3（已完成，请参阅本站 Wiki）