OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 /// A comprehensive, cross-platform path manipulation library. | 5 /// A comprehensive, cross-platform path manipulation library. |
6 /// | 6 /// |
7 /// ## Installing ## | 7 /// ## Installing ## |
8 /// | 8 /// |
9 /// Use [pub][] to install this package. Add the following to your | 9 /// Use [pub][] to install this package. Add the following to your |
10 /// `pubspec.yaml` file. | 10 /// `pubspec.yaml` file. |
(...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
55 | 55 |
56 /// A default context for manipulating POSIX paths. | 56 /// A default context for manipulating POSIX paths. |
57 final posix = new Context(style: Style.posix); | 57 final posix = new Context(style: Style.posix); |
58 | 58 |
59 /// A default context for manipulating Windows paths. | 59 /// A default context for manipulating Windows paths. |
60 final windows = new Context(style: Style.windows); | 60 final windows = new Context(style: Style.windows); |
61 | 61 |
62 /// A default context for manipulating URLs. | 62 /// A default context for manipulating URLs. |
63 final url = new Context(style: Style.url); | 63 final url = new Context(style: Style.url); |
64 | 64 |
65 /// The result of [Uri.base] last time the current working directory was | |
66 /// calculated. | |
67 /// | |
68 /// This is used to invalidate [_cachedContext] when the working directory has | |
69 /// changed since the last time a function was called. | |
70 Uri _lastBaseUri; | |
71 | |
72 /// An internal context for the current OS so we can provide a straight | 65 /// An internal context for the current OS so we can provide a straight |
73 /// functional interface and not require users to create one. | 66 /// functional interface and not require users to create one. |
74 Context get _context { | 67 final Context _context = new Context.internal(); |
75 if (_cachedContext != null && Uri.base == _lastBaseUri) return _cachedContext; | |
76 _lastBaseUri = Uri.base; | |
77 _cachedContext = new Context(); | |
78 return _cachedContext; | |
79 } | |
80 Context _cachedContext; | |
81 | 68 |
82 /// Returns the [Style] of the current context. | 69 /// Returns the [Style] of the current context. |
83 /// | 70 /// |
84 /// This is the style that all top-level path functions will use. | 71 /// This is the style that all top-level path functions will use. |
85 Style get style => _context.style; | 72 Style get style => _context.style; |
86 | 73 |
87 /// Gets the path to the current working directory. | 74 /// Gets the path to the current working directory. |
88 /// | 75 /// |
89 /// In the browser, this means the current URL, without the last file segment. | 76 /// In the browser, this means the current URL, without the last file segment. |
90 String get current { | 77 String get current { |
(...skipping 291 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
382 /// | 369 /// |
383 /// // Windows at "C:\root\path" | 370 /// // Windows at "C:\root\path" |
384 /// path.prettyUri('file:///C:/root/path/a/b.dart'); // -> r'a\b.dart' | 371 /// path.prettyUri('file:///C:/root/path/a/b.dart'); // -> r'a\b.dart' |
385 /// path.prettyUri('http://dartlang.org/'); // -> 'http://dartlang.org' | 372 /// path.prettyUri('http://dartlang.org/'); // -> 'http://dartlang.org' |
386 /// | 373 /// |
387 /// // URL at "http://dartlang.org/root/path" | 374 /// // URL at "http://dartlang.org/root/path" |
388 /// path.prettyUri('http://dartlang.org/root/path/a/b.dart'); | 375 /// path.prettyUri('http://dartlang.org/root/path/a/b.dart'); |
389 /// // -> r'a/b.dart' | 376 /// // -> r'a/b.dart' |
390 /// path.prettyUri('file:///root/path'); // -> 'file:///root/path' | 377 /// path.prettyUri('file:///root/path'); // -> 'file:///root/path' |
391 String prettyUri(uri) => _context.prettyUri(uri); | 378 String prettyUri(uri) => _context.prettyUri(uri); |
OLD | NEW |