An integrated web templating environment
Project description
Tayra template language is a full-featured abstract markup language used to describe web-documents. It is primarily inspired from mako-templates and HAML (especially the indentation based markup definitions). Although it is young and relatively a new kid among the old-timers, it can be considered as the evolutionary next step for some of them. And probably it is the only templating language that allows developers to build and distribute their templates as plugins, not to mention the fact that tayra’s implementation itself is heavily based on plugins.
You can learn more and hack into its guts at google-code or github
Some interesting features in tayra are,
concise and beautiful syntax.
pluggable tag handlers for custom tag elements.
full programmability available via,
expression substitution.
control-blocks like if-elif-else.
looping contructs like for / while.
python statements.
template abstraction using function blocks, with its own local scope.
import other template scripts into the local namespace and access their functions
template inheritance for re-usable web-layouting.
and unique ability to create template plugins, distribute them as separate package.
Installation
There are multiple ways to install tayra and the easiest way is by easy_install.
# -Z to do unzipped install. The reason for installing it
# in un-zipped form is to make use of the command line tool.
# -U to upgrade install
easy_install -Z -U tayraInstall from source code,
You can obtain the source code by, downloading the latest tar.gz or cloning from mercurial repositories.
hg clone https://code.google.com/p/tayra/
# or
hg clone https://bitbucket.org/prataprc/tayraAfter untarring the source package, or cloning the source repository into your local machine, install source package by executing,
> sudo python ./setup.py install
> sudo python ./setup.py develop # to install the development versionCommand line usage
Make sure that tayra package is installed in your environment (using easy_install) or available via PYTHONPATH. tayra/tyr.py script under tayra-package can be used as command line tool. Either invoke it from its original path, or create a symbolic link to a bin/ directory.
script-file: <site-package>/tayra/tyr.py
symbolic link to your binary path, like,
ln -s <site-package>/tayra/tyr.py $(HOME)/bin/tyr.py
# or,
ln -s <site-package>/tayra/tyr.py /usr/bin/tyr.pyOnce tyr.py is available as an executable command and tayra module in your python path, use the command-line tool, like,
# A corresponding .html file will be generated in the same directory
tyr.py <template-file>
# For more help, try
tyr.py -hUsing it as python library
pa = Pluggdapps.boot( None )
compiler = pa.query_plugin( pa, ISettings, 'ttlcompiler' )
# Compile
code = compiler.compilettl( file=ttlfile )
# Load
module = compiler.load( code, context=context )
# Generate
html = compiler.generatehtml( module, context )Development
It is always better to setup the development tree under a virtual environemnt. To begin with, first checkout the source tree from the latest repository tree and then use the make command to create a development environment.
cd tayra
make developwhich,
sets-up a virtual environment under tayra-env/ directory.
Installs tayra under the virtual environment in development mode python ./setup.py develop
source ./tayra-env/bin/activate # To start using the tayra package
make bdist_egg # For creating binary distribution
make sdist # For creating source distribution
make test # To test the package
make upload # To build the egg and upload it into pypiThe .egg package will be availabe under dist/ directory
If you enable [‘beautify_html’] option, you will have to install beautifulsoup4 package.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
