OLD | NEW |
---|---|
(Empty) | |
1 W3C Web Platform Tests in Blink Layout Tests | |
2 | |
3 Design Doc: https://goo.gl/iXUaZd | |
4 | |
5 This directory contains checked out and reduced code from web-platform-tests | |
6 (https://github.com/w3c/web-platform-tests/) required to run WPT tests as part | |
Dirk Pranke
2015/06/15 23:41:48
nit: "run the WPT tests as part of Blink's test in
burnik
2015/06/16 09:24:34
Done.
| |
7 of Blink Layout Tests as well as some maintenance and configuration code. | |
Dirk Pranke
2015/06/15 23:41:48
Please mention that this directory also contains c
burnik
2015/06/16 09:24:34
Done.
| |
8 | |
9 The third party code lives in the wpt subdirectory: | |
10 Tools/Scripts/webkitpy/thirdparty/wpt/wpt | |
11 | |
12 For licensing, see README.chromium in parent directory | |
13 (Tools/Scripts/webkitpy/thirdparty/README.chromium). | |
14 | |
15 ** | |
16 | |
17 Files in this directory (non third-party) | |
18 | |
19 README.chromium | |
20 =============== | |
21 This file. | |
22 | |
23 wpt.config.json | |
24 =============== | |
25 The configuration file used when running WPTServe. Note that this file loads | |
26 after wpt/config.default.json and this configuration gets merged onto it. When | |
27 changing the ports (HTTP/S, WS/S), make sure to update the python code too. | |
28 | |
29 checkout.sh | |
30 =========== | |
31 Running this script without arguments will remove the existing checkout | |
32 (thirdparty/wpt/wpt) and perform a fresh one. See "Rolling in WPT" for more. | |
33 | |
34 WPTHeads | |
35 ======== | |
36 List of git commit-ish for the WPT repositories. File format is as follows: | |
37 First line: HEAD position for web-platform-tests. | |
38 Rest of lines: parent directory, submodule name, HEAD position for submodule. | |
39 The submodule checkout is performed in order when running ./checkout.sh. | |
40 | |
41 WPTWhiteList | |
42 ============ | |
43 The explicit list of files being kept, everything else not on this list is | |
44 deleted when running "./checkout.sh reduce". Use this file to control what gets | |
45 checked in and try to keep the list as small as possible (use what you need). | |
46 | |
47 ** | |
48 | |
49 Rolling in WPT | |
50 | |
51 When rolling in new versions of WPT support, use WPTHeads to adjust the HEAD | |
52 positions. You can then call "./checkout.sh clone" which will pull in all the | |
53 code and required submodules. | |
54 | |
55 You can check in the latest code by setting the HEAD commit-ish to "master" on | |
56 each line, afterwards make sure to use the actual SHA1s to lock down the HEAD | |
57 positions. | |
58 | |
59 You can examine what's pulled in and update WPTWhiteList if some new files are | |
60 required to run the updated version. | |
61 | |
62 Once you've cloned the repositories you can call "./checkout.sh reduce" to | |
63 remove everything that is not listed in WPTWhiteList. | |
64 | |
65 Note that calling "./checkout.sh" without arguments is equivalent of calling | |
66 "./checkout.sh clone reduce". | |
67 | |
68 ** | |
69 | |
70 Configuration | |
71 | |
72 Read instructions in WPT README: | |
73 https://github.com/w3c/web-platform-tests/blob/master/README.md | |
74 | |
75 Also, check out the WPTServe Documentation | |
76 (https://wptserve.readthedocs.org/en/latest/). | |
77 | |
78 For setting up SSL, refer to Tools/Scripts/webkitpy/thirdparty/wpt/wpt/_certs | |
79 (which gets generated on the first run). | |
80 | |
81 | |
82 ** | |
83 | |
84 Running web-platform tests with enabled WPTServe on a local machine | |
85 | |
86 Starting run-webkit-tests with the --enable-wptserve flag will use the WPT | |
87 serve for tests which live in LayoutTests/imported/web-platform-tests. | |
88 | |
89 WPTServe starts HTTP/S and WS/S servers as separate processes. | |
90 | |
91 The content_shell used to run the tests will receive the URL of each test | |
92 (instead of a filename). The document root http://web-platform.test/ maps to | |
93 LayoutTests/imported/web-platform-tests. HTTPS tests are enabled by default. | |
94 | |
95 Example run: | |
96 | |
97 ./Tools/Scripts/run-webkit-tests \ | |
98 --debug \ | |
99 --enable-wptserve \ | |
100 --no-new-test-results \ | |
101 imported/web-platform-tests | |
OLD | NEW |