Use a lockfile to persist Pub's installed version constellation.

utils/tests/pub/lock_file_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('lock_file_test');
 
 #import('../../../lib/unittest/unittest.dart');
 #import('../../pub/lock_file.dart');
 #import('../../pub/package.dart');
 #import('../../pub/source.dart');
 #import('../../pub/source_registry.dart');
 #import('../../pub/utils.dart');
 #import('../../pub/version.dart');
+#import('../../pub/yaml/yaml.dart');
 
 class MockSource extends Source {
   final String name = 'mock';
   final bool shouldCache = false;
 
-  void validateDescription(String description) {
+  void validateDescription(String description, [bool fromLockFile=false]) {
     description.endsWith(' desc');
   }
 
   String packageName(String description) {
     // Strip off ' desc'.
     return description.substring(0, description.length - 5);
   }
 }
 
 main() {
@@ skipping 128 matching lines @@
   some: stuff
 packages:
   foo:
     bonus: not used
     version: 1.2.3
     source: mock
     description: foo desc
 ''', sources);
       });
     });
+
+    group('serialize()', () {
+      test('dumps the lockfile to YAML', () {
+        var lockfile = new LockFile.empty();
+        lockfile.packages['foo'] =
+          new PackageId(mockSource, new Version.parse('1.2.3'), 'foo desc');
+        lockfile.packages['bar'] =
+          new PackageId(mockSource, new Version.parse('3.2.1'), 'bar desc');
+
+        expect(loadYaml(lockfile.serialize()), equals({
+          'packages': {
+            'foo': {
+              'version': '1.2.3',
+              'source': 'mock',
+              'description': 'foo desc'
+            },
+            'bar': {
+              'version': '3.2.1',
+              'source': 'mock',
+              'description': 'bar desc'
+            }
+          }
+        }));
+      });
+    });
   });
 }
 
 throwsBadFormat(function) {
   expectThrow(function, (e) => e is FormatException);
 }