summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMalthe Borch <mborch@gmail.com>2009-10-26 12:27:34 +0000
committerMalthe Borch <mborch@gmail.com>2009-10-26 12:27:34 +0000
commit0d13f6596c2cf38a611183e01a7f73173d5d6faa (patch)
tree91482267042f6403dab57816615e1e35c24b99ce /docs
parent077c3c521b1a3cc3b17449f3360f2a0532d50dc7 (diff)
downloadpyramid-0d13f6596c2cf38a611183e01a7f73173d5d6faa.tar.gz
pyramid-0d13f6596c2cf38a611183e01a7f73173d5d6faa.tar.bz2
pyramid-0d13f6596c2cf38a611183e01a7f73173d5d6faa.zip
The root factory may now return an object which implements ``ITraverser`` directly. In this case, no adaptation is done before traversal. This feature is added such that a routes factory can implement its own traversal logic without establishing an artificial context only to get a hook into the traversal machinery.
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/hooks.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/docs/narr/hooks.rst b/docs/narr/hooks.rst
index d2020af0d..6babeace0 100644
--- a/docs/narr/hooks.rst
+++ b/docs/narr/hooks.rst
@@ -278,6 +278,9 @@ when the application :term:`root factory` returned an instance of the
``myapp.models.MyRoot`` object. Otherwise it would use the default
:mod:`repoze.bfg` traverser to do traversal.
+Note that the root object may itself implement ``ITraverser`` in which
+case adaptation is skipped.
+
Example implementations of alternate traversers can be found "in the
wild" within `repoze.bfg.traversalwrapper
<http://pypi.python.org/pypi/repoze.bfg.traversalwrapper>`_ and