dart:io | Add rename to Link

sdk/lib/io/link.dart

 // Copyright (c) 2013, 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;
 
 /**
  * [Link] objects are references to filesystem links.
  *
  */
@@ skipping 63 matching lines @@
 
   /**
    * Synchronously deletes the link. This does not delete, or otherwise
    * affect, the target of the link.  It also works on broken links, but if
    * the link does not exist or is not actually a link, it throws a
    * LinkException.
    */
   void deleteSync();
 
   /**
+   * Renames this link. Returns a `Future<Link>` that completes
+   * with a [Link] instance for the renamed link.
+   *
+   * If [newPath] identifies an existing link, that link is
+   * replaced. If [newPath] identifies an existing file or directory,
+   * the operation fails and the future completes with an exception.
+   */
+  Future<Link> rename(String newPath);
+
+   /**
+   * Synchronously renames this link. Returns a [Link]
+   * instance for the renamed link.
+   *
+   * If [newPath] identifies an existing link, that link is
+   * replaced. If [newPath] identifies an existing file or directory
+   * the operation fails and an exception is thrown.
+   */
+  Link renameSync(String newPath);
+
+  /**
    * Gets the target of the link. Returns a future that completes with
    * the path to the target.
    *
    * If the returned target is a relative path, it is relative to the
    * directory containing the link.
    *
    * If the link does not exist, or is not a link, the future completes with
    * a LinkException.
    */
   Future<String> target();
@@ skipping 94 matching lines @@
       }
       return this;
     });
   }
 
   void deleteSync() {
     var result = _File._deleteLink(path);
     throwIfError(result, "Cannot delete link", path);
   }
 
+  Future<Link> rename(String newPath) {
+    _ensureFileService();
+    List request = new List(3);
+    request[0] = _RENAME_LINK_REQUEST;
+    request[1] = path;
+    request[2] = newPath;
+    return _fileService.call(request).then((response) {
+      if (_isErrorResponse(response)) {
+        throw _exceptionFromResponse(
+            response, "Cannot rename link '$_path' to '$newPath'");
+      }
+      return new Link(newPath);
+    });
+  }
+
+  Link renameSync(String newPath) {
+    var result = _File._renameLink(path, newPath);
+    throwIfError(result, "Cannot rename link '$path' to '$newPath'");
+    return new Link(newPath);
+  }
+
   Future<String> target() {
     _ensureFileService();
     List request = new List(2);
     request[0] = _LINK_TARGET_REQUEST;
     request[1] = path;
     return _fileService.call(request).then((response) {
       if (_isErrorResponse(response)) {
         throw _exceptionFromResponse(response,
             "Cannot get target of link '$path'");
       }
@@ skipping 59 matching lines @@
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }