Testing GUIs with TextTest and StoryText
Downloading and installing StoryText
Latest releases (Python GUIs)
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.
Latest releases (Java GUIs)
Please see the instructions for SWT/EclipseRCP or Swing as appropriate.
Installation (Python GUIs)
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 TextTest documentation.
Latest development version from source control
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 here.
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

Last updated: 08 July 2015