TASKPM/scripts/functional-tests
Pablo Fernández de la Cigoña Nóvoa 85c6608c79 Create new directory scripts/functional-tests
There are included two files:
* README: File which includes some information about how install and use sahi
* common_functions.sah: File which includes some common functions to all the
  followed tests

FEA: ItEr75S18DataTypesTests
2011-08-08 11:59:17 +02:00
..
common_functions.sah Create new directory scripts/functional-tests 2011-08-08 11:59:17 +02:00
README Create new directory scripts/functional-tests 2011-08-08 11:59:17 +02:00

Functional Tests
================

.. sectnum::

:Author: Pablo Fernández de la Cigoña Nóvoa
:Contact: pcigonha@igalia.com
:Date: 05/08/2011
:Copyright:
  Some rights reserved. This document is distributed under the Creative
  Commons Attribution-ShareAlike 3.0 licence, available in
  http://creativecommons.org/licenses/by-sa/3.0/.
:Abstract:
  Basic documentation about NavalPlan functional tests usage.


.. contents:: Table of Contents


Introduction
------------

Inside ``scripts/functional-tests/`` folder of NavalPlan source code, you can find
several scripts to test the correct performance of NavalPlan. There are functional tests
for all all the data types and all most all the administration options.

Every file is called like <menu-option>_test.sah and represent all kind of tests made for
each individual option from the menu, all the files includes all the test to be done,
but the are some common tests for all of them:

* Create <menu-option>
* Create <menu-option> with duplicate type (most be failure)
* Create <menu-option> with empty type (most be failure)
* Create <menu-option> with duplicate name (most be failure)
* Edit   <menu-option>
* Delete <menu-option>


Requirements
------------

To run these test it's necessary to have installed Sahi

You can download it at:
    URL: ``http://sourceforge.net/projects/sahi/files/sahi-v35/20110719/install_sahi_v35_20110719.jar/download``

To install it, execute the following command where you have the previously download file
    $ java -jar install_sahi_v35_XXXXXXXX.jar

You can also see the instructions in sahi's page at:
    URL: ``http://sahi.co.in/w/using-sahi``

* NOTE: If you are using firefox5 you must change this file ``<sahi-path>/htdocs/spr/concat.js`` there replace:

    ``Sahi.prototype._isFF4 = function () {return /Firefox\/4|Iceweasel\/4|Shiretoko\/4/.test(this.navigator.userAgent);};``
    for:
    ``Sahi.prototype._isFF4 = function () {return /Firefox\/4|Iceweasel\/4|Shiretoko\/4|Firefox\/5|Iceweasel\/5|Shiretoko\/5/.test(this.navigator.userAgent);};``

You can also see the instructions in sahi's page at:
    URL: ``http://sahi.co.in/forums/viewtopic.php?id=2578``


Run the Scripts
---------------

Once installed the program you have two kinds of run:

* Graphical: Follow the instructions at
    URL: ``http://sahi.co.in/w/using-sahi``

* Console: including the following sentence in your ``<home>.bashrc``

    $ export PATH=$PATH:<sahi-path>/userdata/bin

    and then you can run the test like:

    $ testrunner.sh yourtest.sah [Initial url] [browser]

    It's possible run more than one script at the same time using a file.suite you can see some information in:
        URL: ``http://sahi.co.in/w/Running+multiple+tests+in+batch+mode``

See more information about how to run at:
    URL: ``http://sahi.co.in/w/using-sahi``