canmove, Confirmed users, Bureaucrats and Sysops emeriti
4,714
edits
Line 15: | Line 15: | ||
The central piece of the extension is its storage folder. It is used to hold all necessary tools and applications, and the test results and acquired test data. Due to limitations with the virtual environment scripts the path of the storage folder cannot contain a blank. That's why it cannot be automatically stored in the users Firefox profile, but has to be chosen by the user himself. | The central piece of the extension is its storage folder. It is used to hold all necessary tools and applications, and the test results and acquired test data. Due to limitations with the virtual environment scripts the path of the storage folder cannot contain a blank. That's why it cannot be automatically stored in the users Firefox profile, but has to be chosen by the user himself. | ||
==The Test Environment== | The following sub-folders exists in the storage: | ||
{| class="fullwidth-table" | |||
| style="background: #eee; width: 50%" | '''Tool / Module''' | |||
| style="background: #eee; width: 50%" | '''Updatability''' | |||
|- | |||
| mozmill-automation | |||
| Mozmill automation scripts which will be executed by the extension | |||
|- | |||
| mozmill-env | |||
| The Mozmill test environment which is necessary to run Mozmill tests | |||
|- | |||
| mozmill-tests | |||
| The most recent set of Mozmill tests | |||
|- | |||
| reports | |||
| Reports which have been created during the test-runs. | |||
|- | |||
| screenshots | |||
| Screenshots which have been automatically created by some tests | |||
|- | |||
|} | |||
===The Test Environment=== | |||
Before Mozmill tests can be run on a machine, the test environment has to be installed first. It includes all necessary tools and modules which are necessary to run Mozmill and to execute our automation scripts. The environment is a part of the storage folder. | Before Mozmill tests can be run on a machine, the test environment has to be installed first. It includes all necessary tools and modules which are necessary to run Mozmill and to execute our automation scripts. The environment is a part of the storage folder. | ||
Line 22: | Line 45: | ||
For the installation of additional Python modules a virtual environment is used. That ensures that we do not change any configuration of the users system and stay local in our sandbox. All the modules will be installed during the setup of the test environment. Update checks will happen in the background each time the Mozmill Crowd dialog gets opened by the user. | For the installation of additional Python modules a virtual environment is used. That ensures that we do not change any configuration of the users system and stay local in our sandbox. All the modules will be installed during the setup of the test environment. Update checks will happen in the background each time the Mozmill Crowd dialog gets opened by the user. | ||
===Windows=== | ====Windows==== | ||
The biggest chunk of the test environment on Windows is the Python interpreter itself. It's necessary because it is not a default application on Windows. Otherwise there is no dependency on other software. | The biggest chunk of the test environment on Windows is the Python interpreter itself. It's necessary because it is not a default application on Windows. Otherwise there is no dependency on other software. | ||
Line 49: | Line 72: | ||
|} | |} | ||
===OS X=== | ====OS X==== | ||
The setup of the test environment on OS X only works with the Python package installed with the system. Any other package installed i.e. via Mac Ports does not work, because the Python headers are not available. | The setup of the test environment on OS X only works with the Python package installed with the system. Any other package installed i.e. via Mac Ports does not work, because the Python headers are not available. | ||
Line 76: | Line 99: | ||
|} | |} | ||
===Linux=== | ====Linux==== | ||
The setup of the test environment only works when the Python headers are installed, i.e. for Debian and Ubuntu it will be python-dev. | The setup of the test environment only works when the Python headers are installed, i.e. for Debian and Ubuntu it will be python-dev. | ||
Line 111: | Line 134: | ||
=== Preferences Dialog === | === Preferences Dialog === | ||
=TBD= | =TBD= |