Bugzilla:QA: Difference between revisions

Bugzilla:QA (view source)

Revision as of 22:20, 11 March 2010

222 bytes removed , 11 March 2010

Cleaned up! General wordsmithing, including making text more clear & concise, and removing personal pronouns. No actual content was changed.

Mrbball

1

edit

@@ Line 10: / Line 10: @@
 == Running Selenium scripts ==
-Till Bugzilla 3.0.x, Selenium tests were all written in HTML, which were the executed from a web browser. It has been decided for Bugzilla 3.2 RC1 and newer to convert them to Perl, giving us more flexibility and control. We no longer write test scripts in HTML.
+Prior to Bugzilla 3.2, Selenium tests were all written in HTML and executed from a web browser. As of Bugzilla 3.2 RC1 they have been converted to Perl, allowing more flexibility and control.
-All our current Selenium scripts can be downloaded using bzr. For instance, to download Perl scripts for Bugzilla 3.6, type:
+A read-only copy of the current Selenium scripts can be downloaded using bzr with:
   bzr co bzr://bzr.mozilla.org/bugzilla/qa/3.6
-Other available branches are listed [http://bzr.mozilla.org/bugzilla/qa/ here].
+A read/write copy can also be downloaded with:
+ bzr co bzr+ssh://''login''@bzr.mozilla.org/bugzilla/qa/3.6
+where ''login'' is your LDAP account. All available releases are listed [http://bzr.mozilla.org/bugzilla/qa/ here].
-Users having write access to our bzr repository must use this command:
+'''Note:''' The HTML scripts to work as is. They were based on a particular landfill installation which contained specific user accounts, products, components and parameters.  Thus, they will not run on a fresh test installation. They are only available to show how the tests worked prior to Bugzilla 3.2.
-  bzr co bzr+ssh://your_login@bzr.mozilla.org/bugzilla/qa/3.6
-where your_login is your LDAP account.
-'''Note:''' Do not expect the HTML scripts to work as is. They were based on a given test installation on landfill having some given user accounts, products, components and parameters, and so they won't run on a fresh test installation. They are only available so that you can see what we did till Bugzilla 3.0.
+As of Bugzilla 3.2, a script named <em>config/generate_test_data.pl</em> will automatically populate new installations, allowing the Selenium and WebService tests to be executed.
+'''Note 1:''' The Bugzilla installation to test must already exist, and must already have its important parameters configured (i.e. ''urlbase'', ''cookiepath'', and ''mail_delivery_method''). It is recommended that ''mail_delivery_method'' be set to '''Test''', unless "actual" bug mail is desired.
-Bugzilla 3.2 and newer have a script named <em>config/generate_test_data.pl</em> which populates your fresh new installation automatically so that you can run our Selenium and WebService tests yourself on your own installation.
+'''Note 2:''' Before executing <em>generate_test_data.pl</em>, make sure the parameters in <em>config/selenium_test.conf</em> are set correctly. This configuration file must match the Bugzilla configuration, especially the ''urlbase'' parameter and the path to the browser ([http://seleniumhq.org/download/ Selenium RC 1.0.1] works with Firefox 3.5, but not with Firefox 3.6). If ''mail_delivery_method'' is set to '''Test''', fake user accounts can be defined in the config file.
-'''Note 1:''' your Bugzilla installation must already exists, and you must already have configured most important parameters (such as the urlbase, cookiepath, and mail_delivery_method* parameters (* set it to 'Test' ideally, unless you really want to get bugmail)).
+Once the DB is populated, start the Selenium server and execute the scripts in t/. To start the Selenium server, either execute <em>config/selenium_server_start.t</em> (which requires the [http://search.cpan.org/~hisso/Alien-SeleniumRC/ Alien::SeleniumRC] Perl module to be installed) or enter:
-'''Note 2:''' Before running <em>generate_test_data.pl</em>, make sure that you set parameters in <em>config/selenium_test.conf</em> correctly. This configuration file must match your local configuration, especially the url to your installation (urlbase), as well as the path to your browser ([http://seleniumhq.org/download/ Selenium RC 1.0.1] works with Firefox 3.5, but not with Firefox 3.6). If you set mail_delivery_method to 'Test', you can define fake user accounts in the config file.
-Once the DB is populated, you can start the Selenium server and run our scripts located in t/. To start the Selenium server, you can either run <em>config/selenium_server_start.t</em> (which requires the [http://search.cpan.org/~hisso/Alien-SeleniumRC/ Alien::SeleniumRC] Perl module to be installed) or you can type:
   java -jar /path/to/selenium-server.jar
-which is exactly what Alien::SeleniumRC is doing. If you didn't install Alien::SeleniumRC, then you must extract <em>selenium-server.jar</em> from the [http://seleniumhq.org/download/ Selenium RC] ZIP file (generally, the JAR file provided by SeleniumRC is more recent than the one found in Alien::SeleniumRC). To run the scripts, go into the t/ directory and type:
+which is exactly what Alien::SeleniumRC does. If Alien::SeleniumRC was not installed, extract <em>selenium-server.jar</em> from the [http://seleniumhq.org/download/ Selenium RC] ZIP file (generally, the JAR file provided by SeleniumRC is more recent than the one found in Alien::SeleniumRC). To execute the scripts, go into the t/ directory and enter:
   prove -v --timer *.t
--v will make the output verbose and --timer will display the time it takes to run each script. Both options are optional. Note that you must have the [http://search.cpan.org/~lukec/Test-WWW-Selenium/ Test::WWW::Selenium] Perl module installed in order to have the scripts to run as it will be the interface between Perl and Selenium!
+-v will make the output verbose and --timer will display the time it takes to execute each script. Both options are optional. Note that the [http://search.cpan.org/~lukec/Test-WWW-Selenium/ Test::WWW::Selenium] Perl module must be installed in order for the scripts to execute.  It is the interface between Perl and Selenium!
 == Writing Selenium scripts ==