kaelzhang / node-semver-stable

Manage stable semver versions

semver-stable

Manage stable semver versions

Install

$ npm install semver-stable --save

Usage

var stable = require('semver-stable');

stable.is(version)

stable.is('1.2.3');        // -> true
stable.is('1.2.3-stable'); // -> false
stable.is('1.2.3-alpha');  // -> false

Returns Boolean whether the version is stable.

stable.maxSatisfying(versions, range)

• versions Array.<semver>
• range String semver range

stable.maxSatisfying([
  '1.3.3',      // not match the range
  '1.2.3-beta', // not a stable version
  '1.2.2',      // that's it
  '1.2.1',      // much older
  '1.1.2'
], '~1.2.0');
// -> 1.2.2

Returns String the latest stable version matches the range.

stable.max(versions);

Returns String the max stable version.

License

MIT

node-semver-stable's Issues

TypeError: Cannot read property 'prerelease' of null

Seems we'll get this error when the input cannot been parsed by semver ...

TypeError: Cannot read property 'prerelease' of null
at repl:1:12
at REPLServer.self.eval (repl.js:110:21)
at Interface. (repl.js:239:12)
at Interface.emit (events.js:95:17)
at Interface._onLine (readline.js:203:10)
at Interface._line (readline.js:532:8)
at Interface._ttyWrite (readline.js:761:14)
at ReadStream.onkeypress (readline.js:100:10)
at ReadStream.emit (events.js:98:17)
at emitKey (readline.js:1096:12)

Should we treat all the versions not match the semver as non-stable?

Such as 1.1, 1.2.3-3, 1.2.3.4 will be non-stable, by the code I added here:
7062182

-  return !semver_obj.prerelease.length;
+  return semver_obj === null ? false : !semver_obj.prerelease.length;

Maybe we can return a int instead of boolean? 1 as stable, 0 as unstable, -1 as unstable.

What do you think @kaelzhang ? If you don't mind, I would like to send a PR to add this change 👍