| 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 |
| 17 part of unittest; |
| 18 |
| 16 class MatchState { | 19 class MatchState { |
| 17 var state = null; | 20 var state = null; |
| 18 | 21 |
| 19 MatchState([this.state]); | 22 MatchState([this.state]); |
| 20 } | 23 } |
| 21 | 24 |
| 22 /** | 25 /** |
| 23 * 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 |
| 24 * matcher, either add a class that implements from IMatcher or | 27 * matcher, either add a class that implements from IMatcher or |
| 25 * a class that inherits from Matcher. Inheriting from Matcher has | 28 * a class that inherits from Matcher. Inheriting from Matcher has |
| (...skipping 21 matching lines...) Expand all Loading... |
| 47 * Generates a description of the matcher failed for a particular | 50 * Generates a description of the matcher failed for a particular |
| 48 * [item], by appending the description to [mismatchDescription]. | 51 * [item], by appending the description to [mismatchDescription]. |
| 49 * 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 |
| 50 * only called after a failed match. There may be additional info | 53 * only called after a failed match. There may be additional info |
| 51 * about the mismatch in [matchState]. | 54 * about the mismatch in [matchState]. |
| 52 */ | 55 */ |
| 53 Description describeMismatch(item, Description mismatchDescription, | 56 Description describeMismatch(item, Description mismatchDescription, |
| 54 MatchState matchState, bool verbose) => | 57 MatchState matchState, bool verbose) => |
| 55 mismatchDescription.add('was ').addDescriptionOf(item); | 58 mismatchDescription.add('was ').addDescriptionOf(item); |
| 56 } | 59 } |
| OLD | NEW |