Changes between Version 25 and Version 26 of DeveloperGuidelines/Testing/Selenium

Timestamp:

06/19/12 23:41:13 (13 years ago)

Author:

coldblooded

Comment:

--

DeveloperGuidelines/Testing/Selenium

@@ -75 +75 @@
 
 == 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.
+We aim to make it as easy as possible to write additional tests, which can easily be plugged into the Sahana Eden Testing System Framework. 
 
-The canonical example is: {{{eden/modules/tests/org/org_create_organisation.py}}}
+The canonical example is: {{{eden/modules/tests/org/create_organisation.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.
+
+'''A walk-through example:'''[[BR]]
+We want to make an automated test script to test the Create Organization module. 
+Create Organization falls under Human Resources Management (HRM) feature, therefore we must add this test script module file in the subfolder /hrm (eden/modules/tests/hrm/)
+
+Steps of automated the test for Create Organization:[[BR]][[BR]]
+ 
+1) Let's call this test file: create_organization.py and save it in the subfolder /hrm. [[BR]][[BR]]
+
+2) We must now make sure we add the file name in the __init__.py
+Open file __init__.py in the subfolder /hrm and add:
+{{{
+from create_organisation import *
+}}}
+3) create_organisation.py
+{{{
+import os
+import time
+from selenium.common.exceptions import NoSuchElementException
+from gluon import current
+from s3 import s3_debug
+from tests.web2unittest import SeleniumUnitTest
+
+class CreateOrganization(SeleniumUnitTest):
+
+    # -------------------------------------------------------------------------
+    def test_org001_create_organisation(self, items=[0]):
+        """
+            Create an Organisation
+            
+            @param items: Organisation(s) to create from the data
+
+            @ToDo: currently optimised for a single record
+        """
+        print "\n"
+        # Configuration
+        self.login(account="normal", nexturl="org/organisation/create")
+        tablename = "org_organisation"
+        #data = current.data["organisation"]
+        # Data for the Organisation resource
+        self.create("org_organisation", 
+                    [( "name", "Romanian Food Assistance Association (Test)"), ( "acronym", "RFAAT"), ("website", "http://www.rfaat.com"), ("comments", "This is a Test Organization")]
+                     )
+        for item in items:
+            _data = data[item]
+            # Check whether the data already exists
+            s3db = current.s3db
+            db = current.db
+            table = s3db[tablename]
+            fieldname = _data[0][0]
+            value = _data[0][1]
+            query = (table[fieldname] == value) & (table.deleted == "F")
+            record = db(query).select(table.id,
+                                      limitby=(0, 1)).first()
+            if record:
+                print "org_create_organisation skipped as %s already exists in the db\n" % value
+                return False
+
+            # Login, if not-already done so
+            self.login(account=account, nexturl=url)
+}}}
+
+4) To run this automated test script.
+Open suite.py (modules/tests/suite.py) and add at the bottom of suite.py script so it can be executed. (NOTE: We add the class name, not the function name).
+{{{
+addTests(loadTests(CreateOrganization))
+}}}
+
+5) Run your test script. (Refer above on how to run/execute test scripts from the Test Suite).
+
+'''Other information on the Test System framework:'''[[BR]]
 
 The key is to make tests which are as least fragile as possible through: