The first part is clearly to download TextTest itself
from the sourceforge
. You can then unzip this anywhere and run it from that location.
The download is fairly large as it includes TextTest's tests for itself, which are
useful as a tool for understanding features by example.
You will need at least version 2.4 on UNIX and at least version 2.5.1 on Windows. Python 2.6 is now
being tested against, although Python 2.6.1 and 2.6.0 have bugs that affect TextTest on Windows,
which are fixed in 2.6.2. Note that most Linux installations come with Python
TextTest's GUI makes use of PyGTK, which is a thin wrapper around the C GUI library GTK. You will need
at least GTK 2.10 and an equivalent version of PyGTK. All development is currently being done against GTK 2.12,
although workarounds are now in place for some bugs in GTK 2.14 and later now so it should function better. However,
the self-tests for some GUI functionality will not work there. If you can, sticking to 2.12 is probably a good
idea for now.
Note that most Linux installations include a PyGTK package and some (e.g. Ubuntu) have it installed by default.
To test whether your Python installation already includes PyGTK, type 'import gtk' into a python prompt. No response means you do.
However, this can be a curse as well as a blessing, because if you have an older "enterprise" linux platform
such as Red Hat or SuSE, it's difficult to put a newer GTK in place than the default. In this case you should
refer to the instructions under doc/Upgrade_PyGTK_Enterprise_Linux in the TextTest download.
On Windows, the summary for how to install is that you should get the GTK 2.12 bundle from here
, unzip it somewhere, add its "bin" subdirectory to your PATH and then run the three installers at the top of the PyGTK downloads
- Tkdiff and diff. You will need a decent graphical difference tool on your
PATH, along with a textual version for reports. We recommend 'tkdiff' and 'diff' respectively which are present on most UNIX
systems and are TextTest's defaults. If you're on UNIX and tkdiff isn't there, download from tkdiff's
project page on sourceforge.
On Windows, Patrick Finnegan sent me a very nice Windows
installer for tkdiff and diff
and kindly agreed that I
could distribute it here. Note that the installer won't affect
your path though, so you'll need to set PATH in autoexec.bat or
similar to include wherever it's installed (typcially something
like C:\Program Files\tkdiff)
- Emacs and notepad. TextTest also makes use of a generic editor for viewing files. This defaults to "emacs" on UNIX systems and "notepad" on Windows, which are both likely to be pre-installed. Your UNIX installation will certainly have a package for "emacs" if not. It's easy to change these to use other editors if desired via the "view_program" configuration setting.
For viewing test files while they are running, there is a
menu option to display a window with live updates of the file.
On UNIX this defaults to using 'xterm -e tail -f'. On Windows there is a
nice equivalent called baretail which is TextTest's default. You
can download it from Bare
Metal Software's site
. Like everything else you should add
it to your PATH. Naturally, there is no compulsion to use this
functionality so this download is optional. Selecting it on Windows
will just produce an error dialog if “baretail” can't be
TextTest uses a root directory where it starts to look for
tests, determined primarily by the environment variable
TEXTTEST_HOME. This is the first thing determined by TextTest on
being called and not much will happen if it isn't set.
You are strongly recommended to pick an existing root directory for all
your tests and set TEXTTEST_HOME to this directory in some
persistent way (for example your shell starter script on UNIX or
autoexec.bat on Windows). In this way you will not need to think
about it more than once.