Get codebase ready for actually supporting versioning.

utils/pub/pubspec.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('pub_pubspec');
+
+#import('io.dart');
+#import('pub.dart');
+#import('source.dart');
+#import('utils.dart');
+#import('version.dart');
+#import('yaml/yaml.dart');
+
+/**
+ * The parsed and validated contents of a pubspec file.
+ */
+class Pubspec {
+  /**
+   * This package's version.
+   */
+  final Version version;
+
+  /**
+   * The packages this package depends on.
+   */
+  List<PackageRef> dependencies;
+
+  Pubspec._(this.version, this.dependencies);
+
+  Pubspec.empty()
+    : version = Version.none,
+      dependencies = <PackageRef>[];
+
+  /**
+   * Parses the pubspec whose text is [contents]. If the pubspec doesn't define
+   * version for itself, it defaults to [Version.none].
+   */
+  factory Pubspec.parse(String contents, SourceRegistry sources) {
+    var version = Version.none;
+    var dependencies = <PackageRef>[];
+
+    if (contents.trim() == '') return new Pubspec.empty();
+
+    var parsedPubspec = loadYaml(contents);
+    if (parsedPubspec is! Map) {
+      throw new FormatException('The pubspec must be a YAML mapping.');
+    }
+
+    if (parsedPubspec.containsKey('version')) {
+      version = new Version.parse(parsedPubspec['version']);
+    }
+
+    if (parsedPubspec.containsKey('dependencies')) {
+      var dependencyEntries = parsedPubspec['dependencies'];
+      if (dependencyEntries is! Map ||
+          dependencyEntries.getKeys().some((e) => e is! String)) {
+        throw new FormatException(
+            'The pubspec dependencies must be a map of package names.');
+      }
+
+      dependencyEntries.forEach((name, spec) {
+        var description, source;
+        if (spec == null) {
+          description = name;
+          source = sources.defaultSource;
+        } else if (spec is String) {
+          description = name;
+          source = sources.defaultSource;
+          // TODO(rnystrom): Support parsing version constraints like
+          // ">= 2.0.0 < 3.1.3".
+          version = new Version.parse(spec);
+        } else if (spec is Map) {
+          if (spec.containsKey('version')) {
+            // TODO(rnystrom): Support parsing version constraints like
+            // ">= 2.0.0 < 3.1.3".
+            version = new Version.parse(spec.remove('version'));
+          }
+
+          var sourceNames = spec.getKeys();
+          if (sourceNames.length > 1) {
+            throw new FormatException(
+                'Dependency $name may only have one source: $sourceNames.');
+          }
+
+          var sourceName = only(sourceNames);
+          if (sourceName is! String) {
+            throw new FormatException(
+                'Source name $sourceName must be a string.');
+          }
+
+          source = sources[sourceName];
+          description = spec[sourceName];
+        } else {
+          throw new FormatException(
+              'Dependency specification $spec must be a string or a mapping.');
+        }
+
+        source.validateDescription(description);
+
+        dependencies.add(new PackageRef(
+            name, source, Version.none, description));
+      });
+    }
+
+    return new Pubspec._(version, dependencies);
+  }
+}