blob: 87dd8334bf7d10bd3a293e44d02ad2e8fb51a2bf [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<Link> create(
* String target, {
* bool recursive: false
* })
* Creates a symbolic link. Returns a Future<Link> that completes with the link
* when it has been created. If the link exists, the future will complete with
* an error.
*
* If recursive is false, the default, the link is created only if all
* directories in its path exist. If recursive is true, all non-existing path
* components are created. The directories in the path of target are not
* affected, unless they are also in path.
*
* On the Windows platform, this will only work with directories, and the target
* directory must exist. The link will be created as a Junction. Only absolute
* links will be created, and relative paths to the target will be converted to
* absolute paths by joining them with the path of the directory the link is
* contained in.
*
* On other platforms, the posix symlink() call is used to make a symbolic link
* containing the string target. If target is a relative path, it will be
* interpreted relative to the directory containing the link.
* @description Checks that if the link exists, the future will complete with
* an error.
* @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 tmp = getTempLinkSync(parent: sandbox);
Link link = new Link(tmp.path);
asyncStart();
await link.create(tmp.targetSync()).then((Link created) {
Expect.fail("Link create() should fail");
asyncEnd();
}, onError: (_) {
asyncEnd();
});
}