Side by Side Diff: README.md
Issue 29328998:
Issue 132 - Add REAMDE to adblockplustests repository (Closed)
Patch Set: Addressed feedback
Created Oct. 12, 2015, 11:04 a.m.
| Left: | ||
| Right: |
Use n/p to move between diff chunks;
N/P to move between comments.
« no previous file with comments
|
« no previous file
|
no next file »
|
no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')
| OLD | NEW |
|---|---|
| (Empty) | |
| 1 # Adblock Plus Tests | |
| 2 | |
| 3 ## Introduction | |
| 4 | |
| 5 The `adblockplustests` repository contains the test suite for the Adblock Plus | |
| 6 extension in Firefox. This test suite is itself a separate Firefox extension | |
| 7 which interacts with the Adblock Plus extension in order to test it. | |
| 8 (It is therefore assumed that the tests should pass when the latest available | |
| 9 revisions of `adblockplus` and `adblockplustests` are used in combination.) | |
| 10 | |
| 11 Some of the tests in this test suite are also reused by the Chrome/Opera/Safari | |
| 12 version of Adblock Plus. Please see the `adblockpluschrome` repository for | |
| 13 details on how to run the tests there. | |
| 14 | |
| 15 | |
| 16 ## Usage | |
| 17 | |
| 18 To test your changes to Adblock Plus for Firefox you will need to build and | |
| 19 install both your modified version of the extension and the test suite. For | |
| 20 each project you will need to type the following: | |
| 21 | |
| 22 ./build.py build | |
| 23 | |
| 24 This will create a build with a name in the form | |
| 25 `adblockplus[tests]-1.2.3.nnnn.xpi`, which you can then manually add to Firefox. | |
| 26 | |
| 27 Alternatively, to speed up the process, you can install the | |
| 28 [Extension Auto-Installer](https://addons.mozilla.org/addon/autoinstaller) | |
| 29 extension. Assuming that Extension Auto-Installer is configured to use port 8888 | |
| 30 (the default value), you can build and install in one step by running: | |
| 31 | |
| 32 ./build.py autoinstall 8888 | |
| 33 | |
| 34 Once both the Adblock Plus and Adblock Plus Tests extensions have been built and | |
| 35 installed you can run the test suite by opening the Firefox Add-ons Manager, | |
| 36 pressing the "Preferences" button for the Adblock Plus Tests extension and then | |
| 37 pressing the "Run" button. | |
| 38 | |
| 39 Things to note: | |
| 40 | |
| 41 - The test suite can take some time to run, sometimes several minutes. | |
| 42 - If you re-install the Adblock Plus Tests extension you will need to re-load | |
| 43 the preferences page before pressing "Run" again. Otherwise the tests will not | |
| 44 re-start. | |
| 45 - Some tests are currently known to fail (sometimes depending on your browser | |
| 46 version and configuration). It is recommended to run the test suite first, | |
| 47 before making any changes, to check which tests are expected to fail. | |
| OLD | NEW |
« no previous file with comments
|
« no previous file
|
no next file »
|
no next file with comments »
