Testrunner for 3rd parties.

pkg/unittest/unittest.dart

 // Copyright (c) 2011, 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.
 
 /**
  * A library for writing dart unit tests.
  *
  * To import this library, specify the relative path to
  * pkg/unittest/unittest.dart.
  *
@@ skipping 138 matching lines @@
 #source('matcher.dart');
 #source('mock.dart');
 #source('numeric_matchers.dart');
 #source('operator_matchers.dart');
 #source('string_matchers.dart');
 #source('test_case.dart');
 
 /** [Configuration] used by the unittest library. */
 Configuration _config = null;
 
+Configuration get config => _config;
+
 /**
  * Set the [Configuration] used by the unittest library. Returns any
  * previous configuration.
+ * TODO: consider deprecating in favor of a setter now we have a getter.
  */
 Configuration configure(Configuration config) {
   Configuration _oldConfig = _config;
   _config = config;
   return _oldConfig;
 }
 
 void logMessage(String message) => _config.log(message);
 
 /**
  * Description text of the current test group. If multiple groups are nested,
  * this will contain all of their text concatenated.
  */
 String _currentGroup = '';
 
+/** Separator used between group names and test names. */
+String groupSep = ' ';
+
 /** Tests executed in this suite. */
 List<TestCase> _tests;
 
 /** Get the list of tests. */
-get testCases() => _tests;
+get testCases => _tests;
 
 /**
  * Callback used to run tests. Entrypoints can replace this with their own
  * if they want.
  */
 Function _testRunner;
 
 /** Setup function called before each test in a group */
 Function _testSetup;
 
@@ skipping 37 matching lines @@
       if (result == false) {
         _fail('Exception:\n$e\ndid not match expectation.');
       }
     }
   }
 
   if (threw != true) _fail('An expected exception was not thrown.');
 }
 
 /**
- * The regexp pattern filter which constrains which tests to run
- * based on their descriptions.
- */
-
-String filter = null;
-
-/**
  * Creates a new test case with the given description and body. The
  * description will include the descriptions of any surrounding group()
  * calls.
  */
 void test(String spec, TestFunction body) {
   ensureInitialized();
-
   _tests.add(new TestCase(_tests.length + 1, _fullSpec(spec), body, 0));
 }
 
 /**
  * (Deprecated) Creates a new async test case with the given description
  * and body. The description will include the descriptions of any surrounding
  * group() calls.
  */
 // TODO(sigmund): deprecate this API
 void asyncTest(String spec, int callbacks, TestFunction body) {
@@ skipping 292 matching lines @@
 Function protectAsync2(Function callback) {
   return new _SpreadArgsHelper.optionalCalls(callback).invoke2;
 }
 
 /**
  * Creates a new named group of tests. Calls to group() or test() within the
  * body of the function passed to this will inherit this group's description.
  */
 void group(String description, void body()) {
   ensureInitialized();
-
   // Concatenate the new group.
   final parentGroup = _currentGroup;
   if (_currentGroup != '') {
     // Add a space.
-    _currentGroup = '$_currentGroup $description';
+    _currentGroup = '$_currentGroup$groupSep$description';
   } else {
     // The first group.
     _currentGroup = description;
   }
 
   // Groups can be nested, so we need to preserve the current
   // settings for test setup/teardown.
   Function parentSetup = _testSetup;
   Function parentTeardown = _testTeardown;
 
@@ skipping 105 matching lines @@
   });
   port.toSendPort().send(null, null);
 }
 
 rerunTests() {
   _uncaughtErrorMessage = null;
   _initialized = true; // We don't want to reset the test array.
   runTests();
 }
 
+/**
+ * Filter the tests. [testFilter] can be a [RegExp], a [String] or a
+ * predicate function. This is different to enabling/disabling tests
+ * in that it removes the tests completely.
+ */
+void filterTests(testFilter) {
+  var filterFunction;
+  if (testFilter is String) {
+    RegExp re = new RegExp(testFilter);
+    filterFunction = (t) => re.hasMatch(t.description);
+  } else if (testFilter is RegExp) {
+    filterFunction = (t) => testFilter.hasMatch(t.description);
+  } else if (testFilter is Function) {
+    filterFunction = testFilter;
+  }
+  _tests = _tests.filter(filterFunction);
+}
+
 /** Runs all queued tests, one at a time. */
 runTests() {
   _currentTest = 0;
   _currentGroup = '';
 
   // If we are soloing a test, remove all the others.
   if (_soloTest != null) {
-    _tests = _tests.filter((t) => t == _soloTest);
-  }
-
-  if (filter != null) {
-    RegExp re = new RegExp(filter);
-    _tests = _tests.filter((t) => re.hasMatch(t.description));
+    filterTests((t) => t == _soloTest);
   }
 
   _config.onStart();
 
   _defer(() {
     _testRunner();
   });
 }
 
 /**
@@ skipping 70 matching lines @@
       case _ERROR: testsErrors_++; break;
     }
   }
   _config.onDone(testsPassed_, testsFailed_, testsErrors_, _tests,
       _uncaughtErrorMessage);
   _initialized = false;
 }
 
 String _fullSpec(String spec) {
   if (spec === null) return '$_currentGroup';
-  return _currentGroup != '' ? '$_currentGroup $spec' : spec;
+  return _currentGroup != '' ? '$_currentGroup$groupSep$spec' : spec;
 }
 
 void _fail(String message) {
   throw new ExpectException(message);
 }
 
 /**
  * Lazily initializes the test library if not already initialized.
  */
 ensureInitialized() {
-  if (_initialized) return;
+  if (_initialized) {
+    return;
+  }
   _initialized = true;
 
   _tests = <TestCase>[];
   _testRunner = _nextBatch;
   _uncaughtErrorMessage = null;
 
   if (_config == null) {
     _config = new Configuration();
   }
   _config.onInit();
@@ skipping 31 matching lines @@
 }
 
 /** Enable a test by ID. */
 void enableTest(int testId) => _setTestEnabledState(testId, true);
 
 /** Disable a test by ID. */
 void disableTest(int testId) => _setTestEnabledState(testId, false);
 
 /** Signature for a test function. */
 typedef void TestFunction();