Pyramid

==================

Features
--------

- A ``repoze.bfg.location`` API module was added.

Backwards incompatibilities
---------------------------

- Applications must now use the ``repoze.bfg.interfaces.ILocation``
interface rather than ``zope.location.interfaces.ILocation`` to
represent that a model object is "location-aware". We've removed
a dependency on ``zope.location`` for cleanliness purposes: as
new versions of zope libraries are released which have improved
dependency information, getting rid of our dependence on
``zope.location`` will prevent a newly installed repoze.bfg
application from requiring the ``zope.security``, egg, which not
truly used at all in a "stock" repoze.bfg setup. These
dependencies are still required by the stack at this time; this
is purely a futureproofing move.

The security and model documentation for previous versions of
``repoze.bfg`` recommended using the
``zope.location.interfaces.ILocation`` interface to represent
that a model object is "location-aware". This documentation has
been changed to reflect that this interface should now be
imported from ``repoze.bfg.interfaces.ILocation`` instead.

==================

Docs
----

- Documented URL dispatch better in narrative form.

Bug fixes
---------

- Routes URL dispatch did not have access to the WSGI environment,
so conditions such as method=GET did not work.

Features
--------

- Add ``principals_allowed_by_permission`` API to security module.

- Replace ``z3c.pt`` support with support for ``chameleon.zpt``.
Chameleon is the new name for the package that used to be named
``z3c.pt``. NOTE: If you update a ``repoze.bfg`` SVN checkout
that you're using for development, you will need to run "setup.py
install" or "setup.py develop" again in order to obtain the
proper Chameleon packages. ``z3c.pt`` is no longer supported by
``repoze.bfg``. All API functions that used to render ``z3c.pt``
templates will work fine with the new packages, and your
templates should render almost identically.

- Add a ``repoze.bfg.chameleon_zpt`` module. This module provides
Chameleon ZPT support.

- Add a ``repoze.bfg.xslt`` module. This module provides XSLT
support.

- Add a ``repoze.bfg.chameleon_genshi`` module. This provides
direct Genshi support, which did not exist previously.

Deprecations
------------

- Importing API functions directly from ``repoze.bfg.template`` is
now deprecated. The ``get_template``, ``render_template``,
``render_template_to_response`` functions should now be imported
from ``repoze.chameleon_zpt``. The ``render_transform``, and
``render_transform_to_response`` functions should now be imported
from ``repoze.bfg.xslt``. The ``repoze.bfg.template`` module
will remain around "forever" to support backwards compatibility.

==================

Features
--------

- Add compatibility with z3c.pt 1.0a7+ (z3c.pt became a namespace package).

Bug fixes
---------

- ``repoze.bfg.traversal.find_model`` function did not function properly.

==================

Features
--------

- Add startup process docs.

- Allow configuration cache to be bypassed by actions which include special
"uncacheable" discriminators (for actions that have variable results).

Bug Fixes
---------

- Move core repoze.bfg ZCML into a ``repoze.bfg.includes`` package so we
can use repoze.bfg better as a namespace package. Adjust the code
generator to use it. We've left around the ``configure.zcml`` in the
repoze.bfg package directly so as not to break older apps.

- When a zcml application registry cache was unpickled, and it contained a
reference to an object that no longer existed (such as a view), bfg would
not start properly.

==================

Features
--------

- Event notification is issued after application is created and configured
(``IWSGIApplicationCreatedEvent``).

- New API module: ``repoze.bfg.view``. This module contains the functions
named ``render_view_to_response``, ``render_view_to_iterable``,
``render_view`` and ``is_response``, which are documented in the API
docs. These features aid programmatic (non-server-driven) view
execution.

==================

Backwards incompatibilities
---------------------------

- Make ``repoze.bfg`` a namespace package so we can allow folks to create
subpackages (e.g. ``repoze.bfg.otherthing``) within separate eggs. This
is a backwards incompatible change which makes it impossible to import
"make_app" and "get_options" from the ``repoze.bfg`` module directly.
This change will break all existing apps generated by the paster code
generator. Instead, you need to import these functions as
``repoze.bfg.router:make_app`` and ``repoze.bfg.registry:get_options``,
respectively. Sorry folks, it has to be done now or never, and
definitely better now.

Features
--------

- Add ``model_path`` API function to traversal module.

Bugfixes

- Normalize path returned by repoze.bfg.caller_path.