Changes between Version 7 and Version 8 of DeveloperGuidelines/Testing/Selenium

Timestamp:

05/04/12 04:49:28 (13 years ago)

Author:

coldblooded

Comment:

--

DeveloperGuidelines/Testing/Selenium

@@ -1 @@
-= Testing =
+= Sahana Eden Testing functionality documentation: =
 [[TOC]]
+'''Introducing automated testing system built inside Sahana Eden (S3) framework.'''
+
 "A bug is a test case you haven't written yet" [[BR]]
 "Unit Tests allow merciless [http://diveintopython.org/refactoring/refactoring.html refactoring]"
@@ -11 +13 @@
 * http://seleniumhq.org/docs/appendix_migrating_from_rc_to_webdriver.html#why-migrate-to-webdriver
 
+== How does it work? == 
+The system relies on Selenium web driver and IDE to execute and/or create automated test scripts.
+Selenium provides the ability to test Sahana Eden as users see it - namely through a web browser. This therefore does end-to-end Functional Testing, however it can also be sued as Unit Testing.
+
 These tests are stored in {{{eden/modules/tests}}}
 
-== Installation ==
-Install Selenium Python Client Driver into your running Python:
-* http://selenium.googlecode.com/svn/trunk/docs/api/py/index.html
+== Installation of the testing environment in your machine ==
+
+In order to execute the automated Selenium powered test scripts, you must install the Selenium Web Drivers into Python as packages.[[BR]]
+
+''Windows & MAC OSx installation:''[[BR]]
+
+Download latest Selenium package:[[BR]]
+1) http://pypi.python.org/packages/source/s/selenium/selenium-2.20.0.tar.gz [[BR]]
+2) Extract it[[BR]]
+3) CMD/Terminal bash:
 {{{
-pip install -U selenium
-}}}
-or
-{{{
-wget http://pypi.python.org/packages/source/s/selenium/selenium-2.20.0.tar.gz
-tar zxvf selenium-2.20.0.tar.gz
 cd selenium-2.20.0
 python setup.py install
 }}}
-== Running Tests ==
+
+== Running / Executing Automated test scripts: ==
+In Sahana Eden, the testing system is implemented in the directory: eden/modules/tests/ [[BR]]
+Now that you have installed all the Selenium packages to your Python on your machine, you can now run them to test Eden module(s) functionalities. [[BR]][[BR]]
+
 Before running the Selenium scripts, you should put your database into a known state:
 {{{
@@ -36 +47 @@
 deployment_settings.base.prepopulate = 2
 }}}
+Run the whole test suite for the Eden application:[[BR]]
 
-Run the whole test suite for the 'eden' application:
 {{{
 cd web2py
 python web2py.py -S eden -M -R applications/eden/modules/tests/suite.py
 }}}
-Run a single test for the 'eden' application:
+
+Run a single test script for the Eden application:[[BR]]
+
 {{{
 cd web2py
 python web2py.py -S eden -M -R applications/eden/modules/tests/suite.py -A mytestfunction
 }}}
+[[BR]]
 
-== Writing Tests ==
-We aim to make it as easy as possible to write additional tests, which can easily be plugged into the suite.
+== Writing / Creating your own test scripts:==
+We aim to make it as easy as possible to write additional tests, which can easily be plugged into the testing suite or/and executed separately.[[BR]]
 
-An example has been created: {{{eden/modules/tests/hrm/staff.py}}}
+Use the Selenium IDE to generate python codes. [[BR]]
+
+An example has been created: {{{eden/modules/tests/hrm/hrm001.py}}}
 
 New tests should be stored in a subfolder per module, adding the foldername to {{{eden/modules/tests/__init__.py}}} & creating an {{{__init__.py}}} in the subfolder.