master/README.w32

   1 Several users have reported success in running a buildslave under Windows.
   2 The following list of steps might help you accomplish the same. They are a
   3 list of what I did as a unix guy struggling to make a winXP box run the
   4 buildbot unit tests. When I was done, most of the unit tests passed.
   5
   6 If you discover things that are missing or incorrect, please send your
   7 corrections to the buildbot-devel mailing list (archives and subscription
   8 information are available at http://buildbot.sourceforge.net).
   9
  10
  11 0. Check to make sure your PATHEXT environment variable has ";.PY" in
  12 it -- if not set your global environment to include it.
  13
  14  Control Panels / System / Advanced / Environment Variables / System variables
  15
  16 1. Install python -- 2.4 -- http://python.org
  17         * run win32 installer - no special options needed so far
  18
  19 2. install zope interface package -- 3.0.1final --
  20 http://www.zope.org/Products/ZopeInterface
  21         * run win32 installer - it should auto-detect your python 2.4
  22           installation
  23
  24 3. python for windows extensions -- build 203 --
  25 http://pywin32.sourceforge.net/
  26         * run win32 installer - it should auto-detect your python 2.4
  27           installation
  28
  29  the installer complains about a missing DLL. Download mfc71.dll from the
  30  site mentioned in the warning
  31  (http://starship.python.net/crew/mhammond/win32/) and move it into
  32  c:\Python24\DLLs
  33
  34 4. at this point, to preserve my own sanity, I grabbed cygwin.com's setup.exe
  35    and started it. It behaves a lot like dselect. I installed bash and other
  36    tools (but *not* python). I added C:\cygwin\bin to PATH, allowing me to
  37    use tar, md5sum, cvs, all the usual stuff. I also installed emacs, going
  38    from the notes at http://www.gnu.org/software/emacs/windows/ntemacs.html .
  39    Their FAQ at http://www.gnu.org/software/emacs/windows/faq3.html#install
  40    has a note on how to swap CapsLock and Control.
  41
  42  I also modified PATH (in the same place as PATHEXT) to include C:\Python24
  43  and C:\Python24\Scripts . This will allow 'python' and (eventually) 'trial'
  44  to work in a regular command shell.
  45
  46 5. twisted -- 2.0 -- http://twistedmatrix.com/projects/core/
  47         * unpack tarball and run
  48                 python setup.py install
  49         Note: if you want to test your setup - run:
  50                 python c:\python24\Scripts\trial.py -o -R twisted
  51         (the -o will format the output for console and the "-R twisted" will
  52          recursively run all unit tests)
  53
  54  I had to edit Twisted (core)'s setup.py, to make detectExtensions() return
  55  an empty list before running builder._compile_helper(). Apparently the test
  56  it uses to detect if the (optional) C modules can be compiled causes the
  57  install process to simply quit without actually installing anything.
  58
  59  I installed several packages: core, Lore, Mail, Web, and Words. They all got
  60  copied to C:\Python24\Lib\site-packages\
  61
  62  At this point
  63
  64    trial --version
  65
  66  works, so 'trial -o -R twisted' will run the Twisted test suite. Note that
  67  this is not necessarily setting PYTHONPATH, so it may be running the test
  68  suite that was installed, not the one in the current directory.
  69
  70 6. I used CVS to grab a copy of the latest Buildbot sources. To run the
  71    tests, you must first add the buildbot directory to PYTHONPATH. Windows
  72    does not appear to have a Bourne-shell-style syntax to set a variable just
  73    for a single command, so you have to set it once and remember it will
  74    affect all commands for the lifetime of that shell session.
  75
  76   set PYTHONPATH=.
  77   trial -o -r win32 buildbot.test
  78
  79  To run against both buildbot-CVS and, say, Twisted-SVN, do:
  80
  81   set PYTHONPATH=.;C:\path to\Twisted-SVN
  82
  83
  84 All commands are done using the normal cmd.exe command shell. As of
  85 buildbot-0.6.4, only one unit test fails (test_webPathname_port) when you run
  86 under the 'win32' reactor. (if you run under the default reactor, many of the
  87 child-process-spawning commands fail, but test_webPathname_port passes. go
  88 figure.)
  89
  90 Actually setting up a buildslave is not yet covered by this document. Patches
  91 gladly accepted.
  92
  93  -Brian