Учебник - часть 1
Содержание
Вступление
В главе Первые шаги, был описан процесс установки BlueBream и создания проекта из шбалона bluebream. В этом учебнике, вы научитесь создавать простое приложение ticket collector. Данная серия уроков поможет ближе ознакомится с принципами BlueBream.
Вот несколько функций будущего приложения:
- В один накопитель можно добавить сколько угодно билетов.
- Каждый новый билет должен иметь описание и один начальный комментарий.
- К билету можно добавлять комментарии.
Это первая часть обучения. После завершения этой главы, вы должны уметь:
- Понимать структуру директорий проекта.
- Использовать и настраивать Buildout.
- Создавать контент-объекты (content objects) и интерфейсы.
Использовать инструмент для генерации форм (zope.formlib).
Примеры, которые предлагаются для изучения в документации можно загрузить отсюда. Исходники доступны на разных этапах, соответственно разделам.
- Этап 1 : разделы от 5.2 до 5.7
- Этап 2 : раздел 5.8
- Этап 3 : раздел 5.9
- Этап 4 : раздел 6.2
- Этап 5 : раздел 6.3
Этап 6 : разделы 6.4 & 6.5
Создание нового проекта
Использование шаблона проекта 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
Итак, проект создан. Теперь необходимо произвести следующее:
- 1) положит сгенерированные файлы под контроль версий
2) запустить: python boostrap.py 3) запустить: ./bin/buildout
Как видно из примера выше, мы предоставили почти всю информацию о проекте. Значения, которые были указаны, можно поменять позже. Это сделать очень просто; все, что трудно изменить позже - это имена пакетов, потому что на них позже может быть много ссылок в коде.