slav0nic's blog

Начнёмс с модели, она будет довольно простой (model.py):
Хотя в принципе для подобных задач web.db было бы достаточно.

Code.py изначально имеет примерно такой вид:



Опишу подробно строки.
web.webapi.internalerror = web.debugerror подружает отладчик. таким образом кроме вывода ошибки в консоль, в браузере будет появляться отладочная инфа при возникновении внутренних ошибок.
Строкой ниже заменяем ф-цию отвечающую за ответ на 404 ошибку (страница не найдена) на свою (простой print "<b>404 B] </b>")
В urls описываются соответсвия URL и классов, URL задаётся при помощи регулярных выражений.
Ниже задаётся каталог с шаблонами (шаблоны встроенные), кэширование отключено для возможности разработки без перезагрузки сервера, кстати за это отвечает 3й параметр web.run() - web.reloader (в версии 0.21 он не работает)
Класс index включает в себя всего один метод GET для обработки запросов соответсвующего типа, web.header() позволяет изменить http заголовок на нужным, в нашем случае задаём кодировку. Ниже идут ф-ции получения записей их количества.
web.output служит для выдачи результата клиенту, в принципе во всех примерах используется простой print, по больщому счёту разницы никакой, данная ф-ция лишь добавляет строку (в нашем случаем возвращает темплейт) к ответу сервера и кодирует юникод объекты в utf-8, но имхо так более кошерней смотрится В)).
render.index вызывает темплейт. Темплятор находит в каталоге 'tmpl/' шаблон index.html и передаёт ему заданные параметры.

Рассмотрим непосредственно сам темплейт: Язык довольно прост, все строки питона начинаются с $, для приёма параметров служит ф-ция with (posts, config, entry_count), стоит обратить внимание, что после with должен стоять пробел, иначе парсер ругнётся, также стоит следить за пробелами после : в циклах =\ (на будущее скажу, что парсер реально гавно=), хотя в целом к темплейтам привыкнуть можно). В принципе не сильно радует отсутствие импортов модулей, всё ф-ции необходимо передавать через глобальный свойство global класса Template. Например
чтоб получить доступ к xrange() ф-цие, необходимо добавить в code.py строку web.template.Template.globals['xrange'] = xrange, после чего в шаблонах можно обратиться к ней как $:xrange(), только вот как заюзать эту ф-цию например в цикле for я не вкурил.... ":" говорит о том что метод глобальный, хотя например $:i.entry говорит, что вывод будет осуществяться "так как есть", без прогонки через web.websafe() (эта ф-ция запрещает вывод html, заменяет <> и тп символы).
Также хочу отметить небольшую попу в версии 0.22, unicode объекты не раскодируются в utf-8, поэтому в примере я делал это вручную, в текущей svn версии 0.3 это делается автоматом.
В принципе это наверно всё по темлейтам, думаю добавить нечего) Подробней можно прочесть на офсайте.

Рассмотрим создание и обработку форм на примере добавления записей:

Как я уже говорил в первой заметке web.form довольно удобен и поддерживает валидаторы, с которыми разобрался даже я В)
Добавим 2й класс add_entry, добавим описание формы во view.py (кстати важно чтоб форма была глобальна, и к ней можно было обратиться из метода GET (непосредственного рисования) и POST для обработки и валидации) и шаблон:

1. class add_entry:
2.    
3.     def GET(self):
4.         web.header("Content-Type","text/html; charset=utf-8")
5.         web.output(render.add_entry(view.add_entry_form))
6.  
7.     def POST(self):
8.         web.header("Content-Type","text/html; charset=utf-8")
9.         i = web.input()
10.         v = view.add_entry_form(i)
11.         if v.validates():
12.             web.output("posting...")
13.             model.postEntry((i.login, i.subject, i.tags, web.safemarkdown(i.entry.decode('utf-8'))))
14.             web.output("ok")
15.             web.seeother("/")
16.         else:
17.             web.output(render.add_entry(v))

Метод GET только рисует форму, POST - получает введённые данные через web.input(), получаем объект типа storage(), мы можем получить значение поля login как через i.login, так и через i['login'].value, после чего передаём все введённые данные нашей форме для проверки на валидность, метод validates() говорит нам валидна ли данные, если да - добавляем в базу, перекодируя текст в хтмл, пропуская через markdown (safemarkdown защищает от XSS-уязвимостей и убирает <> и тп, можете глянуть в utils.py). Методweb.seeother() перекидывает на главную страницу, в принципе есть метод web.redirect(), разница лишь в http-ответах (подробности в RFC по HTTP или рассылке по webpy B] )

view.py:

1. from web import form
2.  
3. #форма добавления записи
4. add_entry_form = form.Form(
5.             form.Textbox("login", form.notnull),
6.             form.Textbox("subject", form.notnull),
7.             form.Textbox("tags"),
8.             form.Textarea("entry", form.notnull, rows="30", cols="80" ),
9.         )

Думаю тут всё понятно, form.notnull делает поле обязательным. Также можно задать более серьёзные валидаторы, кому инетерсно глянет на http://web.py/form
add_entry.html:

1. $def with (add_entry_form)
2. <html>
3. <style type="text/css">
4. th { text-align: left; background-color: #EEEEEE; }
5. p.error { background-color: #FFEEEE; }
6. </style>
7.  
8. <form name="main" method="post">
9. $if not add_entry_form.valid:
10.     <p class="error">Incorrect data</p>
11.     $:add_entry_form.render()
12.     <input type="submit" />
13. $else:
14.     $:add_entry_form.render()
15.     <input type="submit" />
16.  
17. </form>
18. </html>

Здесь я реализовал все свои космические знания по web, забабахав CSS =))
В данном темплейте проверяется форма, если она не валидна - выводится мессага "Incorrect data", при этом автоматом справа от невалидного поля появляется надпись Required (надо будет глянуть как его заменить =) )
Вот так это выглядит:


Вот почти и всё что хотелось показать, осталось сделать выборку постов по slug:
Так как описание ulr'a для данной операции имеет вид /view/(.*) то всё что будет передаваться после /view/ необходимо получить и обработать, для этого метод GET имеет такой вид:

1. class view_entry:
2.    
3.     def GET(self, slug):
4.        ...

Все необходимые данные будут заноситься в slug переменную, по которой и будет проходить выборка.

Запущенное на дефолтном серваке всё это дело ест 8.5мб озу

Вот и всё, писал как можно проще, чтоб было понятно начинающим и интересно бывалым =) Надеюсь не зря убил время В) Думаю в это статье мне удалось описать большую часть ф-ций webpy и способов работы с элементарными вещами и показать что web.py максимально прост, но за этой простотой скрывается достаточный функционал, который при желании легко достигается сторонними модулями. Если сравнивать с другими "большими" фреймворками, то webpy мне напоминает pylons, по крайней мере не вижу сложности взять все модули используемые в пилонах и прикрутить к webpy ) Также webpy подойдёт людям, которые не могу найти нормальный фреймворк, но имеют пристрастия к определённым пакетам для работы с формами, темплейтами, БД и вэбом в целом, опять же из-за простоты привязки. webpy не мешает писать и не навязывает свои правила.
Чёт меня в философию потянуло ёптъ... (O_o)

В дальнейшем постараюсь написать про использование cookie, поддержку сессий родную (в web.py 0.3svn)/через flup, поддержку openid посредством модуля weboid , добавление rss и тп.
Надеюсь желание писать не пропадёт ).

PS: под вэб никогда толком не кодил, решил пострадать фигнёй )
Позже напишу пару строк про настройку lighttp + fcgi для этой гадости (хотя там всё стандартно)

Полные исходники можно взять с http://slav0nic.org.ua/static/files/sl_blog.zip