From 916f88578ad68470a35a4b7afd223e9dbf5fd20d Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Mon, 18 May 2009 07:07:12 +0000 Subject: Features -------- - Added a ``traverse`` function to the ``repoze.bfg.traversal`` module. This function may be used to retrieve certain values computed during path resolution. See the Traversal API chapter of the documentation for more information about this function. Deprecations ------------ - Internal: ``ITraverser`` callables should now return a dictionary rather than a tuple. Up until 0.7.0, all ITraversers were assumed to return a 3-tuple. In 0.7.1, ITraversers were assumed to return a 6-tuple. As (by evidence) it's likely we'll need to add further information to the return value of an ITraverser callable, 0.8 assumes that an ITraverser return a dictionary with certain elements in it. See the ``repoze.bfg.interfaces.ITraverser`` interface for the list of keys that should be present in the dictionary. ``ITraversers`` which return tuples will still work, although a deprecation warning will be issued. Backwards Incompatibilities --------------------------- - If your code used the ITraverser interface directly (not via an API function such as ``find_model``) via an adapter lookup, you'll need to change your code to expect a dictionary rather than a 3- or 6-tuple if your code ever gets return values from the default ModelGraphTraverser or RoutesModelTraverser adapters. --- repoze/bfg/urldispatch.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'repoze/bfg/urldispatch.py') diff --git a/repoze/bfg/urldispatch.py b/repoze/bfg/urldispatch.py index 4c3bc2ed3..3e60c0ba5 100644 --- a/repoze/bfg/urldispatch.py +++ b/repoze/bfg/urldispatch.py @@ -154,7 +154,9 @@ class RoutesModelTraverser(object): if environ['SCRIPT_NAME'].endswith('/'): environ['SCRIPT_NAME'] = environ['SCRIPT_NAME'][:-1] - return self.context, route.name, subpath, None, self.context, None + return dict(context=self.context, view_name=route.name, + subpath=subpath, traversed=None, virtual_root=self.context, + virtual_root_path=None, root=self.context) class RoutesContextURL(object): """ The IContextURL adapter used to generate URLs for a context -- cgit v1.2.3