Tutorial Approach

This tutorial uses conventions to keep the introduction focused and concise. Details, references, and deeper discussions are mentioned in "See also" notes.

See also

This is an example "See also" note.

This "Getting Started" tutorial is broken into independent steps, starting with the smallest possible "single file WSGI app" example. Each of these steps introduce a topic and a very small set of concepts via working code. The steps each correspond to a directory in this repo, where each step/topic/directory is a Python package.

To successfully run each step:

$ cd request_response
$ $VENV/bin/python setup.py develop

...and repeat for each step you would like to work on. In most cases we will start with the results of an earlier step.

Directory Tree

As we develop our tutorial our directory tree will resemble the structure below:

quicktutorial/
  request_response/
    development.ini
    setup.py
    tutorial/
      __init__.py
      home.pt
      tests.py
      views.py

Each of the first-level directories (e.g. request_response) is a Python project (except, as noted, the hello_world step.) The tutorial directory is a Python package. At the end of each step, we copy a previous directory into a new directory to use as a starting point.