diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/glossary.rst | 5 | ||||
| -rw-r--r-- | docs/narr/project.rst | 18 |
2 files changed, 18 insertions, 5 deletions
diff --git a/docs/glossary.rst b/docs/glossary.rst index 5274ef2de..99c72a5a2 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -24,6 +24,11 @@ The "URL name" of a view, e.g "index.html". If a view is configured without a name, its name is considered to be the empty string (which implies the "default view"). + virtualenv + An isolated Python environment. Allows you to control which + packages are used on a particular project by cloning your main + Python. `virtualenv <http://pypi.python.org/pypi/virtualenv>`_ + was created by Ian Bicking. model An object representing data in the system. A model is part of the object graph traversed by the system. Models are traversed to diff --git a/docs/narr/project.rst b/docs/narr/project.rst index 10a1548fd..1cfac5b1e 100644 --- a/docs/narr/project.rst +++ b/docs/narr/project.rst @@ -68,7 +68,7 @@ generated ``setup.py``:: Finished processing dependencies for myproject==0.1 This will install your application 's package into the interpreter so -it can be found and run under a webserver. +it can be found and run as a WSGI application inside a WSGI server. Running The Tests For Your Application -------------------------------------- @@ -241,9 +241,16 @@ the HTML given back to the browser. hop in the URL. (That data comes from the model.) The request is an instance of a WebOb request. -#. The model renders a remplate and returns the result as the +#. The model renders a template and returns the result as the response. +.. note:: + + This example uses ``render_template_to_response`` which allows the + view author to think only in terms of templates. If you want more + control over the response, use ``render_template`` and create your + own WebOb Response object to return. + ``models.py`` ~~~~~~~~~~~~~ @@ -275,9 +282,10 @@ the root. ``run.py`` ~~~~~~~~~~ -We need a small Python module that sets everything, fires up a web -server, and handles incoming requests. Later we'll see how to use a -Paste configuration file to do this work for us. +We need a small Python module that configures our application and +advertises itself to our Paste ``.ini`` file. For convenience, we +also make it possible to run this module directory without the Paste +configuration file: .. literalinclude:: myproject/myproject/run.py :linenos: |