Jinja2 templates for whole directories / multiple files.
pip3 install mondirFiles in the input template directory can use both normal Jinja syntax and syntax extensions introduced by Mondir. File and directory names can contain Jinja syntax, too.
For instance, to output a file for each entry in a list of names, you could
place a file named greeting-for-{{ name }}.txt in a directory and fill it
with:
{% thisfile for name in names -%}
Hello {{ name }}!Templating this out is as simple as this:
from mondir import DirTemplate
template = DirTemplate("template_input_dir")
template.render("output_dir", names=["John", "Jane", "Alice", "Bob"])A full tutorial is available in the docs.
- dirtempl: Same idea as this one, but doesn't support Jinja2 template syntax.
- dirtemplate: Also the same idea and also uses Jinja2. But I only found out about it after I wrote mine and now the sunk cost fallacy compels me to stick with it no matter what.
- yamldirs creates whole directories from
YAML specs. While working on Mondir, I considered having a similar file
format as an intermediate step between the templates and the final output
(which would have made a couple of things easier to implement and would have
had the benefit of making the output of Jinja's regular
render()meaningful), but dropped the idea over performance concerns.
Given that the obvious names from the "Similar projects" section were taken and my working title (fisyte, for filesystem templates) sounded dumb, I stole how Jinja got its name, i.e. by using a word that means temple (because that sounds a bit like template) in another language. The first translation of temple on Wiktionary that also contains the fragment dir (for directory) is the Bengali word mondir. So that's it.
DirTemplate.render()now raises newly introduced exceptionsTemplateLoadingError,TemplateRenderingError, andTemplateOutputErrorinstead of merely passing along exceptions from Jinja/Python'sos, allowing users to see which files/params were responsible.