Backslant – шаблонизатор в стиле slim

в 21:05, , рубрики: AST, jinja2, python, slim, templates

Захотелось мне сделать шаблонизатор, чтобы как slim, теги чтобы автоматом закрывались и прочее. Красиво же так:

html
  head
    title
        - yield "Плюшка!" + " Чашка чаю!"

Но и этого мне мало, хочу чтобы не было своего недоязыка, хочу чтобы просто питоновские конструкции. А кто захочет себе в ногу стрельнуть и бизнес логики в шаблоны навалить, то это проблема начинашек, мне зачем мучаться размазывая код вьюх в папки типа utils, template_tags и прочее?

А и еще можно кстати угореть так уж угореть — а пусть шаблоны через новый механизм импорта в python 3 тянутся. И если надо что-то от другого шаблона себе вставить, то тоже пусть также работает.

А еще, еще пусть каждый шаблон это генератор!

Ну сказано сделано, встречайте github.com/Deepwalker/backslant. Он еще конечно не до конца допилен, но надо получить фидбек.

Итак, попробуем на пять, base.bs:

!doctype/ html
html
head
    title
        " Page Title
body
    h1 {'class': ' '.join(['main', 'content'], 'ng-app': 'Application'}
        " Page Header
    div.content
        - yield from options['content_block']()
    div.footer
        " Backslant © 2015

Что тут у нас — doctype заканчивается на /, значит тег закрывать через </doctype> не надо.

Строки пока начинаются с ", надо допилить грамматику чтобы можно было сразу после тела тега, попозже.

У h1 аргументы передаются обычным python dict, в рамках которого любой код, который можно в объявлении словаря.

Дальше интересное — yield from из вызова некоего content_block, который лежит в каком-то options. Ну что сказать — options это kwargs, так как объявления параметров шаблона у нас тут нет. Может и зря кстати что нет.

Так вот, про content_block — тут мы ожидаем что нам передадут в параметре некий колбек, и считаем что там будет генератор — у нас же все шаблоны генераторы. Вот значит какой-то шаблон захочет использовать наш base.bs, и вызовет его render, и передаст туда колбек.

И это будет index.bs:

- from . import base
:call base.render(*options)
    :content_block
        - for i in range(10):
            p
                - yield 'Paragraph {}'.format(i)
    :footer_block
        p
            " Index page

Тут мы используем немножко сахара вместо того чтобы честно объявить просто функцию и передать её. :call переберет свои дочерние ноды, проверит что все они объявления функций, и засунет их в параметры. А :content_block как раз и объявляет функцию без аргументов с именем content_block, и с этим же именем :call отправит ее в аргументы.
А потом в питоно коде можем использовать:

import backslant
sys.meta_path.insert(0, backslant.PymlFinder('./templates', hook='backslant_import'))
from backslant_import.home import index
for chunk in index.render(title='The Real Thing'):
    print(chunk)

Безумненько. Что добавить по синтаксису — функцию объявить можно, прям - def func(a=True) и прочее. for, if, elif, else — просто чистый питон. Конечно же можно и нужно использовать yield и yield from. Можно импортировать всё что угодно и как угодно использовать.
Из неподдержанного — try: except: .... Текущая версия парсера не очень дружит, надо переделать парсинг.

Что дальше — генератор же. А генератор как известно еще и send умеет, не только next. Правда что из этого можно получить, ну не знаю, можно пофантазировать. Может как-то докармливать данными и отдавать порции на выход.

Скорость — такая же как у jinja2. Можно наверное попробовать как-то разогнать еще, но в основном код состоит из yield и yield from, компилируется через ast, нечего особо оптимизировать.

Так вот. Синтаксис можно еще допилить, внедрить какие-то идеи.

Есть кстати идеи? Давайте обсудим. А пока можно посмотреть на проект, потыркать примеры github.com/Deepwalker/backslant/tree/master/example

Автор: Deepwalker

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js