OLD | NEW |
1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 library test.backend.test; | 5 library test.backend.test; |
6 | 6 |
| 7 import 'group.dart'; |
7 import 'live_test.dart'; | 8 import 'live_test.dart'; |
8 import 'metadata.dart'; | 9 import 'metadata.dart'; |
9 import 'operating_system.dart'; | 10 import 'operating_system.dart'; |
10 import 'suite.dart'; | 11 import 'suite.dart'; |
11 import 'group_entry.dart'; | 12 import 'group_entry.dart'; |
12 import 'test_platform.dart'; | 13 import 'test_platform.dart'; |
13 | 14 |
14 /// A single test. | 15 /// A single test. |
15 /// | 16 /// |
16 /// A test is immutable and stateless, which means that it can't be run | 17 /// A test is immutable and stateless, which means that it can't be run |
17 /// directly. To run one, load a live version using [Test.load] and run it using | 18 /// directly. To run one, load a live version using [Test.load] and run it using |
18 /// [LiveTest.run]. | 19 /// [LiveTest.run]. |
19 abstract class Test implements GroupEntry { | 20 abstract class Test implements GroupEntry { |
20 String get name; | 21 String get name; |
21 | 22 |
22 Metadata get metadata; | 23 Metadata get metadata; |
23 | 24 |
24 /// Loads a live version of this test, which can be used to run it a single | 25 /// Loads a live version of this test, which can be used to run it a single |
25 /// time. | 26 /// time. |
26 /// | 27 /// |
27 /// [suite] is the suite within which this test is being run. | 28 /// [suite] is the suite within which this test is being run. If [groups] is |
28 LiveTest load(Suite suite); | 29 /// passed, it's the list of groups containing this test; otherwise, it |
| 30 /// defaults to just containing `suite.group`. |
| 31 LiveTest load(Suite suite, {Iterable<Group> groups}); |
29 | 32 |
30 Test forPlatform(TestPlatform platform, {OperatingSystem os}); | 33 Test forPlatform(TestPlatform platform, {OperatingSystem os}); |
31 | 34 |
32 Test filter(bool callback(Test test)) => callback(this) ? this : null; | 35 Test filter(bool callback(Test test)) => callback(this) ? this : null; |
33 } | 36 } |
OLD | NEW |