This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Template Illiterate Engine

What is TIE ?

The TIE library provides a set of classes and utilities to facilitate the definition of very simple, personal template languages.

The library provides a basic substitution engine based on regular expressions, which doesn’t recognize any particular syntax by itself; it’s up to the user to provide it with his own tag patterns as well as their optional, custom behaviour.

TIE also provides simple tools to ease the definition of those custom tags, and aims to allow for easy customisation or extension (either by providing callbacks or by subclassing the provided types).

Do I need it ?

Maybe. Maybe not.

If you need a full-fledged template engine, with lots of features and good performances, then TIE is probably not for you. You’ll be far better off using an already established template language - Quite a lot of them are already part of the python ecosystem and have more than proven themselves. Trying to emulate one of those with TIE might be possible, but will surely prove very cumbersome and inneficient.

On the other hand, TIE might still be overkill if your requirements are very simple. Python’s batteries include a very nice and quite powerful string formatting syntax, and also provides a Template class for slightly more complex operations. Those built-in features might be more than sufficient for what you have in mind. (See for more info on python’s string operations.)

TIE aims to step in when python’s built-in tools might be enough for the job, but become too unwieldy to handle the task in a straight-forward way.


You can install TIE by simply using pip (this is the recomanded way):

pip install tie

If you must, you can also use easy_install:

easy_install tie

Alternativeley, you could also clone the project’s repository and run the setup script:

git clone
cd TIE/
python install

Getting Started

For most basic uses, rendering a template with TIE involves 3 simple steps:

  • Register your tag patterns
  • Wrap your template(s) text in (a) Template object(s)
  • Pass your templates the data they need to render them

A naive exemple could look like this:

>>> import tie
>>> # Register a tag pattern
>>> tie.tag.register("name")
>>> # Instanciate a Template object
>>> my_template = tie.Template("Hello, name!")
>>> # Render it!
>>> res = my_template(name="raphi")
>>> print(res)
Hello, raphi!
>>> res = my_template(name="Darth Vader, lord of the sith")
>>> print(res)
Hello, Darth Vader, lord of the sith!

Read the (still incomplete) Full documentation hosted on readthedocs.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
TIE-0.1.0.tar.gz (18.5 kB) Copy SHA256 Checksum SHA256 Source Jun 30, 2013
TIE-0.1.0.win32.exe (74.8 kB) Copy SHA256 Checksum SHA256 any Windows Installer Jun 30, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting