| Index: mojo/public/dart/third_party/path/lib/src/internal_style.dart
|
| diff --git a/mojo/public/dart/third_party/path/lib/src/internal_style.dart b/mojo/public/dart/third_party/path/lib/src/internal_style.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..549f95ba94b0b79cc4c6cd59b597bd7ba72529a9
|
| --- /dev/null
|
| +++ b/mojo/public/dart/third_party/path/lib/src/internal_style.dart
|
| @@ -0,0 +1,71 @@
|
| +// Copyright (c) 2014, 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 path.internal_style;
|
| +
|
| +import 'context.dart';
|
| +import 'style.dart';
|
| +
|
| +/// The internal interface for the [Style] type.
|
| +///
|
| +/// Users should be able to pass around instances of [Style] like an enum, but
|
| +/// the members that [Context] uses should be hidden from them. Those members
|
| +/// are defined on this class instead.
|
| +abstract class InternalStyle extends Style {
|
| + /// The default path separator for this style.
|
| + ///
|
| + /// On POSIX, this is `/`. On Windows, it's `\`.
|
| + String get separator;
|
| +
|
| + /// Returns whether [path] contains a separator.
|
| + bool containsSeparator(String path);
|
| +
|
| + /// Returns whether [codeUnit] is the character code of a separator.
|
| + bool isSeparator(int codeUnit);
|
| +
|
| + /// Returns whether this path component needs a separator after it.
|
| + ///
|
| + /// Windows and POSIX styles just need separators when the previous component
|
| + /// doesn't already end in a separator, but the URL always needs to place a
|
| + /// separator between the root and the first component, even if the root
|
| + /// already ends in a separator character. For example, to join "file://" and
|
| + /// "usr", an additional "/" is needed (making "file:///usr").
|
| + bool needsSeparator(String path);
|
| +
|
| + /// Returns the number of characters of the root part.
|
| + ///
|
| + /// Returns 0 if the path is relative.
|
| + ///
|
| + /// If the path is root-relative, the root length is 1.
|
| + int rootLength(String path);
|
| +
|
| + /// Gets the root prefix of [path] if path is absolute. If [path] is relative,
|
| + /// returns `null`.
|
| + String getRoot(String path) {
|
| + var length = rootLength(path);
|
| + if (length > 0) return path.substring(0, length);
|
| + return isRootRelative(path) ? path[0] : null;
|
| + }
|
| +
|
| + /// Returns whether [path] is root-relative.
|
| + ///
|
| + /// If [path] is relative or absolute and not root-relative, returns `false`.
|
| + bool isRootRelative(String path);
|
| +
|
| + /// Returns the path represented by [uri] in this style.
|
| + String pathFromUri(Uri uri);
|
| +
|
| + /// Returns the URI that represents the relative path made of [parts].
|
| + Uri relativePathToUri(String path) {
|
| + var segments = context.split(path);
|
| +
|
| + // Ensure that a trailing slash in the path produces a trailing slash in the
|
| + // URL.
|
| + if (isSeparator(path.codeUnitAt(path.length - 1))) segments.add('');
|
| + return new Uri(pathSegments: segments);
|
| + }
|
| +
|
| + /// Returns the URI that represents [path], which is assumed to be absolute.
|
| + Uri absolutePathToUri(String path);
|
| +}
|
|
|