Pyramid

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

- Add ``keys``, ``items``, and ``values`` methods to
``testing.DummyModel``.

- Add __delitem__ method to ``testing.DummyModel``.

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

- Fix ModelGraphTraverser; don't try to change the ``__name__`` or
``__parent__`` of an object that claims it implements ILocation during
traversal even if the ``__name__`` or ``__parent__`` of the object
traversed does not match the name used in the traversal step or the or
the traversal parent . Rationale: it was insane to do so. This bug was
only found due to a misconfiguration in an application that mistakenly
had intermediate persistent non-ILocation objects; traversal was causing
a persistent write on every request under this setup.

- ``repoze.bfg.location.locate`` now unconditionally sets ``__name__`` and
``__parent__`` on objects which provide ILocation (it previously only set
them conditionally if they didn't match attributes already present on the
object via equality).

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

- Add chameleon text template API (chameleon ${name} renderings where the
template does not need to be wrapped in any containing XML).

- Change docs to explain install in terms of a virtualenv
(unconditionally).

- Make pushpage decorator compatible with repoze.bfg.convention's
``bfg_view`` decorator when they're stacked.

- Add content_length attribute to testing.DummyRequest.

- Change paster template ``tests.py`` to include a true unit test. Retain
old test as an integration test. Update documentation.

- Document view registrations against classes and ``repoze.bfg.convention``
in context.

- Change the default paster template to register its single view against a
class rather than an interface.

- Document adding a request type interface to the request via a subscriber
function in the events narrative documentation.

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

Backwards Incompatibilities
---------------------------

- ``repoze.bfg.traversal.model_url`` now always appends a slash to all
generated URLs unless further elements are passed in as the third and
following arguments. Rationale: views often use ``model_url`` without
the third-and-following arguments in order to generate a URL for a model
in order to point at the default view of a model. The URL that points to
the default view of the *root* model is technically ``http://mysite/`` as
opposed to ``http://mysite`` (browsers happen to ask for '/' implicitly
in the GET request). Because URLs are never automatically generated for
anything *except* models by ``model_url``, and because the root model is
not really special, we continue this pattern. The impact of this change
is minimal (at most you will have too many slashes in your URL, which BFG
deals with gracefully anyway).

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

Features
--------

- Allow ``testing.registerEventListener`` to be used with Zope 3 style
"object events" (subscribers accept more than a single event argument).
We extend the list with the arguments, rather than append.

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

Bug Fixes
---------

- The ``model_path`` and ``model_url`` traversal APIs returned the wrong
value for the root object (e.g. ``model_path`` returned ``''`` for the
root object, while it should have been returning ``'/'``).