diff options
| author | Chris McDonough <chrism@plope.com> | 2013-10-02 18:57:17 -0400 |
|---|---|---|
| committer | Chris McDonough <chrism@plope.com> | 2013-10-02 18:57:17 -0400 |
| commit | 61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2 (patch) | |
| tree | 66bb56b03f2df802dd0836d017a59f993bcf86c8 /docs/narr | |
| parent | 79d9d6862ff906aa0bf26968e0ba763c54775b5c (diff) | |
| parent | 96188ac4b74cb1e67cb95afdb9519ecd8934d688 (diff) | |
| download | pyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.tar.gz pyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.tar.bz2 pyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.zip | |
Merge branch 'bertjwregeer-docs/remove_redundant'
Diffstat (limited to 'docs/narr')
| -rw-r--r-- | docs/narr/traversal.rst | 30 |
1 files changed, 5 insertions, 25 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst index a60c5ba56..454bb5620 100644 --- a/docs/narr/traversal.rst +++ b/docs/narr/traversal.rst @@ -146,35 +146,15 @@ refer to a root factory defined in a different module. If no :term:`root factory` is passed to the :app:`Pyramid` :term:`Configurator` constructor, or if the ``root_factory`` value -specified is ``None``, a *default* root factory is used. The default +specified is ``None``, a :term:`default root factory` is used. The default root factory always returns a resource that has no child resources; it is effectively empty. Usually a root factory for a traversal-based application will be more -complicated than the above ``Root`` class; in particular it may be -associated with a database connection or another persistence mechanism. - -.. sidebar:: Emulating the Default Root Factory - - For purposes of understanding the default root factory better, we'll note - that you can emulate the default root factory by using this code as an - explicit root factory in your application setup: - - .. code-block:: python - :linenos: - - class Root(object): - def __init__(self, request): - pass - - config = Configurator(root_factory=Root) - - The default root factory is just a really stupid object that has no - behavior or state. Using :term:`traversal` against an application that - uses the resource tree supplied by the default root resource is not very - interesting, because the default root resource has no children. Its - availability is more useful when you're developing an application using - :term:`URL dispatch`. +complicated than the above ``Root`` class; in particular it may be associated +with a database connection or another persistence mechanism. The above +``Root`` class is analogous to the default root factory present in Pyramid. The +default root factory is very simple and not very useful. .. note:: |
