diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-05-27 21:51:00 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-05-27 21:51:00 +0000 |
| commit | cca321bd168286583535f54673ae9b81e028c6f1 (patch) | |
| tree | c5524262725bf640c25a2924a7b1e3a33fd261e8 /docs/narr/traversal.rst | |
| parent | 64b2942bfe6431e97fc41fd2fadd26c87ac67a5a (diff) | |
| download | pyramid-cca321bd168286583535f54673ae9b81e028c6f1.tar.gz pyramid-cca321bd168286583535f54673ae9b81e028c6f1.tar.bz2 pyramid-cca321bd168286583535f54673ae9b81e028c6f1.zip | |
Rendering.
Diffstat (limited to 'docs/narr/traversal.rst')
| -rw-r--r-- | docs/narr/traversal.rst | 40 |
1 files changed, 20 insertions, 20 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst index b8076368a..76823041a 100644 --- a/docs/narr/traversal.rst +++ b/docs/narr/traversal.rst @@ -185,22 +185,22 @@ traversing the follwing graph:: Here's what happens: - - bfg traverses the root, and attempts to find foo, which it finds. +- bfg traverses the root, and attempts to find foo, which it finds. - - bfg traverses foo, and attempts to find bar, which it finds. +- bfg traverses foo, and attempts to find bar, which it finds. - - bfg traverses bar, and attempts to find baz, which it does not - find ('bar' raises a ``KeyError`` when asked for baz). +- bfg traverses bar, and attempts to find baz, which it does not + find ('bar' raises a ``KeyError`` when asked for baz). The fact that it does not find "baz" at this point does not signify an error condition. It signifies that: - - the "context" is bar (the context is the last item found during - traversal). +- the "context" is bar (the context is the last item found during + traversal). - - the "view name" is ``baz`` +- the "view name" is ``baz`` - - the "subpath" is ``['biz', 'buz.txt']`` +- the "subpath" is ``['biz', 'buz.txt']`` Because it's the "context", bfg examimes "bar" to find out what "type" it is. Let's say it finds that the context is an ``IBar`` type @@ -211,8 +211,8 @@ Using the "view name" ("baz") and the type, it asks the :term:`application registry` (configured separately, via ``configure.zcml``) this question: - - Please find me a :term:`view` with the name "baz" that can be used - for the type ``IBar``. +- Please find me a :term:`view` with the name "baz" that can be used + for the type ``IBar``. Let's say it finds no matching view type. It then returns a ``NotFound``. The request ends. Everyone is sad. @@ -231,23 +231,23 @@ But! For this graph:: The user asks for ``http://example.com/foo/bar/baz/biz/buz.txt`` - - bfg traverses foo, and attempts to find bar, which it finds. +- bfg traverses foo, and attempts to find bar, which it finds. - - bfg traverses bar, and attempts to find baz, which it finds. +- bfg traverses bar, and attempts to find baz, which it finds. - - bfg traverses baz, and attempts to find biz, which it finds. +- bfg traverses baz, and attempts to find biz, which it finds. - - bfg traverses biz, and attemtps to find "buz.txt" which it does - not find. +- bfg traverses biz, and attemtps to find "buz.txt" which it does + not find. The fact that it does not find "buz.txt" at this point does not signify an error condition. It signifies that: - - the "context" is biz (the context is the last item found during traversal). +- the "context" is biz (the context is the last item found during traversal). - - the "view name" is "buz.txt" +- the "view name" is "buz.txt" - - the "subpath" is the empty list [] +- the "subpath" is the empty list [] Because it's the "context", bfg examimes "biz" to find out what "type" it is. Let's say it finds that the context an ``IBiz`` type (because @@ -257,8 +257,8 @@ indicates it's an ``IBiz``). Using the "view name" ("buz.txt") and the type, it asks the :term:`application registry` this question: - - Please find me a :term:`view` with the name "buz.txt" that can be - used for type ``IBiz``. +- Please find me a :term:`view` with the name "buz.txt" that can be + used for type ``IBiz``. Let's say that question is answered "here you go, here'a a bit of code that is willing to deal with that case", and returns a :term:`view`. |
