Учебник - часть 1

Вступление

В главе Первые шаги, был описан процесс установки BlueBream и создания проекта из шаблона bluebream. В этом учебнике, вы научитесь создавать простое приложение коллектор заявок. Данная серия уроков поможет ближе ознакомится с принципами BlueBream.

Вот несколько функций будущего приложения:

• В один накопитель можно добавить сколько угодно заявок.
• Каждая новая заявка должен иметь описание и один начальный комментарий.
• К заявке можно добавлять комментарии.

Это первая часть обучения. После завершения этой главы, вы должны уметь:

• Понимать структуру директорий проекта.
• Использовать и настраивать Buildout.
• Создавать контент-объекты (content objects) и интерфейсы.

• Использовать инструмент для генерации форм (zope.formlib).

Создание нового проекта

Использование шаблона проекта bluebream

В этом разделе мы будем создавать структуру папок для нашего приложения. Я предполагаю, что вы уже установили bluebream, используя команду easy_install bluebream, как упоминалось в главе Первые шаги. Давайте назовем приложение ticketcollector, и создадим Python пакет с именем tc.main. Итак, мы создали проект с именем ticketcollector, пакетом пространства имен tc и под-пакетом main. Давайте создадим структуру папок для нашего приложения:

   1 $ paster create -t bluebream
   2 
   3 Selected and implied templates:
   4   bluebream#bluebream  A BlueBream project, base template
   5 
   6 Enter project name: ticketcollector
   7 Variables:
   8   egg:      ticketcollector
   9   package:  ticketcollector
  10   project:  ticketcollector
  11 Enter python_package (Main Python package (with namespace, if any)) ['ticketcollector']: tc.main
  12 Enter interpreter (Name of custom Python interpreter) ['breampy']:
  13 Enter version (Version (like 0.1)) ['0.1']:
  14 Enter description (One-line description of the package) ['']: Ticket Collector
  15 Enter long_description (Multi-line description (in reST)) ['']: An issue tracking application
  16 Enter keywords (Space-separated keywords/tags) ['']:
  17 Enter author (Author name) ['']: Baiju M
  18 Enter author_email (Author email) ['']: baiju@example.com
  19 Enter url (URL of homepage) ['']:
  20 Enter license_name (License name) ['']: ZPL
  21 Enter zip_safe (True/False: if the package can be distributed as a .zip file) [False]:
  22 Creating template bluebream
  23 Creating directory ./ticketcollector
  24 
  25 Your project has been created! Now, you want to:
  26 1) put the generated files under version control
  27 2) run: python boostrap.py
  28 3) run: ./bin/buildout

Как видно из примера выше, мы предоставили почти всю информацию о проекте. Значения, которые были указаны, можно поменять позже. Это сделать очень просто; все, что трудно изменить позже - это имена пакетов, потому что на них позже может быть много ссылок в коде.

Организация нового пакета

Если вы перейдете в папку ticketcollector, вы увидите несколько папок и файлов:

jack@computer:/projects/ticketcollector$ ls -CF
bootstrap.py  debug.ini   etc/      src/  versions.cfg
buildout.cfg  deploy.ini  setup.py  var/

Когда структура проекта готова, вы можете добавить его в систему контроля версий. Вам не следует добавлять папку src/ticketcollector.egg-info, так как она автоматически создается с помощью setuptools. Вот пример с использованием bzr:

jack@computer:/projects/ticketcollector$ rm -fr src/ticketcollector.egg-info/
jack@computer:/projects/ticketcollector$ bzr init
Created a standalone tree (format: 2a)
jack@computer:/projects/ticketcollector$ bzr add *
adding bootstrap.py
adding buildout.cfg
adding debug.ini
...
jack@computer:/projects/ticketcollector$ bzr ci -m "Initial import"
Committing to: /projects/ticketcollector/
added bootstrap.py
added buildout.cfg
...
Committed revision 1.

Добавление проекта в систему контроля версий необязательный, но рекомендуемый шаг. У вас теперь есть правильный исходный код, который, после построения, приобретет вид рабочего приложения. Проект теперь полностью независим, от дистрибутива bluebream, который только помогает добраться до этой точки развития. Теперь проект содержит все необходимое для установки зависимостей из Интернета и настройки приложения.

Генерация (bootstrapping) проекта

Следующий шаг - установка Buildout. Цель Buildout - автоматизировать сборку Python приложений из исходников. Единственное требование для Buildout - это Python. BlueBream предоставляет скрипт генерации для установки !Buildout и настройки проекта для его запуска. Этот скрипт называется bootstrap.py и делает следующие вещи:

• Загружает и устанавливает дистрибутив distribute с PyPI, который содержит внутри пакет setuptools.

• Загружает и устанавливает дистрибутив zc.buildout c PyPI.

• Создает папки проекта :- bin/, eggs/, parts/, develop-eggs/.

• Создает скрипт внутри папки bin с именем buildout.

Когда вы запускаете bootstrap.py, вы видите, что он создает несколько папок и скрипт bin/buildout, как было упомянуто раньше:

jack@computer:/projects/ticketcollector$ python bootstrap.py
Creating directory '/projects/ticketcollector/bin'.
Creating directory '/projects/ticketcollector/parts'.
Creating directory '/projects/ticketcollector/develop-eggs'.
Creating directory '/projects/ticketcollector/eggs'.
Generated script '/projects/ticketcollector/bin/buildout'.

• Папка bin - место, куда Buildout устанавливает все выполнимые скрипты.

• Папка eggs - место, куда Buildout устанавливает яйца.

• Папка parts, куда Buildout сохраняет весь свой вывод. Buildout ожидает, что в этой папке ничего не будет изменятся со стороны разработчика.

• Папка develop-eggs - место, куда Buildout сохраняет ссылки на все локально разработанные яйца.

Настройка Buildout

После генерации проекта вы можете собрать приложение. Все шаги, которые на этот момент уже сделаны, делаются всего один раз для нового проекта, но запуск сборщика необходим при каждом изменение его конфигурации. Теперь вы готовы запустить bin/buildout для того, чтобы собрать приложение, но перед этим следует взглянуть на содержимое файла buildout.cfg:

   1 [buildout]
   2 develop = .
   3 extends = versions.cfg
   4 parts = app
   5         test
   6 
   7 [app]
   8 recipe = zc.recipe.egg
   9 eggs = ticketcollector
  10        z3c.evalexception>=2.0
  11        Paste
  12        PasteScript
  13        PasteDeploy
  14 interpreter = breampy
  15 [test]
  16 recipe = zc.recipe.testrunner
  17 eggs = ticketcollector

Конфигурация сборщика разделена на несколько секций, называемых частями. Главная часть - [buildout], является первой частью в листинге выше. Каждая часть, кроме [buildout], обрабатывается подключаемым механизмом системы Buildout, который называется рецепт. [buildout] обрабатывается как исключительный случай, так как содержит общие настройки.

Давайте рассмотрим [buildout]:

   1 [buildout]
   2 develop = .
   3 extends = versions.cfg
   4 parts = app
   5         test

Первая опция (develop) указывает сборщику, что текущая папка - папка с исходниками дистрибутива, то есть содержит файл setup.py. Buildout исследует setup.py и создаст ссылку на яйцо в папке develop-eggs. Ссылочный файл должен содержать путь к пакету Python. Таким образом сборщик удостоверится, что пакеты будут всегда доступны для импорта. Значение опции develop может быть относительным путем, как указано выше, или абсолютным путем некой папки. Также можно использовать многострочные значения для указания разных путей.

Опция extends указывает сборщику включать полное содержимое файла versions.cfg в качестве части конфигурации. versions.cfg - другой файл настроек Buildout такого же формата, как и buildout.cfg. Он содержит номера релизов и другие зависимости. Вы можете устанавливать многострочные значения опции extends для включения нескольких файлов настроек.

Опция parts содержит список всех частей, которые должны обрабатываться системой Buildout. Buildout ожидает, что на каждую часть конфигурационного файла существует рецепт.

Теперь рассмотрим часть app:

   1 [app]
   2 recipe = zc.recipe.egg
   3 eggs = ticketcollector
   4        z3c.evalexception>=2.0
   5        Paste
   6        PasteScript
   7        PasteDeploy
   8 interpreter = breampy

Эта часть заботится о всех яйцах (eggs), которые необходимы для работы приложения. Пакет zc.recipe.egg - это расширенный рецепт системы Buildout, содержащий множество функций для работы с яйцами. Большинство зависимостей будут связаны с яйцом главного приложения. Опция eggs содержит список всех яиц. Первое яйцо, ticketcollector - это главное локально разрабатываемое яйцо. Последняя опция - interpreter определяет имя интерпретатора, который создал эту часть. Интерпретатор содержит пути ко всех яйцам и их зависимостям, которые содержатся в списке eggs, так что вы можете импортировать любой модуль, который присутствует в списке зависимостей.

Последняя часть создает загрузчик тестов:

   1 [test]
   2 recipe = zc.recipe.testrunner
   3 eggs = ticketcollector

Рецепт testrunner создает загрузчик тестов, используя модуль zope.testing. Единственная необязательная опция - eggs, в которой вы указываете список яиц.

Сборка проекта

Теперь вы можете выполнить команду bin/buildout. Ее выполнение займет некоторое время, так как необходимо загрузить все пакеты с !PyPI. Когда вы запустите сборщик, он выдаст вам примерно следующее:

   1 jack@computer:/projects/ticketcollector$ ./bin/buildout
   2 Develop: '/projects/ticketcollector/.'
   3 Installing app.
   4 Generated script '/projects/ticketcollector/bin/paster'.
   5 Generated interpreter '/projects/ticketcollector/bin/breampy'.
   6 Installing zope_conf.
   7 Installing test.
   8 Generated script '/projects/ticketcollector/bin/test'.

В этом примере все яйца уже находятся в папке eggs. Если их там нет, они будут автоматически загружены и установлены. Сборщик также создает несколько скриптов в папке bin:

• Команда paster используется для запуска веб сервера.

• Команда breampy предоставляет интерпретатор Python, который содержит все яйца, доступные в проекте.

• Команда test используется для запуска тестов.

Теперь у нас есть базовое дерево проекта, на основе которого мы продолжим строить наше приложение.

Настройка PasteDeploy

BlueBream использует WSGI для запуска сервера путем использования PasteDeploy. В PasteDeploy есть два файла настроек: один для внедрения (deploy.ini), другой для разработки (debug.ini).

Давайте подробнее рассмотрим содержимое debug.ini:

   1 [app:main]
   2 use = egg:ticketcollector
   3 
   4 [server:main]
   5 use = egg:Paste#http
   6 host = 127.0.0.1
   7 port = 8080
   8 
   9 [DEFAULT]
  10 # set the name of the zope.conf file
  11 zope_conf = %(here)s/etc/zope.conf

Сначала - раздел [app:main]:

   1 [app:main]
   2 use = egg:ticketcollector

Раздел [app:main] определяет, какое яйцо следует использовать. PasteDeploy ожидает, что точка входа paste.app_factory будет определена в яйце. Если вы обратитесь к файлу setup.py, вы увидите, что она определяется следующим образом:

   1 [paste.app_factory]
   2 main = tc.main.startup:application_factory

Имя отчки входа должно быть main. В противном случае, оно должно явно указыватся в файле настроек (debug.ini и deploy.ini). Например, если определение следующее:

   1 [paste.app_factory]
   2 testapp = tc.main.startup:application_factory

Конфигурацию PasteDeploy следует изменить к следующему виду:

   1 [app:main]
   2 use = egg:ticketcollector#testapp

Следующий раздел ([server:main]) определяет WSGI сервер:

   1 [server:main]
   2 use = egg:Paste#http
   3 host = 127.0.0.1
   4 port = 8080

В этом разделе вы можете изменить имя хоста, порт и сервер самостоятельно. В случае, если вы используете любой другой WSGI сервер, он должен быть включен в список зависимостей в настройках Buildoout.

Последний раздел ([DEFAULT]) - место, где вы определяете значения по умолчанию:

   1 [DEFAULT]
   2 # укажите путь к файлу ''zope.conf''
   3 zope_conf = %(here)s/etc/zope.conf

WSGI приложение, которое определено в tc.main.startup ожидает определения опции zope_conf в разделе [DEFAULT]. Следовательно, эта опция необязательная. Она определяет путь к главному конфигурационному файлу zope. Мы рассмотрим конфигурационный файл zope более детально в следующем разделе.

Файл debug.ini содержит полезные настройки для отладки приложений:

   1 [loggers]
   2 keys = root, wsgi
   3 
   4 [handlers]
   5 keys = console, accesslog
   6 
   7 [formatters]
   8 keys = generic, accesslog
   9 
  10 [formatter_generic]
  11 format = %(asctime)s %(levelname)s [%(name)s] %(message)s
  12 
  13 [formatter_accesslog]
  14 format = %(message)s
  15 
  16 [handler_console]
  17 class = StreamHandler
  18 args = (sys.stderr,)
  19 level = ERROR
  20 formatter = generic
  21 
  22 [handler_accesslog]
  23 class = FileHandler
  24 args = (os.path.join('var', 'log', 'access.log'),
  25         'a')
  26 level = INFO
  27 formatter = accesslog
  28 
  29 [logger_root]
  30 level = INFO
  31 handlers = console
  32 
  33 [logger_wsgi]
  34 level = INFO
  35 handlers = accesslog
  36 qualname = wsgi
  37 propagate = 0
  38 
  39 [filter:translogger]
  40 use = egg:Paste#translogger
  41 setup_console_handler = False
  42 logger_name = wsgi
  43 
  44 [filter-app:main]
  45 # Change the last part from 'ajax' to 'pdb' for a post-mortem debugger
  46 # on the console:
  47 use = egg:z3c.evalexception#ajax
  48 next = zope
  49 
  50 [app:zope]
  51 use = egg:ticketcollector
  52 filter-with = translogger
  53 
  54 [server:main]
  55 use = egg:Paste#http
  56 host = 127.0.0.1
  57 port = 8080
  58 
  59 [DEFAULT]
  60 # set the name of the debug zope.conf file
  61 zope_conf = %(here)s/etc/zope-debug.conf

Отладочная конфигурация использует filter-app вместо app для подключения WSGI middleware. На сегодняшний день включено только (z3c.evalexception#ajax) middleware. Вы можете посмотреть документацию PastDeploy на предмет получения более подробной информации об этих разделах конфигурации. Конфигурационный файл Zope определен здесь (etc/zope-debug.conf) по другому, нежели при настройках для внедрения.

Конфигурация Zope

Подобно конфигурации PasteDeploy, конфигурация Zope состоит из файлов etc/zope.conf и etc/zope-debug.conf.

Вот содержимое etc/zope.conf:

   1 # Identify the component configuration used to define the site:
   2 site-definition etc/site.zcml
   3 
   4 <zodb>
   5 
   6   <filestorage>
   7     path var/filestorage/Data.fs
   8     blob-dir var/blob
   9   </filestorage>
  10 
  11 # Uncomment this if you want to connect to a ZEO server instead:
  12 #  <zeoclient>
  13 #    server localhost:8100
  14 #    storage 1
  15 #    # ZEO client cache, in bytes
  16 #    cache-size 20MB
  17 #    # Uncomment to have a persistent disk cache
  18 #    #client zeo1
  19 #  </zeoclient>
  20 </zodb>
  21 
  22 <eventlog>
  23   # This sets up logging to both a file and to standard output (STDOUT).
  24   # The "path" setting can be a relative or absolute filesystem path or
  25   # the tokens STDOUT or STDERR.
  26 
  27   <logfile>
  28     path var/log/z3.log
  29     formatter zope.exceptions.log.Formatter
  30   </logfile>
  31 
  32   <logfile>
  33     path STDOUT
  34     formatter zope.exceptions.log.Formatter
  35   </logfile>
  36 </eventlog>

В файле zope.conf указывается главный загружаемый ZCML файл (определения сайта). Все пути указываются относительно папки верхнего уровня, где находится файл настроек PasteDeploy.

Определение сайта

BlueBream использует ZCML для индивидуальной конфигурации приложения. ZCML - XML-ный декларативный язык настроек. Как вы только что видели в файле zope.conf, главный файл настроек размещается в файле etc/site.zcml. Вот стандартный листинг:

   1 <configure
   2    xmlns="http://namespaces.zope.org/zope"
   3    xmlns:browser="http://namespaces.zope.org/browser">
   4 
   5   <include package="zope.component" file="meta.zcml" />
   6   <include package="zope.security" file="meta.zcml" />
   7   <include package="zope.publisher" file="meta.zcml" />
   8   <include package="zope.i18n" file="meta.zcml" />
   9   <include package="zope.browserresource" file="meta.zcml" />
  10   <include package="zope.browsermenu" file="meta.zcml" />
  11   <include package="zope.browserpage" file="meta.zcml" />
  12   <include package="zope.securitypolicy" file="meta.zcml" />
  13   <include package="zope.principalregistry" file="meta.zcml" />
  14   <include package="zope.app.publication" file="meta.zcml" />
  15   <include package="zope.app.form.browser" file="meta.zcml" />
  16   <include package="zope.app.container.browser" file="meta.zcml" />
  17   <include package="zope.app.pagetemplate" file="meta.zcml" />
  18   <include package="zope.app.publisher.xmlrpc" file="meta.zcml" />
  19 
  20   <include package="zope.browserresource" />
  21   <include package="zope.copypastemove" />
  22   <include package="zope.publisher" />
  23   <include package="zope.component" />
  24   <include package="zope.traversing" />
  25   <include package="zope.site" />
  26   <include package="zope.annotation" />
  27   <include package="zope.container" />
  28   <include package="zope.componentvocabulary" />
  29   <include package="zope.formlib" />
  30   <include package="zope.app.appsetup" />
  31   <include package="zope.app.security" />
  32   <include package="zope.app.publication" />
  33   <include package="zope.app.form.browser" />
  34   <include package="zope.app.basicskin" />
  35   <include package="zope.browsermenu" />
  36   <include package="zope.principalregistry" />
  37   <include package="zope.authentication" />
  38   <include package="zope.securitypolicy" />
  39   <include package="zope.login" />
  40   <include package="zope.session" />
  41   <include package="zope.app.zcmlfiles" file="menus.zcml" />
  42   <include package="zope.app.authentication" />
  43   <include package="zope.app.security.browser" />
  44   <include package="zope.traversing.browser" />
  45   <include package="zope.app.pagetemplate" />
  46   <include package="zope.app.schema" />
  47 
  48   <include package="tc.main" />
  49 
  50 </configure>

Главный файл настроек site.zcml содержит ссылки на другие файлы настроек, индивидуальные для каждого пакета. ZCML включает несколько директив, как include, page, defaultView и т.д., доступные через разные пространства имен XML. В site.zcml по умолчанию пространство имен XML - http://namespaces.zope.org/zope. Если вы взглянете в начало site.zcml, вы увидите ссылку на XML-ное пространство имен:

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

Директива include доступна в пространство именhttp://namespaces.zope.org/zope. Если вы посмотрите другие файлы настроек, вы увидите, что они используют и другие пространства имен, как http://namespaces.zope.org/browser, содрежащие другие директивы, например, page.

В конце site.zcml включены индивидуальные конфигурационные файлы для проекта. Например, следующая директива:

{{{!#highlight xml <include package="tc.main" /> }}}

обеспечит загрузку файла src/tc/collector/configure.zcml.

Вы можете определить общую конфигурацию всего приложения в site.zcml. Содержимое файла src/tc/collector/configure.zcml примерно следующее:

   1 <configure
   2    xmlns="http://namespaces.zope.org/zope"
   3    xmlns:browser="http://namespaces.zope.org/browser"
   4    i18n_domain="ticketcollector">
   5 
   6   <include file="securitypolicy.zcml" />
   7 
   8   <!-- The following registration (defaultView) register 'index' as
   9        the default view for a container.  The name of default view
  10        can be changed to a different value, for example, 'index.html'.
  11        More details about defaultView registration is available here:
  12        http://bluebream.zope.org/doc/1.0/howto/defaultview.html
  13        -->
  14 
  15   <browser:defaultView
  16      for="zope.container.interfaces.IContainer"
  17      name="index"
  18      />
  19 
  20   <!-- To remove the sample application delete the following line
  21        and remove the `welcome` folder from this directory.
  22        -->
  23   <include package=".welcome" />
  24 
  25 </configure>

Файл securitypolicy.zcml содержит определение политик безопасности. Как видно из создержимого файла configure.zcml, он подключает пакет welcome. По умолчанию, если вы подключаете пакет, и я вно не указываете имя файла настроек, он подключит configure.zcml.

Метаданные пакета

BlueBream использует Setuptools для создания дистрибутива приложения, но вы можете легко заменить его на Distribute.

Файл setup.py для вашего пакета ticketcollector будет иметь следующий вид:

   1 from setuptools import setup, find_packages
   2 
   3 setup(name='ticketcollector',
   4       version='0.1',
   5       description='Ticket Collector',
   6       long_description="""\
   7 A ticket collector application""",
   8       # Get strings from http://www.python.org/pypi?%3Aaction=list_classifiers
   9       classifiers=[],
  10       keywords='',
  11       author='Baiju M',
  12       author_email='baiju@example.com',
  13       url='',
  14       license='ZPL',
  15       package_dir={'': 'src'},
  16       packages=find_packages('src'),
  17       namespace_packages=['tc',],
  18       include_package_data=True,
  19       zip_safe=False,
  20       install_requires=['setuptools',
  21                         'zope.securitypolicy',
  22                         'zope.component',
  23                         'zope.annotation',
  24                         'zope.app.dependable',
  25                         'zope.app.appsetup',
  26                         'zope.app.content',
  27                         'zope.publisher',
  28                         'zope.app.broken',
  29                         'zope.app.component',
  30                         'zope.app.generations',
  31                         'zope.app.error',
  32                         'zope.app.interface',
  33                         'zope.app.publisher',
  34                         'zope.app.security',
  35                         'zope.app.form',
  36                         'zope.app.i18n',
  37                         'zope.app.locales',
  38                         'zope.app.zopeappgenerations',
  39                         'zope.app.principalannotation',
  40                         'zope.app.basicskin',
  41                         'zope.app.rotterdam',
  42                         'zope.app.folder',
  43                         'zope.app.wsgi',
  44                         'zope.formlib',
  45                         'zope.i18n',
  46                         'zope.app.pagetemplate',
  47                         'zope.app.schema',
  48                         'zope.app.container',
  49                         'zope.app.debug',
  50                         'z3c.testsetup',
  51                         'zope.app.testing',
  52                         'zope.testbrowser',
  53                         'zope.login',
  54                         'zope.app.zcmlfiles',
  55                         ],
  56       entry_points = """
  57       [paste.app_factory]
  58       main = tc.main.startup:application_factory
  59 
  60       [paste.global_paster_command]
  61       shell = tc.main.debug:Shell
  62       """,
  63       )

Большинство данных в файле setup.py получено при вводе данных во время создания проекта по шаблону. Ключевой аргумент install_requires, который содержит список всех зависимостей пакета. Существует две точки входа. Первая используется в PasteDeploy для поиска фабрики WSGI приложения, а вторая регистрирует команду скрипта paster с именем shell.

Запуск тестов

BlueBream использует zope.testing в качестве главного фреймворка для автоматизованного тестирования. Вместе с zope.testing можно также использовать модули unittest и doctest, которые входят в стандратную библиотеку языка Python. Также есть модуль zope.testbrowser, который используется для функционального тестирования. Для настройки тестов, слоев, и т.д. BlueBream использует пакет z3c.testsetup.

BlueBream использует рецепт системы Buildout - zc.recipe.testrunner для генерации скрипта запуска.

Если вы посмотрите на конфигурацию сборщика, то увидите там часть, отвечающую за настрйку запуска тестов:

{{{!#highlight ini [test] recipe = zc.recipe.testrunner eggs = ticketcollector }}}

Рецепт testrunner создает скрипт запуска тестов на основе модуля zope.testing. Единственная необязательная опция - eggs, в которой приводится список необходимых яиц.

Для запуска всех тестов используется команда bin/test:

   1 jack@computer:/projects/ticketcollector$ bin/test

Эта команда отыщет все тесты и выполнит их.

Создание объекта приложения

Контейнеры

В этом разделе мы рассмострим одну из основных концепций BlueBream - контейнеры. Как упоминалось раньше, BlueBream использует объектную базу данных ZODB для хранения объектов. Представьте себе ее как контейнер для хранения объектов; внутренний объект этого контейнера может служить контейнером для других объектов, и так далее.

Иерархию объектов можна представить следующим образом:

+-----------------------+
|                       |
|   +---------+  +--+   |
|   |         |  +--+   |
|   |  +--+   |         |
|   |  +--+   |         |
|   +---------+    +--+ |
|                  +--+ |
+-----------------------+

BlueBream позаботится о персистентности объектов. Для того, чтобы сделать объект персистентным, его нужно пронаследовать от persistent.Persistent.

Вот некоторые классы в BlueBream, которые наследуются от persistent.Persistent:

• zope.container.btree.BTreeContainer
• zope.container.folder.Folder
• zope.site.folder.Folder

Если вы пронаследуетесь от любого из этих классов, экземпляр важего класса будет персистентным. Вторая вещь, которую вам необходимо сделать, чтобы сделать объект персистентным - добавить его в существующий контейнер. Вы можете проекспериментировать, используя отладочную оболочку BlueBream. Но перед этим, создайте класс контейнера где-нибудь в коде, и проимпортируйте его. Вы можете добавить это определения контейнера в файл src/tc/collector/init.py (удалите этот код после экспериментов):

   1 from zope.container.btree import BTreeContainer
   2 
   3 class MyContainer(BTreeContainer):
   4     pass

Теперь откройте отладочную оболочку, как показано ниже:

   1 $ ./bin/paster shell debug.ini
   2 ...
   3 
   4 Welcome to the interactive debug prompt.
   5 The 'root' variable contains the ZODB root folder.
   6 The 'app' variable contains the Debugger, 'app.publish(path)' simulates a request.
   7 >>>

Название root обозначает корень дерева объектов базы данных (контейнер верхнего уровня). Проимпортируйте ваш собственный класс, создайте его экземпляр, и добавльте его в корневую папку:

   1 >>> from tc.main import MyContainer
   2 >>> root['c1'] = MyContainer()

ZODB - транзакционная база данных, так что после внесения изменений, вам придется их зафиксировать (commit). Для того, чтобы зафиксировать (commit) изменения используйте функцию transaction.commit, как показано ниже:

   1 >>> import transaction
   2 >>> transaction.commit()

Теперь, когда вы покинете отладочную оболочку, и откроее ее снова, вы увидите, что можете получить доступ к персистентному объекту:

   1 $ ./bin/paster shell debug.ini
   2 ...
   3 Welcome to the interactive debug prompt.
   4 The 'root' variable contains the ZODB root folder.
   5 The 'app' variable contains the Debugger, 'app.publish(path)' simulates a request.
   6 >>> root['c1']
   7 <tc.main.MyContainer object at 0x96091ac>

Делать такие случайные объекты персистентными - не очень хорошая идея. Следующий раздел объяснит, как создавать формальную схему объектов. Теперь вы можете удалить объект из базы, а определение класса MyContainer из файла src/tc/collector/init.py. Вы можете удалить объект так:

   1 >>> del(root['c1'])
   2 >>> import transaction
   3 >>> transaction.commit()

Объявление интерфейса

В качестве первого шага по созданию главного контейнера приложения, который будет хранить все другие объекты, вам следует создать его интерфейс. Давайте назовем его ICollector. Для того, чтобы указать интерфейсу описывать контейнер, необходимо пронаследованть его от zope.container.interfaces.IContainer или любого другого интерфейса, который от него наследуется. Также в главный контейнер приложения рекомендуется добавлять менеджер сайта. Для того, чтобы позже добавить менеджер сайта, рекомендуется пронаследоваться от интерфейса zope.site.interfaces.IFolder. IFolder наследуется от IContainer.

Давайте создадим новый пакет Python с именем collector в src/tc:

   1 $ mkdir src/tc/collector
   2 $ echo "# Python Package" > src/tc/collector/__init__.py

Теперь можно создать файл src/tc/collector/interfaces.py, который будет хранить наши интерфейсы:

   1 from zope.site.interfaces import IFolder
   2 from zope.schema import TextLine
   3 from zope.schema import Text
   4 
   5 class ICollector(IFolder):
   6     """The main application container"""
   7 
   8     name = TextLine(
   9         title=u"Name",
  10         description=u"Name of application container",
  11         default=u"",
  12         required=True)
  13 
  14     description = Text(
  15         title=u"Description",
  16         description=u"Description of application container",
  17         default=u"",
  18         required=False)

Определенный здесь интерфейс - это схема для главного объекта приложения. В схеме определены два поля: name и description. Эта схема позже может быть использована для автоматической генерации веб форм.

Реализация интерфейса

Схема может быть описана как план ваших объектов, так как определяет поля, которые объект должен реализовать, и действия, которые он должен выполнять. После этого, вы можете создавать конкретные классы, которые реализуют вашу схему.

Дальше вам нужно релизовать описанный интерфейс. Для реализации IContainer, вы можете пронаследоваться от zope.site.folder.Folder. Вы можете создать реализацию в src/tc/collector/ticketcollector.py:

   1 from zope.interface import implements
   2 from zope.site.folder import Folder
   3 
   4 from tc.collector.interfaces import ICollector
   5 
   6 class Collector(Folder):
   7     """A simple implementation of a collector using B-Tree
   8     Container."""
   9 
  10     implements(ICollector)
  11 
  12     name = u""
  13     description = u""

Для того, чтобы объявить, что класс реализует некий интерфейс, вы можете использовать функцию implements из пакета zope.interface.

Регистрация компонентов

Когда интерфейсы и их реализации готовы, нужно выполнить их настройку в ZCML. Откройте файл src/tc/collector/configure.zcml в режжиме редактирвоания и введите следующее для регистрации интерфейса ICollector как компонента содержимого:

   1 <configure
   2    xmlns="http://namespaces.zope.org/zope"
   3    xmlns:browser="http://namespaces.zope.org/browser">
   4 
   5 <interface
   6    interface="tc.collector.interfaces.ICollector"
   7    type="zope.app.content.interfaces.IContentType"
   8    />
   9 
  10 </configure>

zope.app.content.interfaces.IContentType представляет контент-тип. Если интерфейс предоставляет тип интерфейса IContentType, то все объекты, которые предоставляют этот интерфейс считаются контент-объектами.

Для установки аннотаций для объектов коллектора нам нужно указать, что он реализует интерфейс zope.annotation.interfaces.IAttributeAnnotatable. Пример конфигурации ниже также объявляет, что наш класс Collector реализует интерфейс zope.container.interfaces.IContentContainer. Эти два класса - примеры интерфейсов-маркеров (marker interfaces), то есть интерфейсов, которые обозначают, что объект принадлежит к специальному типу. Преимущество в том, что для этого не вводятся никакие дополнительные атрибуты или методы.

В этом же файле (src/tc/collector/configure.zcml) перед директивой </configure> добавьте следующие строки:

   1 <class class="tc.collector.ticketcollector.Collector">
   2   <implements
   3      interface="zope.annotation.interfaces.IAttributeAnnotatable"
   4      />
   5   <implements
   6      interface="zope.container.interfaces.IContentContainer"
   7      />
   8   <require
   9      permission="zope.Public"
  10      interface="tc.collector.interfaces.ICollector"
  11      />
  12   <require
  13      permission="zope.Public"
  14      set_schema="tc.collector.interfaces.ICollector"
  15      />
  16 </class>

Директива class - это комплексная директива, то есть может содержать поддирективы, такие как implements и require. Директива class также содержит настройки прав доступа к экземплярам класса Collector.

Вид для добавления коллекторов

Теперь содержимое компонента готово к использованию, но здесь нужна также веб страница, которая позволить добавить объект коллектор заявок. Для создания формы вы можете использовать пакет zope.formlib. Для этого нужно добавить определение класса в файл src/tc/collector/views.py следующим образом:

   1 from zope.site import LocalSiteManager
   2 from zope.formlib import form
   3 
   4 from tc.collector.interfaces import ICollector
   5 
   6 from tc.collector.ticketcollector import Collector
   7 
   8 class AddTicketCollector(form.AddForm):
   9 
  10     form_fields = form.Fields(ICollector)
  11 
  12     def createAndAdd(self, data):
  13         name = data['name']
  14         description = data.get('description', u'')
  15         collector = Collector()
  16         collector.name = name
  17         collector.description = description
  18         self.context[name] = collector
  19         collector.setSiteManager(LocalSiteManager(collector))
  20         self.request.response.redirect(".")

Функция createAndAdd будет вызвана, когда пользователь нажмет кнопку Add в веб форме. Последняя строчка сзади очень важная:

   1 collector.setSiteManager(LocalSiteManager(collector))

Эта строчка добавляет менеджер сайта в коллектор с тем, чтобы использовать его как локальный реестр компонентов, таких как, например, локальные утилиты.

Как вы уже успели увидеть в предыдущем разделе директива browser:page используется для регистрации страницы. Вы можете использовать имя add_ticket_collector, чтобы зарегистрировать ее на интерфейс zope.site.interfaces.IRootFolder. Добавьте эти строчки в файл src/tc/collector/configure.zcml:

   1 <browser:page
   2    for="zope.site.interfaces.IRootFolder"
   3    name="add_ticket_collector"
   4    permission="zope.Public"
   5    class="tc.collector.views.AddTicketCollector"
   6    />

Разработка пакета теперь закончена, но он еще не подключен из главного пакета. Для того, чтобы включить этот пакет в главный (tc.main), вам следует изменить файл src/tc/main/configure.zcml, добавив эту строчку перед </configure>:

   1 <include package="tc.collector" />

Для добавления коллектора заявок сначала необходимо войти в сайт используя логин форму: http://localhost:8080/@@login.html. Вы можете предоставить данные удостоверения, которые присутствуют в файле src/tc/main/securitypolicy.zcml:

   1 <principal
   2    id="zope.manager"
   3    title="Manager"
   4    login="admin"
   5    password="admin"
   6    password_manager="Plain Text"
   7    />

По умолчанию имя пользователя и пароль - admin, admin. Вам следует изменить их на другие. После успешного входа, перейдите по ссылке: http://localhost:8080/@@add_ticket_collector. Вы должны увидеть форму, в кторой можно ввести данные для полей name и description. Введите в поле имя значение mycollector. После ввода данных, отправьте форму.

Вы можете увидеть, что размер файла var/filestorage/Data.fs растет с добавлением объектов. Data.fs - файл, в котором физиически хранятся персистентные объекты.

Вы также можете кдостоверится, что объект действительно сохранен в базе данных через оболочку Python. Если вы войдете в оболочку Python и попытаетесь получить доступ к корневому объекту, то увидите что в нем есть вами добавленный объект:

   1 jack@computer:/projects/ticketcollector$ ./bin/paster shell debug.ini
   2 ...
   3 Welcome to the interactive debug prompt.
   4 The 'root' variable contains the ZODB root folder.
   5 The 'app' variable contains the Debugger, 'app.publish(path)' simulates a request.
   6 >>> list(root.keys())
   7 [u'mycollector']

Через отладочную оболочку вы можете просматривать, добавлять, обновлять или удалять Python объекты или атрибуты.

Вид по умолчанию для коллектора

Если вы попытаетесь получить доступ к коллектору по ссылке http://localhost:8080/mycollector, то получите ошибку NotFound, примерно следующего содержания:

URL: http://localhost:8080/mycollector
...
NotFound: Object: <tc.collector.ticketcollector.Collector object at 0x9fe44ac>, name: u'@@index'

Эта ошибка возникает, потому что нет вида с именем index, зарегистрированного на интерфейс ICollector. Этот раздел покажет вам, как создать вид по умолчанию для интерфейсв ICollector.

Как вы уже увидели в разделе Первые шаги, вы можете создать простой вид и зарегистрировать его в ZCML.

В файле src/tc/collector/views.py добавьте новый вид:

   1 class TicketCollectorMainView(form.DisplayForm):
   2 
   3     def __call__(self):
   4         return "Hello ticket collector!"

Потом добавьте следующее в src/tc/collector/configure.zcml:

<browser:page
   for="tc.collector.interfaces.ICollector"
   name="index"
   permission="zope.Public"
   class="tc.collector.views.TicketCollectorMainView"
   />

Теперь пройдите по ссылке http://localhost:8080/mycollector. Вы должны увидет следующее:

Hello ticket collector!

В следующем разделе вы получите информацию о главной странице для коллектора, а также об использовании шаблонов страниц Zope (Zope Page Templates).

Создание главной страницы

Страница браузера

Страница браузера может быть создана с использованием шаблона. form.DisplayForm поддерживает атрибуты template и form_fields. Вы также можете убрать метод call из TicketCollectorMainView. Обновите класс TicketCollectorMainView в файле src/tc/collector/views.py до следующего вида:

from zope.browserpage import ViewPageTemplateFile

class TicketCollectorMainView(form.DisplayForm):

    form_fields = form.Fields(ICollector)

    template = ViewPageTemplateFile("collectormain.pt")

Вы можете создать src/tc/collector/collectormain.pt со следующим содержимым:

   1 <html>
   2 <head>
   3 <title>Welcome to ticket collector!</title>
   4 </head>
   5 <body>
   6 
   7 Welcome to ticket collector!
   8 
   9 </body>
  10 </html>

Теперь перейдите по ссылке http://localhost:8080/mycollector. Вы должны увидеть

   1 Welcome to ticket collector!.

Перевод: Ростислав Дзинько

Данная страница находится в процессе перевода ...