| 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 part of matcher; | 5 part of matcher; |
| 6 | 6 |
| 7 // To decouple the reporting of errors, and allow for extensibility of | 7 // To decouple the reporting of errors, and allow for extensibility of |
| 8 // matchers, we make use of some interfaces. | 8 // matchers, we make use of some interfaces. |
| 9 | 9 |
| 10 /** | 10 /** |
| (...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 72 * A few matchers make use of the [verbose] flag to provide detailed | 72 * A few matchers make use of the [verbose] flag to provide detailed |
| 73 * information that is not typically included but can be of help in | 73 * information that is not typically included but can be of help in |
| 74 * diagnosing failures, such as stack traces. | 74 * diagnosing failures, such as stack traces. |
| 75 */ | 75 */ |
| 76 Description describeMismatch(item, Description mismatchDescription, | 76 Description describeMismatch(item, Description mismatchDescription, |
| 77 MatchState matchState, bool verbose); | 77 MatchState matchState, bool verbose); |
| 78 } | 78 } |
| 79 | 79 |
| 80 /** | 80 /** |
| 81 * Failed matches are reported using a default IFailureHandler. | 81 * Failed matches are reported using a default IFailureHandler. |
| 82 * The default implementation simply throws ExpectExceptions; | 82 * The default implementation simply throws [TestFailure]s; |
| 83 * this can be replaced by some other implementation of | 83 * this can be replaced by some other implementation of |
| 84 * IFailureHandler by calling configureExpectHandler. | 84 * IFailureHandler by calling configureExpectHandler. |
| 85 */ | 85 */ |
| 86 abstract class FailureHandler { | 86 abstract class FailureHandler { |
| 87 /** This handles failures given a textual decription */ | 87 /** This handles failures given a textual decription */ |
| 88 void fail(String reason); | 88 void fail(String reason); |
| 89 | 89 |
| 90 /** | 90 /** |
| 91 * This handles failures given the actual [value], the [matcher] | 91 * This handles failures given the actual [value], the [matcher] |
| 92 * the [reason] (argument from [expect]), some additonal [matchState] | 92 * the [reason] (argument from [expect]), some additonal [matchState] |
| 93 * generated by the [matcher], and a verbose flag which controls in | 93 * generated by the [matcher], and a verbose flag which controls in |
| 94 * some cases how much [matchState] information is used. It will use | 94 * some cases how much [matchState] information is used. It will use |
| 95 * these to create a detailed error message (typically by calling | 95 * these to create a detailed error message (typically by calling |
| 96 * an [ErrorFormatter]) and then call [fail] with this message. | 96 * an [ErrorFormatter]) and then call [fail] with this message. |
| 97 */ | 97 */ |
| 98 void failMatch(actual, Matcher matcher, String reason, | 98 void failMatch(actual, Matcher matcher, String reason, |
| 99 MatchState matchState, bool verbose); | 99 MatchState matchState, bool verbose); |
| 100 } | 100 } |
| 101 | 101 |
| OLD | NEW |