Java npm SemVer

This is a direct port node-semver, great to have npm like semantics in a Java application.

Releases

Available in the Maven Central repository.

Maven configuration

<dependency>
<groupId>com.github.yuchi</groupId>
<artifactId>npm-semver</artifactId>
<version>1.0.0</version>
</dependency>

Gradle configuration

compile group: "com.github.yuchi", name: "npm-semver", version: "1.0.0"// or
compile "com.github.yuchi:npm-semver:1.0.0"

Quick usage

Versionversion = Version.from("1.2.3");
Rangerange = Range.from("^1.2.0");
range.test(version) // true

Full Usage

Version comparison

booleanloose = false;
Versionv1 = Version.from("1.2.3", loose);
Stringv2 = Version.from("1.3.0", loose);
v1.compareTo(v2); // -1v2.compareTo(v1); // +1v1.compareTo(v1); // 0

In Range tests

booleanloose = false;
Versionv = Version.from("1.2.3", loose);
Ranger = Range.from("^1.0.0", loose);
r.test(v); // true

Range boundaries test

booleanloose = false;
SemVer.isGreaterThenRange("1.3.0", ">1.0.0 <1.4.0", loose); // falseSemVer.isGreaterThenRange("1.5.0", ">1.0.0 <1.4.0", loose); // trueSemVer.isGreaterThenRange("0.9.0", ">1.0.0 <1.4.0", loose); // falseSemVer.isLessThenRange("1.3.0", ">1.0.0 <1.4.0", loose); // falseSemVer.isLessThenRange("1.5.0", ">1.0.0 <1.4.0", loose); // falseSemVer.isLessThenRange("0.9.0", ">1.0.0 <1.4.0", loose); // true

Sorting

List<Version> versions = newArrayList<Version>();
versions.add(Version.from("4.2.0", false));
versions.add(Version.from("1.8.0", false));
versions.add(Version.from("1.2.0", false));
versions.sort(newVersionComparator()); // { "4.2.0", "1.8.0", "1.2.0" }

Versions Stream filtering

List<Version> versions = newArrayList<Version>();
versions.add(Version.from("4.2.0", false));
versions.add(Version.from("1.8.0", false));
versions.add(Version.from("1.2.0", false));
Rangerange = Range.from(">3.0.0", false);
version.stream().filter(range::test); // { "4.2.0" }

Publishing

$ trash build
$ trash tmp
$ mkdir tmp
$ gradle clean preparePublish publish
$ gradle clean preparePublish publish # yes you need to launch it twice

License

This library, java-npm-semver, is free software ("Licensed Software"); you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; including but not limited to, the implied warranty of MERCHANTABILITY, NONINFRINGEMENT, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA