Add jinja2 extensions

[jayvdb]

Especially helpful is statement support, aka do

http://jinja.pocoo.org/docs/2.10/extensions/#expression-statement

Loop Controls would also be nice syntax to have available.

https://github.com/duelafn/python-jinja2-apci looks very helpful for debugging, and for intentionally breaking templates when backwards compatibility is not possible.

https://github.com/wewearglasses/jinja2-required-variables-extension looks great for performance improvements.

https://github.com/zehome/jinja2-commentif looks good for adding comments without the hash prefix which is a keyword in jinja2

https://github.com/tlatsas/jinja2-highlight would be great for documentation.

While very basic, it would also by good to add https://pypi.org/project/jinja2-git/ , and add new git based information to that extension.

Likewise https://pypi.org/project/jinja2-github/ and https://github.com/hackebrot/jinja2-time

https://github.com/stanfeldman/compressinja looks interesting.

https://github.com/danielchatfield/jinja2_markdown or https://github.com/nrsimha/jingo-markdown might be better as an optional moban extension.

https://github.com/jpscaletti/jinja-includewith is a nice syntax improvement

Note to self: see if https://github.com/mankyd/jinjatag is still usable.

[jayvdb]

Perhaps we need some way to enable jinja extensions in the moban yaml. That way people can choose which ones they need.

But enabling expression-statement and loop-controls by default seems sensible. Extra features for free.

[jayvdb]

https://pypi.org/project/jinja2-pimport/ exposes all of python to the templates.

https://pypi.org/project/jinja2-python-version/

https://pypi.org/project/Jinja2-template-info/

https://pypi.org/project/jinja2-stringcase/

https://pypi.org/project/jinja2-slug/

https://github.com/sadimusi/jinja2compact

https://github.com/audreyr/jinja2_pluralize

https://pypi.org/project/jinja2modern/

https://github.com/raicheff/jinja2-minify

https://pypi.org/project/jinja2_maps/

https://pypi.org/project/jinja2time/

https://github.com/Lispython/jinja-kit/blob/master/jinja_kit/utils.py - html sanitizer

https://github.com/frascoweb/jinja-macro-tags - better syntax for macro calls

https://github.com/frascoweb/jinja-macro-tags

https://pypi.org/project/typogrify/ or https://github.com/raicheff/jinja2-typogrify helper

https://github.com/mbr/jinja-vanish

[jayvdb]

thanethomson/statik#6 shows jinja extensions being configurably added by a tool with a similar ethos.

[ayan-b]

I was trying to solve the issue. The user adds the required extensions in the yaml or mobanfile, something like:

extensions:
  - jinja2.ext.do
  - jinja2.ext.loopcontrols

And I am passing the list of extensions through BaseEngine, i.e.,
BaseEngine(template_dirs, context_dirs, engine_cls, extensions). But this clearly breaks all the tests which use BaseEngine and thus all of them need to be updated. As can be found from the docs, the extensions need to be passed while declaring the environment. So, I am thinking of passing extensions without breaking BaseEngine.

[chfw]

I am going to enable this extensions syntax.

extensions:
  jinja2:
    - jinja2.ext.do
    - jinja2.ext.loopcontrols
  handlebar:
    - xxx.x..x..
  template_type:
    - ....

[chfw]

@ayan-b can you help contribute some docs for extensions? for it to go out, as my personal convention, it needs some thing like this: docs/level-12-specify-engine-extensions. This doc should be readable and testable. In tests/test_docs.py, there exists all docs test commands.

My extensions work lives in extensions branch

[ayan-b]

@ayan-b can you help contribute some docs for extensions? for it to go out, as my personal convention, it needs some thing like this: docs/level-12-specify-engine-extensions. This doc should be readable and testable. In tests/test_docs.py, there exists all docs test commands.

My extensions work lives in extensions branch

Sure. However, as per #90 (comment) , we should have expression-statement and loopcontrol enabled by default. I can make a PR doing the same. What do you think?