TASKPM

History

Pablo Fernández de la Cigoña Nóvoa 7ba840434f Added Quality forms tests new file: scripts/functional-tests/administration-management/quality_forms.sah FEA: ItEr75S21AdministrationTests		2011-08-31 17:35:53 +02:00
..
administration-management	Added Quality forms tests	2011-08-31 17:35:53 +02:00
data-types	Change some functions from work_hour_test.sah for functions included in common_function.sah	2011-08-31 16:50:46 +02:00
users	Added two new suites	2011-08-29 10:42:55 +02:00
all_test.suite	Added two new suites	2011-08-29 10:42:55 +02:00
common_functions.sah	Include some functions from criteria, worker, calendar and cost category in common_functions.sah	2011-08-31 16:50:05 +02:00
README	Delete trailing whitespaces from scripts/functional-tests/README	2011-08-11 14:34:13 +02:00
sahi-common-env.sh	Add some files needed to run sahi in <navalplan-root>/scripts/functional-tests and include some explanations in REAME file	2011-08-09 08:25:17 +02:00
start_sahi.sh	Add script to start Sahi from command line	2011-08-09 08:49:44 +02:00
testrunner.sh	Include file all_data_type_test.suite which allow run all data type test	2011-08-26 12:38:49 +02:00

README

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

.. sectnum::

:Author: Pablo Fernández de la Cigoña Nóvoa
:Contact: pcigonha@igalia.com
:Date: 08/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 LibrePlan functional tests usage.


.. contents:: Table of Contents


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

Inside ``scripts/functional-tests/`` folder of LibrePlan source code, you can find
a set of functional tests. They consist of different files and each file groups tests
related to the same functionality.

Each file is called ``<menu-option>_test.sah`` and represent all the tests developed
for an individual option of the menu. Additionally, there are a set of fixed tests
that are always included.

* Create ``<menu-option>``
* Create ``<menu-option>`` with duplicate type (it should not be allowed)
* Create ``<menu-option>`` with empty type (it should not be allowed)
* Create ``<menu-option>`` with duplicate name (it should not be allowed)
* Edit ``<menu-option>``
* Delete ``<menu-option>``


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

To run these tests it's necessary to have installed `Sahi <http://sahi.co.in/>`_.

You can download it at:
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_20110719.jar

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


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

.. WARNING::

    All tests use English as default language. So, if
    your browser language is different from this, they will NOT PASS

Once installed the program you have two ways to execute the tests:

* With a Graphical User Interface (GUI): Follow the instructions at: http://sahi.co.in/w/using-sahi

* On the console:

  * To run sahi scripts, you need to start Sahi::

    $ start_sahi.sh

  * And inside ``scripts/functional-tests/`` you can run them with::

    $ testrunner.sh yourtest.sah <initial-url> <browser>

.. WARNING::

    If you modify Sahi default installation path (``~/sahi/``), you must
    change the path in ``scripts/functional-tests/sahi-common-env.sh``

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

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