Package: repoze.bfg.jinja2
``repoze.bfg`` bindings for `Jinja2 <http:http://jinja.pocoo.org>`_===================================================================These are bindings for the `Jinja2 templating system`_ for the``repoze.bfg`` web framework.High-Level API--------------The API follows the pattern of the "default" template API for``repoze.bfg``, which includes three functions: ``get_template``,``render_template``, and ``render_template_to_response``.  From withina repoze.bfg view function, you might do::from webob import Responsefrom repoze.bfg.jinja2 import get_templatetemplate = get_template('templates/foo.jinja2')return Response(template.render(foo=1))Or::from repoze.bfg.jinja2 import render_templates = render_template('templates/foo.jinja2', foo=1)return Response(s)Or::from repoze.bfg.jinja2 import render_template_to_responsereturn render_template_to_response('templates/foo.jinja2', foo=1)All of these examples are equivalent.  The first argument passed in toeach of them (representing the template location) can be either a fullsystem file path, or can be a file path relative to the package inwhich the view function is defined (as shown above).``repoze.bfg.jinja2`` can also act as a "renderer" for a view when its``configure.zcml`` file is included within the ``repoze.bfg``application you're developing::@bfg_view(renderer='templates/foo.jinja2')def aview(request):return {'foo':1}See the generated ``bfg_jinja2_starter`` paster template for anexample of using the renderer facility.Installation------------Install using setuptools, e.g. (within a virtualenv)::$ easy_install -i http://dist.repoze.org/bfg/dev/simple repoze.bfg.jinja2Creating a Jinja2 ``repoze.bfg`` Project----------------------------------------After you've got ``repoze.bfg.jinja2`` installed, you can invoke thefollowing command to create a Jinja2-based ``repoze.bfg`` project::$ paster create -t bin/paster create -t bfg_jinja2_starterReporting Bugs / Development Versions-------------------------------------Visit http://bugs.repoze.org to report bugs.  Visithttp://svn.repoze.org to download development or tagged versions.Changelog=========0.6 (2009-11-30)----------------- ``repoze.bfg`` 1.2 compatibility.  This package is no longercompatible with ``repoze.bfg`` 1.1- Take out dependency on private package index in setup.cfg.0.5 (2009-11-09)----------------- ``repoze.bfg`` 1.1 support including renderer support.  Changed``bfg_jinja2_starter`` paster template to generate a view that usesa renderer.- This version is no longer compatible with ``repoze.bfg`` 1.0.X (use0.4 for BFG 1.0.X compatibility).0.4 (2009-11-07)----------------- Respect ``reload_templates`` option in BFG.- Don't require ez_setup.py anymore.- Nosetests no longer does coverage by default.- This will be the last release will be the last release that willoperate under BFG 1.0.  Future versions will operate only under BFG1.1.0.3 (2009-05-03)----------------- Add a paster template for creating a Jinja2-based ``repoze.bfg``project.  (e.g. ``paster create -t bfg_jinja2_starter``).0.2 (2009-05-02)----------------- Point setup.cfg index_url at http://dist.repoze.org/bfg/dev/simple0.1 (unknown date)------------------- Initial release.