Metadata-Version: 1.0
Name: repoze.bfg.jinja2
Version: 0.6
Summary: Jinja2 template bindings for repoze.bfg
Home-page: http://www.repoze.org
Author: Agendaless Consulting
Author-email: repoze-dev@lists.repoze.org
License: BSD-derived (http://www.repoze.org/LICENSE.txt)
Description: ``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 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))
        
        Or::
        
          from repoze.bfg.jinja2 import render_template
          s = render_template('templates/foo.jinja2', foo=1)
          return Response(s)
        
        Or::
        
          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::
        
          @bfg_view(renderer='templates/foo.jinja2')
          def aview(request):
              return {'foo':1}
        
        See the generated ``bfg_jinja2_starter`` paster template for an
        example 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.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 http://bugs.repoze.org to report bugs.  Visit
        http://svn.repoze.org to download development or tagged versions.
        
        
        
        
        Changelog
        =========
        
        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 ez_setup.py 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
          1.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/simple
        
        0.1 (unknown date)
        ------------------
        
        - Initial release.
        
        
        
Keywords: web wsgi zope
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Framework :: BFG
Classifier: License :: Repoze Public License
