| | 1 | The rebaselining tool automatically produces new expected results using the layout test results from buildbots. The goal is that after running this tool, the working copy will be ready to create a change containing all new baselines. |
| | 2 | |
| | 3 | The tool is written in Python and lives in `WebKitTools/Scripts` ([http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/rebaseline-chromium-webkit-tests]). |
| | 4 | |
| | 5 | ''pasted from [http://code.google.com/p/chromium/wiki/RebaseliningTool], needs editing'' |
| | 6 | |
| | 7 | == How does this tool work? == |
| | 8 | The script does the following for each platform: |
| | 9 | * Compile a list of tests that need rebaseline. |
| | 10 | * Download test result archive from buildbot for the platform. |
| | 11 | * Extract baselines from the archive file for all identified files. |
| | 12 | * Add new baselines to SVN repository. For GIT repository, you need to manually "git add" all the new baseline files. |
| | 13 | * For each test that has been rebaselined, remove this platform option from the test in _test_expectation.txt_. If no other platform options remaining after removal, delete the test from the file. |
| | 14 | |
| | 15 | After new baselines are generated, the tool launches a html page to compare the old and new baselines. The html can be disabled by option "--no_html_results". |
| | 16 | |
| | 17 | == How to use it? == |
| | 18 | * Make sure the test files (.html) exist at _src\webkit\data\layout_tests_ in repository. If not, add the html files there and commit them. By default, the rebaselining tool retrieves new baselines from the release version of buildbot layout test archive. If you add a new test, you need to wait for buildbot to run layout tests and the actual result for the test has been archived before you can rebaseline it using this tool. Check the *RELEASE* version of [http://build.chromium.org/buildbot/layout_test_results/ buildbot layout archive] to see whether your new test is available. |
| | 19 | * Update _test_expectations.txt_ at _src\webkit\tools\layout_tests_: add option *REBASELINE* to the tests that need to be rebaselined. |
| | 20 | * Run rebaselining script: *rebaseline.bat* for Windows and *rebaseline.sh* for Linux and Mac. The script can be found at _src\webkit\tools\layout_tests_. If you want to pull new baselines from webkit.org canary, run rebaseline.bat or rebaseline.sh with option *--webkit_canary*. |
| | 21 | * If the script runs successfully, new baselines (expected files) are added to SVN repository and the rebaselined tests are removed from _test_expectations.txt_. |
| | 22 | * The tool launches a html page to compare the old and new baselines. Check the new baseline changes are expected. |
| | 23 | * Prepare a patch with the new baselines and _test_expectations.txt_, review the changes and then commit the patch. |
| | 24 | |
| | 25 | == Examples == |
| | 26 | We need rebaseline test _LayoutTests/foo1.html_ for all three platforms and test _LayoutTests/foo2.html_ for *win* and *linux*. |
| | 27 | |
| | 28 | * Make sure test files _foo1.html_ and _foo2.html_ have been committed at _src\webkit\data\layout_tests\LayoutTests_. If these are tests just added, make sure the layout tests ran at buildbot and the test results have been archived. |
| | 29 | * Update _test_expectations.txt_ to include the following lines: |
| | 30 | {{{ |
| | 31 | BUG1234 REBASELINE : LayoutTests/foo1.html = FAIL |
| | 32 | BUG5678 REBASELINE WIN LINUX : LayoutTests/foo2.html = FAIL |
| | 33 | }}}http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/rebaseline-chromium-webkit-tests |
| | 34 | |
| | 35 | If foo1 and foo2 already exist, add option "*REBASELINE*" to the existing tests. |
| | 36 | * Run rebaseline script on *Windows* machine: |
| | 37 | {{{ |
| | 38 | open a command window |
| | 39 | change the directory to [YOUR CHROMUIM DIRECTORY]\src\webkit\tools\layout_tests |
| | 40 | rebaseline.bat |
| | 41 | }}} |
| | 42 | |
| | 43 | * Run rebaseline script on *Linux* or *Mac* machine |
| | 44 | {{{ |
| | 45 | open a shell |
| | 46 | change the directory to [YOUR CHROMUIM DIRECTORY]/src/webkit/tools/layout_tests |
| | 47 | ./rebaseline.sh |
| | 48 | }}} |
| | 49 | |
| | 50 | NOTE: *you only need to run the script on ONE platform. The tool will auto generate new baselines for ALL three platforms*. |
| | 51 | |
| | 52 | * Check tests foo1 and foo2 are removed from test_expectations.txt. |
| | 53 | |
| | 54 | * Create a patch |
| | 55 | {{{ |
| | 56 | gcl change [YOUR PATCH NAME] |
| | 57 | }}} |
| | 58 | Review the changes and then commit it. Don't check in with any tests still marked REBASELINE, as this will prevent others from cleanly using the tool. |
| | 59 | |
| | 60 | * The tool launches a html to compare new baselines with old baselines. Here is an example of the baseline result comparison html: |
| | 61 | [http://www.corp.google.com/~victorw/chromium/rebaseline_html/rebaseline.html Baseline Result Comparison HTML] |
| | 62 | |
| | 63 | == Notes to GIT user == |
| | 64 | If you are using GIT repository, you need to manually "git add" all the new baseline files before creating patch. |
