blob: 84f9af1676d5f7780bb3f1404651573eeb7513df [file] [log] [blame]
// Copyright (c) 2017, 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.
/// @assertion Future<Directory> rename(String newPath)
/// Renames this directory. Returns a Future<Directory> that completes with a
/// Directory instance for the renamed directory.
///
/// If [newPath] identifies an existing directory, then the behavior is
/// platform-specific. On all platforms, a [FileSystemException] is thrown
/// if the existing directory is not empty. On POSIX systems, if [newPath]
/// identifies an existing empty directory then that directory is deleted
/// before this directory is renamed.
///
/// If newPath identifies an existing file or link the operation fails and a
/// [FileSystemException] is thrown.
///
/// @note Shortly:
/// - [File]/[Link] `rename/renameSync` can replace other [File]/[Link] but not
/// [Directory]
/// - [Directory] `rename/renameSync` can not replace an existing
/// [File]/[Link]/[Directory] except on POSIX where it can replace an empty
/// [Directory]
///
/// @description Checks that this method returns a `Future<Directory>` that
/// completes with a [Directory] instance for the renamed directory.
/// @author sgrekhov@unipro.ru
import "dart:io";
import "../../../Utils/expect.dart";
import "../file_utils.dart";
main() async {
await inSandbox(_main);
}
void _main(Directory sandbox) async {
Directory dir = getTempDirectorySync(parent: sandbox);
String oldName = dir.path;
String newName = getTempDirectoryPath(parent: sandbox);
asyncStart();
await dir.rename(newName).then((renamed) {
Expect.equals(newName, renamed.path);
Expect.isTrue(renamed.existsSync());
File oldFile = new File(oldName);
Expect.isFalse(oldFile.existsSync());
asyncEnd();
});
}