ScalaIDE Automated GUI Testing FAQ

I want to contribute. What should I do?

If you want to contribute, there are two options:
  (1) edit a test manually with a text or phyton editor
      --> recommended for small changes only as you cannot run the tests without a squish license
    
  (2) ask for a scala gui tester license for squish
      --> according to the discussions: here and here
        there is a good likelyhood for any serious contributor to get an official squish license.
        Please contact Christian Bulitta ( scala-ide-test@bulitta.com ) or Miles Sabin ( miles@milessabin.com ) if you want to contribute,
        i.e. extend the testsuite or frequently run tests.
        

I have a Squish license and want to run the tests. What should I do?

Setup activities (once only):
    (1) Install Squish and the Squish-IDE
    (2) make sure that squish/bin in in your PATH, e.g.
        PATH=$PATH:/opt/squish-4.0.0-java-linux32/bin/squish/bin
    (3) Download a eclipse galileo version from
             http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/galileor
        e.g.
             http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/galileo/R/eclipse-java-galileo-linux-gtk.t
ar.gz
        This version will be used as base for testing
    (4) Copy build.properties.template --> build.properties
    (5) edit the paths in your personal build.properties accordingly
        --> the build.properties file is intentionally never to be checked in
            as everybody should be free to choose any paths for downloads and installations
    (6) Invoke ant to initialize the target folder (install eclipse and an empty workspace without scala):
        cd org.scala-ide.gui-tests.squish
     ant
    (7) Start the squishide
    (7) Open all available testsuites (currently 2) using Menu File --> Open Testsuite ... :
         - org.scala-ide.gui-tests.squish/src/test/testsuites/suite_install_ide
         - org.scala-ide.gui-tests.squish/src/test/testsuites/suite_installed_ide_tests
         - org.scala-ide.gui-tests.squish/src/test/testsuites/...    (added potentially in the future)
    
Run the tests (frequently, e.g. before each release):
    (1) Start the Squish IDE
    (2) To test whether the scala IDE can be installed, invoke testsuite "suite_install_ide"
        --> this will take some time as a couple of files need to be downloaded
    (3) For further functionality tests, invoke testsuite "suite_installed_ide_tests"

If (2) fails for any reason, you can install the scala-ide from any location you want:
   - cd /scratch/org.scala-ide.gui-tests.squish/target/eclipse/eclipse
   - scalaIDE.sh
   - Install the ScalaIDE from any (local or remote) update site you want

I do not have a squish licence but want to have my contribution GUI tested. What should I do?

Contact Christian Bulitta ( scala-ide-test@bulitta.com ) to find a way. Thanks to Squish GUi test can be written very easily now. It is likely that you just need to describe what your test should test and Christian will find time to implement it.