Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Generate programming code from template files

Project description

Templaty

Documentation Status

Templaty is a code generator written in Python that focuses on generating correct and readable programming code. It features fine-grained control over whitespacing and indentation and a rich meta-language that allows full control over the end result.

🌈 There now is a syntax plugin for Vim!

The template syntax was inspired by Jinja2 and should be very easy to pick up.

def annoying_prompt():
    {% for i in range(0, 5) %}
      prompt("Hey, how you're doing?")
    {% endfor %}

Generates the following code:

def annoying_prompt():
    prompt("Hey, how you're doing?")
    prompt("Hey, how you're doing?")
    prompt("Hey, how you're doing?")
    prompt("Hey, how you're doing?")
    prompt("Hey, how you're doing?")

What about generating an identity matrix in C that imposes no runtime cost?

static const int IDENTITY_MATRIX[][] = [
  {% join i in range(0, 10) with ',' %}
    [{% join j in range(0, 10) with ',' %}{% if j == i %}1{% else %}0{% endjoin %}]
  {% endjoin %}
];

It should look something like this:

static const int IDENTITY_MATRIX[][] = [
  [1,0,0,0,0,0,0,0,0,0],
  [0,1,0,0,0,0,0,0,0,0],
  [0,0,1,0,0,0,0,0,0,0],
  [0,0,0,1,0,0,0,0,0,0],
  [0,0,0,0,1,0,0,0,0,0],
  [0,0,0,0,0,1,0,0,0,0],
  [0,0,0,0,0,0,1,0,0,0],
  [0,0,0,0,0,0,0,1,0,0],
  [0,0,0,0,0,0,0,0,1,0],
  [0,0,0,0,0,0,0,0,0,1]
];

This is just the tip of the iceberg of what Templaty can do!

Usage

Templaty is available on PyPi. You can issue the following command to install it:

pip3 install -U --user templaty

This should make the main command templaty available in your terminal.

FAQ

Will this library support Python 2?

No. Python 2 has reached its end-of-life and the organisation recommends everyone to upgrade to Python 3. Porting to Python 2 requires extra work for no good reason.

Is it safe to use this library in my web server?

No, absolutely not! Templaty is a tool meant to be run by developers, not end-users. As such, it has little (if any) security checks. You should never run untrusted input using Templaty, only code you wrote yourself or from a developer you trust.

What extension should I use for my template files?

It is recommended to use the .tply extension so that syntax plugins like vim-templaty automatically set up the right syntax highlighting for you.

If your template contains code in another programming language, simply prefix the default file extension to .tply, e.g. mytemplate.cc.tply.

License

Templaty is licensed under the Apache 2.0 license, in the hope it will help developers write better programs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for templaty, version 1.3.3
Filename, size File type Python version Upload date Hashes
Filename, size templaty-1.3.3.tar.gz (19.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page