minor adjustment to readme
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / eslint / node_modules / semver / bin / semver.js
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
6 var argv = process.argv.slice(2)
7
8 var versions = []
9
10 var range = []
11
12 var inc = null
13
14 var version = require('../package.json').version
15
16 var loose = false
17
18 var includePrerelease = false
19
20 var coerce = false
21
22 var rtl = false
23
24 var identifier
25
26 var semver = require('../semver')
27
28 var reverse = false
29
30 var options = {}
31
32 main()
33
34 function main () {
35   if (!argv.length) return help()
36   while (argv.length) {
37     var a = argv.shift()
38     var indexOfEqualSign = a.indexOf('=')
39     if (indexOfEqualSign !== -1) {
40       a = a.slice(0, indexOfEqualSign)
41       argv.unshift(a.slice(indexOfEqualSign + 1))
42     }
43     switch (a) {
44       case '-rv': case '-rev': case '--rev': case '--reverse':
45         reverse = true
46         break
47       case '-l': case '--loose':
48         loose = true
49         break
50       case '-p': case '--include-prerelease':
51         includePrerelease = true
52         break
53       case '-v': case '--version':
54         versions.push(argv.shift())
55         break
56       case '-i': case '--inc': case '--increment':
57         switch (argv[0]) {
58           case 'major': case 'minor': case 'patch': case 'prerelease':
59           case 'premajor': case 'preminor': case 'prepatch':
60             inc = argv.shift()
61             break
62           default:
63             inc = 'patch'
64             break
65         }
66         break
67       case '--preid':
68         identifier = argv.shift()
69         break
70       case '-r': case '--range':
71         range.push(argv.shift())
72         break
73       case '-c': case '--coerce':
74         coerce = true
75         break
76       case '--rtl':
77         rtl = true
78         break
79       case '--ltr':
80         rtl = false
81         break
82       case '-h': case '--help': case '-?':
83         return help()
84       default:
85         versions.push(a)
86         break
87     }
88   }
89
90   var options = { loose: loose, includePrerelease: includePrerelease, rtl: rtl }
91
92   versions = versions.map(function (v) {
93     return coerce ? (semver.coerce(v, options) || { version: v }).version : v
94   }).filter(function (v) {
95     return semver.valid(v)
96   })
97   if (!versions.length) return fail()
98   if (inc && (versions.length !== 1 || range.length)) { return failInc() }
99
100   for (var i = 0, l = range.length; i < l; i++) {
101     versions = versions.filter(function (v) {
102       return semver.satisfies(v, range[i], options)
103     })
104     if (!versions.length) return fail()
105   }
106   return success(versions)
107 }
108
109 function failInc () {
110   console.error('--inc can only be used on a single version with no range')
111   fail()
112 }
113
114 function fail () { process.exit(1) }
115
116 function success () {
117   var compare = reverse ? 'rcompare' : 'compare'
118   versions.sort(function (a, b) {
119     return semver[compare](a, b, options)
120   }).map(function (v) {
121     return semver.clean(v, options)
122   }).map(function (v) {
123     return inc ? semver.inc(v, inc, options, identifier) : v
124   }).forEach(function (v, i, _) { console.log(v) })
125 }
126
127 function help () {
128   console.log(['SemVer ' + version,
129     '',
130     'A JavaScript implementation of the https://semver.org/ specification',
131     'Copyright Isaac Z. Schlueter',
132     '',
133     'Usage: semver [options] <version> [<version> [...]]',
134     'Prints valid versions sorted by SemVer precedence',
135     '',
136     'Options:',
137     '-r --range <range>',
138     '        Print versions that match the specified range.',
139     '',
140     '-i --increment [<level>]',
141     '        Increment a version by the specified level.  Level can',
142     '        be one of: major, minor, patch, premajor, preminor,',
143     "        prepatch, or prerelease.  Default level is 'patch'.",
144     '        Only one version may be specified.',
145     '',
146     '--preid <identifier>',
147     '        Identifier to be used to prefix premajor, preminor,',
148     '        prepatch or prerelease version increments.',
149     '',
150     '-l --loose',
151     '        Interpret versions and ranges loosely',
152     '',
153     '-p --include-prerelease',
154     '        Always include prerelease versions in range matching',
155     '',
156     '-c --coerce',
157     '        Coerce a string into SemVer if possible',
158     '        (does not imply --loose)',
159     '',
160     '--rtl',
161     '        Coerce version strings right to left',
162     '',
163     '--ltr',
164     '        Coerce version strings left to right (default)',
165     '',
166     'Program exits successfully if any valid version satisfies',
167     'all supplied ranges, and prints all satisfying versions.',
168     '',
169     'If no satisfying versions are found, then exits failure.',
170     '',
171     'Versions are printed in ascending order, so supplying',
172     'multiple versions to the utility will just sort them.'
173   ].join('\n'))
174 }