Add a path.formatUri method and release path 1.2.0.

pkg/path/test/posix_test.dart

 // 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.
 
 library path.test.posix_test;
 
 import 'package:unittest/unittest.dart';
 import 'package:path/path.dart' as path;
 
 import 'utils.dart';
@@ skipping 490 matching lines @@
     expect(context.toUri('/path/to/foo/'), Uri.parse('file:///path/to/foo/'));
     expect(context.toUri('/'), Uri.parse('file:///'));
     expect(context.toUri('foo/bar'), Uri.parse('foo/bar'));
     expect(context.toUri('/path/to/foo#bar'),
         Uri.parse('file:///path/to/foo%23bar'));
     expect(context.toUri(r'/_{_}_`_^_ _"_%_'),
         Uri.parse('file:///_%7B_%7D_%60_%5E_%20_%22_%25_'));
     expect(context.toUri(r'_{_}_`_^_ _"_%_'),
         Uri.parse('_%7B_%7D_%60_%5E_%20_%22_%25_'));
   });
+
+  group('formatUri', () {
+    test('with a file: URI', () {
+      expect(context.formatUri(Uri.parse('file:///root/path/a/b')), 'a/b');

[Bob Nystrom, 2014/05/23 21:57:52]

The tests would be a bit cleaner if you passed a string argument for most tests
and than just had a single test for passing in a Uri object.

[nweiz, 2014/05/23 22:18:04]

Done.

+      expect(context.formatUri(Uri.parse('file:///other/path/a/b')),
+          '/other/path/a/b');
+      expect(context.formatUri(Uri.parse('file:///root/other')), '../other');
+    });
+
+    test('with an http: URI', () {
+      expect(context.formatUri(Uri.parse('http://dartlang.org/a/b')),
+          'http://dartlang.org/a/b');
+    });
+
+    test('with a relative URI', () {
+      expect(context.formatUri(Uri.parse('a/b')), 'a/b');
+    });
+
+    test('with a root-relative URI', () {
+      expect(context.formatUri(Uri.parse('/a/b')), '/a/b');
+    });
+
+    test('with a String', () {
+      expect(context.formatUri('a/b'), 'a/b');
+    });
+  });
 }