Add a Loader class for loading tests from files.

lib/src/io.dart

 // Copyright (c) 2015, 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.
 
 library unittest.io;
 
+import 'dart:async';
 import 'dart:io';
 
 /// Whether "special" strings such as Unicode characters or color escapes are
 /// safe to use.
 ///
 /// On Windows or when not printing to a terminal, only printable ASCII
 /// characters should be used.
 bool get canUseSpecialChars =>
     Platform.operatingSystem != 'windows' &&
     stdioType(stdout) == StdioType.TERMINAL;
 
 /// Gets a "special" string (ANSI escape or Unicode).
 ///
 /// On Windows or when not printing to a terminal, returns something else since
 /// those aren't supported.
 String getSpecial(String special, [String onWindows = '']) =>
     canUseSpecialChars ? special : onWindows;
+
+/// Creates a temporary directory and passes its path to [fn].
+///
+/// Once the [Future] returned by [fn] completes, the temporary directory and
+/// all its contents are deleted. [fn] can also return `null`, in which case
+/// the temporary directory is deleted immediately afterwards.
+///
+/// Returns a future that completes to the value that the future returned from
+/// [fn] completes to.
+Future withTempDir(Future fn(String path)) {
+  return new Future.sync(() {
+    var tempDir = Directory.systemTemp.createTempSync('unittest_');
+    return new Future.sync(() => fn(tempDir.path))
+        .whenComplete(() => tempDir.deleteSync(recursive: true));

[kevmoo, 2015/02/12 22:31:15]

If tests are being run on many isolates, do we want to avoid blocking IO to
increase throughput?

-Sync

[nweiz, 2015/02/12 22:37:52]

Evidence so far indicates that sync IO functions are noticeably faster than
async; at least in pub, there's enough of a difference that it outweighs the
parallelism benefits. I think that's a good assumption here, but I'll add a TODO
to test empirically.

+  });
+}