Releases may be downloaded from the
SourceForge project pages
. There is now
a Windows installer there which will also install TextTest if required. Releases can also be
installed directly from Python's packaging system via "easy_install storytext" or "pip install storytext".
We aim to make a couple of releases a year, with attendant bugfix releases when required.
Please see the instructions for SWT/EclipseRCP
There are two possibilities (if you didn't run pip or easy_install already). You can go to the "source" directory and
run "python setup.py install". On Windows this will probably install it somewhere like "C:\Python26\Scripts", which
you should then add to your PATH variable. On UNIX you can also leave it where it is, in which case you'll probably
want to add its "source/bin" directory to your PATH for convenience.
StoryText comes with a small PyGTK UI ("storytext_editor") which creates the
UI map file
for you and allows an
overview of your usecases. You therefore need to install PyGTK
even if the app you are testing uses another UI toolkit. Most Linux distros already have PyGTK though and the above Windows installer
includes it, so this shouldn't be a problem. If needed, detailed tips for installing PyGTK can be found under the
There about 550 automated acceptance tests for StoryText, using TextTest, and we aim to keep
the contents of source control stable and usable at all times. Anyone wishing to make changes
should obviously get hold of this version also.
The code is hosted on Launchpad and can be browsed online
To get hold of the latest version, you will need to install the
Bazaar version control tool
You can then just do "bzr branch lp:storytext" to get the latest code.
Note that StoryText is only runnable directly from its source tree when used on Python GUIs on Linux now. On Windows, or with
Java GUIs, it will need to be installed using a command like 'python setup.py install' or 'jython setup.py install' respectively.
We'd suggest making use of virtualenv
for this in order to avoid needing
to use the default Python or Jython installation.
For example, to set up a Jython installation on Linux, you might do
$ jython virtualenv.py ~/.local/jython2.5.3
$ export PATH=~/.local/jython2.5.3/bin:$PATH
$ cd <path_to_storytext_source>
$ ~/.local/jython2.5.3/bin/jython setup.py install