| Index: mojo/public/dart/third_party/package_config/lib/discovery.dart
|
| diff --git a/mojo/public/dart/third_party/package_config/lib/discovery.dart b/mojo/public/dart/third_party/package_config/lib/discovery.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..8e42af79d78fe213b9ec5d1f4ae9d034e99eb0d0
|
| --- /dev/null
|
| +++ b/mojo/public/dart/third_party/package_config/lib/discovery.dart
|
| @@ -0,0 +1,228 @@
|
| +// Copyright (c) 2015, 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.
|
| +
|
| +library package_config.discovery;
|
| +
|
| +import "dart:async";
|
| +import "dart:io";
|
| +import "dart:typed_data" show Uint8List;
|
| +
|
| +import "package:path/path.dart" as path;
|
| +
|
| +import "packages.dart";
|
| +import "packages_file.dart" as pkgfile show parse;
|
| +import "src/packages_impl.dart";
|
| +import "src/packages_io_impl.dart";
|
| +
|
| +/// Reads a package resolution file and creates a [Packages] object from it.
|
| +///
|
| +/// The [packagesFile] must exist and be loadable.
|
| +/// Currently that means the URI must have a `file`, `http` or `https` scheme,
|
| +/// and that the file can be loaded and its contents parsed correctly.
|
| +///
|
| +/// If the [loader] is provided, it is used to fetch non-`file` URIs, and
|
| +/// it can support other schemes or set up more complex HTTP requests.
|
| +///
|
| +/// This function can be used to load an explicitly configured package
|
| +/// resolution file, for example one specified using a `--packages`
|
| +/// command-line parameter.
|
| +Future<Packages> loadPackagesFile(Uri packagesFile,
|
| + {Future<List<int>> loader(Uri uri)}) {
|
| + Packages parseBytes(List<int> bytes) {
|
| + Map<String, Uri> packageMap = pkgfile.parse(bytes, packagesFile);
|
| + return new MapPackages(packageMap);
|
| + }
|
| + if (packagesFile.scheme == "file") {
|
| + File file = new File.fromUri(packagesFile);
|
| + return file.readAsBytes().then(parseBytes);
|
| + }
|
| + if (loader == null) {
|
| + return _httpGet(packagesFile).then(parseBytes);
|
| + }
|
| + return loader(packagesFile).then(parseBytes);
|
| +}
|
| +
|
| +
|
| +/// Create a [Packages] object for a package directory.
|
| +///
|
| +/// The [packagesDir] URI should refer to a directory.
|
| +/// Package names are resolved as relative to sub-directories of the
|
| +/// package directory.
|
| +///
|
| +/// This function can be used for explicitly configured package directories,
|
| +/// for example one specified using a `--package-root` comand-line parameter.
|
| +Packages getPackagesDirectory(Uri packagesDir) {
|
| + if (packagesDir.scheme == "file") {
|
| + Directory directory = new Directory.fromUri(packagesDir);
|
| + return new FilePackagesDirectoryPackages(directory);
|
| + }
|
| + if (!packagesDir.path.endsWith('/')) {
|
| + packagesDir = packagesDir.replace(path: packagesDir.path + '/');
|
| + }
|
| + return new NonFilePackagesDirectoryPackages(packagesDir);
|
| +}
|
| +
|
| +
|
| +/// Discover the package configuration for a Dart script.
|
| +///
|
| +/// The [baseUri] points to either the Dart script or its directory.
|
| +/// A package resolution strategy is found by going through the following steps,
|
| +/// and stopping when something is found.
|
| +///
|
| +/// * Check if a `.packages` file exists in the same directory.
|
| +/// * If `baseUri`'s scheme is not `file`, then assume a `packages` directory
|
| +/// in the same directory, and resolve packages relative to that.
|
| +/// * If `baseUri`'s scheme *is* `file`:
|
| +/// * Check if a `packages` directory exists.
|
| +/// * Otherwise check each successive parent directory of `baseUri` for a
|
| +/// `.packages` file.
|
| +///
|
| +/// If any of these tests succeed, a `Packages` class is returned.
|
| +/// Returns the constant [noPackages] if no resolution strategy is found.
|
| +///
|
| +/// This function currently only supports `file`, `http` and `https` URIs.
|
| +/// It needs to be able to load a `.packages` file from the URI, so only
|
| +/// recognized schemes are accepted.
|
| +///
|
| +/// To support other schemes, or more complex HTTP requests,
|
| +/// an optional [loader] function can be supplied.
|
| +/// It's called to load the `.packages` file for a non-`file` scheme.
|
| +/// The loader function returns the *contents* of the file
|
| +/// identified by the URI it's given.
|
| +/// The content should be a UTF-8 encoded `.packages` file, and must return an
|
| +/// error future if loading fails for any reason.
|
| +Future<Packages> findPackages(Uri baseUri,
|
| + {Future<List<int>> loader(Uri unsupportedUri)}) {
|
| + if (baseUri.scheme == "file") {
|
| + return new Future<Packages>.sync(() => findPackagesFromFile(baseUri));
|
| + } else if (loader != null) {
|
| + return findPackagesFromNonFile(baseUri, loader: loader);
|
| + } else if (baseUri.scheme == "http" || baseUri.scheme == "https") {
|
| + return findPackagesFromNonFile(baseUri, loader: _httpGet);
|
| + } else {
|
| + return new Future<Packages>.value(Packages.noPackages);
|
| + }
|
| +}
|
| +
|
| +/// Find the location of the package resolution file/directory for a Dart file.
|
| +///
|
| +/// Checks for a `.packages` file in the [workingDirectory].
|
| +/// If not found, checks for a `packages` directory in the same directory.
|
| +/// If still not found, starts checking parent directories for
|
| +/// `.packages` until reaching the root directory.
|
| +///
|
| +/// Returns a [File] object of a `.packages` file if one is found, or a
|
| +/// [Directory] object for the `packages/` directory if that is found.
|
| +FileSystemEntity _findPackagesFile(String workingDirectory) {
|
| + var dir = new Directory(workingDirectory);
|
| + if (!dir.isAbsolute) dir = dir.absolute;
|
| + if (!dir.existsSync()) {
|
| + throw new ArgumentError.value(
|
| + workingDirectory, "workingDirectory", "Directory does not exist.");
|
| + }
|
| + File checkForConfigFile(Directory directory) {
|
| + assert(directory.isAbsolute);
|
| + var file = new File(path.join(directory.path, ".packages"));
|
| + if (file.existsSync()) return file;
|
| + return null;
|
| + }
|
| + // Check for $cwd/.packages
|
| + var packagesCfgFile = checkForConfigFile(dir);
|
| + if (packagesCfgFile != null) return packagesCfgFile;
|
| + // Check for $cwd/packages/
|
| + var packagesDir = new Directory(path.join(dir.path, "packages"));
|
| + if (packagesDir.existsSync()) return packagesDir;
|
| + // Check for cwd(/..)+/.packages
|
| + var parentDir = dir.parent;
|
| + while (parentDir.path != dir.path) {
|
| + packagesCfgFile = checkForConfigFile(parentDir);
|
| + if (packagesCfgFile != null) break;
|
| + dir = parentDir;
|
| + parentDir = dir.parent;
|
| + }
|
| + return packagesCfgFile;
|
| +}
|
| +
|
| +/// Finds a package resolution strategy for a local Dart script.
|
| +///
|
| +/// The [fileBaseUri] points to either a Dart script or the directory of the
|
| +/// script. The `fileBaseUri` must be a `file:` URI.
|
| +///
|
| +/// This function first tries to locate a `.packages` file in the `fileBaseUri`
|
| +/// directory. If that is not found, it instead checks for the presence of
|
| +/// a `packages/` directory in the same place.
|
| +/// If that also fails, it starts checking parent directories for a `.packages`
|
| +/// file, and stops if it finds it.
|
| +/// Otherwise it gives up and returns [Packages.noPackages].
|
| +Packages findPackagesFromFile(Uri fileBaseUri) {
|
| + Uri baseDirectoryUri = fileBaseUri;
|
| + if (!fileBaseUri.path.endsWith('/')) {
|
| + baseDirectoryUri = baseDirectoryUri.resolve(".");
|
| + }
|
| + String baseDirectoryPath = baseDirectoryUri.toFilePath();
|
| + FileSystemEntity location = _findPackagesFile(baseDirectoryPath);
|
| + if (location == null) return Packages.noPackages;
|
| + if (location is File) {
|
| + List<int> fileBytes = location.readAsBytesSync();
|
| + Map<String, Uri> map =
|
| + pkgfile.parse(fileBytes, new Uri.file(location.path));
|
| + return new MapPackages(map);
|
| + }
|
| + assert(location is Directory);
|
| + return new FilePackagesDirectoryPackages(location);
|
| +}
|
| +
|
| +/// Finds a package resolution strategy for a Dart script.
|
| +///
|
| +/// The [nonFileUri] points to either a Dart script or the directory of the
|
| +/// script.
|
| +/// The [nonFileUri] should not be a `file:` URI since the algorithm for
|
| +/// finding a package resolution strategy is more elaborate for `file:` URIs.
|
| +/// In that case, use [findPackagesFromFile].
|
| +///
|
| +/// This function first tries to locate a `.packages` file in the [nonFileUri]
|
| +/// directory. If that is not found, it instead assumes a `packages/` directory
|
| +/// in the same place.
|
| +///
|
| +/// By default, this function only works for `http:` and `https:` URIs.
|
| +/// To support other schemes, a loader must be provided, which is used to
|
| +/// try to load the `.packages` file. The loader should return the contents
|
| +/// of the requested `.packages` file as bytes, which will be assumed to be
|
| +/// UTF-8 encoded.
|
| +Future<Packages> findPackagesFromNonFile(Uri nonFileUri,
|
| + {Future<List<int>> loader(Uri name)}) {
|
| + if (loader == null) loader = _httpGet;
|
| + Uri packagesFileUri = nonFileUri.resolve(".packages");
|
| + return loader(packagesFileUri).then((List<int> fileBytes) {
|
| + Map<String, Uri> map = pkgfile.parse(fileBytes, packagesFileUri);
|
| + return new MapPackages(map);
|
| + }, onError: (_) {
|
| + // Didn't manage to load ".packages". Assume a "packages/" directory.
|
| + Uri packagesDirectoryUri = nonFileUri.resolve("packages/");
|
| + return new NonFilePackagesDirectoryPackages(packagesDirectoryUri);
|
| + });
|
| +}
|
| +
|
| +/// Fetches a file over http.
|
| +Future<List<int>> _httpGet(Uri uri) async {
|
| + HttpClient client = new HttpClient();
|
| + HttpClientRequest request = await client.getUrl(uri);
|
| + HttpClientResponse response = await request.close();
|
| + if (response.statusCode != HttpStatus.OK) {
|
| + throw 'Failure getting $uri: '
|
| + '${response.statusCode} ${response.reasonPhrase}';
|
| + }
|
| + List<List<int>> splitContent = await response.toList();
|
| + int totalLength = 0;
|
| + for (var list in splitContent) {
|
| + totalLength += list.length;
|
| + }
|
| + Uint8List result = new Uint8List(totalLength);
|
| + int offset = 0;
|
| + for (List<int> contentPart in splitContent) {
|
| + result.setRange(offset, offset + contentPart.length, contentPart);
|
| + offset += contentPart.length;
|
| + }
|
| + return result;
|
| +}
|
|
|