Confirmed users
1,927
edits
Auto-tools/Projects/peptest: Difference between revisions
Jump to navigation
Jump to search
→Using Peptest
| Line 11: | Line 11: | ||
=== Running Tests === | === Running Tests === | ||
==== Standalone ==== | |||
Currently tests are run from the command line with python.<br> | Currently tests are run from the command line with python.<br> | ||
| Line 25: | Line 25: | ||
#Run the command (use --help for a full list of options)<br><pre>peptest --binary <path_to_binary> --test-path <path_to_test_manifest></pre> | #Run the command (use --help for a full list of options)<br><pre>peptest --binary <path_to_binary> --test-path <path_to_test_manifest></pre> | ||
==== From within mozilla-central ==== | |||
After building, go to your obj dir and type 'make peptest'. This will run all tests in proxy mode, i.e., without accessing the network. | After building, go to your obj dir and type 'make peptest'. This will run all tests in proxy mode, i.e., without accessing the network. | ||
| Line 146: | Line 146: | ||
'''Important:''' You cannot compare the metric from one test to that of another. Tests can be of an arbitrary length and therefore it is impossible to conclude that a test with a metric of 10 is more responsive than a test with a metric of 1000. You must only compare metric values to previous metric values of the same test. | '''Important:''' You cannot compare the metric from one test to that of another. Tests can be of an arbitrary length and therefore it is impossible to conclude that a test with a metric of 10 is more responsive than a test with a metric of 1000. You must only compare metric values to previous metric values of the same test. | ||
=== Proxying to local files to avoid network access === | |||
Peptest can be configured to proxy all network requests to local files. There are three related options: | |||
* --proxy: This option must be given with the location to a text file specifying what URLs should be proxied. The file should have one or more lines in the form <URL> [<options>]. See peptest/tests/firefox/server-locations.txt for an example (as used in buildbot). | |||
* --server-path: This must be set to the path to a directory serving as the root of the local web server. | |||
* --proxy-host-dirs: This indicates that the files in the web server root should be organized according to URL. Without this option, the same content, as found in the server path, is served for all proxied URLs. With this option, the web server root should have one directory per URL. See peptest/tests/firefox/server/ for an example of how the server root should be structured when --proxy-host-dirs is given (as used in buildbot). | |||
== Further Work == | == Further Work == | ||