|Deletions are marked like this.||Additions are marked like this.|
|Line 6:||Line 6:|
|version:: 1.0 (''[[Date(2004-07-01T00:00:00)]]'')||version:: 2.2 (''[[Date(2005-09-27T00:00:00)]]'')|
A framework for WebProgramming.
- CNRI Open Source License.
- Primarily developed on and for Unix, but it seems to work with Apache on Windows too.
- Python versions
- 2.x required
Aimed at sites where complex programming is required, Quixote lets the developer apply as many of their existing Python development skills as possible. For example, you write a Web application by writing a Python package and configuring Quixote to use that package. HTML templates are written in Python-like syntax and can be imported just like other Python code.
Quixote will work with any Web server that supports CGI and/or [http://www.fastcgi.com/ FastCGI]. NeilSchemenauer's new [http://arctrix.com/nas/scgi/protocol.txt SCGI protocol] is also supported, although SCGI has so far only been implemented for Apache. FastCGI or SCGI provide much better performance than CGI, and SCGI has proven more reliable than FastCGI. Finally, Quixote also supports Apache's [http://www.modpython.org/ mod_python]. See doc/web-server.txt in the source distribution for configuration information.
Quixote can also be deployed using the [wiki:TwistedMatrix Twisted] framework. An example script is available in the Quixote sources under services/twisted_http.py
Just like writing any Python application, with the twist that you can also import code from PTL modules (.ptl files, compiled to .ptlc).
Same as from ordinary Python code -- application authors have complete and unhindered access to the platform Quixote is running on.
Most CGI environment variables are exposed in a more Pythonic way, ie. as attributes and/or methods of the ubiquitous HTTPRequest object.
Session, Identification and Authentication
Quixote provides a session management API; sessions are tracked via cookies. By default, session information is lost when the current process terminates, but it's easy to make sessions persistent: you just have to provide a persistent mapping object for Quixote to use instead of an ordinary dictionary.
[http://www.mems-exchange.org/software/dulcinea/ Dulcinea] is a collection of modules useful for developing applications with Quixote and Durus. This includes user management classes.
Authentication is currently not addressed by Quixote; applications must provide their own authentication code. This will probably change in a future release (0.6?).
Outside the scope of Quixote. You can use it with a relational database, with [http://www.mems-exchange.org/software/durus/ the Durus persistent object system], with the ZODB, or with any other Python module for persistence.
While Quixote comes with a templating language (PTL), it is only loosely integrated. Using PTL is optional and other templating languages or presentation support can easily be added.
PTL, Python Template Language, is used to generate HTML from Python code (or to simply embed HTML in Python); the basic syntax is nearly the same as Python's, but expressions are converted to strings and appended to the output. An example snippet of PTL:
def numbers [plain] (n): for i in range(n): i " " # PTL does not add any whitespace
If this is in a file named foo.ptl, you can now write from foo import numbers ; numbers(5), which will produce the output "1 2 3 4 5 ".
All of Python's power is available in a way familiar to Python programmers. Exceptions and tracebacks are handled just like regular Python code. It's easy insert debugging code. PDB and the Python profiler can be used. Compiled PTL modules are saved like .pyc modules and once compiled are quick to load. You can use the Python module and package system to organize templates.
Separating model and view is good. However, to achieve this separation it is not necessarily to cripple the templating language. Real programmers use abstractions. One way to apply abstraction to HTML page generation is to use templates that can be composed to build web pages (much like functions in traditional languages). As these abstractions become higher level, the amount of HTML markup used decreases. Normally, HTML markup is used mostly in low-level templates that are reused many times. In this situation it is logical to put the markup inside of some kind of quotes instead of outside. Take a look a large web applications written in PHP like Sourceforge or Squirrelmail. Notice that most of the code (including presentation releated code) is inside ?php tags.
The model and view should still be separated. This requires good design and some effort; a templating language is not going to do it for you. One good test is to imagine that you need to use a different technology for the interface (e.g. all web browsers stopped working, or, more likely, some better technology emerged). How much of your application code could be reused if all the interface code was thrown away?
PTL is not appropriate for every situation. If the interface is being built by a web designer rather than someone who knows how to program then it would be better to use something like ZopePageTemplates or something similar.
The design goals for Quixote were:
- To allow easy development of Web applications where the accent is more on complicated programming logic than complicated templating.
- To make the templating language as similar to Python as possible. The aim is to make as many of the skills and techniques learned from writing regular Python code applicable to the task of writing Web applications.
- No magic. When it's not obvious what to do in a certain case, Quixote refuses to guess.
If you view a web site as a program, and web pages as subroutines, Quixote just might be the tool for you. If you view a web site as a graphic design showcase, and each web page as an individual work of art, Quixote is probably not what you're looking for.
A lengthier explanation of the design and of how the MEMS Exchange uses Quixote can be found at http://www.amk.ca/python/writing/mx-architecture/ .
Post questions or add material to the [http://www.quixote.ca/qx Quixote wiki].
PTL breaks common utilities like pydoc and pychecker.