75 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			75 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
|  | ## 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 |