diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-06-24 19:41:09 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-06-24 19:41:09 +0000 |
| commit | ea18a50b5e38afdc01748473036988be5289718a (patch) | |
| tree | a5d25e0fcc9054dbf0b816c3a7c2b13e594794c6 /docs/narr/router.rst | |
| parent | 05c02322f5a09c14f49c529d6fd885153e52c66f (diff) | |
| download | pyramid-ea18a50b5e38afdc01748473036988be5289718a.tar.gz pyramid-ea18a50b5e38afdc01748473036988be5289718a.tar.bz2 pyramid-ea18a50b5e38afdc01748473036988be5289718a.zip | |
- ``repoze.bfg`` no longer relies on the Routes package to interpret
URL paths.
Diffstat (limited to 'docs/narr/router.rst')
| -rw-r--r-- | docs/narr/router.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/docs/narr/router.rst b/docs/narr/router.rst index 2bf7f4ca0..a7e19f134 100644 --- a/docs/narr/router.rst +++ b/docs/narr/router.rst @@ -20,23 +20,23 @@ processing? :mod:`repoze.bfg` :term:`router` object. #. To service :term:`url dispatch`, the :mod:`repoze.bfg` - :term:`router` calls a :term:`Routes` "mapper" callable, which acts - as a :term:`root factory`. The job of the mapper is to examine the - ``PATH_INFO`` and other various keys in the environment to - determine whether any user-defined :term:`route` matches the - current WSGI environment. The :term:`router` passes the WSGI - environment as an argument to the mapper. + :term:`router` calls a :term:`URL dispatch` "root factory wrapper" + callable, which acts as a :term:`root factory`. The job of the + mapper is to examine the ``PATH_INFO`` and other various keys in + the environment to determine whether any user-defined :term:`route` + matches the current WSGI environment. The :term:`router` passes + the WSGI environment as an argument to the mapper. #. If any route matches, the WSGI environment is mutated; a ``bfg.routes.route`` key and a ``bfg.routes.matchdict`` are added to the WSGI environment. If a route *doesn't* match, neither of these keys is added to the WSGI environment. -#. Regardless of whether any route matched or not, the Routes mapper - returns a root object. If a particular :term:`route` named a - ``factory`` argument, this factory is used to generate the root - object, otherwise a default :term:`root factory` is used. If a - root factory argument was passed to the +#. Regardless of whether any route matched or not, the :term:`URL + dispatch` mapper returns a root object. If a particular + :term:`route` named a ``factory`` argument, this factory is used to + generate the root object, otherwise a default :term:`root factory` + is used. If a root factory argument was passed to the ``repoze.bfg.router.make_app``, that callable is used to generate the root object. If the root factory argument passed to ``make_app`` is ``None``, a default root factory is used to |
