Allow Directory.create to create all missing path components.

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.
 
 /**
  * [Directory] objects are used for working with directories.
  */
 abstract class Directory {
   /**
    * Creates a directory object. The path is either an absolute path,
@@ skipping 20 matching lines @@
    * a [:Future<bool>:] that completes with the result.
    */
   Future<bool> exists();
 
   /**
    * Synchronously check whether a directory with this name already exists.
    */
   bool existsSync();
 
   /**
-   * Creates the directory with this name. If the directory already
-   * exists nothing is done. Returns a [:Future<Directory>:] that
-   * completes with this directory once it has been created. If the
-   * directory does not exist and cannot be created the future
-   * completes with an exception.
+   * Creates the directory with this name.
+   *
+   * If [recursive] is false, only the last directory in the path is
+   * created. If [recursive] is true, all non-existing path components
+   * are created. If the directory already exists nothing is done.
+   *
+   * Returns a [:Future<Directory>:] that completes with this
+   * directory once it has been created. If the directory cannot be
+   * created the future completes with an exception.
    */
-  Future<Directory> create();
+  Future<Directory> create({recursive: false});
 
   /**
-   * Synchronously creates the directory with this name. If the
-   * directory already exists nothing is done. If the directory does
-   * not exist and cannot be created an exception is thrown.
+   * Synchronously creates the directory with this name.
+   *
+   * If [recursive] is false, only the last directory in the path is
+   * created. If [recursive] is true, all non-existing path components
+   * are created. If the directory already exists nothing is done.
+   *
+   * If the directory cannot be created an exception is thrown.
    */
-  void createSync();
+  void createSync({recursive: false});
 
   /**
    * Creates a temporary directory with a name based on the current
    * path.  This name and path is used as a template, and additional
    * characters are appended to it by the call to make a unique
    * directory name.  If the path is the empty string, a default
    * system temp directory and name are used for the template.
    *
    * Returns a [:Future<Directory>:] that completes with the newly
    * created temporary directory.
    */
   Future<Directory> createTemp();
 
   /**
    * Synchronously creates a temporary directory with a name based on the
    * current path. This name and path is used as a template, and additional
    * characters are appended to it by the call to make a unique directory name.
    * If the path is the empty string, a default system temp directory and name
    * are used for the template. Returns the newly created temporary directory.
    */
   Directory createTempSync();
 
   /**
-   * Deletes the directory with this name. The directory must be
-   * empty. Returns a [:Future<Directory>:] that completes with
-   * this directory when the deletion is done.
+   * Deletes the directory with this name.
+   *
+   * If [recursive] is false, the directory must be empty.
+   *
+   * If [recursive] is true, this directory and all sub-directories
+   * and files in the directories are deleted.
+   *
+   * Returns a [:Future<Directory>:] that completes with this
+   * directory when the deletion is done. If the directory cannot be
+   * deleted, the future completes with an exception.
    */
-  Future<Directory> delete();
+  Future<Directory> delete({recursive: false});
 
   /**
-   * Synchronously deletes the directory with this name. The directory
-   * must be empty. Throws an exception if the directory cannot be
-   * deleted.
+   * Synchronously deletes the directory with this name.
+   *
+   * If [recursive] is false, the directory must be empty.
+   *
+   * If [recursive] is true, this directory and all sub-directories
+   * and files in the directories are deleted.
+   *
+   * Throws an exception if the directory cannot be deleted.
    */
-  void deleteSync();
-
-  /**
-   * Deletes this directory and all sub-directories and files in the
-   * directories. Returns a [:Future<Directory>:] that completes with
-   * this directory when the deletion is done.
-   */
-  Future<Directory> deleteRecursively();
-
-  /**
-   * Synchronously deletes this directory and all sub-directories and
-   * files in the directories. Throws an exception if the directory
-   * cannot be deleted.
-   */
-  void deleteRecursivelySync();
+  void deleteSync({recursive: false});
 
   /**
    * Rename this directory. Returns a [:Future<Directory>:] that completes
    * with 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 the future completes with an exception.
    */
   Future<Directory> rename(String newPath);
@@ skipping 87 matching lines @@
       if (path != null) {
         sb.add(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }