coolaj86
/
semver-utils.js
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

initial commit in own repo

This commit is contained in:
AJ ONeal 2013-04-24 17:38:53 -06:00
commit 38f8d713a1
4 changed files with 277 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
README.md Normal file
View File

@ -0,0 +1,74 @@
## semver-utils
Some utils that aren't provided by the mainstream `semver` module.
## API
### parse(semverString)
Turns a string such as `1.0.6-1+build-623` into the object
{
semver: '1.0.6-1+build-623'
, version: '1.0.6'
, major: '1'
, minor: '0'
, patch: '6'
, release: '1'
, build: 'build-623'
}
### stringify(semverObject)
Creates a string such as `1.0.6-1+build-623` from the object
{
major: '1'
, minor: '0'
, patch: '6'
, release: '1'
, build: 'build-623'
}
### parseRange(rangeString)
A solution to <https://github.com/isaacs/node-semver/issues/10>
Parses a range string into an array of semver objects
`>= 1.1.7 < 2.0.0 || 1.1.3'` becomes
[
{
"semver": ">= v1.1.7"
, "operator": ">="
, "major": 1
, "minor": 1
, "patch": 7
}
, {
"semver": "< v2.0.0"
, "operator": "<"
, "major": 2
, "minor": 0
, "patch": 0
}
, {
"operator": "||"
}
, {
"semver": "v1.1.3"
, "operator": "="
, "major": 1
, "minor": 1
, "patch": 3
}
]
## Obsolete Work
* https://github.com/mojombo/semver/issues/32
* https://gist.github.com/coolaj86/3012865
* https://github.com/isaacs/node-semver/issues/10
* https://github.com/mojombo/semver.org/issues/59

22
package.json Normal file
View File

@ -0,0 +1,22 @@
{
"name": "semver-utils",
"version": "1.0.0",
"description": "Tools for manipulating semver strings and objects",
"main": "semver-utils.js",
"scripts": {
"test": "node semver-utils-test.js"
},
"repository": {
"type": "git",
"url": "git://github.com/coolaj86/semver-utils.git"
},
"keywords": [
"semver",
"parse",
"parseRange",
"range"
],
"author": "AJ ONeal",
"license": "APACHEv2",
"readmeFilename": "README.md"
}

109
semver-utils-tools.js Normal file
View File

@ -0,0 +1,109 @@
(function () {
var semverutils = require('semver-utils')
;
function testParseRange() {
var str = '~1.0.0 || >= 1.1.7 < 2.0.0+build.1848 || v1.1.3 || 2.0.1-alpha.1227 || 1.0.0 - 1.0.x'
;
console.log(semverutils.parseRange(str));
console.log(semverutils.parseRange('v1.0.0'));
console.log(semverutils.parseRange('< v2.0.0'));
console.log(semverutils.parseRange('~v2.0.0'));
}
function testParse() {
var good
, bad
;
good = [
"1.0.8"
, "1.23.7"
, "2.0.0-alpha.123.abc"
, "2.0.0-alpha.123.abc+build.acebfde1284"
, "1.0.0-alpha"
, "1.0.0-alpha.1"
, "1.0.0-0.3.7"
, "1.0.0-x.7.z.92"
, "1.0.0-alpha"
, "1.0.0-alpha.1"
, "1.0.0-beta.2"
, "1.0.0-beta.11"
, "1.0.0-rc.1"
, "1.0.0-rc.1+build.1"
, "1.0.0-rc.1+build.1-b"
, "1.0.0"
, "1.0.0+0.3.7"
, "1.3.7+build"
, "1.3.7+build.2.b8f12d7"
, "1.3.7+build.11.e0f985a"
, "1.3.7+build.11.e0f9-85a"
, "1.0.0+build-acbe"
, "2.0.0+build.acebfde1284-alpha.123.abc"
];
bad = [
"v1.0.0"
, "a.b.c"
, "1"
, "1.0.0b"
, "1.0"
, "1.0.0+b[\\]^_`uild" // [,\,],^,_,` are between A-z, but not A-Za-z
, "1.0.0+build-acbe." // trailing period
, "1.0.0+build.!@#$%"
];
good.every(function (version) {
var result = semverutils.parse(version)
;
if (!result) {
throw new Error("didn't parse something that should be parseable: " + version);
}
return true;
});
bad.every(function (version) {
var result = semverutils.parse(version)
;
if (result) {
throw new Error("parsed something that should not be parseable: " + version);
}
return true;
});
console.log(semverutils.parse("a.b.c")); // null
console.log(semverutils.parse("1.0.3"));
/*
{
semver: 1.0.3
, major: 1
, minor: 0
, patch: 3
}
*/
console.log(semverutils.parse("1.0.3-rc.1+build.aef312"));
/*
{
semver: v1.0.3-rc.1+build.aef312
, major: 1
, minor: 0
, patch: 3
, build: build.aef312
, release: rc.1
}
*/
console.log(semverutils.parse("1.0.0-rc.1-1"));
console.log(semverutils.parse("1.0.0-rc.1+build.1-b"));
console.log(semverutils.parse("1.0.0-rc.1-1+build.1-b"));
console.log(semverutils.parse("2.0.0+build.acebfde1284-alpha.123.abc"));
}
testParse();
testParseRange();
}());

72
semver-utils.js Normal file
View File

@ -0,0 +1,72 @@
(function () {
"use strict";
var reSemver = /^((\d+)\.(\d+)\.(\d+))(?:-([\dA-Za-z\-]+(?:\.[\dA-Za-z\-]+)*))?(?:\+([\dA-Za-z\-]+(?:\.[\dA-Za-z\-]+)*))?$/
, reSemverRange = /\s*((\|\||\-)|(([<>~]?=?)\s*(v)?([0-9]+)(\.(x|[0-9]+))?(\.(x|[0-9]+))?(([\-+])([a-zA-Z0-9\.]+))?))\s*/g
;
function parseSemver(version) {
// semver, major, minor, patch
// https://github.com/mojombo/semver/issues/32
// https://github.com/isaacs/node-semver/issues/10
// optional v
var m = reSemver.exec(version) || []
, ver = {
semver: m[0]
, version: m[1]
, major: m[2]
, minor: m[3]
, patch: m[4]
, release: m[5]
, build: m[6]
}
;
if (0 === m.length) {
ver = null;
}
return ver;
}
function parseSemverRange(str) {
var m
, arr = []
, obj
;
function prune(key) {
if ('undefined' === typeof obj[key]) {
delete obj[key];
}
}
while (true) {
m = reSemverRange.exec(str);
if (!m) {
break;
}
obj = {
semver: m[3]
, operator: m[4] || m[2]
, major: m[6]
, minor: m[8]
, patch: m[10]
};
if ('+' === m[12]) {
obj.build = m[13];
}
if ('-' === m[12]) {
obj.release = m[13];
}
Object.keys(obj).forEach(prune);
arr.push(obj);
//console.log(m);
}
return arr;
}
module.exports.parse = parseSemver;
module.exports.parseRange = parseSemverRange;
}());