Skip to main content

Jinja2 template bindings for repoze.bfg

Project description

``repoze.bfg`` bindings for `Jinja2 <http:>`_

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 within
a repoze.bfg view function, you might do::

from webob import Response

from repoze.bfg.jinja2 import get_template
template = get_template('templates/foo.jinja2')
return Response(template.render(foo=1))


from repoze.bfg.jinja2 import render_template
s = render_template('templates/foo.jinja2', foo=1)
return Response(s)


from repoze.bfg.jinja2 import render_template_to_response
return render_template_to_response('templates/foo.jinja2', foo=1)

All of these examples are equivalent. The first argument passed in to
each of them (representing the template location) can be either a full
system file path, or can be a file path relative to the package in
which 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::

def aview(request):
return {'foo':1}

See the generated ``bfg_jinja2_starter`` paster template for an
example of using the renderer facility.


Install using setuptools, e.g. (within a virtualenv)::

$ easy_install -i repoze.bfg.jinja2

Creating a Jinja2 ``repoze.bfg`` Project

After you've got ``repoze.bfg.jinja2`` installed, you can invoke the
following command to create a Jinja2-based ``repoze.bfg`` project::

$ paster create -t bin/paster create -t bfg_jinja2_starter

Reporting Bugs / Development Versions

Visit to report bugs. Visit to download development or tagged versions.


0.6 (2009-11-30)

- ``repoze.bfg`` 1.2 compatibility. This package is no longer
compatible 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 uses
a renderer.

- This version is no longer compatible with ``repoze.bfg`` 1.0.X (use
0.4 for BFG 1.0.X compatibility).

0.4 (2009-11-07)

- Respect ``reload_templates`` option in BFG.

- Don't require anymore.

- Nosetests no longer does coverage by default.

- This will be the last release will be the last release that will
operate under BFG 1.0. Future versions will operate only under BFG

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

0.1 (unknown date)

- Initial release.

Project details

Download files

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

Source Distribution

repoze.bfg.jinja2-0.6.tar.gz (29.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page