semver.js 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195
  1. #!/usr/bin/env node
  2. // Standalone semver comparison program.
  3. // Exits successfully and prints matching version(s) if
  4. // any supplied version is valid and passes all tests.
  5. 'use strict'
  6. const argv = process.argv.slice(2)
  7. let versions = []
  8. const range = []
  9. let inc = null
  10. const version = require('../package.json').version
  11. let loose = false
  12. let includePrerelease = false
  13. let coerce = false
  14. let rtl = false
  15. let identifier
  16. let identifierBase
  17. const semver = require('../')
  18. const parseOptions = require('../internal/parse-options')
  19. let reverse = false
  20. let options = {}
  21. const main = () => {
  22. if (!argv.length) {
  23. return help()
  24. }
  25. while (argv.length) {
  26. let a = argv.shift()
  27. const indexOfEqualSign = a.indexOf('=')
  28. if (indexOfEqualSign !== -1) {
  29. const value = a.slice(indexOfEqualSign + 1)
  30. a = a.slice(0, indexOfEqualSign)
  31. argv.unshift(value)
  32. }
  33. switch (a) {
  34. case '-rv': case '-rev': case '--rev': case '--reverse':
  35. reverse = true
  36. break
  37. case '-l': case '--loose':
  38. loose = true
  39. break
  40. case '-p': case '--include-prerelease':
  41. includePrerelease = true
  42. break
  43. case '-v': case '--version':
  44. versions.push(argv.shift())
  45. break
  46. case '-i': case '--inc': case '--increment':
  47. if (semver.RELEASE_TYPES.includes(argv[0]) || (argv[0] === 'release')) {
  48. inc = { value: argv.shift(), maybeErrantValue: null, option: a }
  49. } else {
  50. inc = { value: 'patch', maybeErrantValue: argv[0], option: a }
  51. }
  52. break
  53. case '--preid':
  54. identifier = argv.shift()
  55. break
  56. case '-r': case '--range':
  57. range.push(argv.shift())
  58. break
  59. case '-n':
  60. identifierBase = argv.shift()
  61. if (identifierBase === 'false') {
  62. identifierBase = false
  63. }
  64. break
  65. case '-c': case '--coerce':
  66. coerce = true
  67. break
  68. case '--rtl':
  69. rtl = true
  70. break
  71. case '--ltr':
  72. rtl = false
  73. break
  74. case '-h': case '--help': case '-?':
  75. return help()
  76. default:
  77. versions.push(a)
  78. break
  79. }
  80. }
  81. options = parseOptions({ loose, includePrerelease, rtl })
  82. if (
  83. inc &&
  84. versions.includes(inc.maybeErrantValue) &&
  85. !semver.valid(inc.maybeErrantValue, options)
  86. ) {
  87. console.warn(`Invalid value for ${inc.option}; defaulting to 'patch'. This may become a failure in future major versions.`)
  88. }
  89. versions = versions.map((v) => {
  90. return coerce ? (semver.coerce(v, options) || { version: v }).version : v
  91. }).filter((v) => {
  92. return semver.valid(v, options)
  93. })
  94. if (!versions.length) {
  95. return fail()
  96. }
  97. if (inc && (versions.length !== 1 || range.length)) {
  98. return failInc()
  99. }
  100. for (let i = 0, l = range.length; i < l; i++) {
  101. versions = versions.filter((v) => {
  102. return semver.satisfies(v, range[i], options)
  103. })
  104. if (!versions.length) {
  105. return fail()
  106. }
  107. }
  108. versions
  109. .sort((a, b) => semver[reverse ? 'rcompare' : 'compare'](a, b, options))
  110. .map(v => semver.clean(v, options))
  111. .map(v => inc ? semver.inc(v, inc.value, options, identifier, identifierBase) : v)
  112. .forEach(v => console.log(v))
  113. }
  114. const failInc = () => {
  115. console.error('--inc can only be used on a single version with no range')
  116. fail()
  117. }
  118. const fail = () => process.exit(1)
  119. const help = () => console.log(
  120. `SemVer ${version}
  121. A JavaScript implementation of the https://semver.org/ specification
  122. Copyright Isaac Z. Schlueter
  123. Usage: semver [options] <version> [<version> [...]]
  124. Prints valid versions sorted by SemVer precedence
  125. Options:
  126. -r --range <range>
  127. Print versions that match the specified range.
  128. -i --increment [<level>]
  129. Increment a version by the specified level. Level can
  130. be one of: major, minor, patch, premajor, preminor,
  131. prepatch, prerelease, or release. Default level is 'patch'.
  132. Only one version may be specified.
  133. --preid <identifier>
  134. Identifier to be used to prefix premajor, preminor,
  135. prepatch or prerelease version increments.
  136. -l --loose
  137. Interpret versions and ranges loosely
  138. -p --include-prerelease
  139. Always include prerelease versions in range matching
  140. -c --coerce
  141. Coerce a string into SemVer if possible
  142. (does not imply --loose)
  143. --rtl
  144. Coerce version strings right to left
  145. --ltr
  146. Coerce version strings left to right (default)
  147. -n <base>
  148. Base number to be used for the prerelease identifier.
  149. Can be either 0 or 1, or false to omit the number altogether.
  150. Defaults to 0.
  151. Program exits successfully if any valid version satisfies
  152. all supplied ranges, and prints all satisfying versions.
  153. If no satisfying versions are found, then exits failure.
  154. Versions are printed in ascending order, so supplying
  155. multiple versions to the utility will just sort them.`)
  156. main()