Merge IO v2 branch to bleeding edge

sdk/lib/io/directory.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.
 
 part of dart.io;
 
 /**
  * [Directory] objects are used for working with directories.
  */
-abstract class Directory {
+abstract class Directory extends FileSystemEntity {
   /**
    * Creates a directory object. The path is either an absolute path,
    * or it is a relative path which is interpreted relative to the directory
    * in which the Dart VM was started.
    */
   factory Directory(String path) => new _Directory(path);
 
   /**
    * Creates a directory object from a Path object. The path is either
    * an absolute path, or it is a relative path which is interpreted
@@ skipping 103 matching lines @@
    * Synchronously rename this directory. Returns a [Directory]
    * instance for the renamed directory.
    *
    * If newPath identifies an existing directory, that directory is
    * replaced. If newPath identifies an existing file the operation
    * fails and an exception is thrown.
    */
   Directory renameSync(String newPath);
 
   /**
-   * List the sub-directories and files of this
-   * [Directory]. Optionally recurse into sub-directories. Returns a
-   * [DirectoryLister] object representing the active listing
-   * operation. Handlers for files and directories should be
-   * registered on this DirectoryLister object.
+   * List the sub-directories and files of this [Directory].
+   * Optionally recurse into sub-directories.
+   *
+   * The result is a stream of [FileSystemEntity] objects
+   * for the directories and files.
    */
-  DirectoryLister list({bool recursive: false});
+  Stream<FileSystemEntity> list({bool recursive: false});
 
   /**
-   * List the sub-directories and files of this
-   * [Directory]. Optionally recurse into sub-directories. Returns a
-   * List containing Directory and File objects.
+   * List the sub-directories and files of this [Directory].
+   * Optionally recurse into sub-directories.
+   *
+   * Returns a [List] containing [FileSystemEntity] objects for the
+   * directories and files.
    */
-  List listSync({bool recursive: false});
+  List<FileSystemEntity> listSync({bool recursive: false});
 
   /**
    * Returns a human readable string for this Directory instance.
    */
   String toString();
 
   /**
    * Gets the path of this directory.
    */
   final String path;
 }
 
 
-/**
- * A [DirectoryLister] represents an actively running listing operation.
- *
- * A [DirectoryLister] is obtained from a [Directory] object by calling
- * the [:Directory.list:] method.
- *
- *     Directory dir = new Directory('path/to/my/dir');
- *     DirectoryLister lister = dir.list();
- *
- * For each file and directory, the file or directory handler is
- * called. When all directories have been listed the done handler is
- * called. If the listing operation is recursive, the error handler is
- * called if a subdirectory cannot be opened for listing.
- */
-abstract class DirectoryLister {
-  /**
-   * Sets the directory handler that is called for all directories
-   * during listing. The directory handler is called with the full
-   * path of the directory.
-   */
-  void set onDir(void onDir(String dir));
-
-  /**
-   * Sets the handler that is called for all files during listing. The
-   * file handler is called with the full path of the file.
-   */
-  void set onFile(void onFile(String file));
-
-  /**
-   * Set the handler that is called when a listing is done. The
-   * handler is called with an indication of whether or not the
-   * listing operation completed.
-   */
-  void set onDone(void onDone(bool completed));
-
-  /**
-   * Sets the handler that is called if there is an error while
-   * listing directories.
-   */
-  void set onError(void onError(e));
-}
-
-
 class DirectoryIOException implements Exception {
   const DirectoryIOException([String this.message = "",
                               String this.path = "",
                               OSError this.osError = null]);
   String toString() {
     StringBuffer sb = new StringBuffer();
     sb.add("DirectoryIOException");
     if (!message.isEmpty) {
       sb.add(": $message");
       if (path != null) {
         sb.add(", path = $path");
       }
       if (osError != null) {
         sb.add(" ($osError)");
       }
     } else if (osError != null) {
       sb.add(": $osError");
       if (path != null) {
         sb.add(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }