Installation Guide

TextTest is available via the pip package manager:

pip install texttest

This will make the texttest command line tools available on your system. TextTest also has a graphical user interface for managing your test suite. In order to use it, you will have to install pygtk, which is not currently available via the pip package manager. Installation is platform specific, see below.

Linux

  • Check you if you already have PyGTK - many Linux systems come with it already installed:

    $> python
    Python 2.7.1
    [GCC 4.6.3] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import gtk
    >>>
    

If this produces an error then you don’t have PyGTK and you will need to install it. Refer to the PyGTK home page. You need at least GTK 2.18 and PyGTK 2.16

  • Download the zip file containing all the TextTest source code and tests from http://sf.net/projects/texttest. Unpack it into an installation directory, such as ~/tools/texttest.
  • You may also want to install a separate diff tool such as TkDiff if you havn’t already got it.

Mac

  • Install Homebrew. Check that /usr/local/bin is on your $PATH

  • Install XQuartz. Log in and out again (to activate XQuartz as a windows manager)

  • Set the following environment variables:

    export LC_ALL=en_US.UTF-8
    export LANG=en_US.UTF-8
    
  • Install Python (version 2.6 or 2.7):

    brew install python
    
  • Install PyGTK:

    brew install pygtk
    
  • You may also want to install a separate diff tool such as TkDiff if you havn’t already got it.

Windows

  • Download the zip file containing all the TextTest source code and tests from http://sf.net/projects/texttest. In there is a windows installer which you should run. Re-start windows when you’ve done that. Note: this installer will set the environment variable $TEXTTEST_HOME to C:\\tests

If the all-in-one installer doesn’t work for you, you can install the component pieces by themselves.

  • Install GTK using this GTK 2.18 bundle. Unzip it somewhere like C:GTK (avoid a path containing spaces). Add the bin subdirectory to your $PATH.
  • Install PyGTK. Run the three installers at the top of the PyGTK downloads page. (avoid installation paths containing spaces)
  • Download the zip file containing all the TextTest source code and tests from Sourceforge (http://sf.net/projects/texttest). Unpack it into an installation directory, such as ~/tools/texttest.

Troubleshooting

  • Make sure you have at least Python 2.6, GTK 2.18 and PyGTK 2.16 installed on your system.
  • Make sure that pygtk is installed in the site-packages of the Python installation you’re using.
  • There are some mac-specific hints in the section below.
  • If you still can’t get it to work, contact us via the TextTest mailing list.

Mac-specific Troubleshooting

  • If you get errors like this:

    texttest.py: Fatal IO error 35 (Resource temporarily unavailable) on X server :0.0
    

or:

RuntimeError: could not create GdkCursor object

You could try starting XQuartz first before starting the TextTest GUI. (It’s under /Applications/Utilities/XQuartz) Once it’s started, try running texttest again. If that doesn’t work, when you’ve started XQuartz, on the “Appliations” menu, start “Terminal”. Try starting texttest from this terminal window instead.

  • If you get errors like this:

    GtkWarning: Could not find the icon 'inode-directory'. The 'hicolor' theme was not found either, perhaps you need to install it.
    

You could try:

brew install hicolor-icon-theme