dom/imptests/README@129ffea94266 (annotated)
dom/imptests/README
Sat, 03 Jan 2015 20:18:00 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Sat, 03 Jan 2015 20:18:00 +0100
- branch
- TOR_BUG_3246
- changeset 7
- 129ffea94266
- permissions
- -rw-r--r--
Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.
| michael@0 | 1 | This directory contains tests imported from W3C test suites. In order to make it |
| michael@0 | 2 | as easy as possible to update these tests, no changes are made to the imported |
| michael@0 | 3 | files (names for scripted tests do get a test_ prefix to integrate with the test |
| michael@0 | 4 | runner, however). The scripts to update tests are provided. |
| michael@0 | 5 | |
| michael@0 | 6 | |
| michael@0 | 7 | ======================= |
| michael@0 | 8 | Files in this directory |
| michael@0 | 9 | ======================= |
| michael@0 | 10 | |
| michael@0 | 11 | Source; Usage and purpose; License |
| michael@0 | 12 | |
| michael@0 | 13 | * testharness.js / testharness.css |
| michael@0 | 14 | Directly imported from the W3C repository (<http://dvcs.w3.org/hg/resources>), |
| michael@0 | 15 | with the updateTestharness.py script. |
| michael@0 | 16 | Provide the test harness. |
| michael@0 | 17 | W3C Test Suite License / W3C 3-clause BSD License |
| michael@0 | 18 | |
| michael@0 | 19 | * idlharness.js |
| michael@0 | 20 | Directly imported from the W3C repository (<http://dvcs.w3.org/hg/resources>), |
| michael@0 | 21 | with the updateTestharness.py script. |
| michael@0 | 22 | Used to test WebIDL. |
| michael@0 | 23 | W3C Test Suite License / W3C 3-clause BSD License |
| michael@0 | 24 | |
| michael@0 | 25 | * WebIDLParser.js |
| michael@0 | 26 | Directly imported from the W3C repository (<http://dvcs.w3.org/hg/resources>), |
| michael@0 | 27 | with the updateTestharness.py script. |
| michael@0 | 28 | Used by idlharness.js to parse IDL blocks. |
| michael@0 | 29 | MIT License |
| michael@0 | 30 | |
| michael@0 | 31 | * updateTestharness.py |
| michael@0 | 32 | Used to update the above files. |
| michael@0 | 33 | MPL |
| michael@0 | 34 | |
| michael@0 | 35 | * parseManifest.py |
| michael@0 | 36 | Imported from <https://bitbucket.org/ms2ger/test-runner>. Parses MANIFEST |
| michael@0 | 37 | files (provided in the W3C repository) as documented at |
| michael@0 | 38 | <https://bitbucket.org/ms2ger/test-runner/raw/tip/manifests.txt>. |
| michael@0 | 39 | MIT License |
| michael@0 | 40 | |
| michael@0 | 41 | * testharnessreport.js |
| michael@0 | 42 | Glue between testharness.js and our Mochitest runner. |
| michael@0 | 43 | MPL |
| michael@0 | 44 | |
| michael@0 | 45 | * importTestsuite.py |
| michael@0 | 46 | Imports a test suite from a remote repository. Takes one argument, a file in |
| michael@0 | 47 | the format described under webapps.txt. |
| michael@0 | 48 | Note: removes both source and destination directory before starting. Do not |
| michael@0 | 49 | use with outstanding changes in either directory. |
| michael@0 | 50 | MPL |
| michael@0 | 51 | |
| michael@0 | 52 | * parseFailures.py |
| michael@0 | 53 | Parses failures out of a mochitest log and writes out JSON files and Makefiles |
| michael@0 | 54 | into the correct failures/ folder. |
| michael@0 | 55 | The mochitest log should be produced by setting the 'dumpFailures' flag in |
| michael@0 | 56 | testharnessreport.js; this will print out the encountered failures, marked |
| michael@0 | 57 | by @ signs. |
| michael@0 | 58 | MPL |
| michael@0 | 59 | |
| michael@0 | 60 | * writeBuildFiles.py |
| michael@0 | 61 | Helper functions to write out automatically generated build files. |
| michael@0 | 62 | MPL |
| michael@0 | 63 | |
| michael@0 | 64 | * Makefile.in |
| michael@0 | 65 | Integration with our build system. Installs support files into /resources and |
| michael@0 | 66 | includes a .mk file for each repository. |
| michael@0 | 67 | MPL |
| michael@0 | 68 | |
| michael@0 | 69 | * failures/ |
| michael@0 | 70 | Expected failures for tests in each repository. Each test's failures, if |
| michael@0 | 71 | any, are in a file with the same path and name with .json appended. New |
| michael@0 | 72 | expected fail files currently needed to be added manually to makefiles. |
| michael@0 | 73 | |
| michael@0 | 74 | * html.mk / webapps.mk / ... |
| michael@0 | 75 | Generated by importTestsuite.py from webapps.txt. |
| michael@0 | 76 | Contains a list of the directories with tests. To be included in Makefile.in. |
| michael@0 | 77 | |
| michael@0 | 78 | * html.txt / webapps.txt / ... |
| michael@0 | 79 | Input to importTestsuite.py. |
| michael@0 | 80 | Lists the URL of the repository and the destination directory (separated by a |
| michael@0 | 81 | vertical bar), followed by a list of directories within the repository |
| michael@0 | 82 | (separated by line feeds). |
| michael@0 | 83 | |
| michael@0 | 84 | * html / webapps / ... |
| michael@0 | 85 | Actual tests. |
| michael@0 | 86 | W3C Test Suite License / W3C 3-clause BSD License |
| michael@0 | 87 | |
| michael@0 | 88 | |
| michael@0 | 89 | ===================================================================== |
| michael@0 | 90 | Importing an additional directory from an already-imported repository |
| michael@0 | 91 | ===================================================================== |
| michael@0 | 92 | |
| michael@0 | 93 | Add a line to the relevant data file (e.g. webapps.txt), with the path to the |
| michael@0 | 94 | additional directory relative to the root of the remote repository, and then run |
| michael@0 | 95 | the importTestsuite.py script, passing the data file as its argument. |
| michael@0 | 96 | |
| michael@0 | 97 | |
| michael@0 | 98 | ========================== |
| michael@0 | 99 | Importing a new test suite |
| michael@0 | 100 | ========================== |
| michael@0 | 101 | |
| michael@0 | 102 | Create a data file in the format documented above, and run the |
| michael@0 | 103 | importTestsuite.py script, passing the data file as its argument. |
| michael@0 | 104 | This will create a foo.mk file; include this file in dom/imptests/Makefile.in. |
| michael@0 | 105 | |
| michael@0 | 106 | Add any necessary files in failures/. |
