Installing

dkpeall edited this page Nov 7, 2012 · 13 revisions

Installing Windmill from a pre-built package

  • Note: all the commands will be entered into your platform command line (terminal, cmd prompt).

MacOSX

Pre Reqs

  • Install xcode: http://developer.apple.com/technology/xcode.html
  • Install Python 2.5 or 2.6 (10.4 and previous): http://www.python.org (Do not use MacPorts)
  • Install easy_install:
  • Download http://peak.telecommunity.com/dist/ez_setup.py
    sudo python ez_setup.py

Install
sudo easy_install windmill

Note, if this doesn’t get you the latest version, or if there’s a specific earlier version you want:
sudo easy_install -U windmill==1.4 #or whatever version you want.

Run
windmill shell { firefox|safari } http://www.google.com


Linux

Pre Reqs

  • Install python and setuptools
    sudo apt-get install python2.5
    wget http://peak.telecommunity.com/dist/ez_setup.py
    sudo python ez_setup.py windmill
    sudo apt-get install python-setuptools
  • If you need SSL (https://) support
    sudo apt-get install python-dev
    sudo apt-get install python-openssl
  • Install simplejson from http://pypi.python.org/pypi/simplejson/. For Debian/Ubuntu, use
    sudo apt-get install python-simplejson

Install
sudo easy_install windmill

Note, if this doesn’t get you the latest version, or if there’s a specific earlier version you want,
sudo easy_install -U windmill==1.4 #or whatever version you want.

Run
windmill shell firefox http://www.google.com


Windows

Pre Reqs

  • (optional) Install cygwin: http://www.cygwin.com/
  • Install from the internet
  • Select packages to install, devel > subversion ( * NOTE: do NOT install the subversion-devel, and make all python packages are unchecked)
  • Install Python: http://www.python.org/download/
  • Add Python to your PATH
  • Right click on “My Computer”.
  • Select “Properties” from the context menu.
  • In the “System Properties” dialog box, click on the “Advanced” tab.
  • Click on the “Environment Variables” button.
  • Highlight the “Path” Variable in “System variables” section.
  • Click the “Edit” button.
  • Append the following lines to the text inside the “Variable value” text box semi-colon delimited.
C:\Python25\
C:\Python25\Scripts\
  • *NOTE: If either entry already exists in the text box, do not add a redundant copy.
  • Click “OK” on the “Edit System Variable” dialog box then “OK” on the “Environment Variables” dialog box to commit the changes.
  • Install setuptools
  • Download http://peak.telecommunity.com/dist/ez_setup.py
  • Run ‘python ez_setup.py’ from directory where you saved the file
    python ez_setup.py
  • Install simplejson (If using Python 2.6 skip this step as simplejson is part of Python 2.6)
    easy_install http://files.turbogears.org/eggs/simplejson-1.9.2-py2.5-win32.egg
  • Install the Windows Python extensions: http://sourceforge.net/project/showfiles.php?group_id=78018

Install
easy_install windmill

Note, if this doesn’t get you the latest version, or if there’s a specific earlier version you want,
easy_install -U windmill==1.4 #or whatever version you want.

Run
windmill shell {browser: ie || firefox} http://www.google.com

Installing Windmill From Source

MacOSX

Pre Reqs

  • Install git from http://code.google.com/p/git-osx-installer/downloads/list?can=3 or http://git-scm.com/
  • Install xcode: http://developer.apple.com/technology/xcode.html
  • Install easy_install:
  • Download http://peak.telecommunity.com/dist/ez_setup.py
    sudo python ez_setup.py

Install

git clone git://github.com/windmill/windmill.git windmill
cd windmill
sudo python setup.py develop

Run
windmill shell { firefox|safari } http://www.google.com


Linux

Pre Reqs

  • Install python and setuptools
  • Install git http://git-scm.com/
    sudo apt-get install python2.5
    wget http://peak.telecommunity.com/dist/ez_setup.py
    sudo python ez_setup.py

Install

git clone git://github.com/windmill/windmill.git windmill
cd windmill
sudo python setup.py develop

Run
windmill shell firefox http://www.google.com


Windows

Pre Reqs

  • (optional) Install cygwin: http://www.cygwin.com/
  • Install from the internet
  • Select packages to install ( * NOTE: do NOT install the subversion-devel, and make all python packages are unchecked)
  • Install git: http://github.com/guides/using-git-and-github-for-the-windows-for-newbies (recommended to use msysGit instead of cygwin for install)
  • Install Python: http://www.python.org/download/
  • Add Python to your PATH
  • Right click on “My Computer”.
  • Select “Properties” from the context menu.
  • In the “System Properties” dialog box, click on the “Advanced” tab.
  • Click on the “Environment Variables” button.
  • Highlight the “Path” Variable in “System variables” section.
  • Click the “Edit” button.
  • Append the following lines to the text inside the “Variable value” text box semi-colon delimited.
    C:\Python25\
    C:\Python25\Scripts\
  • *NOTE: If either entry already exists in the text box, do not add a redundant copy.
  • Click “OK” on the “Edit System Variable” dialog box then “OK” on the “Environment Variables” dialog box to commit the changes.
  • Install setuptools
  • Download http://peak.telecommunity.com/dist/ez_setup.py
  • Run ‘python ez_setup.py’ from directory where you saved the file
    python ez_setup.py
  • Install simplejson (If using Python 2.6 skip this step as simplejson is built into Python 2.6)
    easy_install http://files.turbogears.org/eggs/simplejson-1.9.2-py2.5-win32.egg
  • Install the Windows Python extensions: http://sourceforge.net/project/showfiles.php?group_id=78018

Install

git clone git://github.com/windmill/windmill.git HEAD
cd windmill
python setup.py develop

Run
windmill shell {browser: ie || firefox} http://www.google.com

Installing for Development

Installing Git

You’ll need git installed in order to build windmill from source. http://github.com/guides/using-git-and-github-for-the-windows-for-newbies (recommended to use msysGit instead of cygwin for install)

Downloading from Git

git pull git://github.com/windmill/windmill.git HEAD

Running setup.py

If you run setup.py install’s develop command you will install some egg links back to the source repository you’ve downloaded. This way each time you use `svn up` to update the source tree windmill will automatically update to newest.

python setup.py develop

Since you’re using the source trunk, the version is subject to change. Because python egg’s like to keep track of their current version you will have to re-run the previous command when the windmill version is changed in the source trunk’s setup.py.