Setting Up the Tutorial Environment and Running Tutorial Source Code¶
To run this tutorial, you need to have nevow available to python and you’ll need the files in the doc/howto tree. You don’t even have to install nevow; the examples will run within the source tree.
Combinator: The Divmod Way¶
Using SVN with Combinator is the best way to try out the example code in-place (and hop between other SVN branches in the future). This is how we develop and test our applications at Divmod. If you have a system installation of Twisted that you don’t want to update or interfere with, you can use this method without installing anything.
Create a projects directory or change to some other test directory of your choice:
$ mkdir ~/Projects $ cd ~/Projects
If you don’t have the twisted library, check it out now:
$ svn co svn://svn.twistedmatrix.com/svn/Twisted/trunk Twisted/trunk
Then get Combinator and Nevow (and the rest of Divmod). See the Combinator Tutorial for more about these special checkout paths.:
$ svn co http://divmod.org/svn/Divmod/trunk Divmod/trunk
Set up the Combinator environment in this shell. You’ll need this step in any future test shells since it adjusts PATH and PYTHONPATH:
$ eval ``python Divmod/trunk/Combinator/environment.py`` $ # (some "link:" lines are normal)
Register both the Twisted and Divmod (and thus Nevow+Athena) codebases with Combinator:
$ chbranch Twisted trunk $ chbranch Divmod trunk
You can check to see if your environment is ready to go by running the tutorial tests (from any directory, after executing the previous command):
$ trial nevow.test.test\_howtolistings
If they all pass, you’re ready to begin the tutorial.
Standard distutils Installation¶
If you don’t want to manage branches and environments with Combinator,
you can install our code in the standard site-packages
directory.
You’ll still need the source tree so you can use the files in doc/howto.
For those that would prefer the old way, here’s how you do it:
Create a projects directory:
$ mkdir ~/Projects $ cd ~/Projects
Checkout and install the latest Twisted:
$ svn co svn://svn.twistedmatrix.com/svn/Twisted/trunk Twisted $ cd Twisted $ sudo python setup.py install $ cd ../
Checkout and install Nevow:
$ svn co http://divmod.org/svn/Divmod/trunk/Nevow Nevow $ cd Nevow $ sudo python setup.py install $ cd ../