mirror of
https://github.com/dart-lang/sdk
synced 2024-09-06 00:59:09 +00:00
Updating gardening tools readme with info about overlapping sections.
This updates the information in the README.md file regarding overlapping sections, how it is invoke and the result from running it. Bug: Change-Id: I7c8c057ad73d5893c3ff69e4588e0f234f2d5832 Reviewed-on: https://dart-review.googlesource.com/27620 Reviewed-by: Jonas Termansen <sortie@google.com>
This commit is contained in:
parent
6e3d94ab1a
commit
20da198715
|
@ -8,6 +8,7 @@ work.
|
|||
The current (working) tools are:
|
||||
|
||||
- [results](#results)
|
||||
- [status_overlapping](#status_overlapping)
|
||||
- [compare_failures](#compare_failures)
|
||||
- [status_summary](#status_summary)
|
||||
- [current_summary](#current_summary)
|
||||
|
@ -140,6 +141,52 @@ output-directory is `logs`, therefore the file would be written to
|
|||
|
||||
To change the output directory, use the `--output-directory` option.
|
||||
|
||||
## status_overlapping ##
|
||||
|
||||
If a test appears in multiple sections whose conditions are simultaneously true,
|
||||
the test's expectations is the union of the applicable entries. It's often
|
||||
unintended and undesirable to have overlapping sections for this reason. To find
|
||||
overlapping sections, run:
|
||||
|
||||
```console
|
||||
dart tools/gardening/bin/status_overlapping.dart <suite>
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```console
|
||||
dart tools/gardening/bin/status_overlapping.dart <suite> <test>
|
||||
```
|
||||
|
||||
Example output can be:
|
||||
```console
|
||||
...
|
||||
~/dart-sdk/sdk/tests/lib_2/lib_2_analyzer.status
|
||||
5: [ $compiler == dart2analyzer ]
|
||||
9: mirrors/deferred_mirrors_metadata_test: [Fail]
|
||||
10: mirrors/deferred_type_test: [StaticWarning, OK]
|
||||
11: mirrors/generic_f_bounded_mixin_application_test: [StaticWarning]
|
||||
12: mirrors/mirrors_nsm_mismatch_test: [StaticWarning, OK]
|
||||
13: mirrors/mirrors_nsm_test: [StaticWarning, OK]
|
||||
14: mirrors/mirrors_nsm_test/dart2js: [StaticWarning, OK]
|
||||
17: mirrors/repeated_private_anon_mixin_app_test: [StaticWarning, OK]
|
||||
|
||||
19: [ $compiler == dart2analyzer && $strong ]
|
||||
21: mirrors/deferred_mirrors_metadata_test: [StaticWarning]
|
||||
22: mirrors/deferred_type_test: [CompileTimeError, OK]
|
||||
23: mirrors/generic_f_bounded_mixin_application_test: [CompileTimeError]
|
||||
24: mirrors/mirrors_nsm_mismatch_test: [CompileTimeError, OK]
|
||||
25: mirrors/mirrors_nsm_test: [CompileTimeError, OK]
|
||||
26: mirrors/mirrors_nsm_test/dart2js: [CompileTimeError, OK]
|
||||
28: mirrors/repeated_private_anon_mixin_app_test: [CompileTimeError, OK]
|
||||
...
|
||||
```
|
||||
|
||||
Notice that the sections overlap, but there may not be any relationship between
|
||||
entries in a section or file, ex. line 9 and 21. This is easier to see if
|
||||
overlapping entries are grouped by tests. To divide overlapping sections and
|
||||
entries into tests, use --print-test.
|
||||
|
||||
## compare_failures ##
|
||||
This tool compares a test log of a build step with previous builds. This is
|
||||
particularly useful to detect changes over time, such as flakiness of failures,
|
||||
|
|
Loading…
Reference in a new issue