dart:io | Add Directory.CreateSystemTemp(template) and change Directory.CreateTemp(template).

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;
 
 /**
  * A reference to a directory (or _folder_) on the file system.
  */
 abstract class Directory implements FileSystemEntity {
@@ skipping 50 matching lines @@
    *
    * 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({bool recursive: false});
 
   /**
-   * Creates a temporary directory with a name based on the current
-   * path.  The path is used as a template, and additional
-   * characters are appended to it to make a unique temporary
-   * directory name.  If the path is the empty string, a default
-   * system temp directory and name are used for the template.
+   * Creates a temporary directory in this directory.  Additional random
+   * characters are appended to [template] to produce a unique directory
+   * name.
+   *
+   * Returns a [:Future<Directory>:] that completes with the newly
+   * created temporary directory.
+   *
+   * Deprecated behavior, to be removed Oct 18, 2013: If the path is the
+   * empty string, the directory is created in the default system temp
+   * directory.  This capability has been moved to the static function
+   * [createSystemTemp].
+   */
+  Future<Directory> createTemp([String template]);
+
+  /**
+   * Synchronously creates a temporary directory in this directory.
+   * Additional random characters are appended to [template] to produce
+   * a unique directory name.
+   *
+   * Returns the newly created temporary directory.
+   *
+   * Deprecated behavior, to be removed Oct 18, 2013: If the path is the
+   * empty string, the directory is created in the default system temp
+   * directory.  This capability has been moved to the static function
+   * [createSystemTemp].
+   */
+ Directory createTempSync([String template]);
+
+  /**
+   * Creates a temporary directory in the system temp directory.
+   * The location of the system temp directory is platform-dependent,
+   * and may be set by an environment variable.
+   * Additional random characters are appended to [template] to produce
+   * a unique directory name.
    *
    * Returns a [:Future<Directory>:] that completes with the newly
    * created temporary directory.
    */
-  Future<Directory> createTemp();
+  static Future<Directory> createSystemTemp([String template]) =>
+      _Directory.createSystemTemp(template);
 
   /**
-   * Synchronously creates a temporary directory with a name based on the
-   * current path. The path is used as a template, and additional
-   * characters are appended to it to make a unique temporary 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.
+   * Synchronously creates a temporary directory in the system temp directory.
+   * The location of the system temp directory is platform-dependent,
+   * and may be set by an environment variable.
+   * Additional random characters are appended to [template] to produce
+   * a unique directory name.
+   *
+   * Returns a [:Future<Directory>:] that completes with the newly
+   * created temporary directory.
    */
-  Directory createTempSync();
+  static Directory createSystemTempSync([String template]) =>
+      _Directory.createSystemTempSync(template);
 
   Future<String> resolveSymbolicLinks();
 
   String resolveSymbolicLinksSync();
 
   /**
    * Renames 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
@@ skipping 99 matching lines @@
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }