Make the matcher classes for exceptions public so that users can use them to create matchers for th…

pkg/unittest/core_matchers.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 
 /**
  * Returns a matcher that matches empty strings, maps or collections.
  */
 const Matcher isEmpty = const _Empty();
 
@@ skipping 220 matching lines @@
  *   * A [Function] that throws an exception when called. The function cannot
  *     take any arguments. If you want to test that a function expecting
  *     arguments throws, wrap it in another zero-argument function that calls
  *     the one you want to test.
  *
  *   * A [Future] that completes with an exception. Note that this creates an
  *     asynchronous expectation. The call to `expect()` that includes this will
  *     return immediately and execution will continue. Later, when the future
  *     completes, the actual expectation will run.
  */
-const Matcher throws = const _Throws();
+const Matcher throws = const Throws();
 
 /**
  * This can be used to match two kinds of objects:
  *
  *   * A [Function] that throws an exception when called. The function cannot
  *     take any arguments. If you want to test that a function expecting
  *     arguments throws, wrap it in another zero-argument function that calls
  *     the one you want to test.
  *
  *   * A [Future] that completes with an exception. Note that this creates an
  *     asynchronous expectation. The call to `expect()` that includes this will
  *     return immediately and execution will continue. Later, when the future
  *     completes, the actual expectation will run.
  *
  * In both cases, when an exception is thrown, this will test that the exception
  * object matches [matcher]. If [matcher] is not an instance of [Matcher], it
  * will implicitly be treated as `equals(matcher)`.
  */
 Matcher throwsA(matcher) => new _Throws(wrapMatcher(matcher));
 
 /**
  * A matcher that matches a function call against no exception.
  * The function will be called once. Any exceptions will be silently swallowed.
  * The value passed to expect() should be a reference to the function.
  * Note that the function cannot take arguments; to handle this
  * a wrapper will have to be created.
  */
 const Matcher returnsNormally = const _ReturnsNormally();
 
-class _Throws extends BaseMatcher {
+class Throws extends BaseMatcher {
   final Matcher _matcher;
 
-  const _Throws([Matcher matcher]) :
+  const Throws([Matcher matcher]) :
     this._matcher = matcher;
 
   bool matches(item, MatchState matchState) {
     if (item is Future) {
       // Queue up an asynchronous expectation that validates when the future
       // completes.
       item.onComplete(expectAsync1((future) {
         if (future.hasValue) {
           expect(false, reason:
               "Expected future to fail, but succeeded with '${future.value}'.");
@@ skipping 101 matching lines @@
  *
  * bool _isException(x) => x is Exception;
  * final Matcher isException = const _Predicate(_isException, "Exception");
  * final Matcher throwsException = const _Throws(isException);
  *
  * But currently using static functions in const expressions is not supported.
  * For now the only solution for all platforms seems to be separate classes
  * for each exception type.
  */
 
-/* abstract */ class _ExceptionMatcher extends BaseMatcher {
+/* abstract */ class ExceptionMatcher extends BaseMatcher {
   final String _name;
-  const _ExceptionMatcher(this._name);
+  const ExceptionMatcher(this._name);
   Description describe(Description description) =>
       description.add(_name);
 }
 
 /** A matcher for FormatExceptions. */
 const isFormatException = const _FormatException();
 
 /** A matcher for functions that throw FormatException */
 const Matcher throwsFormatException =
-    const _Throws(isFormatException);
+    const Throws(isFormatException);
 
-class _FormatException extends _ExceptionMatcher {
+class _FormatException extends ExceptionMatcher {
   const _FormatException() : super("FormatException");
   bool matches(item, MatchState matchState) => item is FormatException;
 }
 
 /** A matcher for Exceptions. */
 const isException = const _Exception();
 
 /** A matcher for functions that throw Exception */
-const Matcher throwsException = const _Throws(isException);
+const Matcher throwsException = const Throws(isException);
 
-class _Exception extends _ExceptionMatcher {
+class _Exception extends ExceptionMatcher {
   const _Exception() : super("Exception");
   bool matches(item, MatchState matchState) => item is Exception;
 }
 
 /** A matcher for ArgumentErrors. */
 const isArgumentError = const _ArgumentError();
 
 /** A matcher for functions that throw ArgumentError */
 const Matcher throwsArgumentError =
-    const _Throws(isArgumentError);
+    const Throws(isArgumentError);
 
-class _ArgumentError extends _ExceptionMatcher {
+class _ArgumentError extends ExceptionMatcher {
   const _ArgumentError() : super("ArgumentError");
   bool matches(item, MatchState matchState) => item is ArgumentError;
 }
 
 /** A matcher for IllegalJSRegExpExceptions. */
 const isIllegalJSRegExpException = const _IllegalJSRegExpException();
 
 /** A matcher for functions that throw IllegalJSRegExpException */
 const Matcher throwsIllegalJSRegExpException =
-    const _Throws(isIllegalJSRegExpException);
+    const Throws(isIllegalJSRegExpException);
 
-class _IllegalJSRegExpException extends _ExceptionMatcher {
+class _IllegalJSRegExpException extends ExceptionMatcher {
   const _IllegalJSRegExpException() : super("IllegalJSRegExpException");
   bool matches(item, MatchState matchState) => item is IllegalJSRegExpException;
 }
 
 /** A matcher for IndexOutOfRangeExceptions. */
 const isIndexOutOfRangeException = const _IndexOutOfRangeException();
 
 /** A matcher for functions that throw IndexOutOfRangeException */
 const Matcher throwsIndexOutOfRangeException =
-    const _Throws(isIndexOutOfRangeException);
+    const Throws(isIndexOutOfRangeException);
 
-class _IndexOutOfRangeException extends _ExceptionMatcher {
+class _IndexOutOfRangeException extends ExceptionMatcher {
   const _IndexOutOfRangeException() : super("IndexOutOfRangeException");
   bool matches(item, MatchState matchState) => item is IndexOutOfRangeException;
 }
 
 /** A matcher for NoSuchMethodErrors. */
 const isNoSuchMethodError = const _NoSuchMethodError();
 
 /** A matcher for functions that throw NoSuchMethodError */
 const Matcher throwsNoSuchMethodError =
-    const _Throws(isNoSuchMethodError);
+    const Throws(isNoSuchMethodError);
 
-class _NoSuchMethodError extends _ExceptionMatcher {
+class _NoSuchMethodError extends ExceptionMatcher {
   const _NoSuchMethodError() : super("NoSuchMethodError");
   bool matches(item, MatchState matchState) => item is NoSuchMethodError;
 }
 
 /** A matcher for NotImplementedExceptions. */
 const isNotImplementedException = const _NotImplementedException();
 
 /** A matcher for functions that throw Exception */
 const Matcher throwsNotImplementedException =
-    const _Throws(isNotImplementedException);
+    const Throws(isNotImplementedException);
 
-class _NotImplementedException extends _ExceptionMatcher {
+class _NotImplementedException extends ExceptionMatcher {
   const _NotImplementedException() : super("NotImplementedException");
   bool matches(item, MatchState matchState) => item is NotImplementedException;
 }
 
 /** A matcher for NullPointerExceptions. */
 const isNullPointerException = const _NullPointerException();
 
 /** A matcher for functions that throw NotNullPointerException */
 const Matcher throwsNullPointerException =
-    const _Throws(isNullPointerException);
+    const Throws(isNullPointerException);
 
-class _NullPointerException extends _ExceptionMatcher {
+class _NullPointerException extends ExceptionMatcher {
   const _NullPointerException() : super("NullPointerException");
   bool matches(item, MatchState matchState) => item is NullPointerException;
 }
 
 /** A matcher for UnsupportedOperationExceptions. */
 const isUnsupportedOperationException = const _UnsupportedOperationException();
 
 /** A matcher for functions that throw UnsupportedOperationException */
 const Matcher throwsUnsupportedOperationException =
-    const _Throws(isUnsupportedOperationException);
+    const Throws(isUnsupportedOperationException);
 
-class _UnsupportedOperationException extends _ExceptionMatcher {
+class _UnsupportedOperationException extends ExceptionMatcher {
   const _UnsupportedOperationException() :
       super("UnsupportedOperationException");
-  bool matches(item, MatchState matchState) => item is UnsupportedOperationException;
+  bool matches(item, MatchState matchState) =>
+      item is UnsupportedOperationException;
 }
 
 /**
  * Returns a matcher that matches if an object has a length property
  * that matches [matcher].
  */
 Matcher hasLength(matcher) =>
     new _HasLength(wrapMatcher(matcher));
 
 class _HasLength extends BaseMatcher {
@@ skipping 98 matching lines @@
   final _matcher;
   final String _description;
 
   const _Predicate(this._matcher, this._description);
 
   bool matches(item, MatchState matchState) => _matcher(item);
 
   Description describe(Description description) =>
       description.add(_description);
 }