Changes between Initial Version and Version 1 of DeveloperGuidelines/Testing/Selenium

Timestamp:

03/27/12 09:30:43 (13 years ago)

Author:

Fran Boon

Comment:

Initial version for new test framework

DeveloperGuidelines/Testing/Selenium

@@ +1 @@
+= Testing =
+[[TOC]]
+"A bug is a test case you haven't written yet" [[BR]]
+"Unit Tests allow merciless [http://diveintopython.org/refactoring/refactoring.html refactoring]"
+
+Test-Driven Development is a programming styles which says that you 1st write your test cases (from the [BluePrints specs]) & then proceed to make them pass.
+
+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
+
+We are building our framework around the new WebDriver, despite having some legacy code in the older format:
+* http://seleniumhq.org/docs/appendix_migrating_from_rc_to_webdriver.html#why-migrate-to-webdriver
+
+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
+{{{
+pip install -U selenium
+}}}
+or
+{{{
+wget http://pypi.python.org/packages/source/s/selenium/selenium-2.20.tar.gz
+tar zxvf selenium-2.20.tar.gz
+cd selenium-2.20
+python setup.py install
+}}}
+
+== Running Tests ==
+Before running the Selenium scripts, you should put your database into a known state:
+{{{
+clean
+}}}
+
+For the whole test suite, it is assumed that you are using:
+{{{
+deployment_settings.base.prepopulate = 2
+}}}
+
+Run the whole test suite for the 'eden' application:
+{{{
+python web2py.py -S eden -M -R applications/eden/modules/tests/suite.py
+}}}
+Run a single test for the 'eden' application:
+{{{
+python web2py.py -S eden -M -R applications/eden/modules/tests/suite.py -A mytestfunction
+}}}
+
+== Writing Tests ==
+We aim to make it as easy as possible to write additional tests, which can easily be plugged into the suite.
+
+An example has been created: {{{eden/modules/tests/hrm/staff.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.
+
+The key is to make tests which are as least fragile as possible through:
+* State (we should eb able to run individual tests easilty, which check their current state as-required)
+* Deployment_Settings
+* Localisation
+* Theme
+
+This suggests refactoring tests to centralise common elements into a library to mean fixes should only happen in 1 place.
+
+There are a number of possible selectors to use to find your elements...the 'ID' may be the most stable, so don't be afraid of patching the code to add IDs where you'd like to be able to reach them reliably:
+* http://selenium.googlecode.com/svn/trunk/docs/api/py/selenium/selenium.selenium.html
+
+== !ToDo ==
+* Store results in a format suitable for use by CI
+* Namespacing of tests
+* Include timings
+* Run from Nose?
+ * http://blog.shiningpanda.com/2011/12/introducing-selenose.html
+
+== See Also ==
+ * TestCases - User Testing - List of things to test
+ * http://code.google.com/p/selenium/wiki/PageObjects - Style suggestion