OLD | NEW |
---|---|
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 /** | 5 /** |
6 * MatchState is a simple wrapper around an arbitrary object. | 6 * MatchState is a simple wrapper around an arbitrary object. |
7 * [Matcher] [matches] methods can use this to store useful | 7 * [Matcher] [matches] methods can use this to store useful |
8 * information upon match failures, and this information will | 8 * information upon match failures, and this information will |
9 * be passed to [describeMismatch]. Each [Matcher] is responsible | 9 * be passed to [describeMismatch]. Each [Matcher] is responsible |
10 * for its own use of this state, so the state created by [matches] | 10 * for its own use of this state, so the state created by [matches] |
11 * should be consistent with that expected by [describeMismatch] in | 11 * should be consistent with that expected by [describeMismatch] in |
12 * the same [Matcher] class, but can vary between classes. The inner | 12 * the same [Matcher] class, but can vary between classes. The inner |
13 * state, if set, will typically be a [Map] with a number of key-value | 13 * state, if set, will typically be a [Map] with a number of key-value |
14 * pairs containing relevant state information. | 14 * pairs containing relevant state information. |
15 */ | 15 */ |
16 | 16 |
17 part of unittest; | 17 part of matcher; |
Siggi Cherem (dart-lang)
2012/10/31 20:54:02
move part above the comment (the comment should be
gram
2012/11/01 21:23:19
Done.
| |
18 | 18 |
19 class MatchState { | 19 class MatchState { |
20 var state = null; | 20 var state = null; |
21 | 21 |
22 MatchState([this.state]); | 22 MatchState([this.state]); |
23 } | 23 } |
24 | 24 |
25 /** | 25 /** |
26 * BaseMatcher is the base class for all matchers. To implement a new | 26 * BaseMatcher is the base class for all matchers. To implement a new |
27 * matcher, either add a class that implements from IMatcher or | 27 * matcher, either add a class that implements from IMatcher or |
(...skipping 22 matching lines...) Expand all Loading... | |
50 * Generates a description of the matcher failed for a particular | 50 * Generates a description of the matcher failed for a particular |
51 * [item], by appending the description to [mismatchDescription]. | 51 * [item], by appending the description to [mismatchDescription]. |
52 * It does not check whether the [item] fails the match, as it is | 52 * It does not check whether the [item] fails the match, as it is |
53 * only called after a failed match. There may be additional info | 53 * only called after a failed match. There may be additional info |
54 * about the mismatch in [matchState]. | 54 * about the mismatch in [matchState]. |
55 */ | 55 */ |
56 Description describeMismatch(item, Description mismatchDescription, | 56 Description describeMismatch(item, Description mismatchDescription, |
57 MatchState matchState, bool verbose) => | 57 MatchState matchState, bool verbose) => |
58 mismatchDescription.add('was ').addDescriptionOf(item); | 58 mismatchDescription.add('was ').addDescriptionOf(item); |
59 } | 59 } |
OLD | NEW |