semver.js 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191
  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. switch (argv[0]) {
  48. case 'major': case 'minor': case 'patch': case 'prerelease':
  49. case 'premajor': case 'preminor': case 'prepatch':
  50. case 'release':
  51. inc = argv.shift()
  52. break
  53. default:
  54. inc = 'patch'
  55. break
  56. }
  57. break
  58. case '--preid':
  59. identifier = argv.shift()
  60. break
  61. case '-r': case '--range':
  62. range.push(argv.shift())
  63. break
  64. case '-n':
  65. identifierBase = argv.shift()
  66. if (identifierBase === 'false') {
  67. identifierBase = false
  68. }
  69. break
  70. case '-c': case '--coerce':
  71. coerce = true
  72. break
  73. case '--rtl':
  74. rtl = true
  75. break
  76. case '--ltr':
  77. rtl = false
  78. break
  79. case '-h': case '--help': case '-?':
  80. return help()
  81. default:
  82. versions.push(a)
  83. break
  84. }
  85. }
  86. options = parseOptions({ loose, includePrerelease, rtl })
  87. versions = versions.map((v) => {
  88. return coerce ? (semver.coerce(v, options) || { version: v }).version : v
  89. }).filter((v) => {
  90. return semver.valid(v)
  91. })
  92. if (!versions.length) {
  93. return fail()
  94. }
  95. if (inc && (versions.length !== 1 || range.length)) {
  96. return failInc()
  97. }
  98. for (let i = 0, l = range.length; i < l; i++) {
  99. versions = versions.filter((v) => {
  100. return semver.satisfies(v, range[i], options)
  101. })
  102. if (!versions.length) {
  103. return fail()
  104. }
  105. }
  106. versions
  107. .sort((a, b) => semver[reverse ? 'rcompare' : 'compare'](a, b, options))
  108. .map(v => semver.clean(v, options))
  109. .map(v => inc ? semver.inc(v, inc, options, identifier, identifierBase) : v)
  110. .forEach(v => console.log(v))
  111. }
  112. const failInc = () => {
  113. console.error('--inc can only be used on a single version with no range')
  114. fail()
  115. }
  116. const fail = () => process.exit(1)
  117. const help = () => console.log(
  118. `SemVer ${version}
  119. A JavaScript implementation of the https://semver.org/ specification
  120. Copyright Isaac Z. Schlueter
  121. Usage: semver [options] <version> [<version> [...]]
  122. Prints valid versions sorted by SemVer precedence
  123. Options:
  124. -r --range <range>
  125. Print versions that match the specified range.
  126. -i --increment [<level>]
  127. Increment a version by the specified level. Level can
  128. be one of: major, minor, patch, premajor, preminor,
  129. prepatch, prerelease, or release. Default level is 'patch'.
  130. Only one version may be specified.
  131. --preid <identifier>
  132. Identifier to be used to prefix premajor, preminor,
  133. prepatch or prerelease version increments.
  134. -l --loose
  135. Interpret versions and ranges loosely
  136. -p --include-prerelease
  137. Always include prerelease versions in range matching
  138. -c --coerce
  139. Coerce a string into SemVer if possible
  140. (does not imply --loose)
  141. --rtl
  142. Coerce version strings right to left
  143. --ltr
  144. Coerce version strings left to right (default)
  145. -n <base>
  146. Base number to be used for the prerelease identifier.
  147. Can be either 0 or 1, or false to omit the number altogether.
  148. Defaults to 0.
  149. Program exits successfully if any valid version satisfies
  150. all supplied ranges, and prints all satisfying versions.
  151. If no satisfying versions are found, then exits failure.
  152. Versions are printed in ascending order, so supplying
  153. multiple versions to the utility will just sort them.`)
  154. main()