| commit | 77759ae9a03095c71a6aeb8d4ca7fd4ce6f6d801 | [log] [tgz] |
|---|---|---|
| author | Devon Carew <devoncarew@google.com> | Sun Jul 16 20:48:57 2017 -0700 |
| committer | Devon Carew <devoncarew@google.com> | Sun Jul 16 20:48:57 2017 -0700 |
| tree | a1204e47a12ddedfaf793f540eab950fdf730016 | |
| parent | 02558028c9aebe6680df00e41d8156bd916bb4b6 [diff] |
changelog
Coverage provides coverage data collection, manipulation, and formatting for Dart.
collect_coverage collects coverage JSON from the Dart VM Observatory. format_coverage formats JSON coverage data into either LCOV or pretty-printed format.
pub global activate coverage
Consider adding the pub global run executables directory to your path. See Running a script from your PATH for more details.
dart --pause-isolates-on-exit --enable-vm-service=NNNN script.dart pub global run coverage:collect_coverage --uri=http://... -o coverage.json --resume-isolates
or if the pub global run executables are on your PATH,
collect_coverage --uri=http://... -o coverage.json --resume-isolates
where --uri specifies the Observatory URI emitted by the VM.
If collect_coverage is invoked before the script from which coverage is to be collected, it will wait until it detects a VM observatory to which it can connect. An optional --connect-timeout may be specified (in seconds). The --wait-paused flag may be enabled, causing collect_coverage to wait until all isolates are paused before collecting coverage.
dartium --remote-debugging-port=NNNN # execute code in Dartium pub global run coverage:collect_coverage --uri=... -o coverage.json
or if the pub global run executables are on your PATH,
collect_coverage --port=NNNN -o coverage.json
As noted above, collect_coverage may be invoked before Dartium, in which case it will wait until it detects a Dartium remote debugging port, up to the (optional) timeout. Note that coverage cannot be run against a Dartium instance launched from Dart Editor, since the editor makes use of Dartium's remote debugging port.
pub global run coverage:format_coverage --packages=app_package/.packages -i coverage.json
or if the pub global run exectuables are on your PATH,
format_coverage --packages=app_package/.packages -i coverage.json
where app_package is the path to the package whose coverage is being collected. If --sdk-root is set, Dart SDK coverage will also be output.