Welcome to Nevow

This page contains examples of how to build web applications on top of Nevow, in order of increasing complexity. To get a feel of how to structure your Python code while using Nevow, the source of all examples is linked for easy reference. In order to run each example, you will need Zope Interface, Twisted, and Nevow installed, and then you will need to run the example server.

Under windows: you need to run the Twisted Shell from Start-->Applications-->Twisted menu. Under a unix like operating system, make sure that the twistd binary is on your PATH. Installing Twisted will do this for you.

To run the example server, go to the Nevow examples directory (eg: C:\Nevow\examples or /usr/src/Nevow/examples) and run the following command:

twistd -noy examples.tac

Then, to view the running examples, point your web browser at: http://localhost:8080/

Once you are viewing this page as served by the example server, all of the "live" links below will work.

Table of Contents

1. Test Suite
2. Examples
3. LivePage/Canvas/XUL
4. Tag Library Examples
5. Demo Applications

Test Suite

Nevow 0.4 now includes a live test runner which operates inside of your web browser. The test runner currently operates only under Firefox, and not IE or Safari. This will be fixed in a future release. Test suites for some of the examples provided here have been written. The following test suites may be executed by visiting their respective pages:

1. Run basic tests
2. Run livepage example tests
3. Test test harness

Examples Listing

1. A Nevow example that doesn't use any of Nevow automations

   Stan Source

   most_basic.py

   Live examples: most_basic
2. Hello world in Nevow

   Stan Source	hellostan.py
   xmlfile Source	hellohtml.py
   xmlfile Template	hellohtml.html

   Live examples: xmlfile, Stan
3. How to get Session and Request objects from the context

   Stan Source	simple.py
   xmlfile Source	simplehtml.py
   xmlfile Template	simplehtml.html

   Live examples: xmlfile, Stan
   
4. Render tables in Nevow

   xmlfile Source	tablehtml.py
   xmlfile Template	tablehtml.html

   Live example: tables
5. How to use xmlfile directives

   Stan Source	disktemplates_stan.py
   xmlfile Source	disktemplates.py
   xmlfile Template	disktemplates.html

   Live examples: xmlfile, Stan
6. How to handles page children with Nevow, and how to use the <nevow:attr> tag

   Stan Source	children.py
   xmlfile Source	childrenhtml.py
   xmlfile Templates	childrenhtml_RootPage.html childrenhtml_ChildPage.html childrenhtml_ChildOfChildPage.html

   Live examples: stan, xmlfile
7. Allow data= directives to look inside application objects

   Stan Source

   objcontainer.py

   Live example: objcontainer
8. Manual form example

   Stan Source

   manualform.py

   Live example: form
9. Advanced manual form example

   Stan Source

   advanced_manualform.py

   Live example: form
10. Formless example

    Stan Source

    formpost.py

    Live example: formpost
11. Another formless example, but a little bit more complex

    Stan Source

    formpost2.py

    Live example: formpost2
12. Example of interacting with a database

    Stan Source:

    db.py

    Live examples: db
13. An example of using HTTP Basic Auth for simple authentication

    Stan Source

    http_auth.py

    Live example: http_auth
14. Various examples of how to integrate twisted.guard with Nevow for authentication

    Stan Source	guarded.py
    Stan Source	guarded2.py

    Live examples: guarded, guarded2
15. Examples of how to access the session when a user logs out of guarded sites

    Stan Source	logout_guard.py
    Stan Source	logout_guard2.py

    Live examples: logout_guard, logout_guard2
16. Use Configurables to render a form with Formless in a customized template

    xmlfile Source

    customform.py

    Live example: customform
17. Dynamically build your forms

    Stan Source

    formbuilder.py

    Live example: formbuilder
18. Adapting an object to the IRenderer interface in order to make it render itself

    Stan Source

    simple_irenderer.py

    Live example: simple IRenderer
19. More complex example of adapting objects to IRenderer and to different interfaces

    Stan Source

    irenderer.py

    Live example: IRenderer
20. Handling and building a Tree structure dynamically on yor site

    Stan Source

    tree.py

    Live example: tree
21. Simple example of text localisation

    Stan Source

    i18n.py

    Live example: i18n
22. Localisation of disk templates

    xmlfile Source	hello.html
    Python Source	xmli18n.py

    Live example: xmli18n

LivePage/Canvas/XUL

• Chatola: A multiuser realtime chat application using LivePage

  Python Source

  chatola.py

  Live example: chatola
• LiveAnimal: A small LivePage game

  Python Source

  liveanimal.py

  Live example: liveanimal
• Integration between Flash(TM) and Nevow

  Stan Source

  canvas.py

  Live example: canvas
• Integration between XUL and Nevow

  Stan Source	xul_nevow.py
  XUL Source	xul_example.xul

  Live example: xul_nevow

Tag Library Examples

• How to use the Calendar tag from the taglibrary

  Stan Source

  cal.py

  Live example: calendar
• How to use the TabbedPane tag from the taglibrary

  Stan Source

  tabbed.py

  Live example: tabbed
• How to use the Progressbar tag from the taglibrary

  Stan Source

  progress.py

  Live example: progress

Demo Applications

• Extremely basic library, made with atop
  xmlfile Source: with_atop
• Handling users in a web site
  Stan Source: userdb
• Liveevil example in a live chat page
  Source: chatola
• Pastebin example with nevow
  Source: pastebin
• Blog engine
  Source: blogengine
• Link storage webservice (uses Twisted's XML-RPC)
  Source: postit
• Todo list with rails like file structure (requires pgasync 1.3b and postgres)
  Source: todo
• Image uploader that uses atop
  Source: imagination