OLD | NEW |
1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 library package_config.packages; | 5 library package_config.packages; |
6 | 6 |
7 import "src/packages_impl.dart"; | 7 import "src/packages_impl.dart"; |
8 | 8 |
9 /// A package resolution strategy. | 9 /// A package resolution strategy. |
10 /// | 10 /// |
11 /// Allows converting a `package:` URI to a different kind of URI. | 11 /// Allows converting a `package:` URI to a different kind of URI. |
12 /// | 12 /// |
13 /// May also allow listing the available packages and converting | 13 /// May also allow listing the available packages and converting |
14 /// to a `Map<String, Uri>` that gives the base location of each available | 14 /// to a `Map<String, Uri>` that gives the base location of each available |
15 /// package. In some cases there is no way to find the available packages, | 15 /// package. In some cases there is no way to find the available packages, |
16 /// in which case [packages] and [asMap] will throw if used. | 16 /// in which case [packages] and [asMap] will throw if used. |
17 /// One such case is if the packages are resolved relative to a | 17 /// One such case is if the packages are resolved relative to a |
18 /// `packages/` directory available over HTTP. | 18 /// `packages/` directory available over HTTP. |
19 abstract class Packages { | 19 abstract class Packages { |
20 | |
21 /// A [Packages] resolver containing no packages. | 20 /// A [Packages] resolver containing no packages. |
22 /// | 21 /// |
23 /// This constant object is returned by [find] above if no | 22 /// This constant object is returned by [find] above if no |
24 /// package resolution strategy is found. | 23 /// package resolution strategy is found. |
25 static const Packages noPackages = const NoPackages(); | 24 static const Packages noPackages = const NoPackages(); |
26 | 25 |
27 /// Resolve a package URI into a non-package URI. | 26 /// Resolve a package URI into a non-package URI. |
28 /// | 27 /// |
29 /// Translates a `package:` URI, according to the package resolution | 28 /// Translates a `package:` URI, according to the package resolution |
30 /// strategy, into a URI that can be loaded. | 29 /// strategy, into a URI that can be loaded. |
(...skipping 19 matching lines...) Expand all Loading... |
50 /// | 49 /// |
51 /// Returns a map from package name to a base URI. | 50 /// Returns a map from package name to a base URI. |
52 /// The [resolve] method will resolve a package URI with a specific package | 51 /// The [resolve] method will resolve a package URI with a specific package |
53 /// name to a path extending the base URI that this map gives for that | 52 /// name to a path extending the base URI that this map gives for that |
54 /// package name. | 53 /// package name. |
55 /// | 54 /// |
56 /// Some `Packages` objects are unable to find the package names, | 55 /// Some `Packages` objects are unable to find the package names, |
57 /// and calling `asMap` on such a `Packages` object will throw. | 56 /// and calling `asMap` on such a `Packages` object will throw. |
58 Map<String, Uri> asMap(); | 57 Map<String, Uri> asMap(); |
59 } | 58 } |
OLD | NEW |