Context Navigation

Selenium

Timestamp:: 07/02/13 19:01:02 (12 years ago)
Author:: somayjain
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

DeveloperGuidelines/Testing/Selenium

-              v60
+              v61
 == 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 Sahana Eden Testing System Framework.
+The canonical example is: {{{eden/modules/tests/org/create_organisation.py}}}
+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.
 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]]
+'''A walk-through example: Creating a Record'''[[BR]]
+The canonical example is: {{{eden/modules/tests/staff/create_staff.py}}}
+We want to make an automated test script to test the Create Staff module.
+Create Staff falls under Staff feature, therefore we must add this test script module file in the subfolder /staff (eden/modules/tests/staff/)
+Steps of automated the test for Create Staff:[[BR]][[BR]]
 ) Let's call this test file: create_organization.py and save it in the subfolder /hrm. [[BR]][[BR]]
+) Let's call this test file: create_staff.py and save it in the subfolder /staff. [[BR]][[BR]]
 ) 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 *
+}}}
+) create_organisation.py
+{{{
+import os
+import time
+from selenium.common.exceptions import NoSuchElementException
+from gluon import current
+from s3 import s3_debug
+Open file __init__.py in the subfolder /staff and add:
+{{{
+from create_staff import *
+}}}
+) create_staff.py
+{{{
 from tests.web2unittest import SeleniumUnitTest
+class CreateOrganization(SeleniumUnitTest):
+    # -------------------------------------------------------------------------
+    def test_org001_create_organisation(self, items=[0]):
+class CreateStaff(SeleniumUnitTest):
+    def test_hrm001_create_staff(self):
         """
+            Create an Organisation
+            @case: HRM001
+            @description: Create a Staff
+            @param items: Organisation(s) to create from the data
+            @ToDo: currently optimised for a single record
+            @TestDoc: https://docs.google.com/spreadsheet/ccc?key=0AmB3hMcgB-3idG1XNGhhRG9QWF81dUlKLXpJaFlCMFE
+            @Test Wiki: http://eden.sahanafoundation.org/wiki/DeveloperGuidelines/Testing
         """
         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")]
+        self.login(account="admin", nexturl="hrm/staff/create")
+        self.create("hrm_human_resource",
+                    [( "organisation_id",
+                       "International Federation of Red Cross and Red Crescent Societies"),
+                     ( "site_id",
+                       "AP Zone (Office)"),
+                     ( "first_name",
+                       "Robert",
+                       "pr_person"),
+                     ( "middle_name",
+                       "James",
+                       "pr_person"),
+                     ( "last_name",
+                       "Lemon",
+                       "pr_person"),
+                     ( "email",
+                       "rjltestdonotusetest99@romanian.com",
+                       "pr_person"),
+                     ( "job_title_id",
+                       "Warehouse Manager"),
+                     ]
+                     )
+        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)
+}}}
+}}}
+* The create function takes 2 arguments - {{{create(table_name, data)}}}
+* {{{table_name}}} - The name of the database table in which we want to insert the record.
+* {{{data}}} - The list which contains the record to be inserted.
+* Each tuple in the above list contains information about each individual field.
+ * Eg - {{{( "organisation_id","International Federation of Red Cross and Red Crescent Societies")}}}. Here, {{{organisation_id}}} is the label of the field in which we want to insert data {{{International Federation of Red Cross and Red Crescent Societies}}}
 ) 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))
+Determine the template(s) on which you wish to run this test on. The tests for each template are defined in {{{private/templates/<template_name>/tests.py}}}.
+Open tests.py for these templates and append the class name of the test to the list so it can be executed. (NOTE: We add the class name, not the function name).
+{{{
+current.selenium_tests.append("CreateStaff")
 }}}