| Index: mojo/public/dart/third_party/path/lib/path.dart
|
| diff --git a/mojo/public/dart/third_party/path/lib/path.dart b/mojo/public/dart/third_party/path/lib/path.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..af9efe54e849ded0200f1f45b469c32ac3c35bed
|
| --- /dev/null
|
| +++ b/mojo/public/dart/third_party/path/lib/path.dart
|
| @@ -0,0 +1,381 @@
|
| +// Copyright (c) 2012, 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.
|
| +
|
| +/// A comprehensive, cross-platform path manipulation library.
|
| +///
|
| +/// ## Installing ##
|
| +///
|
| +/// Use [pub][] to install this package. Add the following to your
|
| +/// `pubspec.yaml` file.
|
| +///
|
| +/// dependencies:
|
| +/// path: any
|
| +///
|
| +/// Then run `pub install`.
|
| +///
|
| +/// For more information, see the [path package on pub.dartlang.org][pkg].
|
| +///
|
| +/// [pub]: http://pub.dartlang.org
|
| +/// [pkg]: http://pub.dartlang.org/packages/path
|
| +///
|
| +/// ## Usage ##
|
| +///
|
| +/// The path library was designed to be imported with a prefix, though you don't
|
| +/// have to if you don't want to:
|
| +///
|
| +/// import 'package:path/path.dart' as path;
|
| +///
|
| +/// The most common way to use the library is through the top-level functions.
|
| +/// These manipulate path strings based on your current working directory and
|
| +/// the path style (POSIX, Windows, or URLs) of the host platform. For example:
|
| +///
|
| +/// path.join("directory", "file.txt");
|
| +///
|
| +/// This calls the top-level [join] function to join "directory" and "file.txt"
|
| +/// using the current platform's directory separator.
|
| +///
|
| +/// If you want to work with paths for a specific platform regardless of the
|
| +/// underlying platform that the program is running on, you can create a
|
| +/// [Context] and give it an explicit [Style]:
|
| +///
|
| +/// var context = new path.Context(style: Style.windows);
|
| +/// context.join("directory", "file.txt");
|
| +///
|
| +/// This will join "directory" and "file.txt" using the Windows path separator,
|
| +/// even when the program is run on a POSIX machine.
|
| +library path;
|
| +
|
| +import 'src/context.dart';
|
| +import 'src/style.dart';
|
| +
|
| +export 'src/context.dart' hide createInternal;
|
| +export 'src/path_exception.dart';
|
| +export 'src/style.dart';
|
| +
|
| +/// A default context for manipulating POSIX paths.
|
| +final Context posix = new Context(style: Style.posix);
|
| +
|
| +/// A default context for manipulating Windows paths.
|
| +final Context windows = new Context(style: Style.windows);
|
| +
|
| +/// A default context for manipulating URLs.
|
| +final Context url = new Context(style: Style.url);
|
| +
|
| +/// The system path context.
|
| +///
|
| +/// This differs from a context created with [new Context] in that its
|
| +/// [Context.current] is always the current working directory, rather than being
|
| +/// set once when the context is created.
|
| +final Context context = createInternal();
|
| +
|
| +/// Returns the [Style] of the current context.
|
| +///
|
| +/// This is the style that all top-level path functions will use.
|
| +Style get style => context.style;
|
| +
|
| +/// Gets the path to the current working directory.
|
| +///
|
| +/// In the browser, this means the current URL, without the last file segment.
|
| +String get current {
|
| + var uri = Uri.base;
|
| + if (Style.platform == Style.url) {
|
| + return uri.resolve('.').toString();
|
| + } else {
|
| + var path = uri.toFilePath();
|
| + // Remove trailing '/' or '\'.
|
| + int lastIndex = path.length - 1;
|
| + assert(path[lastIndex] == '/' || path[lastIndex] == '\\');
|
| + return path.substring(0, lastIndex);
|
| + }
|
| +}
|
| +
|
| +/// Gets the path separator for the current platform. This is `\` on Windows
|
| +/// and `/` on other platforms (including the browser).
|
| +String get separator => context.separator;
|
| +
|
| +/// Creates a new path by appending the given path parts to [current].
|
| +/// Equivalent to [join()] with [current] as the first argument. Example:
|
| +///
|
| +/// path.absolute('path', 'to/foo'); // -> '/your/current/dir/path/to/foo'
|
| +String absolute(String part1, [String part2, String part3, String part4,
|
| + String part5, String part6, String part7]) =>
|
| + context.absolute(part1, part2, part3, part4, part5, part6, part7);
|
| +
|
| +/// Gets the part of [path] after the last separator.
|
| +///
|
| +/// path.basename('path/to/foo.dart'); // -> 'foo.dart'
|
| +/// path.basename('path/to'); // -> 'to'
|
| +///
|
| +/// Trailing separators are ignored.
|
| +///
|
| +/// path.basename('path/to/'); // -> 'to'
|
| +String basename(String path) => context.basename(path);
|
| +
|
| +/// Gets the part of [path] after the last separator, and without any trailing
|
| +/// file extension.
|
| +///
|
| +/// path.basenameWithoutExtension('path/to/foo.dart'); // -> 'foo'
|
| +///
|
| +/// Trailing separators are ignored.
|
| +///
|
| +/// path.basenameWithoutExtension('path/to/foo.dart/'); // -> 'foo'
|
| +String basenameWithoutExtension(String path) =>
|
| + context.basenameWithoutExtension(path);
|
| +
|
| +/// Gets the part of [path] before the last separator.
|
| +///
|
| +/// path.dirname('path/to/foo.dart'); // -> 'path/to'
|
| +/// path.dirname('path/to'); // -> 'path'
|
| +///
|
| +/// Trailing separators are ignored.
|
| +///
|
| +/// path.dirname('path/to/'); // -> 'path'
|
| +///
|
| +/// If an absolute path contains no directories, only a root, then the root
|
| +/// is returned.
|
| +///
|
| +/// path.dirname('/'); // -> '/' (posix)
|
| +/// path.dirname('c:\'); // -> 'c:\' (windows)
|
| +///
|
| +/// If a relative path has no directories, then '.' is returned.
|
| +///
|
| +/// path.dirname('foo'); // -> '.'
|
| +/// path.dirname(''); // -> '.'
|
| +String dirname(String path) => context.dirname(path);
|
| +
|
| +/// Gets the file extension of [path]: the portion of [basename] from the last
|
| +/// `.` to the end (including the `.` itself).
|
| +///
|
| +/// path.extension('path/to/foo.dart'); // -> '.dart'
|
| +/// path.extension('path/to/foo'); // -> ''
|
| +/// path.extension('path.to/foo'); // -> ''
|
| +/// path.extension('path/to/foo.dart.js'); // -> '.js'
|
| +///
|
| +/// If the file name starts with a `.`, then that is not considered the
|
| +/// extension:
|
| +///
|
| +/// path.extension('~/.bashrc'); // -> ''
|
| +/// path.extension('~/.notes.txt'); // -> '.txt'
|
| +String extension(String path) => context.extension(path);
|
| +
|
| +// TODO(nweiz): add a UNC example for Windows once issue 7323 is fixed.
|
| +/// Returns the root of [path], if it's absolute, or the empty string if it's
|
| +/// relative.
|
| +///
|
| +/// // Unix
|
| +/// path.rootPrefix('path/to/foo'); // -> ''
|
| +/// path.rootPrefix('/path/to/foo'); // -> '/'
|
| +///
|
| +/// // Windows
|
| +/// path.rootPrefix(r'path\to\foo'); // -> ''
|
| +/// path.rootPrefix(r'C:\path\to\foo'); // -> r'C:\'
|
| +///
|
| +/// // URL
|
| +/// path.rootPrefix('path/to/foo'); // -> ''
|
| +/// path.rootPrefix('http://dartlang.org/path/to/foo');
|
| +/// // -> 'http://dartlang.org'
|
| +String rootPrefix(String path) => context.rootPrefix(path);
|
| +
|
| +/// Returns `true` if [path] is an absolute path and `false` if it is a
|
| +/// relative path.
|
| +///
|
| +/// On POSIX systems, absolute paths start with a `/` (forward slash). On
|
| +/// Windows, an absolute path starts with `\\`, or a drive letter followed by
|
| +/// `:/` or `:\`. For URLs, absolute paths either start with a protocol and
|
| +/// optional hostname (e.g. `http://dartlang.org`, `file://`) or with a `/`.
|
| +///
|
| +/// URLs that start with `/` are known as "root-relative", since they're
|
| +/// relative to the root of the current URL. Since root-relative paths are still
|
| +/// absolute in every other sense, [isAbsolute] will return true for them. They
|
| +/// can be detected using [isRootRelative].
|
| +bool isAbsolute(String path) => context.isAbsolute(path);
|
| +
|
| +/// Returns `true` if [path] is a relative path and `false` if it is absolute.
|
| +/// On POSIX systems, absolute paths start with a `/` (forward slash). On
|
| +/// Windows, an absolute path starts with `\\`, or a drive letter followed by
|
| +/// `:/` or `:\`.
|
| +bool isRelative(String path) => context.isRelative(path);
|
| +
|
| +/// Returns `true` if [path] is a root-relative path and `false` if it's not.
|
| +///
|
| +/// URLs that start with `/` are known as "root-relative", since they're
|
| +/// relative to the root of the current URL. Since root-relative paths are still
|
| +/// absolute in every other sense, [isAbsolute] will return true for them. They
|
| +/// can be detected using [isRootRelative].
|
| +///
|
| +/// No POSIX and Windows paths are root-relative.
|
| +bool isRootRelative(String path) => context.isRootRelative(path);
|
| +
|
| +/// Joins the given path parts into a single path using the current platform's
|
| +/// [separator]. Example:
|
| +///
|
| +/// path.join('path', 'to', 'foo'); // -> 'path/to/foo'
|
| +///
|
| +/// If any part ends in a path separator, then a redundant separator will not
|
| +/// be added:
|
| +///
|
| +/// path.join('path/', 'to', 'foo'); // -> 'path/to/foo
|
| +///
|
| +/// If a part is an absolute path, then anything before that will be ignored:
|
| +///
|
| +/// path.join('path', '/to', 'foo'); // -> '/to/foo'
|
| +String join(String part1, [String part2, String part3, String part4,
|
| + String part5, String part6, String part7, String part8]) =>
|
| + context.join(part1, part2, part3, part4, part5, part6, part7, part8);
|
| +
|
| +/// Joins the given path parts into a single path using the current platform's
|
| +/// [separator]. Example:
|
| +///
|
| +/// path.joinAll(['path', 'to', 'foo']); // -> 'path/to/foo'
|
| +///
|
| +/// If any part ends in a path separator, then a redundant separator will not
|
| +/// be added:
|
| +///
|
| +/// path.joinAll(['path/', 'to', 'foo']); // -> 'path/to/foo
|
| +///
|
| +/// If a part is an absolute path, then anything before that will be ignored:
|
| +///
|
| +/// path.joinAll(['path', '/to', 'foo']); // -> '/to/foo'
|
| +///
|
| +/// For a fixed number of parts, [join] is usually terser.
|
| +String joinAll(Iterable<String> parts) => context.joinAll(parts);
|
| +
|
| +// TODO(nweiz): add a UNC example for Windows once issue 7323 is fixed.
|
| +/// Splits [path] into its components using the current platform's [separator].
|
| +///
|
| +/// path.split('path/to/foo'); // -> ['path', 'to', 'foo']
|
| +///
|
| +/// The path will *not* be normalized before splitting.
|
| +///
|
| +/// path.split('path/../foo'); // -> ['path', '..', 'foo']
|
| +///
|
| +/// If [path] is absolute, the root directory will be the first element in the
|
| +/// array. Example:
|
| +///
|
| +/// // Unix
|
| +/// path.split('/path/to/foo'); // -> ['/', 'path', 'to', 'foo']
|
| +///
|
| +/// // Windows
|
| +/// path.split(r'C:\path\to\foo'); // -> [r'C:\', 'path', 'to', 'foo']
|
| +///
|
| +/// // Browser
|
| +/// path.split('http://dartlang.org/path/to/foo');
|
| +/// // -> ['http://dartlang.org', 'path', 'to', 'foo']
|
| +List<String> split(String path) => context.split(path);
|
| +
|
| +/// Normalizes [path], simplifying it by handling `..`, and `.`, and
|
| +/// removing redundant path separators whenever possible.
|
| +///
|
| +/// path.normalize('path/./to/..//file.text'); // -> 'path/file.txt'
|
| +String normalize(String path) => context.normalize(path);
|
| +
|
| +/// Attempts to convert [path] to an equivalent relative path from the current
|
| +/// directory.
|
| +///
|
| +/// // Given current directory is /root/path:
|
| +/// path.relative('/root/path/a/b.dart'); // -> 'a/b.dart'
|
| +/// path.relative('/root/other.dart'); // -> '../other.dart'
|
| +///
|
| +/// If the [from] argument is passed, [path] is made relative to that instead.
|
| +///
|
| +/// path.relative('/root/path/a/b.dart',
|
| +/// from: '/root/path'); // -> 'a/b.dart'
|
| +/// path.relative('/root/other.dart',
|
| +/// from: '/root/path'); // -> '../other.dart'
|
| +///
|
| +/// If [path] and/or [from] are relative paths, they are assumed to be relative
|
| +/// to the current directory.
|
| +///
|
| +/// Since there is no relative path from one drive letter to another on Windows,
|
| +/// or from one hostname to another for URLs, this will return an absolute path
|
| +/// in those cases.
|
| +///
|
| +/// // Windows
|
| +/// path.relative(r'D:\other', from: r'C:\home'); // -> 'D:\other'
|
| +///
|
| +/// // URL
|
| +/// path.relative('http://dartlang.org', from: 'http://pub.dartlang.org');
|
| +/// // -> 'http://dartlang.org'
|
| +String relative(String path, {String from}) =>
|
| + context.relative(path, from: from);
|
| +
|
| +/// Returns `true` if [child] is a path beneath `parent`, and `false` otherwise.
|
| +///
|
| +/// path.isWithin('/root/path', '/root/path/a'); // -> true
|
| +/// path.isWithin('/root/path', '/root/other'); // -> false
|
| +/// path.isWithin('/root/path', '/root/path') // -> false
|
| +bool isWithin(String parent, String child) => context.isWithin(parent, child);
|
| +
|
| +/// Removes a trailing extension from the last part of [path].
|
| +///
|
| +/// withoutExtension('path/to/foo.dart'); // -> 'path/to/foo'
|
| +String withoutExtension(String path) => context.withoutExtension(path);
|
| +
|
| +/// Returns the path represented by [uri], which may be a [String] or a [Uri].
|
| +///
|
| +/// For POSIX and Windows styles, [uri] must be a `file:` URI. For the URL
|
| +/// style, this will just convert [uri] to a string.
|
| +///
|
| +/// // POSIX
|
| +/// context.fromUri('file:///path/to/foo')
|
| +/// // -> '/path/to/foo'
|
| +///
|
| +/// // Windows
|
| +/// context.fromUri('file:///C:/path/to/foo')
|
| +/// // -> r'C:\path\to\foo'
|
| +///
|
| +/// // URL
|
| +/// context.fromUri('http://dartlang.org/path/to/foo')
|
| +/// // -> 'http://dartlang.org/path/to/foo'
|
| +///
|
| +/// If [uri] is relative, a relative path will be returned.
|
| +///
|
| +/// path.fromUri('path/to/foo'); // -> 'path/to/foo'
|
| +String fromUri(uri) => context.fromUri(uri);
|
| +
|
| +/// Returns the URI that represents [path].
|
| +///
|
| +/// For POSIX and Windows styles, this will return a `file:` URI. For the URL
|
| +/// style, this will just convert [path] to a [Uri].
|
| +///
|
| +/// // POSIX
|
| +/// path.toUri('/path/to/foo')
|
| +/// // -> Uri.parse('file:///path/to/foo')
|
| +///
|
| +/// // Windows
|
| +/// path.toUri(r'C:\path\to\foo')
|
| +/// // -> Uri.parse('file:///C:/path/to/foo')
|
| +///
|
| +/// // URL
|
| +/// path.toUri('http://dartlang.org/path/to/foo')
|
| +/// // -> Uri.parse('http://dartlang.org/path/to/foo')
|
| +///
|
| +/// If [path] is relative, a relative URI will be returned.
|
| +///
|
| +/// path.toUri('path/to/foo')
|
| +/// // -> Uri.parse('path/to/foo')
|
| +Uri toUri(String path) => context.toUri(path);
|
| +
|
| +/// Returns a terse, human-readable representation of [uri].
|
| +///
|
| +/// [uri] can be a [String] or a [Uri]. If it can be made relative to the
|
| +/// current working directory, that's done. Otherwise, it's returned as-is. This
|
| +/// gracefully handles non-`file:` URIs for [Style.posix] and [Style.windows].
|
| +///
|
| +/// The returned value is meant for human consumption, and may be either URI-
|
| +/// or path-formatted.
|
| +///
|
| +/// // POSIX at "/root/path"
|
| +/// path.prettyUri('file:///root/path/a/b.dart'); // -> 'a/b.dart'
|
| +/// path.prettyUri('http://dartlang.org/'); // -> 'http://dartlang.org'
|
| +///
|
| +/// // Windows at "C:\root\path"
|
| +/// path.prettyUri('file:///C:/root/path/a/b.dart'); // -> r'a\b.dart'
|
| +/// path.prettyUri('http://dartlang.org/'); // -> 'http://dartlang.org'
|
| +///
|
| +/// // URL at "http://dartlang.org/root/path"
|
| +/// path.prettyUri('http://dartlang.org/root/path/a/b.dart');
|
| +/// // -> r'a/b.dart'
|
| +/// path.prettyUri('file:///root/path'); // -> 'file:///root/path'
|
| +String prettyUri(uri) => context.prettyUri(uri);
|
|
|