diff options
| author | bors <bors@rust-lang.org> | 2014-02-03 15:11:44 -0800 |
|---|---|---|
| committer | bors <bors@rust-lang.org> | 2014-02-03 15:11:44 -0800 |
| commit | fde11e7ae5b9b67dfdf23862f60f4ee4dae4910f (patch) | |
| tree | 72bd687dcfe75e5258146baee470be6ee0ed95f7 /src/libextra | |
| parent | d42521aa92006a3378c535adec80ae2257bff083 (diff) | |
| parent | fdb820a1be9d28220a2e509b1f29e5381516c9ee (diff) | |
| download | rust-fde11e7ae5b9b67dfdf23862f60f4ee4dae4910f.tar.gz rust-fde11e7ae5b9b67dfdf23862f60f4ee4dae4910f.zip | |
auto merge of #12012 : omasanori/rust/semver, r=alexcrichton
Done as a part of #8784.
Diffstat (limited to 'src/libextra')
| -rw-r--r-- | src/libextra/lib.rs | 1 | ||||
| -rw-r--r-- | src/libextra/semver.rs | 423 |
2 files changed, 0 insertions, 424 deletions
diff --git a/src/libextra/lib.rs b/src/libextra/lib.rs index 358dca5e5ac..2c417026065 100644 --- a/src/libextra/lib.rs +++ b/src/libextra/lib.rs @@ -83,7 +83,6 @@ pub mod rational; #[path="num/complex.rs"] pub mod complex; pub mod stats; -pub mod semver; pub mod hex; pub mod uuid; diff --git a/src/libextra/semver.rs b/src/libextra/semver.rs deleted file mode 100644 index 0faf4ee664e..00000000000 --- a/src/libextra/semver.rs +++ /dev/null @@ -1,423 +0,0 @@ -// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT -// file at the top-level directory of this distribution and at -// http://rust-lang.org/COPYRIGHT. -// -// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or -// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license -// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your -// option. This file may not be copied, modified, or distributed -// except according to those terms. - -//! Semantic version parsing and comparison. -//! -//! Semantic versioning (see http://semver.org/) is a set of rules for -//! assigning version numbers intended to convey meaning about what has -//! changed, and how much. A version number has five parts: -//! -//! * Major number, updated for incompatible API changes -//! * Minor number, updated for backwards-compatible API additions -//! * Patch number, updated for backwards-compatible bugfixes -//! * Pre-release information (optional), preceded by a hyphen (`-`) -//! * Build metadata (optional), preceded by a plus sign (`+`) -//! -//! The three mandatory components are required to be decimal numbers. The -//! pre-release information and build metadata are required to be a -//! period-separated list of identifiers containing only alphanumeric -//! characters and hyphens. -//! -//! An example version number with all five components is -//! `0.8.1-rc.3.0+20130922.linux`. - -use std::char; -use std::cmp; -use std::option::{Option, Some, None}; -use std::to_str::ToStr; - -/// An identifier in the pre-release or build metadata. If the identifier can -/// be parsed as a decimal value, it will be represented with `Numeric`. -#[deriving(Clone, Eq)] -#[allow(missing_doc)] -pub enum Identifier { - Numeric(uint), - AlphaNumeric(~str) -} - -impl cmp::Ord for Identifier { - #[inline] - fn lt(&self, other: &Identifier) -> bool { - match (self, other) { - (&Numeric(a), &Numeric(b)) => a < b, - (&Numeric(_), _) => true, - (&AlphaNumeric(ref a), &AlphaNumeric(ref b)) => *a < *b, - (&AlphaNumeric(_), _) => false - } - } -} - -impl ToStr for Identifier { - #[inline] - fn to_str(&self) -> ~str { - match self { - &Numeric(n) => n.to_str(), - &AlphaNumeric(ref s) => s.to_str() - } - } -} - - -/// Represents a version number conforming to the semantic versioning scheme. -#[deriving(Clone, Eq)] -pub struct Version { - /// The major version, to be incremented on incompatible changes. - priv major: uint, - /// The minor version, to be incremented when functionality is added in a - /// backwards-compatible manner. - priv minor: uint, - /// The patch version, to be incremented when backwards-compatible bug - /// fixes are made. - priv patch: uint, - /// The pre-release version identifier, if one exists. - priv pre: ~[Identifier], - /// The build metadata, ignored when determining version precedence. - priv build: ~[Identifier], -} - -impl ToStr for Version { - #[inline] - fn to_str(&self) -> ~str { - let s = format!("{}.{}.{}", self.major, self.minor, self.patch); - let s = if self.pre.is_empty() { - s - } else { - format!("{}-{}", s, self.pre.map(|i| i.to_str()).connect(".")) - }; - if self.build.is_empty() { - s - } else { - format!("{}+{}", s, self.build.map(|i| i.to_str()).connect(".")) - } - } -} - -impl cmp::Ord for Version { - #[inline] - fn lt(&self, other: &Version) -> bool { - - self.major < other.major || - - (self.major == other.major && - self.minor < other.minor) || - - (self.major == other.major && - self.minor == other.minor && - self.patch < other.patch) || - - (self.major == other.major && - self.minor == other.minor && - self.patch == other.patch && - // NB: semver spec says 0.0.0-pre < 0.0.0 - // but the version of ord defined for vec - // says that [] < [pre], so we alter it - // here. - (match (self.pre.len(), other.pre.len()) { - (0, 0) => false, - (0, _) => false, - (_, 0) => true, - (_, _) => self.pre < other.pre - })) - } - - #[inline] - fn le(&self, other: &Version) -> bool { - ! (other < self) - } - #[inline] - fn gt(&self, other: &Version) -> bool { - other < self - } - #[inline] - fn ge(&self, other: &Version) -> bool { - ! (self < other) - } -} - -fn take_nonempty_prefix<T:Iterator<char>>(rdr: &mut T, pred: |char| -> bool) - -> (~str, Option<char>) { - let mut buf = ~""; - let mut ch = rdr.next(); - loop { - match ch { - None => break, - Some(c) if !pred(c) => break, - Some(c) => { - buf.push_char(c); - ch = rdr.next(); - } - } - } - debug!("extracted nonempty prefix: {}", buf); - (buf, ch) -} - -fn take_num<T: Iterator<char>>(rdr: &mut T) -> Option<(uint, Option<char>)> { - let (s, ch) = take_nonempty_prefix(rdr, char::is_digit); - match from_str::<uint>(s) { - None => None, - Some(i) => Some((i, ch)) - } -} - -fn take_ident<T: Iterator<char>>(rdr: &mut T) -> Option<(Identifier, Option<char>)> { - let (s,ch) = take_nonempty_prefix(rdr, char::is_alphanumeric); - if s.chars().all(char::is_digit) { - match from_str::<uint>(s) { - None => None, - Some(i) => Some((Numeric(i), ch)) - } - } else { - Some((AlphaNumeric(s), ch)) - } -} - -fn expect(ch: Option<char>, c: char) -> Option<()> { - if ch != Some(c) { - None - } else { - Some(()) - } -} - -fn parse_iter<T: Iterator<char>>(rdr: &mut T) -> Option<Version> { - let maybe_vers = take_num(rdr).and_then(|(major, ch)| { - expect(ch, '.').and_then(|_| Some(major)) - }).and_then(|major| { - take_num(rdr).and_then(|(minor, ch)| { - expect(ch, '.').and_then(|_| Some((major, minor))) - }) - }).and_then(|(major, minor)| { - take_num(rdr).and_then(|(patch, ch)| { - Some((major, minor, patch, ch)) - }) - }); - - let (major, minor, patch, ch) = match maybe_vers { - Some((a, b, c, d)) => (a, b, c, d), - None => return None - }; - - let mut pre = ~[]; - let mut build = ~[]; - - let mut ch = ch; - if ch == Some('-') { - loop { - let (id, c) = match take_ident(rdr) { - Some((id, c)) => (id, c), - None => return None - }; - pre.push(id); - ch = c; - if ch != Some('.') { break; } - } - } - - if ch == Some('+') { - loop { - let (id, c) = match take_ident(rdr) { - Some((id, c)) => (id, c), - None => return None - }; - build.push(id); - ch = c; - if ch != Some('.') { break; } - } - } - - Some(Version { - major: major, - minor: minor, - patch: patch, - pre: pre, - build: build, - }) -} - - -/// Parse a string into a semver object. -pub fn parse(s: &str) -> Option<Version> { - if !s.is_ascii() { - return None; - } - let s = s.trim(); - let v = parse_iter(&mut s.chars()); - match v { - Some(v) => { - if v.to_str().equiv(&s) { - Some(v) - } else { - None - } - } - None => None - } -} - -#[test] -fn test_parse() { - assert_eq!(parse(""), None); - assert_eq!(parse(" "), None); - assert_eq!(parse("1"), None); - assert_eq!(parse("1.2"), None); - assert_eq!(parse("1.2"), None); - assert_eq!(parse("1"), None); - assert_eq!(parse("1.2"), None); - assert_eq!(parse("1.2.3-"), None); - assert_eq!(parse("a.b.c"), None); - assert_eq!(parse("1.2.3 abc"), None); - - assert!(parse("1.2.3") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[], - build: ~[], - })); - assert!(parse(" 1.2.3 ") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[], - build: ~[], - })); - assert!(parse("1.2.3-alpha1") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[AlphaNumeric(~"alpha1")], - build: ~[] - })); - assert!(parse(" 1.2.3-alpha1 ") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[AlphaNumeric(~"alpha1")], - build: ~[] - })); - assert!(parse("1.2.3+build5") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[], - build: ~[AlphaNumeric(~"build5")] - })); - assert!(parse(" 1.2.3+build5 ") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[], - build: ~[AlphaNumeric(~"build5")] - })); - assert!(parse("1.2.3-alpha1+build5") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[AlphaNumeric(~"alpha1")], - build: ~[AlphaNumeric(~"build5")] - })); - assert!(parse(" 1.2.3-alpha1+build5 ") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[AlphaNumeric(~"alpha1")], - build: ~[AlphaNumeric(~"build5")] - })); - assert!(parse("1.2.3-1.alpha1.9+build5.7.3aedf ") == Some(Version { - major: 1u, - minor: 2u, - patch: 3u, - pre: ~[Numeric(1),AlphaNumeric(~"alpha1"),Numeric(9)], - build: ~[AlphaNumeric(~"build5"), - Numeric(7), - AlphaNumeric(~"3aedf")] - })); - -} - -#[test] -fn test_eq() { - assert_eq!(parse("1.2.3"), parse("1.2.3")); - assert_eq!(parse("1.2.3-alpha1"), parse("1.2.3-alpha1")); - assert_eq!(parse("1.2.3+build.42"), parse("1.2.3+build.42")); - assert_eq!(parse("1.2.3-alpha1+42"), parse("1.2.3-alpha1+42")); -} - -#[test] -fn test_ne() { - assert!(parse("0.0.0") != parse("0.0.1")); - assert!(parse("0.0.0") != parse("0.1.0")); - assert!(parse("0.0.0") != parse("1.0.0")); - assert!(parse("1.2.3-alpha") != parse("1.2.3-beta")); - assert!(parse("1.2.3+23") != parse("1.2.3+42")); -} - -#[test] -fn test_lt() { - assert!(parse("0.0.0") < parse("1.2.3-alpha2")); - assert!(parse("1.0.0") < parse("1.2.3-alpha2")); - assert!(parse("1.2.0") < parse("1.2.3-alpha2")); - assert!(parse("1.2.3-alpha1") < parse("1.2.3")); - assert!(parse("1.2.3-alpha1") < parse("1.2.3-alpha2")); - assert!(!(parse("1.2.3-alpha2") < parse("1.2.3-alpha2"))); - assert!(!(parse("1.2.3+23") < parse("1.2.3+42"))); -} - -#[test] -fn test_le() { - assert!(parse("0.0.0") <= parse("1.2.3-alpha2")); - assert!(parse("1.0.0") <= parse("1.2.3-alpha2")); - assert!(parse("1.2.0") <= parse("1.2.3-alpha2")); - assert!(parse("1.2.3-alpha1") <= parse("1.2.3-alpha2")); - assert!(parse("1.2.3-alpha2") <= parse("1.2.3-alpha2")); - assert!(parse("1.2.3+23") <= parse("1.2.3+42")); -} - -#[test] -fn test_gt() { - assert!(parse("1.2.3-alpha2") > parse("0.0.0")); - assert!(parse("1.2.3-alpha2") > parse("1.0.0")); - assert!(parse("1.2.3-alpha2") > parse("1.2.0")); - assert!(parse("1.2.3-alpha2") > parse("1.2.3-alpha1")); - assert!(parse("1.2.3") > parse("1.2.3-alpha2")); - assert!(!(parse("1.2.3-alpha2") > parse("1.2.3-alpha2"))); - assert!(!(parse("1.2.3+23") > parse("1.2.3+42"))); -} - -#[test] -fn test_ge() { - assert!(parse("1.2.3-alpha2") >= parse("0.0.0")); - assert!(parse("1.2.3-alpha2") >= parse("1.0.0")); - assert!(parse("1.2.3-alpha2") >= parse("1.2.0")); - assert!(parse("1.2.3-alpha2") >= parse("1.2.3-alpha1")); - assert!(parse("1.2.3-alpha2") >= parse("1.2.3-alpha2")); - assert!(parse("1.2.3+23") >= parse("1.2.3+42")); -} - -#[test] -fn test_spec_order() { - - let vs = ["1.0.0-alpha", - "1.0.0-alpha.1", - "1.0.0-alpha.beta", - "1.0.0-beta", - "1.0.0-beta.2", - "1.0.0-beta.11", - "1.0.0-rc.1", - "1.0.0"]; - let mut i = 1; - while i < vs.len() { - let a = parse(vs[i-1]).unwrap(); - let b = parse(vs[i]).unwrap(); - assert!(a < b); - i += 1; - } -} |
