Add the ability to match the contents of a file descriptor against a Matcher.

pkg/scheduled_test/lib/descriptor.dart

 // Copyright (c) 2013, 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 declaratively describing a filesystem structure, usually for
 /// the purpose of creating or validating it as part of a scheduled test.
 ///
 /// You can use [dir] and [file] to define a filesystem structure. Then, you can
 /// call [Descriptor.create] to schedule a task that will create that structure
 /// on the physical filesystem, or [Descriptor.validate] to schedule an
@@ skipping 82 matching lines @@
 String _defaultRoot;
 
 /// Creates a new text [FileDescriptor] with [name] and [contents].
 FileDescriptor file(String name, [String contents='']) =>
   new FileDescriptor(name, contents);
 
 /// Creates a new binary [FileDescriptor] descriptor with [name] and [contents].
 FileDescriptor binaryFile(String name, List<int> contents) =>
   new FileDescriptor.binary(name, contents);
 
+/// Creates a new text [FileDescriptor] with [name] that matches its String
+/// contents against [matcher]. If the file is created, it's considered to be
+/// empty.
+FileDescriptor matcherFile(String name, matcher) =>
+  new FileDescriptor.matcher(name, wrapMatcher(matcher));
+
+/// Creates a new binary [FileDescriptor] with [name] that matches its binary
+/// contents against [matcher]. If the file is created, it's considered to be
+/// empty.
+FileDescriptor binaryMatcherFile(String name, matcher) =>
+  new FileDescriptor.binaryMatcher(name, wrapMatcher(matcher));
+
 /// Creates a new [DirectoryDescriptor] descriptor with [name] and [contents].
 DirectoryDescriptor dir(String name, [Iterable<Descriptor> contents]) =>
    new DirectoryDescriptor(name, contents == null? <Descriptor>[] : contents);
 
 /// Creates a new descriptor wrapping a [Future]. This descriptor forwards all
 /// asynchronous operations to the result of [future].
 AsyncDescriptor async(Future<Descriptor> future) =>
   new AsyncDescriptor(future);
 
 /// Creates a new [NothingDescriptor] descriptor that asserts that no entry
 /// named [name] exists.
 NothingDescriptor nothing(String name) => new NothingDescriptor(name);
 
 /// Creates a new [PatternDescriptor] descriptor that asserts than an entry with
 /// a name matching [pattern] exists, and matches the [Descriptor] returned
 /// by [fn].
 PatternDescriptor pattern(Pattern name, EntryCreator fn) =>
   new PatternDescriptor(name, fn);
 
 /// A convenience method for creating a [PatternDescriptor] descriptor that
 /// constructs a [FileDescriptor] descriptor.
 PatternDescriptor filePattern(Pattern name, [String contents='']) =>
   pattern(name, (realName) => file(realName, contents));
 
 /// A convenience method for creating a [PatternDescriptor] descriptor that
 /// constructs a [DirectoryDescriptor] descriptor.
 PatternDescriptor dirPattern(Pattern name, [Iterable<Descriptor> contents]) =>
   pattern(name, (realName) => dir(realName, contents));