Support compiling templates in the browser.

lib/src/template/file_system.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.
 
 // TODO(terry): Investigate common library for file I/O shared between frog and tools.
 
 /** Abstraction for file systems and utility functions to manipulate paths. */
 library file_system;
 
 /**
  * Abstraction around file system access to work in a variety of different
  * environments.
  */
 interface FileSystem {
-  String readAll(String filename);
+  /**
+   * Apply all pending writes.  Until this method is called, writeString is not
+   * guaranteed to have any observable impact.
+   */
+  Future flush();
 
+  Future<String> readAll(String filename);
+
+  /**
+   * Writes [text] to [outfile]. Call flush to insure that changes are visible.
+   */
   void writeString(String outfile, String text);
 
   void createDirectory(String path, [bool recursive]);
   void removeDirectory(String path, [bool recursive]);
 }
 
 /**
  * Replaces all back slashes (\) with forward slashes (/) in [path] and
  * return the result.
  */
@@ skipping 37 matching lines @@
 String basename(String path) {
   path = canonicalizePath(path);
 
   int lastSlash = path.lastIndexOf('/', path.length);
   if (lastSlash == -1) {
     return path;
   } else {
     return path.substring(lastSlash + 1);
   }
 }