semver-utils.js/README.md

75 lines
1.5 KiB
Markdown
Raw Normal View History

2013-04-24 23:38:53 +00:00
## 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