balena-semver 3.0.9 → 3.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +456 -456
- package/package.json +10 -5
package/README.md
CHANGED
|
@@ -115,173 +115,173 @@ If both values are invalid semver values, then the values are compared alphabeti
|
|
|
115
115
|
should not throw when provided with a version.
|
|
116
116
|
|
|
117
117
|
```js
|
|
118
|
-
|
|
119
|
-
|
|
118
|
+
versions.forEach(function (version) {
|
|
119
|
+
chai.expect(function () { return semver.compare(version, version); }).to.not.throw();
|
|
120
120
|
});
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
should correctly sort lists of versions.
|
|
124
124
|
|
|
125
125
|
```js
|
|
126
|
-
|
|
126
|
+
chai.expect(versions.slice().sort(semver.compare)).to.eql(versions);
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
should correctly compare versions with leading 0s.
|
|
130
130
|
|
|
131
131
|
```js
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
132
|
+
chai.expect(semver.compare('18.04.1', '18.4.1')).to.equal(0);
|
|
133
|
+
chai.expect(semver.compare('18.04.2', '18.4.1')).to.equal(1);
|
|
134
|
+
chai.expect(semver.compare('18.04.1', '18.4.2')).to.equal(-1);
|
|
135
135
|
```
|
|
136
136
|
|
|
137
137
|
should correctly compare valid semver values.
|
|
138
138
|
|
|
139
139
|
```js
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
140
|
+
chai.expect(semver.compare('2.0.5', '1.16.0')).to.equal(1);
|
|
141
|
+
chai.expect(semver.compare('2.0.5', '2.0.5')).to.equal(0);
|
|
142
|
+
chai.expect(semver.compare('1.16.0', '2.0.5')).to.equal(-1);
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
should correctly compare valid semver values to Resin formatted versions.
|
|
146
146
|
|
|
147
147
|
```js
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
148
|
+
chai.expect(semver.compare('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(1);
|
|
149
|
+
chai.expect(semver.compare('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(-1);
|
|
150
|
+
chai.expect(semver.compare('1.16.0', 'Resin OS v1.16.0')).to.equal(0);
|
|
151
|
+
chai.expect(semver.compare('Resin OS 1.16.0', '2.0.2')).to.equal(-1);
|
|
152
|
+
chai.expect(semver.compare('Resin OS 1.16.0', '1.16.0')).to.equal(0);
|
|
153
|
+
chai.expect(semver.compare('Resin OS 2.0.2', '1.16.0')).to.equal(1);
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
should correctly compare Resin formatted versions.
|
|
157
157
|
|
|
158
158
|
```js
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
159
|
+
chai.expect(semver.compare('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(1);
|
|
160
|
+
chai.expect(semver.compare('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(-1);
|
|
161
|
+
chai.expect(semver.compare('Resin OS 1.16.0', 'Resin OS 1.16.0')).to.equal(0);
|
|
162
162
|
```
|
|
163
163
|
|
|
164
164
|
should correctly compare Balena formatted versions.
|
|
165
165
|
|
|
166
166
|
```js
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
167
|
+
chai.expect(semver.compare('balenaOS 2.0.5', 'balenaOS 2.0.2+rev2')).to.equal(1);
|
|
168
|
+
chai.expect(semver.compare('balenaOS 1.16.0', 'balenaOS 2.0.2 (prod)')).to.equal(-1);
|
|
169
|
+
chai.expect(semver.compare('balenaOS 1.16.0', 'balenaOS 1.16.0')).to.equal(0);
|
|
170
170
|
```
|
|
171
171
|
|
|
172
172
|
should correctly compare Balena formatted versions to Resin formatted versions.
|
|
173
173
|
|
|
174
174
|
```js
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
175
|
+
chai.expect(semver.compare('balenaOS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(1);
|
|
176
|
+
chai.expect(semver.compare('balenaOS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(-1);
|
|
177
|
+
chai.expect(semver.compare('balenaOS 1.16.0', 'Resin OS 1.16.0')).to.equal(0);
|
|
178
178
|
```
|
|
179
179
|
|
|
180
180
|
should correctly compare Balena formatted versions with leading 0s.
|
|
181
181
|
|
|
182
182
|
```js
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
183
|
+
chai.expect(semver.compare('balenaOS v2.0.2+rev2', 'balenaOS v2.0.2+rev02')).to.equal(0);
|
|
184
|
+
chai.expect(semver.compare('balenaOS v2.0.2+rev01', 'balenaOS v2.0.2+rev02')).to.equal(-1);
|
|
185
|
+
chai.expect(semver.compare('balenaOS v2.0.02+rev2', 'balenaOS v2.0.2+rev1')).to.equal(1);
|
|
186
186
|
```
|
|
187
187
|
|
|
188
188
|
should correctly compare invalid semver values.
|
|
189
189
|
|
|
190
190
|
```js
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
191
|
+
chai.expect(semver.compare('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(-1);
|
|
192
|
+
chai.expect(semver.compare('Linux 14.04', 'A development version')).to.equal(1);
|
|
193
|
+
chai.expect(semver.compare('Version B', 'Version A')).to.equal(1);
|
|
194
|
+
chai.expect(semver.compare('Version A', 'Version A')).to.equal(0);
|
|
195
195
|
```
|
|
196
196
|
|
|
197
197
|
should correctly compare null values.
|
|
198
198
|
|
|
199
199
|
```js
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
200
|
+
chai.expect(semver.compare('2.0.5', null)).to.equal(1);
|
|
201
|
+
chai.expect(semver.compare(null, '1.16.0')).to.equal(-1);
|
|
202
|
+
chai.expect(semver.compare('Resin OS 1.16.0', null)).to.equal(1);
|
|
203
|
+
chai.expect(semver.compare(null, 'Resin OS 1.16.0')).to.equal(-1);
|
|
204
|
+
chai.expect(semver.compare('Linux 14.04', null)).to.equal(1);
|
|
205
|
+
chai.expect(semver.compare(null, 'Linux 14.04')).to.equal(-1);
|
|
206
|
+
chai.expect(semver.compare(null, null)).to.equal(0);
|
|
207
207
|
```
|
|
208
208
|
|
|
209
209
|
should correctly compare undefined values.
|
|
210
210
|
|
|
211
211
|
```js
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
212
|
+
chai.expect(semver.compare('2.0.5', undefined)).to.equal(1);
|
|
213
|
+
chai.expect(semver.compare(undefined, '1.16.0')).to.equal(-1);
|
|
214
|
+
chai.expect(semver.compare('Resin OS 1.16.0', undefined)).to.equal(1);
|
|
215
|
+
chai.expect(semver.compare(undefined, 'Resin OS 1.16.0')).to.equal(-1);
|
|
216
|
+
chai.expect(semver.compare('Linux 14.04', undefined)).to.equal(1);
|
|
217
|
+
chai.expect(semver.compare(undefined, 'Linux 14.04')).to.equal(-1);
|
|
218
|
+
chai.expect(semver.compare(undefined, undefined)).to.equal(0);
|
|
219
219
|
```
|
|
220
220
|
|
|
221
221
|
should correctly compare "rev" values.
|
|
222
222
|
|
|
223
223
|
```js
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
224
|
+
chai.expect(semver.compare('2.0.0+rev6', '2.0.0+rev3')).to.equal(1);
|
|
225
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(1);
|
|
226
|
+
chai.expect(semver.compare('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(1);
|
|
227
|
+
chai.expect(semver.compare('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(-1);
|
|
228
|
+
chai.expect(semver.compare('2.0.0+rev3', '2.0.0+rev3')).to.equal(0);
|
|
229
|
+
chai.expect(semver.compare('2.0.0+rev1', '2.0.0+rev11')).to.equal(-1);
|
|
230
|
+
chai.expect(semver.compare('2.0.0+rev2', '2.0.0+rev11')).to.equal(-1);
|
|
231
231
|
```
|
|
232
232
|
|
|
233
233
|
should correctly compare ".dev" versions.
|
|
234
234
|
|
|
235
235
|
```js
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
236
|
+
chai.expect(semver.compare('2.0.0', '2.0.0+dev')).to.equal(1);
|
|
237
|
+
chai.expect(semver.compare('2.0.0', '2.0.0-dev')).to.equal(1);
|
|
238
|
+
chai.expect(semver.compare('2.0.0', '2.0.0.dev')).to.equal(1);
|
|
239
|
+
chai.expect(semver.compare('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(1);
|
|
240
|
+
chai.expect(semver.compare('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(-1);
|
|
241
|
+
chai.expect(semver.compare('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(0);
|
|
242
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(1);
|
|
243
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(-1);
|
|
244
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(0);
|
|
245
|
+
chai.expect(semver.compare('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(1);
|
|
246
|
+
chai.expect(semver.compare('Resin OS 2.0.0.dev', '2.0.0')).to.equal(-1);
|
|
247
|
+
chai.expect(semver.compare('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(0);
|
|
248
248
|
```
|
|
249
249
|
|
|
250
250
|
should correctly compare "(dev)" and "(prod)" versions without revisions.
|
|
251
251
|
|
|
252
252
|
```js
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
253
|
+
chai.expect(semver.compare('Resin OS 2.0.0', 'Resin OS 2.0.0 (dev)')).to.equal(1);
|
|
254
|
+
chai.expect(semver.compare('Resin OS 2.0.0', 'Resin OS 2.0.0 (prod)')).to.equal(-1);
|
|
255
|
+
chai.expect(semver.compare('Resin OS 2.0.0 (dev)', 'Resin OS 2.0.0 (prod)')).to.equal(-1);
|
|
256
|
+
chai.expect(semver.compare('Resin OS 2.0.0', 'Resin OS 2.0.0-prod')).to.equal(1);
|
|
257
|
+
chai.expect(semver.compare('Resin OS 2.0.0', 'Resin OS 2.0.0.prod')).to.equal(-1);
|
|
258
|
+
chai.expect(semver.compare('Resin OS 2.0.0', 'Resin OS 2.0.0+prod')).to.equal(-1);
|
|
259
|
+
chai.expect(semver.compare('Resin OS 2.0.0 (dev)', 'Resin OS 2.0.0+prod')).to.equal(-1);
|
|
260
|
+
chai.expect(semver.compare('Resin OS 2.0.0.dev', 'Resin OS 2.0.0+dev')).to.equal(0);
|
|
261
|
+
chai.expect(semver.compare('Resin OS 2.0.0.dev', 'Resin OS 2.0.0 (dev)')).to.equal(0);
|
|
262
|
+
chai.expect(semver.compare('Resin OS 2.0.0+dev', 'Resin OS 2.0.0 (dev)')).to.equal(0);
|
|
263
|
+
chai.expect(semver.compare('Resin OS 2.0.0.prod', 'Resin OS 2.0.0+prod')).to.equal(0);
|
|
264
|
+
chai.expect(semver.compare('Resin OS 2.0.0.prod', 'Resin OS 2.0.0 (prod)')).to.equal(0);
|
|
265
|
+
chai.expect(semver.compare('Resin OS 2.0.0+prod', 'Resin OS 2.0.0 (prod)')).to.equal(0);
|
|
266
266
|
```
|
|
267
267
|
|
|
268
268
|
should correctly compare "(dev)" and "(prod)" versions of the same revision.
|
|
269
269
|
|
|
270
270
|
```js
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
271
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3 (dev)')).to.equal(1);
|
|
272
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3 (prod)')).to.equal(-1);
|
|
273
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3 (dev)', 'Resin OS 2.0.0+rev3 (prod)')).to.equal(-1);
|
|
274
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.prod')).to.equal(-1);
|
|
275
|
+
chai.expect(semver.compare('Resin OS 2.0.0+rev3 (dev)', 'Resin OS 2.0.0+rev3+prod')).to.equal(1); // B is invalid
|
|
276
276
|
```
|
|
277
277
|
|
|
278
278
|
should correctly compare versions with underscores.
|
|
279
279
|
|
|
280
280
|
```js
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
281
|
+
chai.expect(semver.compare('6.0.1_logstream', '5.0.1')).to.equal(1);
|
|
282
|
+
chai.expect(semver.compare('6.0.1_logstream', '5.0.1_logstream')).to.equal(1);
|
|
283
|
+
chai.expect(semver.compare('6.0.1_logstream', '7.0.1')).to.equal(-1);
|
|
284
|
+
chai.expect(semver.compare('6.0.1_logstream', '6.0.1')).to.equal(1);
|
|
285
285
|
```
|
|
286
286
|
|
|
287
287
|
<a name="balena-semver-rcompare"></a>
|
|
@@ -311,96 +311,96 @@ If both values are non-null invalid semver values, then the values are compared
|
|
|
311
311
|
should not throw when provided with a version.
|
|
312
312
|
|
|
313
313
|
```js
|
|
314
|
-
|
|
315
|
-
|
|
314
|
+
versions.forEach(function (version) {
|
|
315
|
+
chai.expect(function () { return semver.rcompare(version, version); }).to.not.throw();
|
|
316
316
|
});
|
|
317
317
|
```
|
|
318
318
|
|
|
319
319
|
should correctly compare valid semver values.
|
|
320
320
|
|
|
321
321
|
```js
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
322
|
+
chai.expect(semver.rcompare('2.0.5', '1.16.0')).to.equal(-1);
|
|
323
|
+
chai.expect(semver.rcompare('2.0.5', '2.0.5')).to.equal(0);
|
|
324
|
+
chai.expect(semver.rcompare('1.16.0', '2.0.5')).to.equal(1);
|
|
325
325
|
```
|
|
326
326
|
|
|
327
327
|
should correctly compare valid semver values to Resin formatted versions.
|
|
328
328
|
|
|
329
329
|
```js
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
330
|
+
chai.expect(semver.rcompare('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(-1);
|
|
331
|
+
chai.expect(semver.rcompare('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(1);
|
|
332
|
+
chai.expect(semver.rcompare('1.16.0', 'Resin OS v1.16.0')).to.equal(0);
|
|
333
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', '2.0.2')).to.equal(1);
|
|
334
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', '1.16.0')).to.equal(0);
|
|
335
|
+
chai.expect(semver.rcompare('Resin OS 2.0.2', '1.16.0')).to.equal(-1);
|
|
336
336
|
```
|
|
337
337
|
|
|
338
338
|
should correctly compare Resin formatted versions.
|
|
339
339
|
|
|
340
340
|
```js
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
341
|
+
chai.expect(semver.rcompare('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(-1);
|
|
342
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(1);
|
|
343
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', 'Resin OS 1.16.0')).to.equal(0);
|
|
344
344
|
```
|
|
345
345
|
|
|
346
346
|
should correctly compare invalid semver values.
|
|
347
347
|
|
|
348
348
|
```js
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
349
|
+
chai.expect(semver.rcompare('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(1);
|
|
350
|
+
chai.expect(semver.rcompare('Linux 14.04', 'A development version')).to.equal(-1);
|
|
351
|
+
chai.expect(semver.rcompare('Version B', 'Version A')).to.equal(-1);
|
|
352
|
+
chai.expect(semver.rcompare('Version A', 'Version A')).to.equal(0);
|
|
353
353
|
```
|
|
354
354
|
|
|
355
355
|
should correctly compare null values.
|
|
356
356
|
|
|
357
357
|
```js
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
358
|
+
chai.expect(semver.rcompare('2.0.5', null)).to.equal(-1);
|
|
359
|
+
chai.expect(semver.rcompare(null, '1.16.0')).to.equal(1);
|
|
360
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', null)).to.equal(-1);
|
|
361
|
+
chai.expect(semver.rcompare(null, 'Resin OS 1.16.0')).to.equal(1);
|
|
362
|
+
chai.expect(semver.rcompare('Linux 14.04', null)).to.equal(-1);
|
|
363
|
+
chai.expect(semver.rcompare(null, 'Linux 14.04')).to.equal(1);
|
|
364
|
+
chai.expect(semver.rcompare(null, null)).to.equal(0);
|
|
365
365
|
```
|
|
366
366
|
|
|
367
367
|
should correctly compare undefined values.
|
|
368
368
|
|
|
369
369
|
```js
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
370
|
+
chai.expect(semver.rcompare('2.0.5', undefined)).to.equal(-1);
|
|
371
|
+
chai.expect(semver.rcompare(undefined, '1.16.0')).to.equal(1);
|
|
372
|
+
chai.expect(semver.rcompare('Resin OS 1.16.0', undefined)).to.equal(-1);
|
|
373
|
+
chai.expect(semver.rcompare(undefined, 'Resin OS 1.16.0')).to.equal(1);
|
|
374
|
+
chai.expect(semver.rcompare('Linux 14.04', undefined)).to.equal(-1);
|
|
375
|
+
chai.expect(semver.rcompare(undefined, 'Linux 14.04')).to.equal(1);
|
|
376
|
+
chai.expect(semver.rcompare(undefined, undefined)).to.equal(0);
|
|
377
377
|
```
|
|
378
378
|
|
|
379
379
|
should correctly compare "rev" values.
|
|
380
380
|
|
|
381
381
|
```js
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
382
|
+
chai.expect(semver.rcompare('2.0.0+rev6', '2.0.0+rev3')).to.equal(-1);
|
|
383
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(-1);
|
|
384
|
+
chai.expect(semver.rcompare('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(-1);
|
|
385
|
+
chai.expect(semver.rcompare('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(1);
|
|
386
|
+
chai.expect(semver.rcompare('2.0.0+rev3', '2.0.0+rev3')).to.equal(0);
|
|
387
387
|
```
|
|
388
388
|
|
|
389
389
|
should correctly compare ".dev" versions.
|
|
390
390
|
|
|
391
391
|
```js
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
392
|
+
chai.expect(semver.rcompare('2.0.0', '2.0.0+dev')).to.equal(-1);
|
|
393
|
+
chai.expect(semver.rcompare('2.0.0', '2.0.0-dev')).to.equal(-1);
|
|
394
|
+
chai.expect(semver.rcompare('2.0.0', '2.0.0.dev')).to.equal(-1);
|
|
395
|
+
chai.expect(semver.rcompare('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(-1);
|
|
396
|
+
chai.expect(semver.rcompare('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(1);
|
|
397
|
+
chai.expect(semver.rcompare('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(0);
|
|
398
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(-1);
|
|
399
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(1);
|
|
400
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(0);
|
|
401
|
+
chai.expect(semver.rcompare('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(-1);
|
|
402
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0.dev', '2.0.0')).to.equal(1);
|
|
403
|
+
chai.expect(semver.rcompare('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(0);
|
|
404
404
|
```
|
|
405
405
|
|
|
406
406
|
<a name="balena-semver-major"></a>
|
|
@@ -425,42 +425,42 @@ found, it returns null.
|
|
|
425
425
|
should correctly match valid semver versions.
|
|
426
426
|
|
|
427
427
|
```js
|
|
428
|
-
|
|
428
|
+
chai.expect(semver.major('4.5.1')).to.equal(4);
|
|
429
429
|
```
|
|
430
430
|
|
|
431
431
|
should correctly match resinOS prefixed versions.
|
|
432
432
|
|
|
433
433
|
```js
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
434
|
+
chai.expect(semver.major('Resin OS v2.0.5')).to.equal(2);
|
|
435
|
+
chai.expect(semver.major('Resin OS 2.0.2+rev2')).to.equal(2);
|
|
436
|
+
chai.expect(semver.major('Resin OS 2.0.0.rev1 (prod)')).to.equal(2);
|
|
437
|
+
chai.expect(semver.major('Resin OS 2.0.0-rc5.rev1')).to.equal(2);
|
|
438
438
|
```
|
|
439
439
|
|
|
440
440
|
should return null when version is `null`.
|
|
441
441
|
|
|
442
442
|
```js
|
|
443
|
-
|
|
443
|
+
chai.expect(semver.major(null)).to.equal(null);
|
|
444
444
|
```
|
|
445
445
|
|
|
446
446
|
should return null when version is `undefined`.
|
|
447
447
|
|
|
448
448
|
```js
|
|
449
|
-
|
|
449
|
+
chai.expect(semver.major(undefined)).to.equal(null);
|
|
450
450
|
```
|
|
451
451
|
|
|
452
452
|
should return null when the version contains no valid semver value.
|
|
453
453
|
|
|
454
454
|
```js
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
455
|
+
chai.expect(semver.major('My dev version')).to.equal(null);
|
|
456
|
+
chai.expect(semver.major('Linux 14.04')).to.equal(null);
|
|
457
|
+
chai.expect(semver.major('Software version 42.3.20170726.72bbcf8')).to.equal(null);
|
|
458
458
|
```
|
|
459
459
|
|
|
460
460
|
should correctly match underscored versions.
|
|
461
461
|
|
|
462
462
|
```js
|
|
463
|
-
|
|
463
|
+
chai.expect(semver.major('7.1.2_logstream')).to.equal(7);
|
|
464
464
|
```
|
|
465
465
|
|
|
466
466
|
<a name="balena-semver-prerelease"></a>
|
|
@@ -483,19 +483,19 @@ Returns an array of prerelease components, or null if none exist
|
|
|
483
483
|
should return an array of prerelease components when provided a semver string.
|
|
484
484
|
|
|
485
485
|
```js
|
|
486
|
-
|
|
486
|
+
chai.expect(semver.prerelease('1.16.0-alpha.1')).to.eql(['alpha', 1]);
|
|
487
487
|
```
|
|
488
488
|
|
|
489
489
|
should return null when provided with a semver string that has no prerelease segment.
|
|
490
490
|
|
|
491
491
|
```js
|
|
492
|
-
|
|
492
|
+
chai.expect(semver.prerelease('1.16.0')).to.eql(null);
|
|
493
493
|
```
|
|
494
494
|
|
|
495
495
|
should return an array of prerelease components when provided a resinOS prefixed version.
|
|
496
496
|
|
|
497
497
|
```js
|
|
498
|
-
|
|
498
|
+
chai.expect(semver.prerelease('Resin OS 2.0.0-rc5.rev1')).to.eql([
|
|
499
499
|
'rc5',
|
|
500
500
|
'rev1',
|
|
501
501
|
]);
|
|
@@ -504,27 +504,27 @@ should return an array of prerelease components when provided a resinOS prefixed
|
|
|
504
504
|
should return null when provided a resinOS prefixed version that has no prerelease segment.
|
|
505
505
|
|
|
506
506
|
```js
|
|
507
|
-
|
|
507
|
+
chai.expect(semver.prerelease('Resin OS 2.0.0')).to.equal(null);
|
|
508
508
|
```
|
|
509
509
|
|
|
510
510
|
should return null when provided with an invalid version.
|
|
511
511
|
|
|
512
512
|
```js
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
513
|
+
chai.expect(semver.prerelease('My dev version')).to.equal(null);
|
|
514
|
+
chai.expect(semver.prerelease('Linux 14.04')).to.equal(null);
|
|
515
|
+
chai.expect(semver.prerelease('Software version 42.3.20170726.72bbcf8')).to.equal(null);
|
|
516
516
|
```
|
|
517
517
|
|
|
518
518
|
should return null when provided with a null value.
|
|
519
519
|
|
|
520
520
|
```js
|
|
521
|
-
|
|
521
|
+
chai.expect(semver.prerelease(null)).to.equal(null);
|
|
522
522
|
```
|
|
523
523
|
|
|
524
524
|
should return null when provided with an undefined value.
|
|
525
525
|
|
|
526
526
|
```js
|
|
527
|
-
|
|
527
|
+
chai.expect(semver.prerelease(undefined)).to.equal(null);
|
|
528
528
|
```
|
|
529
529
|
|
|
530
530
|
<a name="balena-semver-gte"></a>
|
|
@@ -550,90 +550,90 @@ Non-semver strings are compared alphabetically.
|
|
|
550
550
|
should correctly compare valid semver values.
|
|
551
551
|
|
|
552
552
|
```js
|
|
553
|
-
|
|
554
|
-
|
|
553
|
+
chai.expect(semver.gte('2.0.5', '1.16.0')).to.equal(true);
|
|
554
|
+
chai.expect(semver.gte('1.16.0', '2.0.5')).to.equal(false);
|
|
555
555
|
```
|
|
556
556
|
|
|
557
557
|
should correctly compare valid semver values to Resin formatted versions.
|
|
558
558
|
|
|
559
559
|
```js
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
560
|
+
chai.expect(semver.gte('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
561
|
+
chai.expect(semver.gte('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
562
|
+
chai.expect(semver.gte('Resin OS 1.16.0', '2.0.2')).to.equal(false);
|
|
563
|
+
chai.expect(semver.gte('Resin OS 1.16.0', '1.16.0')).to.equal(true);
|
|
564
564
|
```
|
|
565
565
|
|
|
566
566
|
should correctly compare Resin formatted versions.
|
|
567
567
|
|
|
568
568
|
```js
|
|
569
|
-
|
|
570
|
-
|
|
569
|
+
chai.expect(semver.gte('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(true);
|
|
570
|
+
chai.expect(semver.gte('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(false);
|
|
571
571
|
```
|
|
572
572
|
|
|
573
573
|
should correctly compare invalid semver values.
|
|
574
574
|
|
|
575
575
|
```js
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
576
|
+
chai.expect(semver.gte('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
577
|
+
chai.expect(semver.gte('Linux 14.04', 'A development version')).to.equal(true);
|
|
578
|
+
chai.expect(semver.gte('Version B', 'Version A')).to.equal(true);
|
|
579
579
|
```
|
|
580
580
|
|
|
581
581
|
should correctly compare null values.
|
|
582
582
|
|
|
583
583
|
```js
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
584
|
+
chai.expect(semver.gte('2.0.5', null)).to.equal(true);
|
|
585
|
+
chai.expect(semver.gte(null, '1.16.0')).to.equal(false);
|
|
586
|
+
chai.expect(semver.gte('Resin OS 1.16.0', null)).to.equal(true);
|
|
587
|
+
chai.expect(semver.gte(null, 'Resin OS 1.16.0')).to.equal(false);
|
|
588
|
+
chai.expect(semver.gte('Linux 14.04', null)).to.equal(true);
|
|
589
|
+
chai.expect(semver.gte(null, 'Linux 14.04')).to.equal(false);
|
|
590
|
+
chai.expect(semver.gte(null, null)).to.equal(true);
|
|
591
591
|
```
|
|
592
592
|
|
|
593
593
|
should correctly compare undefined values.
|
|
594
594
|
|
|
595
595
|
```js
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
596
|
+
chai.expect(semver.gte('2.0.5', undefined)).to.equal(true);
|
|
597
|
+
chai.expect(semver.gte(undefined, '1.16.0')).to.equal(false);
|
|
598
|
+
chai.expect(semver.gte('Resin OS 1.16.0', undefined)).to.equal(true);
|
|
599
|
+
chai.expect(semver.gte(undefined, 'Resin OS 1.16.0')).to.equal(false);
|
|
600
|
+
chai.expect(semver.gte('Linux 14.04', undefined)).to.equal(true);
|
|
601
|
+
chai.expect(semver.gte(undefined, 'Linux 14.04')).to.equal(false);
|
|
602
|
+
chai.expect(semver.gte(undefined, undefined)).to.equal(true);
|
|
603
603
|
```
|
|
604
604
|
|
|
605
605
|
should correctly compare "rev" values.
|
|
606
606
|
|
|
607
607
|
```js
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
608
|
+
chai.expect(semver.gte('2.0.0+rev6', '2.0.0+rev3')).to.equal(true);
|
|
609
|
+
chai.expect(semver.gte('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
610
|
+
chai.expect(semver.gte('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
611
|
+
chai.expect(semver.gte('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(false);
|
|
612
|
+
chai.expect(semver.gte('2.0.0+rev3', '2.0.0+rev3')).to.equal(true);
|
|
613
613
|
```
|
|
614
614
|
|
|
615
615
|
should correctly compare ".dev" versions.
|
|
616
616
|
|
|
617
617
|
```js
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
618
|
+
chai.expect(semver.gte('2.0.0', '2.0.0+dev')).to.equal(true);
|
|
619
|
+
chai.expect(semver.gte('2.0.0', '2.0.0-dev')).to.equal(true);
|
|
620
|
+
chai.expect(semver.gte('2.0.0', '2.0.0.dev')).to.equal(true);
|
|
621
|
+
chai.expect(semver.gte('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(true);
|
|
622
|
+
chai.expect(semver.gte('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(false);
|
|
623
|
+
chai.expect(semver.gte('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(true);
|
|
624
|
+
chai.expect(semver.gte('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(true);
|
|
625
|
+
chai.expect(semver.gte('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
626
|
+
chai.expect(semver.gte('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(true);
|
|
627
|
+
chai.expect(semver.gte('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(true);
|
|
628
|
+
chai.expect(semver.gte('Resin OS 2.0.0.dev', '2.0.0')).to.equal(false);
|
|
629
|
+
chai.expect(semver.gte('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(true);
|
|
630
630
|
```
|
|
631
631
|
|
|
632
632
|
should correctly compare underscored versions.
|
|
633
633
|
|
|
634
634
|
```js
|
|
635
|
-
|
|
636
|
-
|
|
635
|
+
chai.expect(semver.gte('7.0.1_logstream', '7.0.1')).to.equal(true);
|
|
636
|
+
chai.expect(semver.gte('7.0.1_logstream', '7.0.1_logstream')).to.equal(true);
|
|
637
637
|
```
|
|
638
638
|
|
|
639
639
|
<a name="balena-semver-gt"></a>
|
|
@@ -659,86 +659,86 @@ Non-semver strings are compared alphabetically.
|
|
|
659
659
|
should correctly compare valid semver values.
|
|
660
660
|
|
|
661
661
|
```js
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
662
|
+
chai.expect(semver.gt('2.0.5', '1.16.0')).to.equal(true);
|
|
663
|
+
chai.expect(semver.gt('1.16.0', '2.0.5')).to.equal(false);
|
|
664
|
+
chai.expect(semver.gt('1.16.0', '1.16.0')).to.equal(false);
|
|
665
665
|
```
|
|
666
666
|
|
|
667
667
|
should correctly compare valid semver values to Resin formatted versions.
|
|
668
668
|
|
|
669
669
|
```js
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
670
|
+
chai.expect(semver.gt('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
671
|
+
chai.expect(semver.gt('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
672
|
+
chai.expect(semver.gt('Resin OS 1.16.0', '2.0.2')).to.equal(false);
|
|
673
|
+
chai.expect(semver.gt('Resin OS 1.16.0', '1.16.0')).to.equal(false);
|
|
674
674
|
```
|
|
675
675
|
|
|
676
676
|
should correctly compare Resin formatted versions.
|
|
677
677
|
|
|
678
678
|
```js
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
679
|
+
chai.expect(semver.gt('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(true);
|
|
680
|
+
chai.expect(semver.gt('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(false);
|
|
681
|
+
chai.expect(semver.gt('Resin OS 1.16.0', 'Resin OS 1.16.0')).to.equal(false);
|
|
682
682
|
```
|
|
683
683
|
|
|
684
684
|
should correctly compare invalid semver values.
|
|
685
685
|
|
|
686
686
|
```js
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
687
|
+
chai.expect(semver.gt('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
688
|
+
chai.expect(semver.gt('Linux 14.04', 'A development version')).to.equal(true);
|
|
689
|
+
chai.expect(semver.gt('Version B', 'Version A')).to.equal(true);
|
|
690
|
+
chai.expect(semver.gt('Version A', 'Version A')).to.equal(false);
|
|
691
691
|
```
|
|
692
692
|
|
|
693
693
|
should correctly compare null values.
|
|
694
694
|
|
|
695
695
|
```js
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
696
|
+
chai.expect(semver.gt('2.0.5', null)).to.equal(true);
|
|
697
|
+
chai.expect(semver.gt(null, '1.16.0')).to.equal(false);
|
|
698
|
+
chai.expect(semver.gt('Resin OS 1.16.0', null)).to.equal(true);
|
|
699
|
+
chai.expect(semver.gt(null, 'Resin OS 1.16.0')).to.equal(false);
|
|
700
|
+
chai.expect(semver.gt('Linux 14.04', null)).to.equal(true);
|
|
701
|
+
chai.expect(semver.gt(null, 'Linux 14.04')).to.equal(false);
|
|
702
|
+
chai.expect(semver.gt(null, null)).to.equal(false);
|
|
703
703
|
```
|
|
704
704
|
|
|
705
705
|
should correctly compare undefined values.
|
|
706
706
|
|
|
707
707
|
```js
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
708
|
+
chai.expect(semver.gt('2.0.5', undefined)).to.equal(true);
|
|
709
|
+
chai.expect(semver.gt(undefined, '1.16.0')).to.equal(false);
|
|
710
|
+
chai.expect(semver.gt('Resin OS 1.16.0', undefined)).to.equal(true);
|
|
711
|
+
chai.expect(semver.gt(undefined, 'Resin OS 1.16.0')).to.equal(false);
|
|
712
|
+
chai.expect(semver.gt('Linux 14.04', undefined)).to.equal(true);
|
|
713
|
+
chai.expect(semver.gt(undefined, 'Linux 14.04')).to.equal(false);
|
|
714
|
+
chai.expect(semver.gt(undefined, undefined)).to.equal(false);
|
|
715
715
|
```
|
|
716
716
|
|
|
717
717
|
should correctly compare "rev" values.
|
|
718
718
|
|
|
719
719
|
```js
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
720
|
+
chai.expect(semver.gt('2.0.0+rev6', '2.0.0+rev3')).to.equal(true);
|
|
721
|
+
chai.expect(semver.gt('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
722
|
+
chai.expect(semver.gt('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
723
|
+
chai.expect(semver.gt('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(false);
|
|
724
|
+
chai.expect(semver.gt('2.0.0+rev3', '2.0.0+rev3')).to.equal(false);
|
|
725
725
|
```
|
|
726
726
|
|
|
727
727
|
should correctly compare ".dev" versions.
|
|
728
728
|
|
|
729
729
|
```js
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
730
|
+
chai.expect(semver.gt('2.0.0', '2.0.0+dev')).to.equal(true);
|
|
731
|
+
chai.expect(semver.gt('2.0.0', '2.0.0-dev')).to.equal(true);
|
|
732
|
+
chai.expect(semver.gt('2.0.0', '2.0.0.dev')).to.equal(true);
|
|
733
|
+
chai.expect(semver.gt('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(true);
|
|
734
|
+
chai.expect(semver.gt('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(false);
|
|
735
|
+
chai.expect(semver.gt('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(false);
|
|
736
|
+
chai.expect(semver.gt('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(true);
|
|
737
|
+
chai.expect(semver.gt('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
738
|
+
chai.expect(semver.gt('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(false);
|
|
739
|
+
chai.expect(semver.gt('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(true);
|
|
740
|
+
chai.expect(semver.gt('Resin OS 2.0.0.dev', '2.0.0')).to.equal(false);
|
|
741
|
+
chai.expect(semver.gt('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(false);
|
|
742
742
|
```
|
|
743
743
|
|
|
744
744
|
<a name="balena-semver-lte"></a>
|
|
@@ -764,86 +764,86 @@ Non-semver strings are compared alphabetically.
|
|
|
764
764
|
should correctly compare valid semver values.
|
|
765
765
|
|
|
766
766
|
```js
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
767
|
+
chai.expect(semver.lte('2.0.5', '1.16.0')).to.equal(false);
|
|
768
|
+
chai.expect(semver.lte('1.16.0', '2.0.5')).to.equal(true);
|
|
769
|
+
chai.expect(semver.lte('1.16.0', '1.16.0')).to.equal(true);
|
|
770
770
|
```
|
|
771
771
|
|
|
772
772
|
should correctly compare valid semver values to Resin formatted versions.
|
|
773
773
|
|
|
774
774
|
```js
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
775
|
+
chai.expect(semver.lte('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
776
|
+
chai.expect(semver.lte('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
777
|
+
chai.expect(semver.lte('Resin OS 1.16.0', '2.0.2')).to.equal(true);
|
|
778
|
+
chai.expect(semver.lte('Resin OS 1.16.0', '1.16.0')).to.equal(true);
|
|
779
779
|
```
|
|
780
780
|
|
|
781
781
|
should correctly compare Resin formatted versions.
|
|
782
782
|
|
|
783
783
|
```js
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
784
|
+
chai.expect(semver.lte('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(false);
|
|
785
|
+
chai.expect(semver.lte('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(true);
|
|
786
|
+
chai.expect(semver.lte('Resin OS 1.16.0', 'Resin OS 1.16.0')).to.equal(true);
|
|
787
787
|
```
|
|
788
788
|
|
|
789
789
|
should correctly compare invalid semver values.
|
|
790
790
|
|
|
791
791
|
```js
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
792
|
+
chai.expect(semver.lte('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
793
|
+
chai.expect(semver.lte('Linux 14.04', 'A development version')).to.equal(false);
|
|
794
|
+
chai.expect(semver.lte('Version B', 'Version A')).to.equal(false);
|
|
795
|
+
chai.expect(semver.lte('Version A', 'Version A')).to.equal(true);
|
|
796
796
|
```
|
|
797
797
|
|
|
798
798
|
should correctly compare null values.
|
|
799
799
|
|
|
800
800
|
```js
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
801
|
+
chai.expect(semver.lte('2.0.5', null)).to.equal(false);
|
|
802
|
+
chai.expect(semver.lte(null, '1.16.0')).to.equal(true);
|
|
803
|
+
chai.expect(semver.lte('Resin OS 1.16.0', null)).to.equal(false);
|
|
804
|
+
chai.expect(semver.lte(null, 'Resin OS 1.16.0')).to.equal(true);
|
|
805
|
+
chai.expect(semver.lte('Linux 14.04', null)).to.equal(false);
|
|
806
|
+
chai.expect(semver.lte(null, 'Linux 14.04')).to.equal(true);
|
|
807
|
+
chai.expect(semver.lte(null, null)).to.equal(true);
|
|
808
808
|
```
|
|
809
809
|
|
|
810
810
|
should correctly compare undefined values.
|
|
811
811
|
|
|
812
812
|
```js
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
813
|
+
chai.expect(semver.lte('2.0.5', undefined)).to.equal(false);
|
|
814
|
+
chai.expect(semver.lte(undefined, '1.16.0')).to.equal(true);
|
|
815
|
+
chai.expect(semver.lte('Resin OS 1.16.0', undefined)).to.equal(false);
|
|
816
|
+
chai.expect(semver.lte(undefined, 'Resin OS 1.16.0')).to.equal(true);
|
|
817
|
+
chai.expect(semver.lte('Linux 14.04', undefined)).to.equal(false);
|
|
818
|
+
chai.expect(semver.lte(undefined, 'Linux 14.04')).to.equal(true);
|
|
819
|
+
chai.expect(semver.lte(undefined, undefined)).to.equal(true);
|
|
820
820
|
```
|
|
821
821
|
|
|
822
822
|
should correctly compare "rev" values.
|
|
823
823
|
|
|
824
824
|
```js
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
825
|
+
chai.expect(semver.lte('2.0.0+rev6', '2.0.0+rev3')).to.equal(false);
|
|
826
|
+
chai.expect(semver.lte('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
827
|
+
chai.expect(semver.lte('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
828
|
+
chai.expect(semver.lte('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(true);
|
|
829
|
+
chai.expect(semver.lte('2.0.0+rev3', '2.0.0+rev3')).to.equal(true);
|
|
830
830
|
```
|
|
831
831
|
|
|
832
832
|
should correctly compare ".dev" versions.
|
|
833
833
|
|
|
834
834
|
```js
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
835
|
+
chai.expect(semver.lte('2.0.0', '2.0.0+dev')).to.equal(false);
|
|
836
|
+
chai.expect(semver.lte('2.0.0', '2.0.0-dev')).to.equal(false);
|
|
837
|
+
chai.expect(semver.lte('2.0.0', '2.0.0.dev')).to.equal(false);
|
|
838
|
+
chai.expect(semver.lte('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(false);
|
|
839
|
+
chai.expect(semver.lte('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(true);
|
|
840
|
+
chai.expect(semver.lte('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(true);
|
|
841
|
+
chai.expect(semver.lte('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(false);
|
|
842
|
+
chai.expect(semver.lte('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
843
|
+
chai.expect(semver.lte('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(true);
|
|
844
|
+
chai.expect(semver.lte('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(false);
|
|
845
|
+
chai.expect(semver.lte('Resin OS 2.0.0.dev', '2.0.0')).to.equal(true);
|
|
846
|
+
chai.expect(semver.lte('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(true);
|
|
847
847
|
```
|
|
848
848
|
|
|
849
849
|
<a name="balena-semver-lt"></a>
|
|
@@ -869,86 +869,86 @@ Non-semver strings are compared alphabetically.
|
|
|
869
869
|
should correctly compare valid semver values.
|
|
870
870
|
|
|
871
871
|
```js
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
872
|
+
chai.expect(semver.lt('2.0.5', '1.16.0')).to.equal(false);
|
|
873
|
+
chai.expect(semver.lt('1.16.0', '2.0.5')).to.equal(true);
|
|
874
|
+
chai.expect(semver.lt('1.16.0', '1.16.0')).to.equal(false);
|
|
875
875
|
```
|
|
876
876
|
|
|
877
877
|
should correctly compare valid semver values to Resin formatted versions.
|
|
878
878
|
|
|
879
879
|
```js
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
880
|
+
chai.expect(semver.lt('2.0.5', 'Resin OS v2.0.2+rev2')).to.equal(false);
|
|
881
|
+
chai.expect(semver.lt('1.16.0', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
882
|
+
chai.expect(semver.lt('Resin OS 1.16.0', '2.0.2')).to.equal(true);
|
|
883
|
+
chai.expect(semver.lt('Resin OS 1.16.0', '1.16.0')).to.equal(false);
|
|
884
884
|
```
|
|
885
885
|
|
|
886
886
|
should correctly compare Resin formatted versions.
|
|
887
887
|
|
|
888
888
|
```js
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
889
|
+
chai.expect(semver.lt('Resin OS 2.0.5', 'Resin OS 2.0.2+rev2')).to.equal(false);
|
|
890
|
+
chai.expect(semver.lt('Resin OS 1.16.0', 'Resin OS 2.0.2 (prod)')).to.equal(true);
|
|
891
|
+
chai.expect(semver.lt('Resin OS 1.16.0', 'Resin OS 1.16.0')).to.equal(false);
|
|
892
892
|
```
|
|
893
893
|
|
|
894
894
|
should correctly compare invalid semver values.
|
|
895
895
|
|
|
896
896
|
```js
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
897
|
+
chai.expect(semver.lt('Linux 14.04', 'Resin OS v2.0.2+rev2')).to.equal(true);
|
|
898
|
+
chai.expect(semver.lt('Linux 14.04', 'A development version')).to.equal(false);
|
|
899
|
+
chai.expect(semver.lt('Version B', 'Version A')).to.equal(false);
|
|
900
|
+
chai.expect(semver.lt('Version A', 'Version A')).to.equal(false);
|
|
901
901
|
```
|
|
902
902
|
|
|
903
903
|
should correctly compare null values.
|
|
904
904
|
|
|
905
905
|
```js
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
906
|
+
chai.expect(semver.lt('2.0.5', null)).to.equal(false);
|
|
907
|
+
chai.expect(semver.lt(null, '1.16.0')).to.equal(true);
|
|
908
|
+
chai.expect(semver.lt('Resin OS 1.16.0', null)).to.equal(false);
|
|
909
|
+
chai.expect(semver.lt(null, 'Resin OS 1.16.0')).to.equal(true);
|
|
910
|
+
chai.expect(semver.lt('Linux 14.04', null)).to.equal(false);
|
|
911
|
+
chai.expect(semver.lt(null, 'Linux 14.04')).to.equal(true);
|
|
912
|
+
chai.expect(semver.lt(null, null)).to.equal(false);
|
|
913
913
|
```
|
|
914
914
|
|
|
915
915
|
should correctly compare undefined values.
|
|
916
916
|
|
|
917
917
|
```js
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
918
|
+
chai.expect(semver.lt('2.0.5', undefined)).to.equal(false);
|
|
919
|
+
chai.expect(semver.lt(undefined, '1.16.0')).to.equal(true);
|
|
920
|
+
chai.expect(semver.lt('Resin OS 1.16.0', undefined)).to.equal(false);
|
|
921
|
+
chai.expect(semver.lt(undefined, 'Resin OS 1.16.0')).to.equal(true);
|
|
922
|
+
chai.expect(semver.lt('Linux 14.04', undefined)).to.equal(false);
|
|
923
|
+
chai.expect(semver.lt(undefined, 'Linux 14.04')).to.equal(true);
|
|
924
|
+
chai.expect(semver.lt(undefined, undefined)).to.equal(false);
|
|
925
925
|
```
|
|
926
926
|
|
|
927
927
|
should correctly compare "rev" values.
|
|
928
928
|
|
|
929
929
|
```js
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
930
|
+
chai.expect(semver.lt('2.0.0+rev6', '2.0.0+rev3')).to.equal(false);
|
|
931
|
+
chai.expect(semver.lt('Resin OS 2.0.0+rev4', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
932
|
+
chai.expect(semver.lt('2.0.0+rev6', 'Resin OS 2.0.0+rev3')).to.equal(false);
|
|
933
|
+
chai.expect(semver.lt('2.0.0+rev2', 'Resin OS 2.0.0+rev5')).to.equal(true);
|
|
934
|
+
chai.expect(semver.lt('2.0.0+rev3', '2.0.0+rev3')).to.equal(false);
|
|
935
935
|
```
|
|
936
936
|
|
|
937
937
|
should correctly compare ".dev" versions.
|
|
938
938
|
|
|
939
939
|
```js
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
940
|
+
chai.expect(semver.lt('2.0.0', '2.0.0+dev')).to.equal(false);
|
|
941
|
+
chai.expect(semver.lt('2.0.0', '2.0.0-dev')).to.equal(false);
|
|
942
|
+
chai.expect(semver.lt('2.0.0', '2.0.0.dev')).to.equal(false);
|
|
943
|
+
chai.expect(semver.lt('2.0.0+rev6', '2.0.0+rev6.dev')).to.equal(false);
|
|
944
|
+
chai.expect(semver.lt('2.0.0+rev6.dev', '2.0.0+rev6')).to.equal(true);
|
|
945
|
+
chai.expect(semver.lt('2.0.0+rev6.dev', '2.0.0+rev6.dev')).to.equal(false);
|
|
946
|
+
chai.expect(semver.lt('Resin OS 2.0.0+rev3', 'Resin OS 2.0.0+rev3.dev')).to.equal(false);
|
|
947
|
+
chai.expect(semver.lt('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3')).to.equal(true);
|
|
948
|
+
chai.expect(semver.lt('Resin OS 2.0.0+rev3.dev', 'Resin OS 2.0.0+rev3.dev')).to.equal(false);
|
|
949
|
+
chai.expect(semver.lt('2.0.0', 'Resin OS 2.0.0.dev')).to.equal(false);
|
|
950
|
+
chai.expect(semver.lt('Resin OS 2.0.0.dev', '2.0.0')).to.equal(true);
|
|
951
|
+
chai.expect(semver.lt('Resin OS 2.0.0.dev', '2.0.0.dev')).to.equal(false);
|
|
952
952
|
```
|
|
953
953
|
|
|
954
954
|
<a name="balena-semver-satisfies"></a>
|
|
@@ -973,47 +973,47 @@ This method will always return false if the provided version doesn't contain a v
|
|
|
973
973
|
should correctly evaluate valid semver values.
|
|
974
974
|
|
|
975
975
|
```js
|
|
976
|
-
|
|
977
|
-
|
|
976
|
+
chai.expect(semver.satisfies('2.0.5', '^2.0.0')).to.equal(true);
|
|
977
|
+
chai.expect(semver.satisfies('1.16.0', '^2.0.0')).to.equal(false);
|
|
978
978
|
```
|
|
979
979
|
|
|
980
980
|
should correctly evaluate Resin formatted versions.
|
|
981
981
|
|
|
982
982
|
```js
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
983
|
+
chai.expect(semver.satisfies('Resin OS 2.0.2+rev2', '^2.0.0')).to.equal(true);
|
|
984
|
+
chai.expect(semver.satisfies('Resin OS 2.0.2 (prod)', '^2.0.0')).to.equal(true);
|
|
985
|
+
chai.expect(semver.satisfies('Resin OS 1.16.0', '^2.0.0')).to.equal(false);
|
|
986
986
|
```
|
|
987
987
|
|
|
988
988
|
should correctly evaluate versions with leading zeros.
|
|
989
989
|
|
|
990
990
|
```js
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
991
|
+
chai.expect(semver.satisfies('2019.04.0', '~2019.04.0')).to.equal(true);
|
|
992
|
+
chai.expect(semver.satisfies('2019.04.1', '~2019.04.0')).to.equal(true);
|
|
993
|
+
chai.expect(semver.satisfies('2019.05.0', '~2019.04.0')).to.equal(false);
|
|
994
|
+
chai.expect(semver.satisfies('2020.05.0', '^2019.04.0')).to.equal(false);
|
|
995
995
|
```
|
|
996
996
|
|
|
997
997
|
should always return false when provided with an invalid semver value.
|
|
998
998
|
|
|
999
999
|
```js
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1000
|
+
chai.expect(semver.satisfies('Linux 14.04', '^2.0.0')).to.equal(false);
|
|
1001
|
+
chai.expect(semver.satisfies('A development version', '^2.0.0')).to.equal(false);
|
|
1002
|
+
chai.expect(semver.satisfies('Version A', '^2.0.0')).to.equal(false);
|
|
1003
|
+
chai.expect(semver.satisfies('Linux 14.04', '*')).to.equal(false);
|
|
1004
|
+
chai.expect(semver.satisfies('Linux 14.04', '< 1.0.0')).to.equal(false);
|
|
1005
1005
|
```
|
|
1006
1006
|
|
|
1007
1007
|
should correctly evaluate null values.
|
|
1008
1008
|
|
|
1009
1009
|
```js
|
|
1010
|
-
|
|
1010
|
+
chai.expect(semver.satisfies(null, '^2.0.0')).to.equal(false);
|
|
1011
1011
|
```
|
|
1012
1012
|
|
|
1013
1013
|
should correctly evaluate undefined values.
|
|
1014
1014
|
|
|
1015
1015
|
```js
|
|
1016
|
-
|
|
1016
|
+
chai.expect(semver.satisfies(undefined, '^2.0.0')).to.equal(false);
|
|
1017
1017
|
```
|
|
1018
1018
|
|
|
1019
1019
|
<a name="balena-semver-maxsatisfying"></a>
|
|
@@ -1039,24 +1039,24 @@ Note that only version that contain a valid semver string can satisfy a range.
|
|
|
1039
1039
|
should return the correct version.
|
|
1040
1040
|
|
|
1041
1041
|
```js
|
|
1042
|
-
|
|
1043
|
-
|
|
1044
|
-
|
|
1042
|
+
chai.expect(semver.maxSatisfying(versions, '1.1.*')).to.equal('Resin OS 1.1.4');
|
|
1043
|
+
chai.expect(semver.maxSatisfying(versions, '^2.0.0')).to.equal('Resin OS 2.14.0');
|
|
1044
|
+
chai.expect(semver.maxSatisfying(versions, '< 1.0.0')).to.equal(null);
|
|
1045
1045
|
```
|
|
1046
1046
|
|
|
1047
1047
|
should return the first version found if multiple versions have equally high values.
|
|
1048
1048
|
|
|
1049
1049
|
```js
|
|
1050
|
-
|
|
1050
|
+
chai.expect(semver.maxSatisfying(['1.0.0', 'Resin OS 1.1.4', '1.1.4'], '1.1.*')).to.equal('Resin OS 1.1.4');
|
|
1051
1051
|
```
|
|
1052
1052
|
|
|
1053
1053
|
should normalize versions used in range parameter.
|
|
1054
1054
|
|
|
1055
1055
|
```js
|
|
1056
|
-
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
|
|
1056
|
+
chai.expect(semver.maxSatisfying(versions, '2.0.0.rev1')).to.equal('Resin OS 2.0.0+rev11');
|
|
1057
|
+
chai.expect(semver.maxSatisfying(versions, '^ Resin OS 2.0.0 (prod)')).to.equal('Resin OS 2.14.0');
|
|
1058
|
+
chai.expect(semver.maxSatisfying(versions, '< Resin OS v1.0.0')).to.equal(null);
|
|
1059
|
+
chai.expect(semver.maxSatisfying(versions, 'Resin OS v1.1.*')).to.equal('Resin OS 1.1.4');
|
|
1060
1060
|
```
|
|
1061
1061
|
|
|
1062
1062
|
<a name="balena-semver-parse"></a>
|
|
@@ -1081,7 +1081,7 @@ null if a valid semver string could not be found
|
|
|
1081
1081
|
should correctly parse valid semver values.
|
|
1082
1082
|
|
|
1083
1083
|
```js
|
|
1084
|
-
|
|
1084
|
+
chai.expect(semver.parse('2.0.5')).to.deep.include({
|
|
1085
1085
|
raw: '2.0.5',
|
|
1086
1086
|
major: 2,
|
|
1087
1087
|
minor: 0,
|
|
@@ -1095,7 +1095,7 @@ should correctly parse valid semver values.
|
|
|
1095
1095
|
should correctly parse Resin formatted versions.
|
|
1096
1096
|
|
|
1097
1097
|
```js
|
|
1098
|
-
|
|
1098
|
+
chai.expect(semver.parse('Resin OS v2.0.2+rev2')).to.deep.include({
|
|
1099
1099
|
raw: 'Resin OS v2.0.2+rev2',
|
|
1100
1100
|
major: 2,
|
|
1101
1101
|
minor: 0,
|
|
@@ -1104,7 +1104,7 @@ should correctly parse Resin formatted versions.
|
|
|
1104
1104
|
prerelease: [],
|
|
1105
1105
|
build: ['rev2'],
|
|
1106
1106
|
});
|
|
1107
|
-
|
|
1107
|
+
chai.expect(semver.parse('Resin OS v2.0.2 (prod)')).to.deep.include({
|
|
1108
1108
|
raw: 'Resin OS v2.0.2 (prod)',
|
|
1109
1109
|
major: 2,
|
|
1110
1110
|
minor: 0,
|
|
@@ -1113,7 +1113,7 @@ should correctly parse Resin formatted versions.
|
|
|
1113
1113
|
prerelease: [],
|
|
1114
1114
|
build: ['prod'],
|
|
1115
1115
|
});
|
|
1116
|
-
|
|
1116
|
+
chai.expect(semver.parse('Resin OS v2.0.2.prod')).to.deep.include({
|
|
1117
1117
|
raw: 'Resin OS v2.0.2.prod',
|
|
1118
1118
|
major: 2,
|
|
1119
1119
|
minor: 0,
|
|
@@ -1122,7 +1122,7 @@ should correctly parse Resin formatted versions.
|
|
|
1122
1122
|
prerelease: [],
|
|
1123
1123
|
build: ['prod'],
|
|
1124
1124
|
});
|
|
1125
|
-
|
|
1125
|
+
chai.expect(semver.parse('Resin OS 2.0.0-rc5.rev1')).to.deep.include({
|
|
1126
1126
|
raw: 'Resin OS 2.0.0-rc5.rev1',
|
|
1127
1127
|
major: 2,
|
|
1128
1128
|
minor: 0,
|
|
@@ -1131,7 +1131,7 @@ should correctly parse Resin formatted versions.
|
|
|
1131
1131
|
prerelease: ['rc5', 'rev1'],
|
|
1132
1132
|
build: [],
|
|
1133
1133
|
});
|
|
1134
|
-
|
|
1134
|
+
chai.expect(semver.parse('Resin OS 2.3.0+rev1.prod')).to.deep.include({
|
|
1135
1135
|
raw: 'Resin OS 2.3.0+rev1.prod',
|
|
1136
1136
|
major: 2,
|
|
1137
1137
|
minor: 3,
|
|
@@ -1140,7 +1140,7 @@ should correctly parse Resin formatted versions.
|
|
|
1140
1140
|
prerelease: [],
|
|
1141
1141
|
build: ['rev1', 'prod'],
|
|
1142
1142
|
});
|
|
1143
|
-
|
|
1143
|
+
chai.expect(semver.parse('Resin OS v2.3.0-a.b.c (prod)')).to.deep.include({
|
|
1144
1144
|
raw: 'Resin OS v2.3.0-a.b.c (prod)',
|
|
1145
1145
|
major: 2,
|
|
1146
1146
|
minor: 3,
|
|
@@ -1149,7 +1149,7 @@ should correctly parse Resin formatted versions.
|
|
|
1149
1149
|
prerelease: ['a', 'b', 'c'],
|
|
1150
1150
|
build: ['prod'],
|
|
1151
1151
|
});
|
|
1152
|
-
|
|
1152
|
+
chai.expect(semver.parse('Resin OS 2.3.0-a.b.c+d.e.f (prod)')).to.deep.include({
|
|
1153
1153
|
raw: 'Resin OS 2.3.0-a.b.c+d.e.f (prod)',
|
|
1154
1154
|
major: 2,
|
|
1155
1155
|
minor: 3,
|
|
@@ -1158,7 +1158,7 @@ should correctly parse Resin formatted versions.
|
|
|
1158
1158
|
prerelease: ['a', 'b', 'c'],
|
|
1159
1159
|
build: ['d', 'e', 'f', 'prod'],
|
|
1160
1160
|
});
|
|
1161
|
-
|
|
1161
|
+
chai.expect(semver.parse('Resin OS 2.3.0+a.b.c (prod)')).to.deep.include({
|
|
1162
1162
|
raw: 'Resin OS 2.3.0+a.b.c (prod)',
|
|
1163
1163
|
major: 2,
|
|
1164
1164
|
minor: 3,
|
|
@@ -1172,27 +1172,27 @@ should correctly parse Resin formatted versions.
|
|
|
1172
1172
|
should correctly parse invalid semver values.
|
|
1173
1173
|
|
|
1174
1174
|
```js
|
|
1175
|
-
|
|
1176
|
-
|
|
1177
|
-
|
|
1175
|
+
chai.expect(semver.parse('Linux 14.04')).to.equal(null);
|
|
1176
|
+
chai.expect(semver.parse('A development version')).to.equal(null);
|
|
1177
|
+
chai.expect(semver.parse('Version A')).to.equal(null);
|
|
1178
1178
|
```
|
|
1179
1179
|
|
|
1180
1180
|
should correctly parse null values.
|
|
1181
1181
|
|
|
1182
1182
|
```js
|
|
1183
|
-
|
|
1183
|
+
chai.expect(semver.parse(null)).to.equal(null);
|
|
1184
1184
|
```
|
|
1185
1185
|
|
|
1186
1186
|
should correctly parse undefined values.
|
|
1187
1187
|
|
|
1188
1188
|
```js
|
|
1189
|
-
|
|
1189
|
+
chai.expect(semver.parse(undefined)).to.equal(null);
|
|
1190
1190
|
```
|
|
1191
1191
|
|
|
1192
1192
|
should correctly parse versions with underscores.
|
|
1193
1193
|
|
|
1194
1194
|
```js
|
|
1195
|
-
|
|
1195
|
+
chai.expect(semver.parse('6.0.1_logstream')).to.deep.include({
|
|
1196
1196
|
raw: '6.0.1_logstream',
|
|
1197
1197
|
major: 6,
|
|
1198
1198
|
minor: 0,
|
|
@@ -1205,7 +1205,7 @@ should correctly parse versions with underscores.
|
|
|
1205
1205
|
should not parse versions with multiple underscores.
|
|
1206
1206
|
|
|
1207
1207
|
```js
|
|
1208
|
-
|
|
1208
|
+
chai.expect(semver.parse('7.0.1_logstream_test')).to.be.null;
|
|
1209
1209
|
```
|
|
1210
1210
|
|
|
1211
1211
|
<a name="balena-semver-valid"></a>
|
|
@@ -1229,25 +1229,25 @@ null if a valid semver string could not be found
|
|
|
1229
1229
|
should return null for invalid semver values.
|
|
1230
1230
|
|
|
1231
1231
|
```js
|
|
1232
|
-
|
|
1233
|
-
|
|
1234
|
-
|
|
1235
|
-
|
|
1236
|
-
|
|
1237
|
-
|
|
1232
|
+
chai.expect(semver.valid(null)).to.equal(null);
|
|
1233
|
+
chai.expect(semver.valid(undefined)).to.equal(null);
|
|
1234
|
+
chai.expect(semver.valid('')).to.equal(null);
|
|
1235
|
+
chai.expect(semver.valid('foobar')).to.equal(null);
|
|
1236
|
+
chai.expect(semver.valid('12345')).to.equal(null);
|
|
1237
|
+
chai.expect(semver.valid('1.2.3.4.5')).to.equal(null);
|
|
1238
1238
|
```
|
|
1239
1239
|
|
|
1240
1240
|
should correctly parse valid values.
|
|
1241
1241
|
|
|
1242
1242
|
```js
|
|
1243
|
-
|
|
1244
|
-
|
|
1245
|
-
|
|
1246
|
-
|
|
1247
|
-
|
|
1248
|
-
|
|
1249
|
-
|
|
1250
|
-
|
|
1243
|
+
chai.expect(semver.valid('Resin OS 1.0.0-pre')).to.equal('1.0.0-pre');
|
|
1244
|
+
chai.expect(semver.valid('Resin OS 1.0.5 (fido)')).to.equal('1.0.5');
|
|
1245
|
+
chai.expect(semver.valid('Resin OS 2.0.0-beta.8')).to.equal('2.0.0-beta.8');
|
|
1246
|
+
chai.expect(semver.valid('Resin OS 2.0.0-beta10.rev1')).to.equal('2.0.0-beta10.rev1');
|
|
1247
|
+
chai.expect(semver.valid('Resin OS 2.0.0+rev3')).to.equal('2.0.0');
|
|
1248
|
+
chai.expect(semver.valid('Resin OS 2.0.0.rev1 (prod)')).to.equal('2.0.0');
|
|
1249
|
+
chai.expect(semver.valid('Resin OS 2.0.0+rev4 (dev)')).to.equal('2.0.0');
|
|
1250
|
+
chai.expect(semver.valid('2.0.6+rev3.dev')).to.equal('2.0.6');
|
|
1251
1251
|
```
|
|
1252
1252
|
|
|
1253
1253
|
<a name="balena-semver-inc"></a>
|
|
@@ -1274,114 +1274,114 @@ null if a valid semver string could not be found
|
|
|
1274
1274
|
should return null for invalid semver values.
|
|
1275
1275
|
|
|
1276
1276
|
```js
|
|
1277
|
-
|
|
1278
|
-
|
|
1279
|
-
|
|
1280
|
-
|
|
1281
|
-
|
|
1282
|
-
|
|
1277
|
+
chai.expect(semver.inc(null, 'major')).to.equal(null);
|
|
1278
|
+
chai.expect(semver.inc(undefined, 'major')).to.equal(null);
|
|
1279
|
+
chai.expect(semver.inc('', 'major')).to.equal(null);
|
|
1280
|
+
chai.expect(semver.inc('foobar', 'major')).to.equal(null);
|
|
1281
|
+
chai.expect(semver.inc('12345', 'major')).to.equal(null);
|
|
1282
|
+
chai.expect(semver.inc('1.2.3.4.5', 'major')).to.equal(null);
|
|
1283
1283
|
```
|
|
1284
1284
|
|
|
1285
1285
|
should correctly increment valid values by a 'premajor' release.
|
|
1286
1286
|
|
|
1287
1287
|
```js
|
|
1288
|
-
|
|
1289
|
-
|
|
1290
|
-
|
|
1291
|
-
|
|
1292
|
-
|
|
1293
|
-
|
|
1294
|
-
|
|
1295
|
-
|
|
1288
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'premajor')).to.equal('2.0.0-0');
|
|
1289
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'premajor')).to.equal('2.0.0-0');
|
|
1290
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'premajor')).to.equal('3.0.0-0');
|
|
1291
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'premajor')).to.equal('3.0.0-0');
|
|
1292
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'premajor')).to.equal('3.0.0-0');
|
|
1293
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'premajor')).to.equal('3.0.0-0');
|
|
1294
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'premajor')).to.equal('3.0.0-0');
|
|
1295
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'premajor')).to.equal('3.0.0-0');
|
|
1296
1296
|
```
|
|
1297
1297
|
|
|
1298
1298
|
should correctly increment valid values by a 'preminor' release.
|
|
1299
1299
|
|
|
1300
1300
|
```js
|
|
1301
|
-
|
|
1302
|
-
|
|
1303
|
-
|
|
1304
|
-
|
|
1305
|
-
|
|
1306
|
-
|
|
1307
|
-
|
|
1308
|
-
|
|
1301
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'preminor')).to.equal('1.1.0-0');
|
|
1302
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'preminor')).to.equal('1.1.0-0');
|
|
1303
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'preminor')).to.equal('2.1.0-0');
|
|
1304
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'preminor')).to.equal('2.1.0-0');
|
|
1305
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'preminor')).to.equal('2.1.0-0');
|
|
1306
|
+
chai.expect(semver.inc('Resin OS 2.1.0.rev1 (prod)', 'preminor')).to.equal('2.2.0-0');
|
|
1307
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'preminor')).to.equal('2.1.0-0');
|
|
1308
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'preminor')).to.equal('2.1.0-0');
|
|
1309
1309
|
```
|
|
1310
1310
|
|
|
1311
1311
|
should correctly increment valid values by a 'prepatch' release.
|
|
1312
1312
|
|
|
1313
1313
|
```js
|
|
1314
|
-
|
|
1315
|
-
|
|
1316
|
-
|
|
1317
|
-
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
|
|
1321
|
-
|
|
1314
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'prepatch')).to.equal('1.0.1-0');
|
|
1315
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'prepatch')).to.equal('1.0.6-0');
|
|
1316
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'prepatch')).to.equal('2.0.1-0');
|
|
1317
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'prepatch')).to.equal('2.0.1-0');
|
|
1318
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'prepatch')).to.equal('2.0.1-0');
|
|
1319
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'prepatch')).to.equal('2.0.1-0');
|
|
1320
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'prepatch')).to.equal('2.0.1-0');
|
|
1321
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'prepatch')).to.equal('2.0.7-0');
|
|
1322
1322
|
```
|
|
1323
1323
|
|
|
1324
1324
|
should correctly increment valid values by a 'prerelease' release.
|
|
1325
1325
|
|
|
1326
1326
|
```js
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
|
|
1332
|
-
|
|
1333
|
-
|
|
1334
|
-
|
|
1327
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'prerelease')).to.equal('1.0.0-pre.0');
|
|
1328
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'prerelease')).to.equal('1.0.6-0');
|
|
1329
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'prerelease')).to.equal('2.0.0-beta.9');
|
|
1330
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'prerelease')).to.equal('2.0.0-beta10.rev1.0');
|
|
1331
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'prerelease')).to.equal('2.0.1-0');
|
|
1332
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'prerelease')).to.equal('2.0.1-0');
|
|
1333
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'prerelease')).to.equal('2.0.1-0');
|
|
1334
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'prerelease')).to.equal('2.0.7-0');
|
|
1335
1335
|
```
|
|
1336
1336
|
|
|
1337
1337
|
should correctly increment valid values by a 'major' release.
|
|
1338
1338
|
|
|
1339
1339
|
```js
|
|
1340
|
-
|
|
1341
|
-
|
|
1342
|
-
|
|
1343
|
-
|
|
1344
|
-
|
|
1345
|
-
|
|
1346
|
-
|
|
1347
|
-
|
|
1340
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'major')).to.equal('1.0.0');
|
|
1341
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'major')).to.equal('2.0.0');
|
|
1342
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'major')).to.equal('2.0.0');
|
|
1343
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'major')).to.equal('2.0.0');
|
|
1344
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'major')).to.equal('3.0.0');
|
|
1345
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'major')).to.equal('3.0.0');
|
|
1346
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'major')).to.equal('3.0.0');
|
|
1347
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'major')).to.equal('3.0.0');
|
|
1348
1348
|
```
|
|
1349
1349
|
|
|
1350
1350
|
should correctly increment valid values by a 'minor' release.
|
|
1351
1351
|
|
|
1352
1352
|
```js
|
|
1353
|
-
|
|
1354
|
-
|
|
1355
|
-
|
|
1356
|
-
|
|
1357
|
-
|
|
1358
|
-
|
|
1359
|
-
|
|
1360
|
-
|
|
1353
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'minor')).to.equal('1.0.0');
|
|
1354
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'minor')).to.equal('1.1.0');
|
|
1355
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'minor')).to.equal('2.0.0');
|
|
1356
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'minor')).to.equal('2.0.0');
|
|
1357
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'minor')).to.equal('2.1.0');
|
|
1358
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'minor')).to.equal('2.1.0');
|
|
1359
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'minor')).to.equal('2.1.0');
|
|
1360
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'minor')).to.equal('2.1.0');
|
|
1361
1361
|
```
|
|
1362
1362
|
|
|
1363
1363
|
should correctly increment valid values by a 'patch' release.
|
|
1364
1364
|
|
|
1365
1365
|
```js
|
|
1366
|
-
|
|
1367
|
-
|
|
1368
|
-
|
|
1369
|
-
|
|
1370
|
-
|
|
1371
|
-
|
|
1372
|
-
|
|
1373
|
-
|
|
1366
|
+
chai.expect(semver.inc('Resin OS 1.0.0-pre', 'patch')).to.equal('1.0.0');
|
|
1367
|
+
chai.expect(semver.inc('Resin OS 1.0.5 (fido)', 'patch')).to.equal('1.0.6');
|
|
1368
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta.8', 'patch')).to.equal('2.0.0');
|
|
1369
|
+
chai.expect(semver.inc('Resin OS 2.0.0-beta10.rev1', 'patch')).to.equal('2.0.0');
|
|
1370
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev3', 'patch')).to.equal('2.0.1');
|
|
1371
|
+
chai.expect(semver.inc('Resin OS 2.0.0.rev1 (prod)', 'patch')).to.equal('2.0.1');
|
|
1372
|
+
chai.expect(semver.inc('Resin OS 2.0.0+rev4 (dev)', 'patch')).to.equal('2.0.1');
|
|
1373
|
+
chai.expect(semver.inc('2.0.6+rev3.dev', 'patch')).to.equal('2.0.7');
|
|
1374
1374
|
```
|
|
1375
1375
|
|
|
1376
1376
|
should correctly increment 4 digit semver parts.
|
|
1377
1377
|
|
|
1378
1378
|
```js
|
|
1379
|
-
|
|
1380
|
-
|
|
1381
|
-
|
|
1382
|
-
|
|
1383
|
-
|
|
1384
|
-
|
|
1379
|
+
chai.expect(semver.inc('14.1.1000', 'patch')).to.equal('14.1.1001');
|
|
1380
|
+
chai.expect(semver.inc('14.1.1001', 'patch')).to.equal('14.1.1002');
|
|
1381
|
+
chai.expect(semver.inc('14.1000.1000', 'minor')).to.equal('14.1001.0');
|
|
1382
|
+
chai.expect(semver.inc('14.1001.1001', 'minor')).to.equal('14.1002.0');
|
|
1383
|
+
chai.expect(semver.inc('1000.1000.1000', 'major')).to.equal('1001.0.0');
|
|
1384
|
+
chai.expect(semver.inc('1001.1001.1001', 'major')).to.equal('1002.0.0');
|
|
1385
1385
|
```
|
|
1386
1386
|
|
|
1387
1387
|
|