Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(262)

Unified Diff: utils/pub/version.dart

Issue 14297021: Move pub into sdk/lib/_internal. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Disallow package: imports of pub. Created 7 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « utils/pub/validator/utf8_readme.dart ('k') | utils/tests/pub/command_line_config.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: utils/pub/version.dart
diff --git a/utils/pub/version.dart b/utils/pub/version.dart
deleted file mode 100644
index 62669e4b6376a4953863efb9e447e9efe85e074c..0000000000000000000000000000000000000000
--- a/utils/pub/version.dart
+++ /dev/null
@@ -1,473 +0,0 @@
-// 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.
-
-/// Handles version numbers, following the [Semantic Versioning][semver] spec.
-///
-/// [semver]: http://semver.org/
-library version;
-
-import 'dart:math';
-
-import 'utils.dart';
-
-
-/// Regex that matches a version number at the beginning of a string.
-final _START_VERSION = new RegExp(
- r'^' // Start at beginning.
- r'(\d+).(\d+).(\d+)' // Version number.
- r'(-([0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*))?' // Pre-release.
- r'(\+([0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*))?'); // Build.
-
-/// Like [_START_VERSION] but matches the entire string.
-final _COMPLETE_VERSION = new RegExp("${_START_VERSION.pattern}\$");
-
-/// Parses a comparison operator ("<", ">", "<=", or ">=") at the beginning of
-/// a string.
-final _START_COMPARISON = new RegExp(r"^[<>]=?");
-
-/// A parsed semantic version number.
-class Version implements Comparable<Version>, VersionConstraint {
- /// No released version: i.e. "0.0.0".
- static Version get none => new Version(0, 0, 0);
- /// The major version number: "1" in "1.2.3".
- final int major;
-
- /// The minor version number: "2" in "1.2.3".
- final int minor;
-
- /// The patch version number: "3" in "1.2.3".
- final int patch;
-
- /// The pre-release identifier: "foo" in "1.2.3-foo". May be `null`.
- final String preRelease;
-
- /// The build identifier: "foo" in "1.2.3+foo". May be `null`.
- final String build;
-
- /// Creates a new [Version] object.
- Version(this.major, this.minor, this.patch, {String pre, this.build})
- : preRelease = pre {
- if (major < 0) throw new ArgumentError(
- 'Major version must be non-negative.');
- if (minor < 0) throw new ArgumentError(
- 'Minor version must be non-negative.');
- if (patch < 0) throw new ArgumentError(
- 'Patch version must be non-negative.');
- }
-
- /// Creates a new [Version] by parsing [text].
- factory Version.parse(String text) {
- final match = _COMPLETE_VERSION.firstMatch(text);
- if (match == null) {
- throw new FormatException('Could not parse "$text".');
- }
-
- try {
- int major = int.parse(match[1]);
- int minor = int.parse(match[2]);
- int patch = int.parse(match[3]);
-
- String preRelease = match[5];
- String build = match[8];
-
- return new Version(major, minor, patch, pre: preRelease, build: build);
- } on FormatException catch (ex) {
- throw new FormatException('Could not parse "$text".');
- }
- }
-
- /// Returns the primary version out of a list of candidates. This is the
- /// highest-numbered stable (non-prerelease) version. If there are no stable
- /// versions, it's just the highest-numbered version.
- static Version primary(List<Version> versions) {
- var primary;
- for (var version in versions) {
- if (primary == null || (!version.isPreRelease && primary.isPreRelease) ||
- (version.isPreRelease == primary.isPreRelease && version > primary)) {
- primary = version;
- }
- }
- return primary;
- }
-
- bool operator ==(other) {
- if (other is! Version) return false;
- return compareTo(other) == 0;
- }
-
- bool operator <(Version other) => compareTo(other) < 0;
- bool operator >(Version other) => compareTo(other) > 0;
- bool operator <=(Version other) => compareTo(other) <= 0;
- bool operator >=(Version other) => compareTo(other) >= 0;
-
- bool get isAny => false;
- bool get isEmpty => false;
-
- /// Whether or not this is a pre-release version.
- bool get isPreRelease => preRelease != null;
-
- /// Tests if [other] matches this version exactly.
- bool allows(Version other) => this == other;
-
- VersionConstraint intersect(VersionConstraint other) {
- if (other.isEmpty) return other;
-
- // Intersect a version and a range.
- if (other is VersionRange) return other.intersect(this);
-
- // Intersecting two versions only works if they are the same.
- if (other is Version) {
- return this == other ? this : VersionConstraint.empty;
- }
-
- throw new ArgumentError(
- 'Unknown VersionConstraint type $other.');
- }
-
- int compareTo(Version other) {
- if (major != other.major) return major.compareTo(other.major);
- if (minor != other.minor) return minor.compareTo(other.minor);
- if (patch != other.patch) return patch.compareTo(other.patch);
-
- if (preRelease != other.preRelease) {
- // Pre-releases always come before no pre-release string.
- if (preRelease == null) return 1;
- if (other.preRelease == null) return -1;
-
- return _compareStrings(preRelease, other.preRelease);
- }
-
- if (build != other.build) {
- // Builds always come after no build string.
- if (build == null) return -1;
- if (other.build == null) return 1;
-
- return _compareStrings(build, other.build);
- }
-
- return 0;
- }
-
- int get hashCode => toString().hashCode;
-
- String toString() {
- var buffer = new StringBuffer();
- buffer.write('$major.$minor.$patch');
- if (preRelease != null) buffer.write('-$preRelease');
- if (build != null) buffer.write('+$build');
- return buffer.toString();
- }
-
- /// Compares the string part of two versions. This is used for the pre-release
- /// and build version parts. This follows Rule 12. of the Semantic Versioning
- /// spec.
- int _compareStrings(String a, String b) {
- var aParts = _splitParts(a);
- var bParts = _splitParts(b);
-
- for (int i = 0; i < max(aParts.length, bParts.length); i++) {
- var aPart = (i < aParts.length) ? aParts[i] : null;
- var bPart = (i < bParts.length) ? bParts[i] : null;
-
- if (aPart != bPart) {
- // Missing parts come before present ones.
- if (aPart == null) return -1;
- if (bPart == null) return 1;
-
- if (aPart is int) {
- if (bPart is int) {
- // Compare two numbers.
- return aPart.compareTo(bPart);
- } else {
- // Numbers come before strings.
- return -1;
- }
- } else {
- if (bPart is int) {
- // Strings come after numbers.
- return 1;
- } else {
- // Compare two strings.
- return aPart.compareTo(bPart);
- }
- }
- }
- }
- }
-
- /// Splits a string of dot-delimited identifiers into their component parts.
- /// Identifiers that are numeric are converted to numbers.
- List _splitParts(String text) {
- return text.split('.').map((part) {
- try {
- return int.parse(part);
- } on FormatException catch (ex) {
- // Not a number.
- return part;
- }
- }).toList();
- }
-}
-
-/// A [VersionConstraint] is a predicate that can determine whether a given
-/// version is valid or not. For example, a ">= 2.0.0" constraint allows any
-/// version that is "2.0.0" or greater. Version objects themselves implement
-/// this to match a specific version.
-abstract class VersionConstraint {
- /// A [VersionConstraint] that allows all versions.
- static VersionConstraint any = new VersionRange();
-
- /// A [VersionConstraint] that allows no versions: i.e. the empty set.
- static VersionConstraint empty = const _EmptyVersion();
-
- /// Parses a version constraint. This string is either "any" or a series of
- /// version parts. Each part can be one of:
- ///
- /// * A version string like `1.2.3`. In other words, anything that can be
- /// parsed by [Version.parse()].
- /// * A comparison operator (`<`, `>`, `<=`, or `>=`) followed by a version
- /// string.
- ///
- /// Whitespace is ignored.
- ///
- /// Examples:
- ///
- /// any
- /// 1.2.3-alpha
- /// <=5.1.4
- /// >2.0.4 <= 2.4.6
- factory VersionConstraint.parse(String text) {
- // Handle the "any" constraint.
- if (text.trim() == "any") return new VersionRange();
-
- var originalText = text;
- var constraints = <VersionConstraint>[];
-
- void skipWhitespace() {
- text = text.trim();
- }
-
- // Try to parse and consume a version number.
- Version matchVersion() {
- var version = _START_VERSION.firstMatch(text);
- if (version == null) return null;
-
- text = text.substring(version.end);
- return new Version.parse(version[0]);
- }
-
- // Try to parse and consume a comparison operator followed by a version.
- VersionConstraint matchComparison() {
- var comparison = _START_COMPARISON.firstMatch(text);
- if (comparison == null) return null;
-
- var op = comparison[0];
- text = text.substring(comparison.end);
- skipWhitespace();
-
- var version = matchVersion();
- if (version == null) {
- throw new FormatException('Expected version number after "$op" in '
- '"$originalText", got "$text".');
- }
-
- switch (op) {
- case '<=':
- return new VersionRange(max: version, includeMax: true);
- case '<':
- return new VersionRange(max: version, includeMax: false);
- case '>=':
- return new VersionRange(min: version, includeMin: true);
- case '>':
- return new VersionRange(min: version, includeMin: false);
- }
- }
-
- while (true) {
- skipWhitespace();
- if (text.isEmpty) break;
-
- var version = matchVersion();
- if (version != null) {
- constraints.add(version);
- continue;
- }
-
- var comparison = matchComparison();
- if (comparison != null) {
- constraints.add(comparison);
- continue;
- }
-
- // If we got here, we couldn't parse the remaining string.
- throw new FormatException('Could not parse version "$originalText". '
- 'Unknown text at "$text".');
- }
-
- if (constraints.isEmpty) {
- throw new FormatException('Cannot parse an empty string.');
- }
-
- return new VersionConstraint.intersection(constraints);
- }
-
- /// Creates a new version constraint that is the intersection of
- /// [constraints]. It will only allow versions that all of those constraints
- /// allow. If constraints is empty, then it returns a VersionConstraint that
- /// allows all versions.
- factory VersionConstraint.intersection(
- Iterable<VersionConstraint> constraints) {
- var constraint = new VersionRange();
- for (var other in constraints) {
- constraint = constraint.intersect(other);
- }
- return constraint;
- }
-
- /// Returns `true` if this constraint allows no versions.
- bool get isEmpty;
-
- /// Returns `true` if this constraint allows all versions.
- bool get isAny;
-
- /// Returns `true` if this constraint allows [version].
- bool allows(Version version);
-
- /// Creates a new [VersionConstraint] that only allows [Version]s allowed by
- /// both this and [other].
- VersionConstraint intersect(VersionConstraint other);
-}
-
-/// Constrains versions to a fall within a given range. If there is a minimum,
-/// then this only allows versions that are at that minimum or greater. If there
-/// is a maximum, then only versions less than that are allowed. In other words,
-/// this allows `>= min, < max`.
-class VersionRange implements VersionConstraint {
- final Version min;
- final Version max;
- final bool includeMin;
- final bool includeMax;
-
- VersionRange({this.min, this.max,
- this.includeMin: false, this.includeMax: false}) {
- if (min != null && max != null && min > max) {
- throw new ArgumentError(
- 'Minimum version ("$min") must be less than maximum ("$max").');
- }
- }
-
- bool operator ==(other) {
- if (other is! VersionRange) return false;
-
- return min == other.min &&
- max == other.max &&
- includeMin == other.includeMin &&
- includeMax == other.includeMax;
- }
-
- bool get isEmpty => false;
-
- bool get isAny => !includeMin && !includeMax;
-
- /// Tests if [other] matches falls within this version range.
- bool allows(Version other) {
- if (min != null && other < min) return false;
- if (min != null && !includeMin && other == min) return false;
- if (max != null && other > max) return false;
- if (max != null && !includeMax && other == max) return false;
- return true;
- }
-
- VersionConstraint intersect(VersionConstraint other) {
- if (other.isEmpty) return other;
-
- // A range and a Version just yields the version if it's in the range.
- if (other is Version) {
- return allows(other) ? other : VersionConstraint.empty;
- }
-
- if (other is VersionRange) {
- // Intersect the two ranges.
- var intersectMin = min;
- var intersectIncludeMin = includeMin;
- var intersectMax = max;
- var intersectIncludeMax = includeMax;
-
- if (other.min == null) {
- // Do nothing.
- } else if (intersectMin == null || intersectMin < other.min) {
- intersectMin = other.min;
- intersectIncludeMin = other.includeMin;
- } else if (intersectMin == other.min && !other.includeMin) {
- // The edges are the same, but one is exclusive, make it exclusive.
- intersectIncludeMin = false;
- }
-
- if (other.max == null) {
- // Do nothing.
- } else if (intersectMax == null || intersectMax > other.max) {
- intersectMax = other.max;
- intersectIncludeMax = other.includeMax;
- } else if (intersectMax == other.max && !other.includeMax) {
- // The edges are the same, but one is exclusive, make it exclusive.
- intersectIncludeMax = false;
- }
-
- if (intersectMin == null && intersectMax == null) {
- // Open range.
- return new VersionRange();
- }
-
- // If the range is just a single version.
- if (intersectMin == intersectMax) {
- // If both ends are inclusive, allow that version.
- if (intersectIncludeMin && intersectIncludeMax) return intersectMin;
-
- // Otherwise, no versions.
- return VersionConstraint.empty;
- }
-
- if (intersectMin != null && intersectMax != null &&
- intersectMin > intersectMax) {
- // Non-overlapping ranges, so empty.
- return VersionConstraint.empty;
- }
-
- // If we got here, there is an actual range.
- return new VersionRange(min: intersectMin, max: intersectMax,
- includeMin: intersectIncludeMin, includeMax: intersectIncludeMax);
- }
-
- throw new ArgumentError(
- 'Unknown VersionConstraint type $other.');
- }
-
- String toString() {
- var buffer = new StringBuffer();
-
- if (min != null) {
- buffer.write(includeMin ? '>=' : '>');
- buffer.write(min);
- }
-
- if (max != null) {
- if (min != null) buffer.write(' ');
- buffer.write(includeMax ? '<=' : '<');
- buffer.write(max);
- }
-
- if (min == null && max == null) buffer.write('any');
- return buffer.toString();
- }
-}
-
-class _EmptyVersion implements VersionConstraint {
- const _EmptyVersion();
-
- bool get isEmpty => true;
- bool get isAny => false;
- bool allows(Version other) => false;
- VersionConstraint intersect(VersionConstraint other) => this;
- String toString() => '<empty>';
-}
« no previous file with comments | « utils/pub/validator/utf8_readme.dart ('k') | utils/tests/pub/command_line_config.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698