[d565449] | 1 | exports = module.exports = SemVer
|
---|
| 2 |
|
---|
| 3 | var debug
|
---|
| 4 | /* istanbul ignore next */
|
---|
| 5 | if (typeof process === 'object' &&
|
---|
| 6 | process.env &&
|
---|
| 7 | process.env.NODE_DEBUG &&
|
---|
| 8 | /\bsemver\b/i.test(process.env.NODE_DEBUG)) {
|
---|
| 9 | debug = function () {
|
---|
| 10 | var args = Array.prototype.slice.call(arguments, 0)
|
---|
| 11 | args.unshift('SEMVER')
|
---|
| 12 | console.log.apply(console, args)
|
---|
| 13 | }
|
---|
| 14 | } else {
|
---|
| 15 | debug = function () {}
|
---|
| 16 | }
|
---|
| 17 |
|
---|
| 18 | // Note: this is the semver.org version of the spec that it implements
|
---|
| 19 | // Not necessarily the package version of this code.
|
---|
| 20 | exports.SEMVER_SPEC_VERSION = '2.0.0'
|
---|
| 21 |
|
---|
| 22 | var MAX_LENGTH = 256
|
---|
| 23 | var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER ||
|
---|
| 24 | /* istanbul ignore next */ 9007199254740991
|
---|
| 25 |
|
---|
| 26 | // Max safe segment length for coercion.
|
---|
| 27 | var MAX_SAFE_COMPONENT_LENGTH = 16
|
---|
| 28 |
|
---|
| 29 | var MAX_SAFE_BUILD_LENGTH = MAX_LENGTH - 6
|
---|
| 30 |
|
---|
| 31 | // The actual regexps go on exports.re
|
---|
| 32 | var re = exports.re = []
|
---|
| 33 | var safeRe = exports.safeRe = []
|
---|
| 34 | var src = exports.src = []
|
---|
| 35 | var t = exports.tokens = {}
|
---|
| 36 | var R = 0
|
---|
| 37 |
|
---|
| 38 | function tok (n) {
|
---|
| 39 | t[n] = R++
|
---|
| 40 | }
|
---|
| 41 |
|
---|
| 42 | var LETTERDASHNUMBER = '[a-zA-Z0-9-]'
|
---|
| 43 |
|
---|
| 44 | // Replace some greedy regex tokens to prevent regex dos issues. These regex are
|
---|
| 45 | // used internally via the safeRe object since all inputs in this library get
|
---|
| 46 | // normalized first to trim and collapse all extra whitespace. The original
|
---|
| 47 | // regexes are exported for userland consumption and lower level usage. A
|
---|
| 48 | // future breaking change could export the safer regex only with a note that
|
---|
| 49 | // all input should have extra whitespace removed.
|
---|
| 50 | var safeRegexReplacements = [
|
---|
| 51 | ['\\s', 1],
|
---|
| 52 | ['\\d', MAX_LENGTH],
|
---|
| 53 | [LETTERDASHNUMBER, MAX_SAFE_BUILD_LENGTH],
|
---|
| 54 | ]
|
---|
| 55 |
|
---|
| 56 | function makeSafeRe (value) {
|
---|
| 57 | for (var i = 0; i < safeRegexReplacements.length; i++) {
|
---|
| 58 | var token = safeRegexReplacements[i][0]
|
---|
| 59 | var max = safeRegexReplacements[i][1]
|
---|
| 60 | value = value
|
---|
| 61 | .split(token + '*').join(token + '{0,' + max + '}')
|
---|
| 62 | .split(token + '+').join(token + '{1,' + max + '}')
|
---|
| 63 | }
|
---|
| 64 | return value
|
---|
| 65 | }
|
---|
| 66 |
|
---|
| 67 | // The following Regular Expressions can be used for tokenizing,
|
---|
| 68 | // validating, and parsing SemVer version strings.
|
---|
| 69 |
|
---|
| 70 | // ## Numeric Identifier
|
---|
| 71 | // A single `0`, or a non-zero digit followed by zero or more digits.
|
---|
| 72 |
|
---|
| 73 | tok('NUMERICIDENTIFIER')
|
---|
| 74 | src[t.NUMERICIDENTIFIER] = '0|[1-9]\\d*'
|
---|
| 75 | tok('NUMERICIDENTIFIERLOOSE')
|
---|
| 76 | src[t.NUMERICIDENTIFIERLOOSE] = '\\d+'
|
---|
| 77 |
|
---|
| 78 | // ## Non-numeric Identifier
|
---|
| 79 | // Zero or more digits, followed by a letter or hyphen, and then zero or
|
---|
| 80 | // more letters, digits, or hyphens.
|
---|
| 81 |
|
---|
| 82 | tok('NONNUMERICIDENTIFIER')
|
---|
| 83 | src[t.NONNUMERICIDENTIFIER] = '\\d*[a-zA-Z-]' + LETTERDASHNUMBER + '*'
|
---|
| 84 |
|
---|
| 85 | // ## Main Version
|
---|
| 86 | // Three dot-separated numeric identifiers.
|
---|
| 87 |
|
---|
| 88 | tok('MAINVERSION')
|
---|
| 89 | src[t.MAINVERSION] = '(' + src[t.NUMERICIDENTIFIER] + ')\\.' +
|
---|
| 90 | '(' + src[t.NUMERICIDENTIFIER] + ')\\.' +
|
---|
| 91 | '(' + src[t.NUMERICIDENTIFIER] + ')'
|
---|
| 92 |
|
---|
| 93 | tok('MAINVERSIONLOOSE')
|
---|
| 94 | src[t.MAINVERSIONLOOSE] = '(' + src[t.NUMERICIDENTIFIERLOOSE] + ')\\.' +
|
---|
| 95 | '(' + src[t.NUMERICIDENTIFIERLOOSE] + ')\\.' +
|
---|
| 96 | '(' + src[t.NUMERICIDENTIFIERLOOSE] + ')'
|
---|
| 97 |
|
---|
| 98 | // ## Pre-release Version Identifier
|
---|
| 99 | // A numeric identifier, or a non-numeric identifier.
|
---|
| 100 |
|
---|
| 101 | tok('PRERELEASEIDENTIFIER')
|
---|
| 102 | src[t.PRERELEASEIDENTIFIER] = '(?:' + src[t.NUMERICIDENTIFIER] +
|
---|
| 103 | '|' + src[t.NONNUMERICIDENTIFIER] + ')'
|
---|
| 104 |
|
---|
| 105 | tok('PRERELEASEIDENTIFIERLOOSE')
|
---|
| 106 | src[t.PRERELEASEIDENTIFIERLOOSE] = '(?:' + src[t.NUMERICIDENTIFIERLOOSE] +
|
---|
| 107 | '|' + src[t.NONNUMERICIDENTIFIER] + ')'
|
---|
| 108 |
|
---|
| 109 | // ## Pre-release Version
|
---|
| 110 | // Hyphen, followed by one or more dot-separated pre-release version
|
---|
| 111 | // identifiers.
|
---|
| 112 |
|
---|
| 113 | tok('PRERELEASE')
|
---|
| 114 | src[t.PRERELEASE] = '(?:-(' + src[t.PRERELEASEIDENTIFIER] +
|
---|
| 115 | '(?:\\.' + src[t.PRERELEASEIDENTIFIER] + ')*))'
|
---|
| 116 |
|
---|
| 117 | tok('PRERELEASELOOSE')
|
---|
| 118 | src[t.PRERELEASELOOSE] = '(?:-?(' + src[t.PRERELEASEIDENTIFIERLOOSE] +
|
---|
| 119 | '(?:\\.' + src[t.PRERELEASEIDENTIFIERLOOSE] + ')*))'
|
---|
| 120 |
|
---|
| 121 | // ## Build Metadata Identifier
|
---|
| 122 | // Any combination of digits, letters, or hyphens.
|
---|
| 123 |
|
---|
| 124 | tok('BUILDIDENTIFIER')
|
---|
| 125 | src[t.BUILDIDENTIFIER] = LETTERDASHNUMBER + '+'
|
---|
| 126 |
|
---|
| 127 | // ## Build Metadata
|
---|
| 128 | // Plus sign, followed by one or more period-separated build metadata
|
---|
| 129 | // identifiers.
|
---|
| 130 |
|
---|
| 131 | tok('BUILD')
|
---|
| 132 | src[t.BUILD] = '(?:\\+(' + src[t.BUILDIDENTIFIER] +
|
---|
| 133 | '(?:\\.' + src[t.BUILDIDENTIFIER] + ')*))'
|
---|
| 134 |
|
---|
| 135 | // ## Full Version String
|
---|
| 136 | // A main version, followed optionally by a pre-release version and
|
---|
| 137 | // build metadata.
|
---|
| 138 |
|
---|
| 139 | // Note that the only major, minor, patch, and pre-release sections of
|
---|
| 140 | // the version string are capturing groups. The build metadata is not a
|
---|
| 141 | // capturing group, because it should not ever be used in version
|
---|
| 142 | // comparison.
|
---|
| 143 |
|
---|
| 144 | tok('FULL')
|
---|
| 145 | tok('FULLPLAIN')
|
---|
| 146 | src[t.FULLPLAIN] = 'v?' + src[t.MAINVERSION] +
|
---|
| 147 | src[t.PRERELEASE] + '?' +
|
---|
| 148 | src[t.BUILD] + '?'
|
---|
| 149 |
|
---|
| 150 | src[t.FULL] = '^' + src[t.FULLPLAIN] + '$'
|
---|
| 151 |
|
---|
| 152 | // like full, but allows v1.2.3 and =1.2.3, which people do sometimes.
|
---|
| 153 | // also, 1.0.0alpha1 (prerelease without the hyphen) which is pretty
|
---|
| 154 | // common in the npm registry.
|
---|
| 155 | tok('LOOSEPLAIN')
|
---|
| 156 | src[t.LOOSEPLAIN] = '[v=\\s]*' + src[t.MAINVERSIONLOOSE] +
|
---|
| 157 | src[t.PRERELEASELOOSE] + '?' +
|
---|
| 158 | src[t.BUILD] + '?'
|
---|
| 159 |
|
---|
| 160 | tok('LOOSE')
|
---|
| 161 | src[t.LOOSE] = '^' + src[t.LOOSEPLAIN] + '$'
|
---|
| 162 |
|
---|
| 163 | tok('GTLT')
|
---|
| 164 | src[t.GTLT] = '((?:<|>)?=?)'
|
---|
| 165 |
|
---|
| 166 | // Something like "2.*" or "1.2.x".
|
---|
| 167 | // Note that "x.x" is a valid xRange identifer, meaning "any version"
|
---|
| 168 | // Only the first item is strictly required.
|
---|
| 169 | tok('XRANGEIDENTIFIERLOOSE')
|
---|
| 170 | src[t.XRANGEIDENTIFIERLOOSE] = src[t.NUMERICIDENTIFIERLOOSE] + '|x|X|\\*'
|
---|
| 171 | tok('XRANGEIDENTIFIER')
|
---|
| 172 | src[t.XRANGEIDENTIFIER] = src[t.NUMERICIDENTIFIER] + '|x|X|\\*'
|
---|
| 173 |
|
---|
| 174 | tok('XRANGEPLAIN')
|
---|
| 175 | src[t.XRANGEPLAIN] = '[v=\\s]*(' + src[t.XRANGEIDENTIFIER] + ')' +
|
---|
| 176 | '(?:\\.(' + src[t.XRANGEIDENTIFIER] + ')' +
|
---|
| 177 | '(?:\\.(' + src[t.XRANGEIDENTIFIER] + ')' +
|
---|
| 178 | '(?:' + src[t.PRERELEASE] + ')?' +
|
---|
| 179 | src[t.BUILD] + '?' +
|
---|
| 180 | ')?)?'
|
---|
| 181 |
|
---|
| 182 | tok('XRANGEPLAINLOOSE')
|
---|
| 183 | src[t.XRANGEPLAINLOOSE] = '[v=\\s]*(' + src[t.XRANGEIDENTIFIERLOOSE] + ')' +
|
---|
| 184 | '(?:\\.(' + src[t.XRANGEIDENTIFIERLOOSE] + ')' +
|
---|
| 185 | '(?:\\.(' + src[t.XRANGEIDENTIFIERLOOSE] + ')' +
|
---|
| 186 | '(?:' + src[t.PRERELEASELOOSE] + ')?' +
|
---|
| 187 | src[t.BUILD] + '?' +
|
---|
| 188 | ')?)?'
|
---|
| 189 |
|
---|
| 190 | tok('XRANGE')
|
---|
| 191 | src[t.XRANGE] = '^' + src[t.GTLT] + '\\s*' + src[t.XRANGEPLAIN] + '$'
|
---|
| 192 | tok('XRANGELOOSE')
|
---|
| 193 | src[t.XRANGELOOSE] = '^' + src[t.GTLT] + '\\s*' + src[t.XRANGEPLAINLOOSE] + '$'
|
---|
| 194 |
|
---|
| 195 | // Coercion.
|
---|
| 196 | // Extract anything that could conceivably be a part of a valid semver
|
---|
| 197 | tok('COERCE')
|
---|
| 198 | src[t.COERCE] = '(^|[^\\d])' +
|
---|
| 199 | '(\\d{1,' + MAX_SAFE_COMPONENT_LENGTH + '})' +
|
---|
| 200 | '(?:\\.(\\d{1,' + MAX_SAFE_COMPONENT_LENGTH + '}))?' +
|
---|
| 201 | '(?:\\.(\\d{1,' + MAX_SAFE_COMPONENT_LENGTH + '}))?' +
|
---|
| 202 | '(?:$|[^\\d])'
|
---|
| 203 | tok('COERCERTL')
|
---|
| 204 | re[t.COERCERTL] = new RegExp(src[t.COERCE], 'g')
|
---|
| 205 | safeRe[t.COERCERTL] = new RegExp(makeSafeRe(src[t.COERCE]), 'g')
|
---|
| 206 |
|
---|
| 207 | // Tilde ranges.
|
---|
| 208 | // Meaning is "reasonably at or greater than"
|
---|
| 209 | tok('LONETILDE')
|
---|
| 210 | src[t.LONETILDE] = '(?:~>?)'
|
---|
| 211 |
|
---|
| 212 | tok('TILDETRIM')
|
---|
| 213 | src[t.TILDETRIM] = '(\\s*)' + src[t.LONETILDE] + '\\s+'
|
---|
| 214 | re[t.TILDETRIM] = new RegExp(src[t.TILDETRIM], 'g')
|
---|
| 215 | safeRe[t.TILDETRIM] = new RegExp(makeSafeRe(src[t.TILDETRIM]), 'g')
|
---|
| 216 | var tildeTrimReplace = '$1~'
|
---|
| 217 |
|
---|
| 218 | tok('TILDE')
|
---|
| 219 | src[t.TILDE] = '^' + src[t.LONETILDE] + src[t.XRANGEPLAIN] + '$'
|
---|
| 220 | tok('TILDELOOSE')
|
---|
| 221 | src[t.TILDELOOSE] = '^' + src[t.LONETILDE] + src[t.XRANGEPLAINLOOSE] + '$'
|
---|
| 222 |
|
---|
| 223 | // Caret ranges.
|
---|
| 224 | // Meaning is "at least and backwards compatible with"
|
---|
| 225 | tok('LONECARET')
|
---|
| 226 | src[t.LONECARET] = '(?:\\^)'
|
---|
| 227 |
|
---|
| 228 | tok('CARETTRIM')
|
---|
| 229 | src[t.CARETTRIM] = '(\\s*)' + src[t.LONECARET] + '\\s+'
|
---|
| 230 | re[t.CARETTRIM] = new RegExp(src[t.CARETTRIM], 'g')
|
---|
| 231 | safeRe[t.CARETTRIM] = new RegExp(makeSafeRe(src[t.CARETTRIM]), 'g')
|
---|
| 232 | var caretTrimReplace = '$1^'
|
---|
| 233 |
|
---|
| 234 | tok('CARET')
|
---|
| 235 | src[t.CARET] = '^' + src[t.LONECARET] + src[t.XRANGEPLAIN] + '$'
|
---|
| 236 | tok('CARETLOOSE')
|
---|
| 237 | src[t.CARETLOOSE] = '^' + src[t.LONECARET] + src[t.XRANGEPLAINLOOSE] + '$'
|
---|
| 238 |
|
---|
| 239 | // A simple gt/lt/eq thing, or just "" to indicate "any version"
|
---|
| 240 | tok('COMPARATORLOOSE')
|
---|
| 241 | src[t.COMPARATORLOOSE] = '^' + src[t.GTLT] + '\\s*(' + src[t.LOOSEPLAIN] + ')$|^$'
|
---|
| 242 | tok('COMPARATOR')
|
---|
| 243 | src[t.COMPARATOR] = '^' + src[t.GTLT] + '\\s*(' + src[t.FULLPLAIN] + ')$|^$'
|
---|
| 244 |
|
---|
| 245 | // An expression to strip any whitespace between the gtlt and the thing
|
---|
| 246 | // it modifies, so that `> 1.2.3` ==> `>1.2.3`
|
---|
| 247 | tok('COMPARATORTRIM')
|
---|
| 248 | src[t.COMPARATORTRIM] = '(\\s*)' + src[t.GTLT] +
|
---|
| 249 | '\\s*(' + src[t.LOOSEPLAIN] + '|' + src[t.XRANGEPLAIN] + ')'
|
---|
| 250 |
|
---|
| 251 | // this one has to use the /g flag
|
---|
| 252 | re[t.COMPARATORTRIM] = new RegExp(src[t.COMPARATORTRIM], 'g')
|
---|
| 253 | safeRe[t.COMPARATORTRIM] = new RegExp(makeSafeRe(src[t.COMPARATORTRIM]), 'g')
|
---|
| 254 | var comparatorTrimReplace = '$1$2$3'
|
---|
| 255 |
|
---|
| 256 | // Something like `1.2.3 - 1.2.4`
|
---|
| 257 | // Note that these all use the loose form, because they'll be
|
---|
| 258 | // checked against either the strict or loose comparator form
|
---|
| 259 | // later.
|
---|
| 260 | tok('HYPHENRANGE')
|
---|
| 261 | src[t.HYPHENRANGE] = '^\\s*(' + src[t.XRANGEPLAIN] + ')' +
|
---|
| 262 | '\\s+-\\s+' +
|
---|
| 263 | '(' + src[t.XRANGEPLAIN] + ')' +
|
---|
| 264 | '\\s*$'
|
---|
| 265 |
|
---|
| 266 | tok('HYPHENRANGELOOSE')
|
---|
| 267 | src[t.HYPHENRANGELOOSE] = '^\\s*(' + src[t.XRANGEPLAINLOOSE] + ')' +
|
---|
| 268 | '\\s+-\\s+' +
|
---|
| 269 | '(' + src[t.XRANGEPLAINLOOSE] + ')' +
|
---|
| 270 | '\\s*$'
|
---|
| 271 |
|
---|
| 272 | // Star ranges basically just allow anything at all.
|
---|
| 273 | tok('STAR')
|
---|
| 274 | src[t.STAR] = '(<|>)?=?\\s*\\*'
|
---|
| 275 |
|
---|
| 276 | // Compile to actual regexp objects.
|
---|
| 277 | // All are flag-free, unless they were created above with a flag.
|
---|
| 278 | for (var i = 0; i < R; i++) {
|
---|
| 279 | debug(i, src[i])
|
---|
| 280 | if (!re[i]) {
|
---|
| 281 | re[i] = new RegExp(src[i])
|
---|
| 282 |
|
---|
| 283 | // Replace all greedy whitespace to prevent regex dos issues. These regex are
|
---|
| 284 | // used internally via the safeRe object since all inputs in this library get
|
---|
| 285 | // normalized first to trim and collapse all extra whitespace. The original
|
---|
| 286 | // regexes are exported for userland consumption and lower level usage. A
|
---|
| 287 | // future breaking change could export the safer regex only with a note that
|
---|
| 288 | // all input should have extra whitespace removed.
|
---|
| 289 | safeRe[i] = new RegExp(makeSafeRe(src[i]))
|
---|
| 290 | }
|
---|
| 291 | }
|
---|
| 292 |
|
---|
| 293 | exports.parse = parse
|
---|
| 294 | function parse (version, options) {
|
---|
| 295 | if (!options || typeof options !== 'object') {
|
---|
| 296 | options = {
|
---|
| 297 | loose: !!options,
|
---|
| 298 | includePrerelease: false
|
---|
| 299 | }
|
---|
| 300 | }
|
---|
| 301 |
|
---|
| 302 | if (version instanceof SemVer) {
|
---|
| 303 | return version
|
---|
| 304 | }
|
---|
| 305 |
|
---|
| 306 | if (typeof version !== 'string') {
|
---|
| 307 | return null
|
---|
| 308 | }
|
---|
| 309 |
|
---|
| 310 | if (version.length > MAX_LENGTH) {
|
---|
| 311 | return null
|
---|
| 312 | }
|
---|
| 313 |
|
---|
| 314 | var r = options.loose ? safeRe[t.LOOSE] : safeRe[t.FULL]
|
---|
| 315 | if (!r.test(version)) {
|
---|
| 316 | return null
|
---|
| 317 | }
|
---|
| 318 |
|
---|
| 319 | try {
|
---|
| 320 | return new SemVer(version, options)
|
---|
| 321 | } catch (er) {
|
---|
| 322 | return null
|
---|
| 323 | }
|
---|
| 324 | }
|
---|
| 325 |
|
---|
| 326 | exports.valid = valid
|
---|
| 327 | function valid (version, options) {
|
---|
| 328 | var v = parse(version, options)
|
---|
| 329 | return v ? v.version : null
|
---|
| 330 | }
|
---|
| 331 |
|
---|
| 332 | exports.clean = clean
|
---|
| 333 | function clean (version, options) {
|
---|
| 334 | var s = parse(version.trim().replace(/^[=v]+/, ''), options)
|
---|
| 335 | return s ? s.version : null
|
---|
| 336 | }
|
---|
| 337 |
|
---|
| 338 | exports.SemVer = SemVer
|
---|
| 339 |
|
---|
| 340 | function SemVer (version, options) {
|
---|
| 341 | if (!options || typeof options !== 'object') {
|
---|
| 342 | options = {
|
---|
| 343 | loose: !!options,
|
---|
| 344 | includePrerelease: false
|
---|
| 345 | }
|
---|
| 346 | }
|
---|
| 347 | if (version instanceof SemVer) {
|
---|
| 348 | if (version.loose === options.loose) {
|
---|
| 349 | return version
|
---|
| 350 | } else {
|
---|
| 351 | version = version.version
|
---|
| 352 | }
|
---|
| 353 | } else if (typeof version !== 'string') {
|
---|
| 354 | throw new TypeError('Invalid Version: ' + version)
|
---|
| 355 | }
|
---|
| 356 |
|
---|
| 357 | if (version.length > MAX_LENGTH) {
|
---|
| 358 | throw new TypeError('version is longer than ' + MAX_LENGTH + ' characters')
|
---|
| 359 | }
|
---|
| 360 |
|
---|
| 361 | if (!(this instanceof SemVer)) {
|
---|
| 362 | return new SemVer(version, options)
|
---|
| 363 | }
|
---|
| 364 |
|
---|
| 365 | debug('SemVer', version, options)
|
---|
| 366 | this.options = options
|
---|
| 367 | this.loose = !!options.loose
|
---|
| 368 |
|
---|
| 369 | var m = version.trim().match(options.loose ? safeRe[t.LOOSE] : safeRe[t.FULL])
|
---|
| 370 |
|
---|
| 371 | if (!m) {
|
---|
| 372 | throw new TypeError('Invalid Version: ' + version)
|
---|
| 373 | }
|
---|
| 374 |
|
---|
| 375 | this.raw = version
|
---|
| 376 |
|
---|
| 377 | // these are actually numbers
|
---|
| 378 | this.major = +m[1]
|
---|
| 379 | this.minor = +m[2]
|
---|
| 380 | this.patch = +m[3]
|
---|
| 381 |
|
---|
| 382 | if (this.major > MAX_SAFE_INTEGER || this.major < 0) {
|
---|
| 383 | throw new TypeError('Invalid major version')
|
---|
| 384 | }
|
---|
| 385 |
|
---|
| 386 | if (this.minor > MAX_SAFE_INTEGER || this.minor < 0) {
|
---|
| 387 | throw new TypeError('Invalid minor version')
|
---|
| 388 | }
|
---|
| 389 |
|
---|
| 390 | if (this.patch > MAX_SAFE_INTEGER || this.patch < 0) {
|
---|
| 391 | throw new TypeError('Invalid patch version')
|
---|
| 392 | }
|
---|
| 393 |
|
---|
| 394 | // numberify any prerelease numeric ids
|
---|
| 395 | if (!m[4]) {
|
---|
| 396 | this.prerelease = []
|
---|
| 397 | } else {
|
---|
| 398 | this.prerelease = m[4].split('.').map(function (id) {
|
---|
| 399 | if (/^[0-9]+$/.test(id)) {
|
---|
| 400 | var num = +id
|
---|
| 401 | if (num >= 0 && num < MAX_SAFE_INTEGER) {
|
---|
| 402 | return num
|
---|
| 403 | }
|
---|
| 404 | }
|
---|
| 405 | return id
|
---|
| 406 | })
|
---|
| 407 | }
|
---|
| 408 |
|
---|
| 409 | this.build = m[5] ? m[5].split('.') : []
|
---|
| 410 | this.format()
|
---|
| 411 | }
|
---|
| 412 |
|
---|
| 413 | SemVer.prototype.format = function () {
|
---|
| 414 | this.version = this.major + '.' + this.minor + '.' + this.patch
|
---|
| 415 | if (this.prerelease.length) {
|
---|
| 416 | this.version += '-' + this.prerelease.join('.')
|
---|
| 417 | }
|
---|
| 418 | return this.version
|
---|
| 419 | }
|
---|
| 420 |
|
---|
| 421 | SemVer.prototype.toString = function () {
|
---|
| 422 | return this.version
|
---|
| 423 | }
|
---|
| 424 |
|
---|
| 425 | SemVer.prototype.compare = function (other) {
|
---|
| 426 | debug('SemVer.compare', this.version, this.options, other)
|
---|
| 427 | if (!(other instanceof SemVer)) {
|
---|
| 428 | other = new SemVer(other, this.options)
|
---|
| 429 | }
|
---|
| 430 |
|
---|
| 431 | return this.compareMain(other) || this.comparePre(other)
|
---|
| 432 | }
|
---|
| 433 |
|
---|
| 434 | SemVer.prototype.compareMain = function (other) {
|
---|
| 435 | if (!(other instanceof SemVer)) {
|
---|
| 436 | other = new SemVer(other, this.options)
|
---|
| 437 | }
|
---|
| 438 |
|
---|
| 439 | return compareIdentifiers(this.major, other.major) ||
|
---|
| 440 | compareIdentifiers(this.minor, other.minor) ||
|
---|
| 441 | compareIdentifiers(this.patch, other.patch)
|
---|
| 442 | }
|
---|
| 443 |
|
---|
| 444 | SemVer.prototype.comparePre = function (other) {
|
---|
| 445 | if (!(other instanceof SemVer)) {
|
---|
| 446 | other = new SemVer(other, this.options)
|
---|
| 447 | }
|
---|
| 448 |
|
---|
| 449 | // NOT having a prerelease is > having one
|
---|
| 450 | if (this.prerelease.length && !other.prerelease.length) {
|
---|
| 451 | return -1
|
---|
| 452 | } else if (!this.prerelease.length && other.prerelease.length) {
|
---|
| 453 | return 1
|
---|
| 454 | } else if (!this.prerelease.length && !other.prerelease.length) {
|
---|
| 455 | return 0
|
---|
| 456 | }
|
---|
| 457 |
|
---|
| 458 | var i = 0
|
---|
| 459 | do {
|
---|
| 460 | var a = this.prerelease[i]
|
---|
| 461 | var b = other.prerelease[i]
|
---|
| 462 | debug('prerelease compare', i, a, b)
|
---|
| 463 | if (a === undefined && b === undefined) {
|
---|
| 464 | return 0
|
---|
| 465 | } else if (b === undefined) {
|
---|
| 466 | return 1
|
---|
| 467 | } else if (a === undefined) {
|
---|
| 468 | return -1
|
---|
| 469 | } else if (a === b) {
|
---|
| 470 | continue
|
---|
| 471 | } else {
|
---|
| 472 | return compareIdentifiers(a, b)
|
---|
| 473 | }
|
---|
| 474 | } while (++i)
|
---|
| 475 | }
|
---|
| 476 |
|
---|
| 477 | SemVer.prototype.compareBuild = function (other) {
|
---|
| 478 | if (!(other instanceof SemVer)) {
|
---|
| 479 | other = new SemVer(other, this.options)
|
---|
| 480 | }
|
---|
| 481 |
|
---|
| 482 | var i = 0
|
---|
| 483 | do {
|
---|
| 484 | var a = this.build[i]
|
---|
| 485 | var b = other.build[i]
|
---|
| 486 | debug('prerelease compare', i, a, b)
|
---|
| 487 | if (a === undefined && b === undefined) {
|
---|
| 488 | return 0
|
---|
| 489 | } else if (b === undefined) {
|
---|
| 490 | return 1
|
---|
| 491 | } else if (a === undefined) {
|
---|
| 492 | return -1
|
---|
| 493 | } else if (a === b) {
|
---|
| 494 | continue
|
---|
| 495 | } else {
|
---|
| 496 | return compareIdentifiers(a, b)
|
---|
| 497 | }
|
---|
| 498 | } while (++i)
|
---|
| 499 | }
|
---|
| 500 |
|
---|
| 501 | // preminor will bump the version up to the next minor release, and immediately
|
---|
| 502 | // down to pre-release. premajor and prepatch work the same way.
|
---|
| 503 | SemVer.prototype.inc = function (release, identifier) {
|
---|
| 504 | switch (release) {
|
---|
| 505 | case 'premajor':
|
---|
| 506 | this.prerelease.length = 0
|
---|
| 507 | this.patch = 0
|
---|
| 508 | this.minor = 0
|
---|
| 509 | this.major++
|
---|
| 510 | this.inc('pre', identifier)
|
---|
| 511 | break
|
---|
| 512 | case 'preminor':
|
---|
| 513 | this.prerelease.length = 0
|
---|
| 514 | this.patch = 0
|
---|
| 515 | this.minor++
|
---|
| 516 | this.inc('pre', identifier)
|
---|
| 517 | break
|
---|
| 518 | case 'prepatch':
|
---|
| 519 | // If this is already a prerelease, it will bump to the next version
|
---|
| 520 | // drop any prereleases that might already exist, since they are not
|
---|
| 521 | // relevant at this point.
|
---|
| 522 | this.prerelease.length = 0
|
---|
| 523 | this.inc('patch', identifier)
|
---|
| 524 | this.inc('pre', identifier)
|
---|
| 525 | break
|
---|
| 526 | // If the input is a non-prerelease version, this acts the same as
|
---|
| 527 | // prepatch.
|
---|
| 528 | case 'prerelease':
|
---|
| 529 | if (this.prerelease.length === 0) {
|
---|
| 530 | this.inc('patch', identifier)
|
---|
| 531 | }
|
---|
| 532 | this.inc('pre', identifier)
|
---|
| 533 | break
|
---|
| 534 |
|
---|
| 535 | case 'major':
|
---|
| 536 | // If this is a pre-major version, bump up to the same major version.
|
---|
| 537 | // Otherwise increment major.
|
---|
| 538 | // 1.0.0-5 bumps to 1.0.0
|
---|
| 539 | // 1.1.0 bumps to 2.0.0
|
---|
| 540 | if (this.minor !== 0 ||
|
---|
| 541 | this.patch !== 0 ||
|
---|
| 542 | this.prerelease.length === 0) {
|
---|
| 543 | this.major++
|
---|
| 544 | }
|
---|
| 545 | this.minor = 0
|
---|
| 546 | this.patch = 0
|
---|
| 547 | this.prerelease = []
|
---|
| 548 | break
|
---|
| 549 | case 'minor':
|
---|
| 550 | // If this is a pre-minor version, bump up to the same minor version.
|
---|
| 551 | // Otherwise increment minor.
|
---|
| 552 | // 1.2.0-5 bumps to 1.2.0
|
---|
| 553 | // 1.2.1 bumps to 1.3.0
|
---|
| 554 | if (this.patch !== 0 || this.prerelease.length === 0) {
|
---|
| 555 | this.minor++
|
---|
| 556 | }
|
---|
| 557 | this.patch = 0
|
---|
| 558 | this.prerelease = []
|
---|
| 559 | break
|
---|
| 560 | case 'patch':
|
---|
| 561 | // If this is not a pre-release version, it will increment the patch.
|
---|
| 562 | // If it is a pre-release it will bump up to the same patch version.
|
---|
| 563 | // 1.2.0-5 patches to 1.2.0
|
---|
| 564 | // 1.2.0 patches to 1.2.1
|
---|
| 565 | if (this.prerelease.length === 0) {
|
---|
| 566 | this.patch++
|
---|
| 567 | }
|
---|
| 568 | this.prerelease = []
|
---|
| 569 | break
|
---|
| 570 | // This probably shouldn't be used publicly.
|
---|
| 571 | // 1.0.0 "pre" would become 1.0.0-0 which is the wrong direction.
|
---|
| 572 | case 'pre':
|
---|
| 573 | if (this.prerelease.length === 0) {
|
---|
| 574 | this.prerelease = [0]
|
---|
| 575 | } else {
|
---|
| 576 | var i = this.prerelease.length
|
---|
| 577 | while (--i >= 0) {
|
---|
| 578 | if (typeof this.prerelease[i] === 'number') {
|
---|
| 579 | this.prerelease[i]++
|
---|
| 580 | i = -2
|
---|
| 581 | }
|
---|
| 582 | }
|
---|
| 583 | if (i === -1) {
|
---|
| 584 | // didn't increment anything
|
---|
| 585 | this.prerelease.push(0)
|
---|
| 586 | }
|
---|
| 587 | }
|
---|
| 588 | if (identifier) {
|
---|
| 589 | // 1.2.0-beta.1 bumps to 1.2.0-beta.2,
|
---|
| 590 | // 1.2.0-beta.fooblz or 1.2.0-beta bumps to 1.2.0-beta.0
|
---|
| 591 | if (this.prerelease[0] === identifier) {
|
---|
| 592 | if (isNaN(this.prerelease[1])) {
|
---|
| 593 | this.prerelease = [identifier, 0]
|
---|
| 594 | }
|
---|
| 595 | } else {
|
---|
| 596 | this.prerelease = [identifier, 0]
|
---|
| 597 | }
|
---|
| 598 | }
|
---|
| 599 | break
|
---|
| 600 |
|
---|
| 601 | default:
|
---|
| 602 | throw new Error('invalid increment argument: ' + release)
|
---|
| 603 | }
|
---|
| 604 | this.format()
|
---|
| 605 | this.raw = this.version
|
---|
| 606 | return this
|
---|
| 607 | }
|
---|
| 608 |
|
---|
| 609 | exports.inc = inc
|
---|
| 610 | function inc (version, release, loose, identifier) {
|
---|
| 611 | if (typeof (loose) === 'string') {
|
---|
| 612 | identifier = loose
|
---|
| 613 | loose = undefined
|
---|
| 614 | }
|
---|
| 615 |
|
---|
| 616 | try {
|
---|
| 617 | return new SemVer(version, loose).inc(release, identifier).version
|
---|
| 618 | } catch (er) {
|
---|
| 619 | return null
|
---|
| 620 | }
|
---|
| 621 | }
|
---|
| 622 |
|
---|
| 623 | exports.diff = diff
|
---|
| 624 | function diff (version1, version2) {
|
---|
| 625 | if (eq(version1, version2)) {
|
---|
| 626 | return null
|
---|
| 627 | } else {
|
---|
| 628 | var v1 = parse(version1)
|
---|
| 629 | var v2 = parse(version2)
|
---|
| 630 | var prefix = ''
|
---|
| 631 | if (v1.prerelease.length || v2.prerelease.length) {
|
---|
| 632 | prefix = 'pre'
|
---|
| 633 | var defaultResult = 'prerelease'
|
---|
| 634 | }
|
---|
| 635 | for (var key in v1) {
|
---|
| 636 | if (key === 'major' || key === 'minor' || key === 'patch') {
|
---|
| 637 | if (v1[key] !== v2[key]) {
|
---|
| 638 | return prefix + key
|
---|
| 639 | }
|
---|
| 640 | }
|
---|
| 641 | }
|
---|
| 642 | return defaultResult // may be undefined
|
---|
| 643 | }
|
---|
| 644 | }
|
---|
| 645 |
|
---|
| 646 | exports.compareIdentifiers = compareIdentifiers
|
---|
| 647 |
|
---|
| 648 | var numeric = /^[0-9]+$/
|
---|
| 649 | function compareIdentifiers (a, b) {
|
---|
| 650 | var anum = numeric.test(a)
|
---|
| 651 | var bnum = numeric.test(b)
|
---|
| 652 |
|
---|
| 653 | if (anum && bnum) {
|
---|
| 654 | a = +a
|
---|
| 655 | b = +b
|
---|
| 656 | }
|
---|
| 657 |
|
---|
| 658 | return a === b ? 0
|
---|
| 659 | : (anum && !bnum) ? -1
|
---|
| 660 | : (bnum && !anum) ? 1
|
---|
| 661 | : a < b ? -1
|
---|
| 662 | : 1
|
---|
| 663 | }
|
---|
| 664 |
|
---|
| 665 | exports.rcompareIdentifiers = rcompareIdentifiers
|
---|
| 666 | function rcompareIdentifiers (a, b) {
|
---|
| 667 | return compareIdentifiers(b, a)
|
---|
| 668 | }
|
---|
| 669 |
|
---|
| 670 | exports.major = major
|
---|
| 671 | function major (a, loose) {
|
---|
| 672 | return new SemVer(a, loose).major
|
---|
| 673 | }
|
---|
| 674 |
|
---|
| 675 | exports.minor = minor
|
---|
| 676 | function minor (a, loose) {
|
---|
| 677 | return new SemVer(a, loose).minor
|
---|
| 678 | }
|
---|
| 679 |
|
---|
| 680 | exports.patch = patch
|
---|
| 681 | function patch (a, loose) {
|
---|
| 682 | return new SemVer(a, loose).patch
|
---|
| 683 | }
|
---|
| 684 |
|
---|
| 685 | exports.compare = compare
|
---|
| 686 | function compare (a, b, loose) {
|
---|
| 687 | return new SemVer(a, loose).compare(new SemVer(b, loose))
|
---|
| 688 | }
|
---|
| 689 |
|
---|
| 690 | exports.compareLoose = compareLoose
|
---|
| 691 | function compareLoose (a, b) {
|
---|
| 692 | return compare(a, b, true)
|
---|
| 693 | }
|
---|
| 694 |
|
---|
| 695 | exports.compareBuild = compareBuild
|
---|
| 696 | function compareBuild (a, b, loose) {
|
---|
| 697 | var versionA = new SemVer(a, loose)
|
---|
| 698 | var versionB = new SemVer(b, loose)
|
---|
| 699 | return versionA.compare(versionB) || versionA.compareBuild(versionB)
|
---|
| 700 | }
|
---|
| 701 |
|
---|
| 702 | exports.rcompare = rcompare
|
---|
| 703 | function rcompare (a, b, loose) {
|
---|
| 704 | return compare(b, a, loose)
|
---|
| 705 | }
|
---|
| 706 |
|
---|
| 707 | exports.sort = sort
|
---|
| 708 | function sort (list, loose) {
|
---|
| 709 | return list.sort(function (a, b) {
|
---|
| 710 | return exports.compareBuild(a, b, loose)
|
---|
| 711 | })
|
---|
| 712 | }
|
---|
| 713 |
|
---|
| 714 | exports.rsort = rsort
|
---|
| 715 | function rsort (list, loose) {
|
---|
| 716 | return list.sort(function (a, b) {
|
---|
| 717 | return exports.compareBuild(b, a, loose)
|
---|
| 718 | })
|
---|
| 719 | }
|
---|
| 720 |
|
---|
| 721 | exports.gt = gt
|
---|
| 722 | function gt (a, b, loose) {
|
---|
| 723 | return compare(a, b, loose) > 0
|
---|
| 724 | }
|
---|
| 725 |
|
---|
| 726 | exports.lt = lt
|
---|
| 727 | function lt (a, b, loose) {
|
---|
| 728 | return compare(a, b, loose) < 0
|
---|
| 729 | }
|
---|
| 730 |
|
---|
| 731 | exports.eq = eq
|
---|
| 732 | function eq (a, b, loose) {
|
---|
| 733 | return compare(a, b, loose) === 0
|
---|
| 734 | }
|
---|
| 735 |
|
---|
| 736 | exports.neq = neq
|
---|
| 737 | function neq (a, b, loose) {
|
---|
| 738 | return compare(a, b, loose) !== 0
|
---|
| 739 | }
|
---|
| 740 |
|
---|
| 741 | exports.gte = gte
|
---|
| 742 | function gte (a, b, loose) {
|
---|
| 743 | return compare(a, b, loose) >= 0
|
---|
| 744 | }
|
---|
| 745 |
|
---|
| 746 | exports.lte = lte
|
---|
| 747 | function lte (a, b, loose) {
|
---|
| 748 | return compare(a, b, loose) <= 0
|
---|
| 749 | }
|
---|
| 750 |
|
---|
| 751 | exports.cmp = cmp
|
---|
| 752 | function cmp (a, op, b, loose) {
|
---|
| 753 | switch (op) {
|
---|
| 754 | case '===':
|
---|
| 755 | if (typeof a === 'object')
|
---|
| 756 | a = a.version
|
---|
| 757 | if (typeof b === 'object')
|
---|
| 758 | b = b.version
|
---|
| 759 | return a === b
|
---|
| 760 |
|
---|
| 761 | case '!==':
|
---|
| 762 | if (typeof a === 'object')
|
---|
| 763 | a = a.version
|
---|
| 764 | if (typeof b === 'object')
|
---|
| 765 | b = b.version
|
---|
| 766 | return a !== b
|
---|
| 767 |
|
---|
| 768 | case '':
|
---|
| 769 | case '=':
|
---|
| 770 | case '==':
|
---|
| 771 | return eq(a, b, loose)
|
---|
| 772 |
|
---|
| 773 | case '!=':
|
---|
| 774 | return neq(a, b, loose)
|
---|
| 775 |
|
---|
| 776 | case '>':
|
---|
| 777 | return gt(a, b, loose)
|
---|
| 778 |
|
---|
| 779 | case '>=':
|
---|
| 780 | return gte(a, b, loose)
|
---|
| 781 |
|
---|
| 782 | case '<':
|
---|
| 783 | return lt(a, b, loose)
|
---|
| 784 |
|
---|
| 785 | case '<=':
|
---|
| 786 | return lte(a, b, loose)
|
---|
| 787 |
|
---|
| 788 | default:
|
---|
| 789 | throw new TypeError('Invalid operator: ' + op)
|
---|
| 790 | }
|
---|
| 791 | }
|
---|
| 792 |
|
---|
| 793 | exports.Comparator = Comparator
|
---|
| 794 | function Comparator (comp, options) {
|
---|
| 795 | if (!options || typeof options !== 'object') {
|
---|
| 796 | options = {
|
---|
| 797 | loose: !!options,
|
---|
| 798 | includePrerelease: false
|
---|
| 799 | }
|
---|
| 800 | }
|
---|
| 801 |
|
---|
| 802 | if (comp instanceof Comparator) {
|
---|
| 803 | if (comp.loose === !!options.loose) {
|
---|
| 804 | return comp
|
---|
| 805 | } else {
|
---|
| 806 | comp = comp.value
|
---|
| 807 | }
|
---|
| 808 | }
|
---|
| 809 |
|
---|
| 810 | if (!(this instanceof Comparator)) {
|
---|
| 811 | return new Comparator(comp, options)
|
---|
| 812 | }
|
---|
| 813 |
|
---|
| 814 | comp = comp.trim().split(/\s+/).join(' ')
|
---|
| 815 | debug('comparator', comp, options)
|
---|
| 816 | this.options = options
|
---|
| 817 | this.loose = !!options.loose
|
---|
| 818 | this.parse(comp)
|
---|
| 819 |
|
---|
| 820 | if (this.semver === ANY) {
|
---|
| 821 | this.value = ''
|
---|
| 822 | } else {
|
---|
| 823 | this.value = this.operator + this.semver.version
|
---|
| 824 | }
|
---|
| 825 |
|
---|
| 826 | debug('comp', this)
|
---|
| 827 | }
|
---|
| 828 |
|
---|
| 829 | var ANY = {}
|
---|
| 830 | Comparator.prototype.parse = function (comp) {
|
---|
| 831 | var r = this.options.loose ? safeRe[t.COMPARATORLOOSE] : safeRe[t.COMPARATOR]
|
---|
| 832 | var m = comp.match(r)
|
---|
| 833 |
|
---|
| 834 | if (!m) {
|
---|
| 835 | throw new TypeError('Invalid comparator: ' + comp)
|
---|
| 836 | }
|
---|
| 837 |
|
---|
| 838 | this.operator = m[1] !== undefined ? m[1] : ''
|
---|
| 839 | if (this.operator === '=') {
|
---|
| 840 | this.operator = ''
|
---|
| 841 | }
|
---|
| 842 |
|
---|
| 843 | // if it literally is just '>' or '' then allow anything.
|
---|
| 844 | if (!m[2]) {
|
---|
| 845 | this.semver = ANY
|
---|
| 846 | } else {
|
---|
| 847 | this.semver = new SemVer(m[2], this.options.loose)
|
---|
| 848 | }
|
---|
| 849 | }
|
---|
| 850 |
|
---|
| 851 | Comparator.prototype.toString = function () {
|
---|
| 852 | return this.value
|
---|
| 853 | }
|
---|
| 854 |
|
---|
| 855 | Comparator.prototype.test = function (version) {
|
---|
| 856 | debug('Comparator.test', version, this.options.loose)
|
---|
| 857 |
|
---|
| 858 | if (this.semver === ANY || version === ANY) {
|
---|
| 859 | return true
|
---|
| 860 | }
|
---|
| 861 |
|
---|
| 862 | if (typeof version === 'string') {
|
---|
| 863 | try {
|
---|
| 864 | version = new SemVer(version, this.options)
|
---|
| 865 | } catch (er) {
|
---|
| 866 | return false
|
---|
| 867 | }
|
---|
| 868 | }
|
---|
| 869 |
|
---|
| 870 | return cmp(version, this.operator, this.semver, this.options)
|
---|
| 871 | }
|
---|
| 872 |
|
---|
| 873 | Comparator.prototype.intersects = function (comp, options) {
|
---|
| 874 | if (!(comp instanceof Comparator)) {
|
---|
| 875 | throw new TypeError('a Comparator is required')
|
---|
| 876 | }
|
---|
| 877 |
|
---|
| 878 | if (!options || typeof options !== 'object') {
|
---|
| 879 | options = {
|
---|
| 880 | loose: !!options,
|
---|
| 881 | includePrerelease: false
|
---|
| 882 | }
|
---|
| 883 | }
|
---|
| 884 |
|
---|
| 885 | var rangeTmp
|
---|
| 886 |
|
---|
| 887 | if (this.operator === '') {
|
---|
| 888 | if (this.value === '') {
|
---|
| 889 | return true
|
---|
| 890 | }
|
---|
| 891 | rangeTmp = new Range(comp.value, options)
|
---|
| 892 | return satisfies(this.value, rangeTmp, options)
|
---|
| 893 | } else if (comp.operator === '') {
|
---|
| 894 | if (comp.value === '') {
|
---|
| 895 | return true
|
---|
| 896 | }
|
---|
| 897 | rangeTmp = new Range(this.value, options)
|
---|
| 898 | return satisfies(comp.semver, rangeTmp, options)
|
---|
| 899 | }
|
---|
| 900 |
|
---|
| 901 | var sameDirectionIncreasing =
|
---|
| 902 | (this.operator === '>=' || this.operator === '>') &&
|
---|
| 903 | (comp.operator === '>=' || comp.operator === '>')
|
---|
| 904 | var sameDirectionDecreasing =
|
---|
| 905 | (this.operator === '<=' || this.operator === '<') &&
|
---|
| 906 | (comp.operator === '<=' || comp.operator === '<')
|
---|
| 907 | var sameSemVer = this.semver.version === comp.semver.version
|
---|
| 908 | var differentDirectionsInclusive =
|
---|
| 909 | (this.operator === '>=' || this.operator === '<=') &&
|
---|
| 910 | (comp.operator === '>=' || comp.operator === '<=')
|
---|
| 911 | var oppositeDirectionsLessThan =
|
---|
| 912 | cmp(this.semver, '<', comp.semver, options) &&
|
---|
| 913 | ((this.operator === '>=' || this.operator === '>') &&
|
---|
| 914 | (comp.operator === '<=' || comp.operator === '<'))
|
---|
| 915 | var oppositeDirectionsGreaterThan =
|
---|
| 916 | cmp(this.semver, '>', comp.semver, options) &&
|
---|
| 917 | ((this.operator === '<=' || this.operator === '<') &&
|
---|
| 918 | (comp.operator === '>=' || comp.operator === '>'))
|
---|
| 919 |
|
---|
| 920 | return sameDirectionIncreasing || sameDirectionDecreasing ||
|
---|
| 921 | (sameSemVer && differentDirectionsInclusive) ||
|
---|
| 922 | oppositeDirectionsLessThan || oppositeDirectionsGreaterThan
|
---|
| 923 | }
|
---|
| 924 |
|
---|
| 925 | exports.Range = Range
|
---|
| 926 | function Range (range, options) {
|
---|
| 927 | if (!options || typeof options !== 'object') {
|
---|
| 928 | options = {
|
---|
| 929 | loose: !!options,
|
---|
| 930 | includePrerelease: false
|
---|
| 931 | }
|
---|
| 932 | }
|
---|
| 933 |
|
---|
| 934 | if (range instanceof Range) {
|
---|
| 935 | if (range.loose === !!options.loose &&
|
---|
| 936 | range.includePrerelease === !!options.includePrerelease) {
|
---|
| 937 | return range
|
---|
| 938 | } else {
|
---|
| 939 | return new Range(range.raw, options)
|
---|
| 940 | }
|
---|
| 941 | }
|
---|
| 942 |
|
---|
| 943 | if (range instanceof Comparator) {
|
---|
| 944 | return new Range(range.value, options)
|
---|
| 945 | }
|
---|
| 946 |
|
---|
| 947 | if (!(this instanceof Range)) {
|
---|
| 948 | return new Range(range, options)
|
---|
| 949 | }
|
---|
| 950 |
|
---|
| 951 | this.options = options
|
---|
| 952 | this.loose = !!options.loose
|
---|
| 953 | this.includePrerelease = !!options.includePrerelease
|
---|
| 954 |
|
---|
| 955 | // First reduce all whitespace as much as possible so we do not have to rely
|
---|
| 956 | // on potentially slow regexes like \s*. This is then stored and used for
|
---|
| 957 | // future error messages as well.
|
---|
| 958 | this.raw = range
|
---|
| 959 | .trim()
|
---|
| 960 | .split(/\s+/)
|
---|
| 961 | .join(' ')
|
---|
| 962 |
|
---|
| 963 | // First, split based on boolean or ||
|
---|
| 964 | this.set = this.raw.split('||').map(function (range) {
|
---|
| 965 | return this.parseRange(range.trim())
|
---|
| 966 | }, this).filter(function (c) {
|
---|
| 967 | // throw out any that are not relevant for whatever reason
|
---|
| 968 | return c.length
|
---|
| 969 | })
|
---|
| 970 |
|
---|
| 971 | if (!this.set.length) {
|
---|
| 972 | throw new TypeError('Invalid SemVer Range: ' + this.raw)
|
---|
| 973 | }
|
---|
| 974 |
|
---|
| 975 | this.format()
|
---|
| 976 | }
|
---|
| 977 |
|
---|
| 978 | Range.prototype.format = function () {
|
---|
| 979 | this.range = this.set.map(function (comps) {
|
---|
| 980 | return comps.join(' ').trim()
|
---|
| 981 | }).join('||').trim()
|
---|
| 982 | return this.range
|
---|
| 983 | }
|
---|
| 984 |
|
---|
| 985 | Range.prototype.toString = function () {
|
---|
| 986 | return this.range
|
---|
| 987 | }
|
---|
| 988 |
|
---|
| 989 | Range.prototype.parseRange = function (range) {
|
---|
| 990 | var loose = this.options.loose
|
---|
| 991 | // `1.2.3 - 1.2.4` => `>=1.2.3 <=1.2.4`
|
---|
| 992 | var hr = loose ? safeRe[t.HYPHENRANGELOOSE] : safeRe[t.HYPHENRANGE]
|
---|
| 993 | range = range.replace(hr, hyphenReplace)
|
---|
| 994 | debug('hyphen replace', range)
|
---|
| 995 | // `> 1.2.3 < 1.2.5` => `>1.2.3 <1.2.5`
|
---|
| 996 | range = range.replace(safeRe[t.COMPARATORTRIM], comparatorTrimReplace)
|
---|
| 997 | debug('comparator trim', range, safeRe[t.COMPARATORTRIM])
|
---|
| 998 |
|
---|
| 999 | // `~ 1.2.3` => `~1.2.3`
|
---|
| 1000 | range = range.replace(safeRe[t.TILDETRIM], tildeTrimReplace)
|
---|
| 1001 |
|
---|
| 1002 | // `^ 1.2.3` => `^1.2.3`
|
---|
| 1003 | range = range.replace(safeRe[t.CARETTRIM], caretTrimReplace)
|
---|
| 1004 |
|
---|
| 1005 | // normalize spaces
|
---|
| 1006 | range = range.split(/\s+/).join(' ')
|
---|
| 1007 |
|
---|
| 1008 | // At this point, the range is completely trimmed and
|
---|
| 1009 | // ready to be split into comparators.
|
---|
| 1010 |
|
---|
| 1011 | var compRe = loose ? safeRe[t.COMPARATORLOOSE] : safeRe[t.COMPARATOR]
|
---|
| 1012 | var set = range.split(' ').map(function (comp) {
|
---|
| 1013 | return parseComparator(comp, this.options)
|
---|
| 1014 | }, this).join(' ').split(/\s+/)
|
---|
| 1015 | if (this.options.loose) {
|
---|
| 1016 | // in loose mode, throw out any that are not valid comparators
|
---|
| 1017 | set = set.filter(function (comp) {
|
---|
| 1018 | return !!comp.match(compRe)
|
---|
| 1019 | })
|
---|
| 1020 | }
|
---|
| 1021 | set = set.map(function (comp) {
|
---|
| 1022 | return new Comparator(comp, this.options)
|
---|
| 1023 | }, this)
|
---|
| 1024 |
|
---|
| 1025 | return set
|
---|
| 1026 | }
|
---|
| 1027 |
|
---|
| 1028 | Range.prototype.intersects = function (range, options) {
|
---|
| 1029 | if (!(range instanceof Range)) {
|
---|
| 1030 | throw new TypeError('a Range is required')
|
---|
| 1031 | }
|
---|
| 1032 |
|
---|
| 1033 | return this.set.some(function (thisComparators) {
|
---|
| 1034 | return (
|
---|
| 1035 | isSatisfiable(thisComparators, options) &&
|
---|
| 1036 | range.set.some(function (rangeComparators) {
|
---|
| 1037 | return (
|
---|
| 1038 | isSatisfiable(rangeComparators, options) &&
|
---|
| 1039 | thisComparators.every(function (thisComparator) {
|
---|
| 1040 | return rangeComparators.every(function (rangeComparator) {
|
---|
| 1041 | return thisComparator.intersects(rangeComparator, options)
|
---|
| 1042 | })
|
---|
| 1043 | })
|
---|
| 1044 | )
|
---|
| 1045 | })
|
---|
| 1046 | )
|
---|
| 1047 | })
|
---|
| 1048 | }
|
---|
| 1049 |
|
---|
| 1050 | // take a set of comparators and determine whether there
|
---|
| 1051 | // exists a version which can satisfy it
|
---|
| 1052 | function isSatisfiable (comparators, options) {
|
---|
| 1053 | var result = true
|
---|
| 1054 | var remainingComparators = comparators.slice()
|
---|
| 1055 | var testComparator = remainingComparators.pop()
|
---|
| 1056 |
|
---|
| 1057 | while (result && remainingComparators.length) {
|
---|
| 1058 | result = remainingComparators.every(function (otherComparator) {
|
---|
| 1059 | return testComparator.intersects(otherComparator, options)
|
---|
| 1060 | })
|
---|
| 1061 |
|
---|
| 1062 | testComparator = remainingComparators.pop()
|
---|
| 1063 | }
|
---|
| 1064 |
|
---|
| 1065 | return result
|
---|
| 1066 | }
|
---|
| 1067 |
|
---|
| 1068 | // Mostly just for testing and legacy API reasons
|
---|
| 1069 | exports.toComparators = toComparators
|
---|
| 1070 | function toComparators (range, options) {
|
---|
| 1071 | return new Range(range, options).set.map(function (comp) {
|
---|
| 1072 | return comp.map(function (c) {
|
---|
| 1073 | return c.value
|
---|
| 1074 | }).join(' ').trim().split(' ')
|
---|
| 1075 | })
|
---|
| 1076 | }
|
---|
| 1077 |
|
---|
| 1078 | // comprised of xranges, tildes, stars, and gtlt's at this point.
|
---|
| 1079 | // already replaced the hyphen ranges
|
---|
| 1080 | // turn into a set of JUST comparators.
|
---|
| 1081 | function parseComparator (comp, options) {
|
---|
| 1082 | debug('comp', comp, options)
|
---|
| 1083 | comp = replaceCarets(comp, options)
|
---|
| 1084 | debug('caret', comp)
|
---|
| 1085 | comp = replaceTildes(comp, options)
|
---|
| 1086 | debug('tildes', comp)
|
---|
| 1087 | comp = replaceXRanges(comp, options)
|
---|
| 1088 | debug('xrange', comp)
|
---|
| 1089 | comp = replaceStars(comp, options)
|
---|
| 1090 | debug('stars', comp)
|
---|
| 1091 | return comp
|
---|
| 1092 | }
|
---|
| 1093 |
|
---|
| 1094 | function isX (id) {
|
---|
| 1095 | return !id || id.toLowerCase() === 'x' || id === '*'
|
---|
| 1096 | }
|
---|
| 1097 |
|
---|
| 1098 | // ~, ~> --> * (any, kinda silly)
|
---|
| 1099 | // ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0
|
---|
| 1100 | // ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0
|
---|
| 1101 | // ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0
|
---|
| 1102 | // ~1.2.3, ~>1.2.3 --> >=1.2.3 <1.3.0
|
---|
| 1103 | // ~1.2.0, ~>1.2.0 --> >=1.2.0 <1.3.0
|
---|
| 1104 | function replaceTildes (comp, options) {
|
---|
| 1105 | return comp.trim().split(/\s+/).map(function (comp) {
|
---|
| 1106 | return replaceTilde(comp, options)
|
---|
| 1107 | }).join(' ')
|
---|
| 1108 | }
|
---|
| 1109 |
|
---|
| 1110 | function replaceTilde (comp, options) {
|
---|
| 1111 | var r = options.loose ? safeRe[t.TILDELOOSE] : safeRe[t.TILDE]
|
---|
| 1112 | return comp.replace(r, function (_, M, m, p, pr) {
|
---|
| 1113 | debug('tilde', comp, _, M, m, p, pr)
|
---|
| 1114 | var ret
|
---|
| 1115 |
|
---|
| 1116 | if (isX(M)) {
|
---|
| 1117 | ret = ''
|
---|
| 1118 | } else if (isX(m)) {
|
---|
| 1119 | ret = '>=' + M + '.0.0 <' + (+M + 1) + '.0.0'
|
---|
| 1120 | } else if (isX(p)) {
|
---|
| 1121 | // ~1.2 == >=1.2.0 <1.3.0
|
---|
| 1122 | ret = '>=' + M + '.' + m + '.0 <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1123 | } else if (pr) {
|
---|
| 1124 | debug('replaceTilde pr', pr)
|
---|
| 1125 | ret = '>=' + M + '.' + m + '.' + p + '-' + pr +
|
---|
| 1126 | ' <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1127 | } else {
|
---|
| 1128 | // ~1.2.3 == >=1.2.3 <1.3.0
|
---|
| 1129 | ret = '>=' + M + '.' + m + '.' + p +
|
---|
| 1130 | ' <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1131 | }
|
---|
| 1132 |
|
---|
| 1133 | debug('tilde return', ret)
|
---|
| 1134 | return ret
|
---|
| 1135 | })
|
---|
| 1136 | }
|
---|
| 1137 |
|
---|
| 1138 | // ^ --> * (any, kinda silly)
|
---|
| 1139 | // ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0
|
---|
| 1140 | // ^2.0, ^2.0.x --> >=2.0.0 <3.0.0
|
---|
| 1141 | // ^1.2, ^1.2.x --> >=1.2.0 <2.0.0
|
---|
| 1142 | // ^1.2.3 --> >=1.2.3 <2.0.0
|
---|
| 1143 | // ^1.2.0 --> >=1.2.0 <2.0.0
|
---|
| 1144 | function replaceCarets (comp, options) {
|
---|
| 1145 | return comp.trim().split(/\s+/).map(function (comp) {
|
---|
| 1146 | return replaceCaret(comp, options)
|
---|
| 1147 | }).join(' ')
|
---|
| 1148 | }
|
---|
| 1149 |
|
---|
| 1150 | function replaceCaret (comp, options) {
|
---|
| 1151 | debug('caret', comp, options)
|
---|
| 1152 | var r = options.loose ? safeRe[t.CARETLOOSE] : safeRe[t.CARET]
|
---|
| 1153 | return comp.replace(r, function (_, M, m, p, pr) {
|
---|
| 1154 | debug('caret', comp, _, M, m, p, pr)
|
---|
| 1155 | var ret
|
---|
| 1156 |
|
---|
| 1157 | if (isX(M)) {
|
---|
| 1158 | ret = ''
|
---|
| 1159 | } else if (isX(m)) {
|
---|
| 1160 | ret = '>=' + M + '.0.0 <' + (+M + 1) + '.0.0'
|
---|
| 1161 | } else if (isX(p)) {
|
---|
| 1162 | if (M === '0') {
|
---|
| 1163 | ret = '>=' + M + '.' + m + '.0 <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1164 | } else {
|
---|
| 1165 | ret = '>=' + M + '.' + m + '.0 <' + (+M + 1) + '.0.0'
|
---|
| 1166 | }
|
---|
| 1167 | } else if (pr) {
|
---|
| 1168 | debug('replaceCaret pr', pr)
|
---|
| 1169 | if (M === '0') {
|
---|
| 1170 | if (m === '0') {
|
---|
| 1171 | ret = '>=' + M + '.' + m + '.' + p + '-' + pr +
|
---|
| 1172 | ' <' + M + '.' + m + '.' + (+p + 1)
|
---|
| 1173 | } else {
|
---|
| 1174 | ret = '>=' + M + '.' + m + '.' + p + '-' + pr +
|
---|
| 1175 | ' <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1176 | }
|
---|
| 1177 | } else {
|
---|
| 1178 | ret = '>=' + M + '.' + m + '.' + p + '-' + pr +
|
---|
| 1179 | ' <' + (+M + 1) + '.0.0'
|
---|
| 1180 | }
|
---|
| 1181 | } else {
|
---|
| 1182 | debug('no pr')
|
---|
| 1183 | if (M === '0') {
|
---|
| 1184 | if (m === '0') {
|
---|
| 1185 | ret = '>=' + M + '.' + m + '.' + p +
|
---|
| 1186 | ' <' + M + '.' + m + '.' + (+p + 1)
|
---|
| 1187 | } else {
|
---|
| 1188 | ret = '>=' + M + '.' + m + '.' + p +
|
---|
| 1189 | ' <' + M + '.' + (+m + 1) + '.0'
|
---|
| 1190 | }
|
---|
| 1191 | } else {
|
---|
| 1192 | ret = '>=' + M + '.' + m + '.' + p +
|
---|
| 1193 | ' <' + (+M + 1) + '.0.0'
|
---|
| 1194 | }
|
---|
| 1195 | }
|
---|
| 1196 |
|
---|
| 1197 | debug('caret return', ret)
|
---|
| 1198 | return ret
|
---|
| 1199 | })
|
---|
| 1200 | }
|
---|
| 1201 |
|
---|
| 1202 | function replaceXRanges (comp, options) {
|
---|
| 1203 | debug('replaceXRanges', comp, options)
|
---|
| 1204 | return comp.split(/\s+/).map(function (comp) {
|
---|
| 1205 | return replaceXRange(comp, options)
|
---|
| 1206 | }).join(' ')
|
---|
| 1207 | }
|
---|
| 1208 |
|
---|
| 1209 | function replaceXRange (comp, options) {
|
---|
| 1210 | comp = comp.trim()
|
---|
| 1211 | var r = options.loose ? safeRe[t.XRANGELOOSE] : safeRe[t.XRANGE]
|
---|
| 1212 | return comp.replace(r, function (ret, gtlt, M, m, p, pr) {
|
---|
| 1213 | debug('xRange', comp, ret, gtlt, M, m, p, pr)
|
---|
| 1214 | var xM = isX(M)
|
---|
| 1215 | var xm = xM || isX(m)
|
---|
| 1216 | var xp = xm || isX(p)
|
---|
| 1217 | var anyX = xp
|
---|
| 1218 |
|
---|
| 1219 | if (gtlt === '=' && anyX) {
|
---|
| 1220 | gtlt = ''
|
---|
| 1221 | }
|
---|
| 1222 |
|
---|
| 1223 | // if we're including prereleases in the match, then we need
|
---|
| 1224 | // to fix this to -0, the lowest possible prerelease value
|
---|
| 1225 | pr = options.includePrerelease ? '-0' : ''
|
---|
| 1226 |
|
---|
| 1227 | if (xM) {
|
---|
| 1228 | if (gtlt === '>' || gtlt === '<') {
|
---|
| 1229 | // nothing is allowed
|
---|
| 1230 | ret = '<0.0.0-0'
|
---|
| 1231 | } else {
|
---|
| 1232 | // nothing is forbidden
|
---|
| 1233 | ret = '*'
|
---|
| 1234 | }
|
---|
| 1235 | } else if (gtlt && anyX) {
|
---|
| 1236 | // we know patch is an x, because we have any x at all.
|
---|
| 1237 | // replace X with 0
|
---|
| 1238 | if (xm) {
|
---|
| 1239 | m = 0
|
---|
| 1240 | }
|
---|
| 1241 | p = 0
|
---|
| 1242 |
|
---|
| 1243 | if (gtlt === '>') {
|
---|
| 1244 | // >1 => >=2.0.0
|
---|
| 1245 | // >1.2 => >=1.3.0
|
---|
| 1246 | // >1.2.3 => >= 1.2.4
|
---|
| 1247 | gtlt = '>='
|
---|
| 1248 | if (xm) {
|
---|
| 1249 | M = +M + 1
|
---|
| 1250 | m = 0
|
---|
| 1251 | p = 0
|
---|
| 1252 | } else {
|
---|
| 1253 | m = +m + 1
|
---|
| 1254 | p = 0
|
---|
| 1255 | }
|
---|
| 1256 | } else if (gtlt === '<=') {
|
---|
| 1257 | // <=0.7.x is actually <0.8.0, since any 0.7.x should
|
---|
| 1258 | // pass. Similarly, <=7.x is actually <8.0.0, etc.
|
---|
| 1259 | gtlt = '<'
|
---|
| 1260 | if (xm) {
|
---|
| 1261 | M = +M + 1
|
---|
| 1262 | } else {
|
---|
| 1263 | m = +m + 1
|
---|
| 1264 | }
|
---|
| 1265 | }
|
---|
| 1266 |
|
---|
| 1267 | ret = gtlt + M + '.' + m + '.' + p + pr
|
---|
| 1268 | } else if (xm) {
|
---|
| 1269 | ret = '>=' + M + '.0.0' + pr + ' <' + (+M + 1) + '.0.0' + pr
|
---|
| 1270 | } else if (xp) {
|
---|
| 1271 | ret = '>=' + M + '.' + m + '.0' + pr +
|
---|
| 1272 | ' <' + M + '.' + (+m + 1) + '.0' + pr
|
---|
| 1273 | }
|
---|
| 1274 |
|
---|
| 1275 | debug('xRange return', ret)
|
---|
| 1276 |
|
---|
| 1277 | return ret
|
---|
| 1278 | })
|
---|
| 1279 | }
|
---|
| 1280 |
|
---|
| 1281 | // Because * is AND-ed with everything else in the comparator,
|
---|
| 1282 | // and '' means "any version", just remove the *s entirely.
|
---|
| 1283 | function replaceStars (comp, options) {
|
---|
| 1284 | debug('replaceStars', comp, options)
|
---|
| 1285 | // Looseness is ignored here. star is always as loose as it gets!
|
---|
| 1286 | return comp.trim().replace(safeRe[t.STAR], '')
|
---|
| 1287 | }
|
---|
| 1288 |
|
---|
| 1289 | // This function is passed to string.replace(re[t.HYPHENRANGE])
|
---|
| 1290 | // M, m, patch, prerelease, build
|
---|
| 1291 | // 1.2 - 3.4.5 => >=1.2.0 <=3.4.5
|
---|
| 1292 | // 1.2.3 - 3.4 => >=1.2.0 <3.5.0 Any 3.4.x will do
|
---|
| 1293 | // 1.2 - 3.4 => >=1.2.0 <3.5.0
|
---|
| 1294 | function hyphenReplace ($0,
|
---|
| 1295 | from, fM, fm, fp, fpr, fb,
|
---|
| 1296 | to, tM, tm, tp, tpr, tb) {
|
---|
| 1297 | if (isX(fM)) {
|
---|
| 1298 | from = ''
|
---|
| 1299 | } else if (isX(fm)) {
|
---|
| 1300 | from = '>=' + fM + '.0.0'
|
---|
| 1301 | } else if (isX(fp)) {
|
---|
| 1302 | from = '>=' + fM + '.' + fm + '.0'
|
---|
| 1303 | } else {
|
---|
| 1304 | from = '>=' + from
|
---|
| 1305 | }
|
---|
| 1306 |
|
---|
| 1307 | if (isX(tM)) {
|
---|
| 1308 | to = ''
|
---|
| 1309 | } else if (isX(tm)) {
|
---|
| 1310 | to = '<' + (+tM + 1) + '.0.0'
|
---|
| 1311 | } else if (isX(tp)) {
|
---|
| 1312 | to = '<' + tM + '.' + (+tm + 1) + '.0'
|
---|
| 1313 | } else if (tpr) {
|
---|
| 1314 | to = '<=' + tM + '.' + tm + '.' + tp + '-' + tpr
|
---|
| 1315 | } else {
|
---|
| 1316 | to = '<=' + to
|
---|
| 1317 | }
|
---|
| 1318 |
|
---|
| 1319 | return (from + ' ' + to).trim()
|
---|
| 1320 | }
|
---|
| 1321 |
|
---|
| 1322 | // if ANY of the sets match ALL of its comparators, then pass
|
---|
| 1323 | Range.prototype.test = function (version) {
|
---|
| 1324 | if (!version) {
|
---|
| 1325 | return false
|
---|
| 1326 | }
|
---|
| 1327 |
|
---|
| 1328 | if (typeof version === 'string') {
|
---|
| 1329 | try {
|
---|
| 1330 | version = new SemVer(version, this.options)
|
---|
| 1331 | } catch (er) {
|
---|
| 1332 | return false
|
---|
| 1333 | }
|
---|
| 1334 | }
|
---|
| 1335 |
|
---|
| 1336 | for (var i = 0; i < this.set.length; i++) {
|
---|
| 1337 | if (testSet(this.set[i], version, this.options)) {
|
---|
| 1338 | return true
|
---|
| 1339 | }
|
---|
| 1340 | }
|
---|
| 1341 | return false
|
---|
| 1342 | }
|
---|
| 1343 |
|
---|
| 1344 | function testSet (set, version, options) {
|
---|
| 1345 | for (var i = 0; i < set.length; i++) {
|
---|
| 1346 | if (!set[i].test(version)) {
|
---|
| 1347 | return false
|
---|
| 1348 | }
|
---|
| 1349 | }
|
---|
| 1350 |
|
---|
| 1351 | if (version.prerelease.length && !options.includePrerelease) {
|
---|
| 1352 | // Find the set of versions that are allowed to have prereleases
|
---|
| 1353 | // For example, ^1.2.3-pr.1 desugars to >=1.2.3-pr.1 <2.0.0
|
---|
| 1354 | // That should allow `1.2.3-pr.2` to pass.
|
---|
| 1355 | // However, `1.2.4-alpha.notready` should NOT be allowed,
|
---|
| 1356 | // even though it's within the range set by the comparators.
|
---|
| 1357 | for (i = 0; i < set.length; i++) {
|
---|
| 1358 | debug(set[i].semver)
|
---|
| 1359 | if (set[i].semver === ANY) {
|
---|
| 1360 | continue
|
---|
| 1361 | }
|
---|
| 1362 |
|
---|
| 1363 | if (set[i].semver.prerelease.length > 0) {
|
---|
| 1364 | var allowed = set[i].semver
|
---|
| 1365 | if (allowed.major === version.major &&
|
---|
| 1366 | allowed.minor === version.minor &&
|
---|
| 1367 | allowed.patch === version.patch) {
|
---|
| 1368 | return true
|
---|
| 1369 | }
|
---|
| 1370 | }
|
---|
| 1371 | }
|
---|
| 1372 |
|
---|
| 1373 | // Version has a -pre, but it's not one of the ones we like.
|
---|
| 1374 | return false
|
---|
| 1375 | }
|
---|
| 1376 |
|
---|
| 1377 | return true
|
---|
| 1378 | }
|
---|
| 1379 |
|
---|
| 1380 | exports.satisfies = satisfies
|
---|
| 1381 | function satisfies (version, range, options) {
|
---|
| 1382 | try {
|
---|
| 1383 | range = new Range(range, options)
|
---|
| 1384 | } catch (er) {
|
---|
| 1385 | return false
|
---|
| 1386 | }
|
---|
| 1387 | return range.test(version)
|
---|
| 1388 | }
|
---|
| 1389 |
|
---|
| 1390 | exports.maxSatisfying = maxSatisfying
|
---|
| 1391 | function maxSatisfying (versions, range, options) {
|
---|
| 1392 | var max = null
|
---|
| 1393 | var maxSV = null
|
---|
| 1394 | try {
|
---|
| 1395 | var rangeObj = new Range(range, options)
|
---|
| 1396 | } catch (er) {
|
---|
| 1397 | return null
|
---|
| 1398 | }
|
---|
| 1399 | versions.forEach(function (v) {
|
---|
| 1400 | if (rangeObj.test(v)) {
|
---|
| 1401 | // satisfies(v, range, options)
|
---|
| 1402 | if (!max || maxSV.compare(v) === -1) {
|
---|
| 1403 | // compare(max, v, true)
|
---|
| 1404 | max = v
|
---|
| 1405 | maxSV = new SemVer(max, options)
|
---|
| 1406 | }
|
---|
| 1407 | }
|
---|
| 1408 | })
|
---|
| 1409 | return max
|
---|
| 1410 | }
|
---|
| 1411 |
|
---|
| 1412 | exports.minSatisfying = minSatisfying
|
---|
| 1413 | function minSatisfying (versions, range, options) {
|
---|
| 1414 | var min = null
|
---|
| 1415 | var minSV = null
|
---|
| 1416 | try {
|
---|
| 1417 | var rangeObj = new Range(range, options)
|
---|
| 1418 | } catch (er) {
|
---|
| 1419 | return null
|
---|
| 1420 | }
|
---|
| 1421 | versions.forEach(function (v) {
|
---|
| 1422 | if (rangeObj.test(v)) {
|
---|
| 1423 | // satisfies(v, range, options)
|
---|
| 1424 | if (!min || minSV.compare(v) === 1) {
|
---|
| 1425 | // compare(min, v, true)
|
---|
| 1426 | min = v
|
---|
| 1427 | minSV = new SemVer(min, options)
|
---|
| 1428 | }
|
---|
| 1429 | }
|
---|
| 1430 | })
|
---|
| 1431 | return min
|
---|
| 1432 | }
|
---|
| 1433 |
|
---|
| 1434 | exports.minVersion = minVersion
|
---|
| 1435 | function minVersion (range, loose) {
|
---|
| 1436 | range = new Range(range, loose)
|
---|
| 1437 |
|
---|
| 1438 | var minver = new SemVer('0.0.0')
|
---|
| 1439 | if (range.test(minver)) {
|
---|
| 1440 | return minver
|
---|
| 1441 | }
|
---|
| 1442 |
|
---|
| 1443 | minver = new SemVer('0.0.0-0')
|
---|
| 1444 | if (range.test(minver)) {
|
---|
| 1445 | return minver
|
---|
| 1446 | }
|
---|
| 1447 |
|
---|
| 1448 | minver = null
|
---|
| 1449 | for (var i = 0; i < range.set.length; ++i) {
|
---|
| 1450 | var comparators = range.set[i]
|
---|
| 1451 |
|
---|
| 1452 | comparators.forEach(function (comparator) {
|
---|
| 1453 | // Clone to avoid manipulating the comparator's semver object.
|
---|
| 1454 | var compver = new SemVer(comparator.semver.version)
|
---|
| 1455 | switch (comparator.operator) {
|
---|
| 1456 | case '>':
|
---|
| 1457 | if (compver.prerelease.length === 0) {
|
---|
| 1458 | compver.patch++
|
---|
| 1459 | } else {
|
---|
| 1460 | compver.prerelease.push(0)
|
---|
| 1461 | }
|
---|
| 1462 | compver.raw = compver.format()
|
---|
| 1463 | /* fallthrough */
|
---|
| 1464 | case '':
|
---|
| 1465 | case '>=':
|
---|
| 1466 | if (!minver || gt(minver, compver)) {
|
---|
| 1467 | minver = compver
|
---|
| 1468 | }
|
---|
| 1469 | break
|
---|
| 1470 | case '<':
|
---|
| 1471 | case '<=':
|
---|
| 1472 | /* Ignore maximum versions */
|
---|
| 1473 | break
|
---|
| 1474 | /* istanbul ignore next */
|
---|
| 1475 | default:
|
---|
| 1476 | throw new Error('Unexpected operation: ' + comparator.operator)
|
---|
| 1477 | }
|
---|
| 1478 | })
|
---|
| 1479 | }
|
---|
| 1480 |
|
---|
| 1481 | if (minver && range.test(minver)) {
|
---|
| 1482 | return minver
|
---|
| 1483 | }
|
---|
| 1484 |
|
---|
| 1485 | return null
|
---|
| 1486 | }
|
---|
| 1487 |
|
---|
| 1488 | exports.validRange = validRange
|
---|
| 1489 | function validRange (range, options) {
|
---|
| 1490 | try {
|
---|
| 1491 | // Return '*' instead of '' so that truthiness works.
|
---|
| 1492 | // This will throw if it's invalid anyway
|
---|
| 1493 | return new Range(range, options).range || '*'
|
---|
| 1494 | } catch (er) {
|
---|
| 1495 | return null
|
---|
| 1496 | }
|
---|
| 1497 | }
|
---|
| 1498 |
|
---|
| 1499 | // Determine if version is less than all the versions possible in the range
|
---|
| 1500 | exports.ltr = ltr
|
---|
| 1501 | function ltr (version, range, options) {
|
---|
| 1502 | return outside(version, range, '<', options)
|
---|
| 1503 | }
|
---|
| 1504 |
|
---|
| 1505 | // Determine if version is greater than all the versions possible in the range.
|
---|
| 1506 | exports.gtr = gtr
|
---|
| 1507 | function gtr (version, range, options) {
|
---|
| 1508 | return outside(version, range, '>', options)
|
---|
| 1509 | }
|
---|
| 1510 |
|
---|
| 1511 | exports.outside = outside
|
---|
| 1512 | function outside (version, range, hilo, options) {
|
---|
| 1513 | version = new SemVer(version, options)
|
---|
| 1514 | range = new Range(range, options)
|
---|
| 1515 |
|
---|
| 1516 | var gtfn, ltefn, ltfn, comp, ecomp
|
---|
| 1517 | switch (hilo) {
|
---|
| 1518 | case '>':
|
---|
| 1519 | gtfn = gt
|
---|
| 1520 | ltefn = lte
|
---|
| 1521 | ltfn = lt
|
---|
| 1522 | comp = '>'
|
---|
| 1523 | ecomp = '>='
|
---|
| 1524 | break
|
---|
| 1525 | case '<':
|
---|
| 1526 | gtfn = lt
|
---|
| 1527 | ltefn = gte
|
---|
| 1528 | ltfn = gt
|
---|
| 1529 | comp = '<'
|
---|
| 1530 | ecomp = '<='
|
---|
| 1531 | break
|
---|
| 1532 | default:
|
---|
| 1533 | throw new TypeError('Must provide a hilo val of "<" or ">"')
|
---|
| 1534 | }
|
---|
| 1535 |
|
---|
| 1536 | // If it satisifes the range it is not outside
|
---|
| 1537 | if (satisfies(version, range, options)) {
|
---|
| 1538 | return false
|
---|
| 1539 | }
|
---|
| 1540 |
|
---|
| 1541 | // From now on, variable terms are as if we're in "gtr" mode.
|
---|
| 1542 | // but note that everything is flipped for the "ltr" function.
|
---|
| 1543 |
|
---|
| 1544 | for (var i = 0; i < range.set.length; ++i) {
|
---|
| 1545 | var comparators = range.set[i]
|
---|
| 1546 |
|
---|
| 1547 | var high = null
|
---|
| 1548 | var low = null
|
---|
| 1549 |
|
---|
| 1550 | comparators.forEach(function (comparator) {
|
---|
| 1551 | if (comparator.semver === ANY) {
|
---|
| 1552 | comparator = new Comparator('>=0.0.0')
|
---|
| 1553 | }
|
---|
| 1554 | high = high || comparator
|
---|
| 1555 | low = low || comparator
|
---|
| 1556 | if (gtfn(comparator.semver, high.semver, options)) {
|
---|
| 1557 | high = comparator
|
---|
| 1558 | } else if (ltfn(comparator.semver, low.semver, options)) {
|
---|
| 1559 | low = comparator
|
---|
| 1560 | }
|
---|
| 1561 | })
|
---|
| 1562 |
|
---|
| 1563 | // If the edge version comparator has a operator then our version
|
---|
| 1564 | // isn't outside it
|
---|
| 1565 | if (high.operator === comp || high.operator === ecomp) {
|
---|
| 1566 | return false
|
---|
| 1567 | }
|
---|
| 1568 |
|
---|
| 1569 | // If the lowest version comparator has an operator and our version
|
---|
| 1570 | // is less than it then it isn't higher than the range
|
---|
| 1571 | if ((!low.operator || low.operator === comp) &&
|
---|
| 1572 | ltefn(version, low.semver)) {
|
---|
| 1573 | return false
|
---|
| 1574 | } else if (low.operator === ecomp && ltfn(version, low.semver)) {
|
---|
| 1575 | return false
|
---|
| 1576 | }
|
---|
| 1577 | }
|
---|
| 1578 | return true
|
---|
| 1579 | }
|
---|
| 1580 |
|
---|
| 1581 | exports.prerelease = prerelease
|
---|
| 1582 | function prerelease (version, options) {
|
---|
| 1583 | var parsed = parse(version, options)
|
---|
| 1584 | return (parsed && parsed.prerelease.length) ? parsed.prerelease : null
|
---|
| 1585 | }
|
---|
| 1586 |
|
---|
| 1587 | exports.intersects = intersects
|
---|
| 1588 | function intersects (r1, r2, options) {
|
---|
| 1589 | r1 = new Range(r1, options)
|
---|
| 1590 | r2 = new Range(r2, options)
|
---|
| 1591 | return r1.intersects(r2)
|
---|
| 1592 | }
|
---|
| 1593 |
|
---|
| 1594 | exports.coerce = coerce
|
---|
| 1595 | function coerce (version, options) {
|
---|
| 1596 | if (version instanceof SemVer) {
|
---|
| 1597 | return version
|
---|
| 1598 | }
|
---|
| 1599 |
|
---|
| 1600 | if (typeof version === 'number') {
|
---|
| 1601 | version = String(version)
|
---|
| 1602 | }
|
---|
| 1603 |
|
---|
| 1604 | if (typeof version !== 'string') {
|
---|
| 1605 | return null
|
---|
| 1606 | }
|
---|
| 1607 |
|
---|
| 1608 | options = options || {}
|
---|
| 1609 |
|
---|
| 1610 | var match = null
|
---|
| 1611 | if (!options.rtl) {
|
---|
| 1612 | match = version.match(safeRe[t.COERCE])
|
---|
| 1613 | } else {
|
---|
| 1614 | // Find the right-most coercible string that does not share
|
---|
| 1615 | // a terminus with a more left-ward coercible string.
|
---|
| 1616 | // Eg, '1.2.3.4' wants to coerce '2.3.4', not '3.4' or '4'
|
---|
| 1617 | //
|
---|
| 1618 | // Walk through the string checking with a /g regexp
|
---|
| 1619 | // Manually set the index so as to pick up overlapping matches.
|
---|
| 1620 | // Stop when we get a match that ends at the string end, since no
|
---|
| 1621 | // coercible string can be more right-ward without the same terminus.
|
---|
| 1622 | var next
|
---|
| 1623 | while ((next = safeRe[t.COERCERTL].exec(version)) &&
|
---|
| 1624 | (!match || match.index + match[0].length !== version.length)
|
---|
| 1625 | ) {
|
---|
| 1626 | if (!match ||
|
---|
| 1627 | next.index + next[0].length !== match.index + match[0].length) {
|
---|
| 1628 | match = next
|
---|
| 1629 | }
|
---|
| 1630 | safeRe[t.COERCERTL].lastIndex = next.index + next[1].length + next[2].length
|
---|
| 1631 | }
|
---|
| 1632 | // leave it in a clean state
|
---|
| 1633 | safeRe[t.COERCERTL].lastIndex = -1
|
---|
| 1634 | }
|
---|
| 1635 |
|
---|
| 1636 | if (match === null) {
|
---|
| 1637 | return null
|
---|
| 1638 | }
|
---|
| 1639 |
|
---|
| 1640 | return parse(match[2] +
|
---|
| 1641 | '.' + (match[3] || '0') +
|
---|
| 1642 | '.' + (match[4] || '0'), options)
|
---|
| 1643 | }
|
---|