mirror of https://github.com/lukechilds/node.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
303 lines
8.8 KiB
303 lines
8.8 KiB
|
|
// 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+"$")
|
|
}
|
|
|
|
|
|
Object.getOwnPropertyNames(expressions).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)
|
|
}
|
|
|
|
|