| // 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 in the file system. |
| /// |
| /// The created link will point to the path at `target`, whether that path |
| /// exists or not. |
| /// |
| /// Returns a `Future<Link>` that completes with the link when it has been |
| /// created. If the link path already 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 |
| /// parent paths are created first. The directories in the path of target are |
| /// not affected, unless they are also in [path]. |
| /// |
| /// On the Windows platform, this call will create a true symbolic link instead |
| /// of a junction. The link represents a file or directory and does not change |
| /// its type after creation. If `target` exists then the type of the link will |
| /// match the type `target`, otherwise a file symlink is created. |
| /// |
| /// 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. |
| /// |
| /// 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 `recursive` is `true`, all non-existing path |
| /// components are created |
| /// @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 { |
| String dirPath = getTempDirectoryPath(parent: sandbox); |
| Directory target = getTempDirectorySync(parent: sandbox); |
| String linkPath = |
| dirPath + Platform.pathSeparator + getTempFileName(extension: "lnk"); |
| Link link = new Link(linkPath); |
| asyncStart(); |
| await link.create(target.path, recursive: true).then((Link created) { |
| Expect.isTrue(created.existsSync()); |
| Expect.equals(link.path, created.path); |
| asyncEnd(); |
| }); |
| } |