LibTest/io/Link/rename_A01_t01.dart

// 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<Link> rename(String newPath)
/// 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.
///
/// @description Checks that this method returns a Future<Link> that completes
/// with a Link instance for the renamed link.
///
/// @note The test should run with the Administrator priveleges on Windows.
/// Dart API Spec reads:
/// In order to create a symbolic link on Windows, Dart must be run in
/// Administrator mode or the system must have Developer Mode enabled, otherwise
/// a FileSystemException will be raised with ERROR_PRIVILEGE_NOT_HELD set as
/// the errno when this call is made.
///
/// @author sgrekhov@unipro.ru

import "dart:io";
import "../../../Utils/expect.dart";
import "../file_utils.dart";

main() async {
  await inSandbox(_main);
}

_main(Directory sandbox) async {
  Link link = getTempLinkSync(parent: sandbox);
  String target = link.targetSync();
  String newName = getTempFilePath(parent: sandbox);

  asyncStart();
  await link.rename(newName).then((renamed) {
    Expect.equals(newName, renamed.path);
    Expect.equals(target, renamed.targetSync());
    Expect.isTrue(renamed.existsSync());
    Expect.isFalse(link.existsSync());
    asyncEnd();
  });
}