dart:io | Add "followLinks" optional parameter to Directory.list, let it return Link objects when f…

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 extends FileSystemEntity {
@@ skipping 116 matching lines @@
    * 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);
 
   /**
    * Lists the sub-directories and files of this [Directory].
    * Optionally recurses into sub-directories.
    *
+   * If [followLinks] is false, then any symbolic links found
+   * are reported as links, rather than as directories or files,
+   * and are not recursed into.
+   *
    * The result is a stream of [FileSystemEntity] objects
-   * for the directories and files.
+   * for the directories, files, and links.
    */
-  Stream<FileSystemEntity> list({bool recursive: false});
+  Stream<FileSystemEntity> list({bool recursive: false,
+                                 bool followLinks: true});
 
   /**
    * Lists the sub-directories and files of this [Directory].
    * Optionally recurses into sub-directories.
    *
+   * If [followLinks] is false, then any symbolic links found
+   * are reported as links, rather than as directories or files,
+   * and are not recursed into.
+   *
    * Returns a [List] containing [FileSystemEntity] objects for the
-   * directories and files.
+   * directories, files, and links.
    */
-  List<FileSystemEntity> listSync({bool recursive: false});
+  List<FileSystemEntity> listSync({bool recursive: false,
+                                   bool followLinks: true});
 
   /**
    * Returns a human readable string for this Directory instance.
    */
   String toString();
 
   /**
    * Gets the path of this directory.
    */
   final String path;
@@ skipping 20 matching lines @@
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }