Тимофей Перевезенцев. Кухня современных python шаблонизаторов

Современные шаблонизаторыКакие они бывают и почему этого мало.

Перевезенцев Тимофей

май 18, 2010

Виды шаблонизаторов

Текстовые, использующие собственный синтаксис шаблоновI текстовые, которые работают с любым текстом и не имеют

понятия о семантике (jinja2, django, mako, chetah и др.)I с синтаксисом основанным на отступах (haml-подобные, daml,

ghrml)

Использующие обычные python объекты и собственный API (Stan,werkzeug и др.)DOM ориентированные (шаблон - (x)html документ, данныезаносятся с помощью DOM-подобных API из кода)

Перевезенцев Т. () Современные шаблонизаторы май 18, 2010 2 / 28

Текстовые шаблонизаторы, которые работают с любымтекстом и не имеют понятия о семантике

Мы к ним уже привыкли. Верстка пишется как есть, с вкраплениямиспециального синтаксиса шаблона.

мы можем верстать с ошибками (экранирование)мы можем получать невалидную версткупри внесении изменений в уже готовую верстку нужно быть оченьвнимательным


Текстовые шаблонизаторы с синтаксисом основанным наотступах

Явление довольно новое (свежее). Позволяют более тонко наблюдатьи контролировать структуру документа. Т.к. они владеют семантикой,могут быть более умными.

получается еще один язык разметки, который преобразуется вxml, а не текстна практике шаблоны могут быть совершенно непонятнымия не встречал шаблонизатор, который бы пользовался знаниемсемантики (это грустно)


Список требований, с учетом опыта использования

Управление потоком представленияВозможность повторного использованияКонтроль валидности (autoescape, правильная вложенность тегов)Области видимости данных шаблонаКачество диагностики ошибокВозможность использования в тексте символов специальных сточки зрения результатаБыстродействие (всех ли волнует быстродействие?)Тонкий контроль whitespace


Контроль валидности

Автоматическое экранирование выводимых в шаблон данныхдолжно быть включено по умолчаниюЧто бы указать, что данные представляют из себя валиднуюверстку надо каким-то образом пометить объект с данными


Контроль валидности

При этом надо учитывать, что существует несколько контекстов, вкоторых вставляются данные. А именно:

тэгатрибут


Возможность повторного использования

Есть несколько способов повторного применения шаблонов:макрос (включение, include)наследование шаблонов



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



Какой же способ лучше?



Совмещение обеих методик - самый гибкий вариант.


Область видимости данных шаблона

Все данные попадающие в шаблон - глобальные.



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



Давайте признаем, что термин "блок"( {% block content %} ) непригоден! Что это?

блок кодамакрос



{% block content %}{% set a = ’value’ %}{% block inner_block %}

{{ a }}{% endblock %}

{% endblock %}



Правильнее было бы называть - "метод"шаблона. И вызывать метод"как следует": {% self.content() %}



Появляется определенность в терминологииСтановится понятна ситуация с областью видимости



{% def inner_block(a) %}{{ a }}

{% enddef %}

{% def content() %}{% set a = ’value’ %}{{ self.inner_block(a) }}

{% enddef %}

{{ self.content() }}



Вспомагательные (контекстные) переменные в шаблоне - не самыйлучший выбор.

<ul>{% for item in items %}

<li {% if loop.first %}class="first"{% endif %}>{{ item.title }}

</li>{% endfor %}</ul>



<ul>{% for part in parts %}

<li {% if loop.first %}class="first"{% endif %}>{% for item in part %}

{{ loop ??? }}{% endfor %}</li>

{% endfor %}</ul>



Решение очень простое. (Tempita, Ян Бикинг)

<ul>{% for l1, part in looper(parts) %}

<li {% if l1.first %}class="first"{% endif %}>{% for l2, item in looper(part) %}

{{ l1.index }}{{ l2.index }}

{% endfor %}</li>

{% endfor %}</ul>


Качество диагностики ошибок

При возникновении исключений в шаблоне, строка шаблона свызовом повлекшим исключение должна отображаться в стекевызововШаблонизатор не должен маскировать исключения


Делаем свой шаблонизатор

Зачем? Развитие шаблонизаторов остановилось. Почти всепопулярные представители имеют одинаковый синтаксис и подход.При этом никто не хочет учитывать уже накопившийся опыт иэволюционировать.



Для этого нам понадобятся

лексер (токенайзер)парсер



В информатике лексический анализ — процесс аналитическогоразбора входной последовательности символов (например, такой какисходный код на одном из языков программирования) с цельюполучения на выходе последовательности символов, называемых«токенами» (подобно группировке букв в словах). При этом, группасимволов входной последовательности, идентифицируемая на выходепроцесса как токен, называется лексема, то есть в процесселексического анализа производится распознавание и выделение лексемиз входной последовательности символов. wikipedia



В информатике, синтаксический анализ (парсинг) — это процесссопоставления линейной последовательности лексем (слов, токенов)языка с его формальной грамматикой. Результатом обычно являетсядерево разбора (синтаксическое дерево). wikipedia


Встречайте mint

http://github.com/riffm/mint/


Тимофей Перевезенцев. Кухня современных python шаблонизаторов

Technology