languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-09-06 00:59:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updating gardening tools readme with info about overlapping sections.

Browse source 
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:
Morten Krogh-Jespersen 2017-12-08 13:21:09 +00:00 committed by Morten Krogh-jespersen
parent 6e3d94ab1a
commit 20da198715
1 changed files with 47 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
tools/gardening/README.md
View file

@ -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,