QA/Desktop Firefox/Automation: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
 
(74 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= UNDER CONSTRUCTION =
''This is being refactored from the old documentation [https://wiki.mozilla.org/QA/Mozmill_Test_Automation here]''
''If you are looking for the Automation Services team, please go to their [[QA/Automation_Services|team page]].''
''If you are looking for the Automation Services team, please go to their [[QA/Automation_Services|team page]].''


Line 15: Line 11:


= The Team =
= The Team =
{|class="querytable"
{|class="querytable" style="width:60%"
  |-
  |-
  | class="header" | Person
  | class="header" | Person
| class="header" | Photo
  | class="header" | Location
  | class="header" | Location
  | class="header" | Role
  | class="header" | Role
  |-
  |-
  | [mailto:ahughes@mozilla.com Anthony Hughes] <br> IRC: ashughes
  | [mailto:ahughes@mozilla.com Anthony Hughes] <br> IRC: ashughes
|
  | Vancouver, Canada
  | Vancouver, Canada
  | Team Lead
  | Team Lead
  |-
  |-
  | Vlad Maniac <br> IRC: vladmaniac
  | Vlad Maniac <br> IRC: vladmaniac
|
  | Cluj, Romania
  | Cluj, Romania
  | Contractor Lead
  | Developer Lead
  |-
  |-
  | Alex Lakatos <br> IRC: AlexLakatos
  | Alex Lakatos <br> IRC: AlexLakatos
|
  | Cluj, Romania
  | Cluj, Romania
  | Developer
  | Developer
  |-
  |-
  | Remus Pop <br> IRC: remuspop
  | Andreea Matei <br> IRC: AndreeaMatei
|
  | Cluj, Romania
  | Cluj, Romania
  | Developer
  | Developer
Line 48: Line 39:
* Join the [http://www.mibbit.com/chat/?server=irc.mozilla.org&channel=%23automation #automation] IRC channel to ask about test automation
* Join the [http://www.mibbit.com/chat/?server=irc.mozilla.org&channel=%23automation #automation] IRC channel to ask about test automation


= Meetings =
= Weekly Project Status =
Every two weeks we meet to discuss the progress we have made, where we want to go, and how we are going to get there. You can learn a lot about what we do just by listening in to one of our meetings. '''These meetings are open to everyone.'''
The following is an archive of our weekly accomplishments and discussions.
 
* '''March 2012''': [[QA/Desktop_Firefox/Automation/Status:2012-03-02 | 2nd]], [[QA/Desktop_Firefox/Automation/Status:2012-03-09 | 9th]]
* '''February 2012''': [[QA/Desktop_Firefox/Automation/Status:2012-02-03 | 3rd]], [[QA/Desktop_Firefox/Automation/Status:2012-02-10 | 10th]], [[QA/Desktop_Firefox/Automation/Status:2012-02-17 | 17th]], [[QA/Desktop_Firefox/Automation/Status:2012-02-24 | 24th]]
 
= How You Can Help =
There are numerous ways you can help us with Mozmill test automation.
 
=== Running the Tests ===
By far, the easiest way you can help us is by running the tests using the [https://addons.mozilla.org/en-US/firefox/addon/mozmill-crowd/ Mozmill Crowd] extension. Results can be seen [http://mozmill-crowd.blargon7.com here]. If you notice any failures, report them by [http://bit.ly/wHfgTC filing a bug].
 
=== Getting Started with Development ===
* Familiarize yourself with some of our existing [http://hg.mozilla.org/qa/mozmill-tests/file/default/tests/functional functional tests]
* Familiarize yourself with the [https://developer.mozilla.org/en/Mozmill_Tests Mozmill Tests documentation] and try running some tests
* Review the list of open and unassigned bugs from one of the projects below, try to find something you want to work on
* Sign onto the #automation channel on IRC to get help or [mailto:ahughes@mozilla.com send an email] to Anthony Hughes
* Be sure to review our [https://developer.mozilla.org/en/Mozmill_Tests#Writing_Mozmill_tests development process] and [https://developer.mozilla.org/en/Mozmill_Tests/Commit_Policy commit policy] so you know what to expect, and what we expect of you
''Everyone on the automation team is willing and able to both help you get started and teach you the skills necessary to be successful. If you aren't sure where to get started or fear you don't have the skills to help, '''just ask!'''''
 
=== P1 Projects ===
==== Chemspill Regressions ====
The following is the life-cycle for a chemspill regression test.
# MozTrap smoketest is created, in-moztrap+ added to the bug in bugzilla
# Automate the MozTrap smoketest
# Remove the MozTrap smoketest from active testruns, in-qa-automation+ added to the bug in bugzilla
 
Firefox 13.0.1:
* {{drop|}} {{bug|756850}} Some combinations of Hebrew vowels and consonants not displayed in certain fonts with harfbuzz
** Out of scope for Mozmill, will be covered through in-testsuite automation
* {{drop|}} {{bug|736731}} Hotmail no longer auto-updates
** Out of scope for Mozmill due to live-site requirements, will be included in manual spotchecks
 
==== MozTrap Smoketests ====
; Not Doable
The following tests are not possible to automate due to technical dependencies and scope.
* [https://moztrap.mozilla.org/manage/case/328/ Download and view a PDF] (we could automate once the internal PDF viewer is enabled by default)
* [https://moztrap.mozilla.org/manage/case/325/ Breakpad end-to-end test] (probably only needs Mozmill 2.0 with crash detection)
* [https://moztrap.mozilla.org/manage/case/334/ Printing common file formats]
* Downloading and opening common file formats
** [https://moztrap.mozilla.org/manage/case/330/ DMG]
** [https://moztrap.mozilla.org/manage/case/331/ TAR]
** [https://moztrap.mozilla.org/manage/case/332/ EXE]
* Uninstalling Firefox
** [https://moztrap.mozilla.org/manage/case/324/ Linux]
** [https://moztrap.mozilla.org/manage/case/323/ Mac]
** [https://moztrap.mozilla.org/manage/case/321/ Win XP]
** [https://moztrap.mozilla.org/manage/case/322/ Win Vista, 7, 8]
* [https://moztrap.mozilla.org/manage/case/278/ Mozilla maintenance service]
* [https://moztrap.mozilla.org/manage/case/318/ Mac OSX code-sign verification]
* [https://moztrap.mozilla.org/manage/case/260/ Default installation and start Firefox]
 
; Doable
The following tests are possible to automate and are either assigned or available for anyone to assign to themselves.
 
* '''[ASSIGNED]''' [https://moztrap.mozilla.org/manage/case/266/ Video playback of popular formats] ({{bug|489474}})
* '''[FIXED]''' [https://moztrap.mozilla.org/manage/case/327/ Switch-to-Tab in the Awesomebar] ({{bug|779127}})
* '''[ASSIGNED]''' [https://moztrap.mozilla.org/manage/case/329/ Share your geo location] ({{bug|758187}})
* '''[FIXED]''' [https://moztrap.mozilla.org/manage/case/333/ Quit Firefox] ({{bug|757916}}


Meeting Information:
==== Firefox Features ====
<pre>
* [https://moztrap.mozilla.org/manage/cases/?filter-suite=31 Silent Updates]
  When: Mondays, 8am PT / 4pm GMT
* [https://moztrap.mozilla.org/manage/cases/?filter-suite=33 Show in-line PDF]
Dial-in: +1 (800) 707-2533 Password 369 Conference 654
* [https://moztrap.mozilla.org/manage/cases/?filter-suite=46 In-content Preferences]
</pre>


= Areas of Work =
=== P2 Projects ===
== Projects ==
{|class="querytable"
{| class="querytable"
|class="header" style="width:20%" | Project
|class="header" style="width:60%" | Description
|class="header" style="width:20%" | Open Bugs
|-
| '''Test Failures'''
| Fixing tests which have caused a failure and investigating for possible Firefox bugs
| [http://bit.ly/wByTFy mozmill-test-failure]
|-
| '''Test Refactoring'''
| Updating tests so that they conform to new coding guidelines and modules
| [http://bit.ly/t5HWZM mozmill-test-refactor]
|-
| '''Good First Bug'''
| Bugs which have been hand-picked for new contributors
| [http://bit.ly/szrMtZ good-first-bug]
  |-
  |-
  | class="header" | Project
  | '''Local Data'''
| class="header" | Summary
  | Writing minimized test cases to be used by the tests (web pages, add-ons, etc)
  | class="header" | Status
  | [http://bit.ly/x8zbLG mozmill-test-data]
  | class="header" | % COMPLETE
| class="header" | Documents
  |-
  |-
  | Failures
  | '''Endurance Tests'''
  | Repair broken tests
  | Writing tests which repeat the same task to stress memory usage
| 6 / 17
  | [http://bit.ly/yJq6VH mozmill-endurance]
| 33.3 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=2 worksheet]
  |-
  |-
  | Endurance
  | '''Smoketests'''
  | Tests measuring resource usage in various scenarios
  | Writing tests for the most basic functionality
| 6 / 27
  | [http://bit.ly/zGnG31 mozmill-smoketest]
| 23.1 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=6 worksheet]
  |-
  |-
  | Smoketests
  | '''Functional Tests'''
  | Tests covering the most basic functionality
  | Writing tests for more detailed functionality
| 15 / 32
  | [http://bit.ly/yTP5ri mozmill-functional]
| 45.5 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=0 worksheet]
  |-
  |-
  | Restart
  | '''l10n Tests'''
  | Tests requiring Firefox to restart
  | Writing tests to verify compatibility with the numerous languages supported by Firefox
| 19 / 29
  | [http://bit.ly/xogyOF mozmill-l10n]
| 65.5 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=8 worksheet]
  |-
  |-
  | Functional
  | '''Restart Tests'''
  | Tests covering more advanced functionality
  | Writing tests which verify functionality requiring restart (updates, add-ons, etc)
| 75 / 122
  | [http://bit.ly/ytXscT mozmill-restart]
| 61.5 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=7 worksheet]
  |-
  |-
  | l10n
  | '''Add-ons Tests'''
  | Tests for the numerous localizations/languages
  | Writing tests for specific add-ons (Selenium IDE, Google Toolbar, etc)
| 2 / 25
  | [http://bit.ly/zJxpLS mozmill-addons]
| 8 %
  | [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=9 worksheet]
  |}
  |}
''Prioritized by increasing complexity and decreasing need''


== How To Help ==
== Contributing ==
; Before you Begin
=== Before you Begin ===
* Learn about [https://developer.mozilla.org/en/Mozmill#Installation installing Mozmill]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#The_Mozmill-Test_repository the test repository]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#Running_Mozmill_tests running tests]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#Writing_Mozmill_tests writing tests]
* Learn about our [https://developer.mozilla.org/en/Mozmill_Tests/Commit_Policy commit policy]
 
=== Where to get Help ===
* Joining the [http://www.mibbit.com/chat/?server=irc.mozilla.org&channel=%23automation #automation] channel on IRC and ask for help
* Sending an email directly to [mailto:ahughes@mozilla.com Anthony Hughes]


; Getting Started
=== Getting Started ===
* Set up your Mozmill development environment (if you have not done so already)
* Set up your Mozmill development environment (if you have not done so already)
* Pick an project which fits best with your area of interest
* Pick an project which fits best with your area of interest
* Familiarize yourself with some existing code
* Familiarize yourself with some existing code
* Find a test you want to automate using the worksheet
* Pick a [[#Projects | project]] which interests you
* File a bug:
* Assign a bug to yourself or file a new one
** instructions for bug...
* Start coding
* Start coding
* Submit your first patch into the review process
* Submit your first patch into the review process
* '''''Remember to ask for help via [mailto:ahughes@mozilla.com email] or on irc.mozilla.org #automation'''''


; What to do when RESOLVED FIXED?
=== What to do when RESOLVED FIXED? ===
* Wait until the next day's testrun to appear on the dashboard, and verify that your test passes
* Wait until the next day's testrun to appear on the dashboard, and verify that your test passes
* Assuming it passes, update the worksheet
* Assuming it passes, update the worksheet
Line 125: Line 180:
<hr />
<hr />
Covered by Mozmill test:<br>
Covered by Mozmill test:<br>
<a href="URL TO TEST IN default BRANCH ON hg.mozilla.org">folder/testModule.js</a>
<a href="http://hg.mozilla.org/qa/mozmill-tests/file/default/tests/testFolder/testModule.js">
  testFolder/testModule.js
</a>
</pre>
</pre>
* Add the Litmus test to ''Aurora Mozmill Tests'' subgroup
* Add the Litmus test to ''Aurora Mozmill Tests'' subgroup
* ''should you be unable to perform any of the above duties, please comment in your bug''
* ''should you be unable to perform any of the above duties, please comment in your bug''
== l10n Tests ==
l10n Tests are used to verify the numerous language translations (locales) do not break functionality and UI in Firefox.
* [https://litmus.mozilla.org/show_test.cgi?searchType=by_category&product_id=1&branch_id=44&testgroup_id=271&subgroup_id= Manual testcases which need automation]
* [https://docs.google.com/spreadsheet/ccc?key=0AmkRt0ylPb8zdEhjOXRUak1MY1ViaS1zT2hBRWd4QlE&hl=en_US#gid=9 Worksheet for tracking UNASSIGNED and FIXED work]
* [https://bugzilla.mozilla.org/show_bug.cgi?id=562084 Tracking bug for l10n test development]
* [http://hg.mozilla.org/qa/mozmill-tests/file/default/tests/l10n Source code of the l10n Tests]
* [http://hg.mozilla.org/qa/mozmill-tests/file/default/lib Source code of the shared modules]
* [http://mozmill-release.brasstacks.mozilla.com/#/l10n/reports Dashboard of l10n test results]
= Getting Started =
To help you get started, we have put together a couple of guides:
* Learn about [https://developer.mozilla.org/en/Mozmill#Installation installing Mozmill]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#The_Mozmill-Test_repository the test repository]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#Running_Mozmill_tests running tests]
* Learn about [https://developer.mozilla.org/en/Mozmill_Tests#Writing_Mozmill_tests writing tests]
Of course, if you have any questions, you can always reach us by:
* Joining the [http://www.mibbit.com/chat/?server=irc.mozilla.org&channel=%23automation #automation] channel on IRC
* Sending an email directly to [mailto:ahughes@mozilla.com Anthony Hughes]

Latest revision as of 14:08, 18 October 2012

If you are looking for the Automation Services team, please go to their team page.

Overview

Mozilla QA uses Mozmill, a tool developed for test automation of applications based on the Gecko Platform (XUL Runner).

We use this tool to automate our manual tests in Litmus. The primary goal is to lessen the time we spend actively testing Smoketest, Basic Functional, and Full Functional level regression tests; enabling us to focus our time more on deep testing of bleeding-edge features and bugs.

An added benefit of using automation is that we can run tests across multiple platforms and locales in parallel, thereby increasing the coverage of regression tests in a smaller amount of time. To put that all into perspective, a single person running the BFTs on one platform and one locale takes about 8 hours. Mozmill can run the same tests across all platforms and all locales in a couple of hours.

The Mozmill tool and APIs are maintained and developed by the Automation Services team. The relatively small Desktop Automation team is responsible for developing the tests. This is where we need you, the community.

The Team

Person Location Role
Anthony Hughes
IRC: ashughes 		Vancouver, Canada Team Lead
Vlad Maniac
IRC: vladmaniac 		Cluj, Romania Developer Lead
Alex Lakatos
IRC: AlexLakatos 		Cluj, Romania Developer
Andreea Matei
IRC: AndreeaMatei 		Cluj, Romania Developer

You can get in contact with us in a few different ways:

  • Take part in a discussion on the mozmill-dev mailing list
  • Join the #mozmill IRC channel to ask about Mozmill
  • Join the #automation IRC channel to ask about test automation

Weekly Project Status

The following is an archive of our weekly accomplishments and discussions.

How You Can Help

There are numerous ways you can help us with Mozmill test automation.

Running the Tests

By far, the easiest way you can help us is by running the tests using the Mozmill Crowd extension. Results can be seen here. If you notice any failures, report them by filing a bug.

Getting Started with Development

  • Familiarize yourself with some of our existing functional tests
  • Familiarize yourself with the Mozmill Tests documentation and try running some tests
  • Review the list of open and unassigned bugs from one of the projects below, try to find something you want to work on
  • Sign onto the #automation channel on IRC to get help or send an email to Anthony Hughes
  • Be sure to review our development process and commit policy so you know what to expect, and what we expect of you

Everyone on the automation team is willing and able to both help you get started and teach you the skills necessary to be successful. If you aren't sure where to get started or fear you don't have the skills to help, just ask!

P1 Projects

Chemspill Regressions

The following is the life-cycle for a chemspill regression test.

  1. MozTrap smoketest is created, in-moztrap+ added to the bug in bugzilla
  2. Automate the MozTrap smoketest
  3. Remove the MozTrap smoketest from active testruns, in-qa-automation+ added to the bug in bugzilla

Firefox 13.0.1:

  • [DROPPED] bug 756850 Some combinations of Hebrew vowels and consonants not displayed in certain fonts with harfbuzz
    • Out of scope for Mozmill, will be covered through in-testsuite automation
  • [DROPPED] bug 736731 Hotmail no longer auto-updates
    • Out of scope for Mozmill due to live-site requirements, will be included in manual spotchecks

MozTrap Smoketests

Not Doable

The following tests are not possible to automate due to technical dependencies and scope.

Doable

The following tests are possible to automate and are either assigned or available for anyone to assign to themselves.

Firefox Features

P2 Projects

Project Description Open Bugs
Test Failures Fixing tests which have caused a failure and investigating for possible Firefox bugs mozmill-test-failure
Test Refactoring Updating tests so that they conform to new coding guidelines and modules mozmill-test-refactor
Good First Bug Bugs which have been hand-picked for new contributors good-first-bug
Local Data Writing minimized test cases to be used by the tests (web pages, add-ons, etc) mozmill-test-data
Endurance Tests Writing tests which repeat the same task to stress memory usage mozmill-endurance
Smoketests Writing tests for the most basic functionality mozmill-smoketest
Functional Tests Writing tests for more detailed functionality mozmill-functional
l10n Tests Writing tests to verify compatibility with the numerous languages supported by Firefox mozmill-l10n
Restart Tests Writing tests which verify functionality requiring restart (updates, add-ons, etc) mozmill-restart
Add-ons Tests Writing tests for specific add-ons (Selenium IDE, Google Toolbar, etc) mozmill-addons

Contributing

Before you Begin

Where to get Help

Getting Started

  • Set up your Mozmill development environment (if you have not done so already)
  • Pick an project which fits best with your area of interest
  • Familiarize yourself with some existing code
  • Pick a project which interests you
  • Assign a bug to yourself or file a new one
  • Start coding
  • Submit your first patch into the review process
  • Remember to ask for help via email or on irc.mozilla.org #automation

What to do when RESOLVED FIXED?

  • Wait until the next day's testrun to appear on the dashboard, and verify that your test passes
  • Assuming it passes, update the worksheet
  • Add the following boilerplate to the Litmus test
<hr />
Covered by Mozmill test:<br>
<a href="http://hg.mozilla.org/qa/mozmill-tests/file/default/tests/testFolder/testModule.js">
  testFolder/testModule.js
</a>
  • Add the Litmus test to Aurora Mozmill Tests subgroup
  • should you be unable to perform any of the above duties, please comment in your bug
Retrieved from "https://wiki.mozilla.org/index.php?title=QA/Desktop_Firefox/Automation&oldid=480971"