/packages/semver/semver.js
JavaScript | 305 lines | 238 code | 35 blank | 32 comment | 70 complexity | ccd2acf0e9839cb17e9dcec05f6a8f34 MD5 | raw file
- // modified to work in the browser by using underscore.js
- var _ = require('underscore')._;
- // See http://semver.org/
- // This implementation is a *hair* less strict in that it allows
- // v1.2.3 things, and also tags that don't begin with a char.
- var semver = "\\s*[v=]*\\s*([0-9]+)" // major
- + "\\.([0-9]+)" // minor
- + "\\.([0-9]+)" // patch
- + "(-[0-9]+-?)?" // build
- + "([a-zA-Z-][a-zA-Z0-9-\.:]*)?" // tag
- , exprComparator = "^((<|>)?=?)\s*("+semver+")$|^$"
- , xRangePlain = "[v=]*([0-9]+|x|X|\\*)"
- + "(?:\\.([0-9]+|x|X|\\*)"
- + "(?:\\.([0-9]+|x|X|\\*)"
- + "([a-zA-Z-][a-zA-Z0-9-\.:]*)?)?)?"
- , xRange = "((?:<|>)?=?)?\\s*" + xRangePlain
- , exprSpermy = "(?:~>?)"+xRange
- , expressions = exports.expressions =
- { parse : new RegExp("^\\s*"+semver+"\\s*$")
- , parsePackage : new RegExp("^\\s*([^\/]+)[-@](" +semver+")\\s*$")
- , parseRange : new RegExp(
- "^\\s*(" + semver + ")\\s+-\\s+(" + semver + ")\\s*$")
- , validComparator : new RegExp("^"+exprComparator+"$")
- , parseXRange : new RegExp("^"+xRange+"$")
- , parseSpermy : new RegExp("^"+exprSpermy+"$")
- }
- _(expressions).keys().forEach(function (i) {
- exports[i] = function (str) {
- return ("" + (str || "")).match(expressions[i])
- }
- })
- exports.rangeReplace = ">=$1 <=$7"
- exports.clean = clean
- exports.compare = compare
- exports.satisfies = satisfies
- exports.gt = gt
- exports.gte = gte
- exports.lt = lt
- exports.lte = lte
- exports.eq = eq
- exports.neq = neq
- exports.cmp = cmp
- exports.inc = inc
- exports.valid = valid
- exports.validPackage = validPackage
- exports.validRange = validRange
- exports.maxSatisfying = maxSatisfying
- exports.replaceStars = replaceStars
- exports.toComparators = toComparators
- function stringify (version) {
- var v = version
- return [v[1]||'', v[2]||'', v[3]||''].join(".") + (v[4]||'') + (v[5]||'')
- }
- function clean (version) {
- version = exports.parse(version)
- if (!version) return version
- return stringify(version)
- }
- function valid (version) {
- if (typeof version !== "string") return null
- return exports.parse(version) && version.trim().replace(/^[v=]+/, '')
- }
- function validPackage (version) {
- if (typeof version !== "string") return null
- return version.match(expressions.parsePackage) && version.trim()
- }
- // range can be one of:
- // "1.0.3 - 2.0.0" range, inclusive, like ">=1.0.3 <=2.0.0"
- // ">1.0.2" like 1.0.3 - 9999.9999.9999
- // ">=1.0.2" like 1.0.2 - 9999.9999.9999
- // "<2.0.0" like 0.0.0 - 1.9999.9999
- // ">1.0.2 <2.0.0" like 1.0.3 - 1.9999.9999
- var starExpression = /(<|>)?=?\s*\*/g
- , starReplace = ""
- , compTrimExpression = new RegExp("((<|>)?=?)\\s*("
- +semver+"|"+xRangePlain+")", "g")
- , compTrimReplace = "$1$3"
- function toComparators (range) {
- var ret = _(
- (range || "").trim()
- .replace(expressions.parseRange, exports.rangeReplace)
- .replace(compTrimExpression, compTrimReplace)
- .split(/\s+/)
- .join(" ")
- .split("||")
- )
- .map(function (orchunk) {
- return _(orchunk.split(" "))
- .map(replaceXRanges)
- .map(replaceSpermies)
- .map(replaceStars)
- .join(" ").trim()
- })
- .map(function (orchunk) {
- return _(orchunk.trim().split(/\s+/))
- .filter(function (c) { return c.match(expressions.validComparator) })
- })
- .filter(function (c) { return c.length })
- return ret
- }
- function replaceStars (stars) {
- return stars.trim().replace(starExpression, starReplace)
- }
- // "2.x","2.x.x" --> ">=2.0.0- <2.1.0-"
- // "2.3.x" --> ">=2.3.0- <2.4.0-"
- function replaceXRanges (ranges) {
- return _(ranges.split(/\s+/))
- .map(replaceXRange)
- .join(" ")
- }
- function replaceXRange (version) {
- return version.trim().replace(expressions.parseXRange,
- function (v, gtlt, M, m, p, t) {
- var anyX = !M || M.toLowerCase() === "x" || M === "*"
- || !m || m.toLowerCase() === "x" || m === "*"
- || !p || p.toLowerCase() === "x" || p === "*"
- , ret = v
- if (gtlt && anyX) {
- // just replace x'es with zeroes
- ;(!M || M === "*" || M.toLowerCase() === "x") && (M = 0)
- ;(!m || m === "*" || m.toLowerCase() === "x") && (m = 0)
- ;(!p || p === "*" || p.toLowerCase() === "x") && (p = 0)
- ret = gtlt + M+"."+m+"."+p+"-"
- } else if (!M || M === "*" || M.toLowerCase() === "x") {
- ret = "*" // allow any
- } else if (!m || m === "*" || m.toLowerCase() === "x") {
- // append "-" onto the version, otherwise
- // "1.x.x" matches "2.0.0beta", since the tag
- // *lowers* the version value
- ret = ">="+M+".0.0- <"+(+M+1)+".0.0-"
- } else if (!p || p === "*" || p.toLowerCase() === "x") {
- ret = ">="+M+"."+m+".0- <"+M+"."+(+m+1)+".0-"
- }
- //console.error("parseXRange", [].slice.call(arguments), ret)
- return ret
- })
- }
- // ~, ~> --> * (any, kinda silly)
- // ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0
- // ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0
- // ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0
- // ~1.2.3, ~>1.2.3 --> >=1.2.3 <1.3.0
- // ~1.2.0, ~>1.2.0 --> >=1.2.0 <1.3.0
- function replaceSpermies (version) {
- return version.trim().replace(expressions.parseSpermy,
- function (v, gtlt, M, m, p, t) {
- if (gtlt) throw new Error(
- "Using '"+gtlt+"' with ~ makes no sense. Don't do it.")
- if (!M || M.toLowerCase() === "x") {
- return ""
- }
- // ~1 == >=1.0.0- <2.0.0-
- if (!m || m.toLowerCase() === "x") {
- return ">="+M+".0.0- <"+(+M+1)+".0.0-"
- }
- // ~1.2 == >=1.2.0- <1.3.0-
- if (!p || p.toLowerCase() === "x") {
- return ">="+M+"."+m+".0- <"+M+"."+(+m+1)+".0-"
- }
- // ~1.2.3 == >=1.2.3- <1.3.0-
- t = t || "-"
- return ">="+M+"."+m+"."+p+t+" <"+M+"."+(+m+1)+".0-"
- })
- }
- function validRange (range) {
- range = replaceStars(range)
- var c = toComparators(range)
- return (c.length === 0)
- ? null
- : _(c).map(function (c) { return c.join(" ") }).join("||")
- }
- // returns the highest satisfying version in the list, or undefined
- function maxSatisfying (versions, range) {
- return _(versions)
- .filter(function (v) { return satisfies(v, range) })
- .sort(compare)
- .pop()
- }
- function satisfies (version, range) {
- version = valid(version)
- if (!version) return false
- range = toComparators(range)
- for (var i = 0, l = range.length ; i < l ; i ++) {
- var ok = false
- for (var j = 0, ll = range[i].length ; j < ll ; j ++) {
- var r = range[i][j]
- , gtlt = r.charAt(0) === ">" ? gt
- : r.charAt(0) === "<" ? lt
- : false
- , eq = r.charAt(!!gtlt) === "="
- , sub = (!!eq) + (!!gtlt)
- if (!gtlt) eq = true
- r = r.substr(sub)
- r = (r === "") ? r : valid(r)
- ok = (r === "") || (eq && r === version) || (gtlt && gtlt(version, r))
- if (!ok) break
- }
- if (ok) return true
- }
- return false
- }
- // return v1 > v2 ? 1 : -1
- function compare (v1, v2) {
- var g = gt(v1, v2)
- return g === null ? 0 : g ? 1 : -1
- }
- function rcompare (v1, v2) {
- return compare(v2, v1)
- }
- function lt (v1, v2) { return gt(v2, v1) }
- function gte (v1, v2) { return !lt(v1, v2) }
- function lte (v1, v2) { return !gt(v1, v2) }
- function eq (v1, v2) { return gt(v1, v2) === null }
- function neq (v1, v2) { return gt(v1, v2) !== null }
- function cmp (v1, c, v2) {
- switch (c) {
- case ">": return gt(v1, v2)
- case "<": return lt(v1, v2)
- case ">=": return gte(v1, v2)
- case "<=": return lte(v1, v2)
- case "==": return eq(v1, v2)
- case "!=": return neq(v1, v2)
- case "===": return v1 === v2
- case "!==": return v1 !== v2
- default: throw new Error("Y U NO USE VALID COMPARATOR!? "+c)
- }
- }
- // return v1 > v2
- function num (v) {
- return v === undefined ? -1 : parseInt((v||"0").replace(/[^0-9]+/g, ''), 10)
- }
- function gt (v1, v2) {
- v1 = exports.parse(v1)
- v2 = exports.parse(v2)
- if (!v1 || !v2) return false
- for (var i = 1; i < 5; i ++) {
- v1[i] = num(v1[i])
- v2[i] = num(v2[i])
- if (v1[i] > v2[i]) return true
- else if (v1[i] !== v2[i]) return false
- }
- // no tag is > than any tag, or use lexicographical order.
- var tag1 = v1[5] || ""
- , tag2 = v2[5] || ""
- // kludge: null means they were equal. falsey, and detectable.
- // embarrassingly overclever, though, I know.
- return tag1 === tag2 ? null
- : !tag1 ? true
- : !tag2 ? false
- : tag1 > tag2
- }
- function inc (version, release) {
- version = exports.parse(version)
- if (!version) return null
- var parsedIndexLookup =
- { 'major': 1
- , 'minor': 2
- , 'patch': 3
- , 'build': 4 }
- var incIndex = parsedIndexLookup[release]
- if (incIndex === undefined) return null
- var current = num(version[incIndex])
- version[incIndex] = current === -1 ? 1 : current + 1
- for (var i = incIndex + 1; i < 5; i ++) {
- if (num(version[i]) !== -1) version[i] = "0"
- }
- if (version[4]) version[4] = "-" + version[4]
- version[5] = ""
- return stringify(version)
- }