1
edit
Changes
→Framework Configuration
=Framework Configuration=
==Configure the environment==
#Make sure the [[Firefox_Performance_Testing_:_A_Python_framework_for_Windows_Documentation#Framework_Prerequisites | prerequisites]] are installed.
#Make a directory for the framework:<pre>$mkdir C:\mozilla</pre>
#Download entire framework (directories and all subdirectories) and put it in '''C:\mozilla'''
===BASE_PROFILE_DIR===*Path to the base profile directory used for testing.*Check that BASE_PROFILE_DIR is pointing to the '''base_profile''' directory*If you didn't alter the dir structure, it would be: '''C:\mozilla\testing\performance\win32\base_profile''' *Check there is content in the base_profile directory*(Optional) For the page load test to work, modify the '''hostperm.1''' file**Set to allow urls with scheme:file to open in new windows**Set the preference to open new windows in a tab should be off. ==REPORTS_DIR==**Path to the directory that the generated reports will go into**Create '''extension_perf_reports''' in '''C:\extension_perf_reports or configure mozilla\testing\performance\win32\''' OR **Configure REPORT_DIR path to point to a directory where you want the reports to go into
*INIT_URL
**Path to the file url to load when initializing a new profile
**Check that '''initialize.html''' is in '''C:\mozilla\testing\performance\win32\'''
**Note: Don't change the local file url to a file path
<pre>INIT_URL = 'file:///c:/mozilla/testing/performance/win32/initialize.html'</pre>
*TS_URL
**The path to the file url to load for startup test (Ts)
**Check that '''startup_test.html''' is in '''C:\mozilla\testing\performance\win32\startup_test'''
**Note: Don't change the local file url to a file path
<pre>TS_URL = 'file:///c:/mozilla/testing/performance/win32/startup_test/startup_test.html?begin='</pre>
*TP_URL
**The path to the file url to load for page load test (Tp) **Check that '''cycler.html''' is in '''C:\mozilla\testing\performance\win32\page_load_test'''**Note: Don't change the local file url to a file path <pre>TP_URL = 'file:///c:/mozilla/testing/performance/win32/page_load_test/cycler.html'</pre>
#Create a YAML config file (config.yaml) with info about the profiles you want to test. Copy and paste the following into config.yaml:
<pre>
# Filename will be appended to the timestamp in the report filename.
# Use letters and underscores only
filename: slowmachineyourfilename
# The title of the report
title: 1 GHz Celeron
***use "preferences : {}" for no prefs
***use "extensions: {}" for none
**filename and title can be anything
5. Run '''run_tests.py''' with the name of your config file as an argument: <pre>$run_tests. py config.yaml</pre>*You can use a space-separated list of config files, to generate a report of startup and page load times. The report will be placed in the REPORTS_DIR directory you specified in paths.py.
=Directory Structure of Framework=