docs at pythonweb.org
November 18, 2004
"It is better to have a flexible module that can be used intuitively than an all-singing, all-dancing framework that no-one can be bothered to learn." - James Gardner
The Python Web Modules are a suite of simple and easy to use Python components desinged to allow developers to write Python CGI scripts or web applications with SQL databases, sessions and auth functions without having to install Web Application Servers.
A key part of the project is the creation of documentation and examples to allow developers with less time or expierince to understand the concepts of Python web programming without having to read all the sources and comments from the very beginning.
A Beginner's Guide to web programming with the modules is also available and there are a number of examples.
To use all the features of the modules you will either need a binary distribution (available for Windows) or you will need to install the following software in addition to the source distribution of the web modules:
All downloads including Windows versions are available from http://pythonweb.org/release/
The Python Web Modules don't need installing although it is eaiest if you do install them. The only thing you must do is put the web module folder in a place where Python can find it or tell Python specifically where it is. You can do this in a number of ways:
python setup.py install
>>> import sys >>> sys.path.insert(0,'C:/path/to/distribution/directory')
Note: You should not include the web directory in the path otherwise Python will look for a directory called web inside the web directory and will not find it!
To compile all the Python files for faster execution you can run the compileAll.py script in the scripts directory.
To get up and running with the examples run webserver.py in the scripts directory to start a webserver on port 8080. There must be no spaces in the path to the webserver.py file. Load a web browser and visit http://localhost:8080/doc/html/web/examples.html and you should see the examples page of the documentation. You don't need to install the modules to run the tests, they will run from the unzipped source directory.
The next place to visit is the Beginner's Guide which will get you started programming web applications or the Module Reference which will give you detailed information on the API and way to use each of the modules or the Examples section to see the modules in action.
This document was generated using the tools distributed with Python 2.3
General comments and questions regarding this document should be sent by email to email@example.com. If you find specific errors in this document, either in the content or the presentation, please report the bug by emailing firstname.lastname@example.org.
For any of these channels, please be sure not to send HTML email. Thanks.
The authour of the web modules can be contacted at email@example.com
This documentation is copyright James Gardner 2003-2004 All Rights Reserved. Permission is granted to freely distribute this documentation in electronic form. Commercial printing and distribution is forbidden but you are welcome to print single copies for your own use.See About this document... for information on suggesting changes.