dorkbox/Version
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update README, format & change Issues section

Browse Source
This commit is contained in:
Zafar Khaja 2013-03-09 16:39:41 +04:00
parent 0472787366
commit 223fcf97d0
1 changed files with 26 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
README.md
View File

@ -1,11 +1,13 @@
Java SemVer v0.5.0 [![Build Status](https://travis-ci.org/zafarkhaja/java-semver.png)](https://travis-ci.org/zafarkhaja/java-semver) Java SemVer v0.5.0 [![Build Status](https://travis-ci.org/zafarkhaja/java-semver.png)](https://travis-ci.org/zafarkhaja/java-semver)
================== ==================
Java SemVer is a Java implementation of the Semantic Versioning Specification Java SemVer is a Java implementation of the Semantic Versioning Specification
(http://semver.org/). (http://semver.org/).
**NOTE**: The current version of the Java SemVer corresponds to the Semantic **NOTE**: The current version of the Java SemVer corresponds to the Semantic
Versioning 2.0.0-rc.1. Versioning 2.0.0-rc.1.
Versioning Versioning
---------- ----------
Java SemVer is versioned according to the SemVer Specification. Java SemVer is versioned according to the SemVer Specification.
@ -14,6 +16,7 @@ Java SemVer is versioned according to the SemVer Specification.
zero which according to the SemVer p.4 means that the library is under initial zero which according to the SemVer p.4 means that the library is under initial
development and its public API should not be considered stable. development and its public API should not be considered stable.
Usage Usage
----- -----
Below are some common use cases for the Java SemVer library. Below are some common use cases for the Java SemVer library.
@ -75,26 +78,40 @@ import com.github.zafarkhaja.semver.Version;
Version v1 = Version.valueOf("1.0.0-rc.1+build.1"); Version v1 = Version.valueOf("1.0.0-rc.1+build.1");
Version v2 = Version.valueOf("1.3.7+build.2.b8f12d7"); Version v2 = Version.valueOf("1.3.7+build.2.b8f12d7");
int result = v1.compareTo(v2); // (result < 0) int result = v1.compareTo(v2); // < 0
boolean result = v1.equals(v2); // false
boolean result = v1.equals(v2); // (result == false) boolean result = v1.greaterThan(v2); // false
boolean result = v1.greaterThanOrEqualsTo(v2); // false
boolean result = v1.greaterThan(v2); // (result == false) boolean result = v1.lessThan(v2); // true
boolean result = v1.greaterThanOrEqualsTo(v2); // (result == false) boolean result = v1.lessThanOrEqualsTo(v2); // true
boolean result = v1.lessThan(v2); // (result == true)
boolean result = v1.lessThanOrEqualsTo(v2); // (result == true)
``` ```
Issues Issues
------ ------
As of the moment, there is an ambiguity, at least for me, on what should be the As of the moment, the Specification is not clear about what should be the
behavior of pre-release and build versions when the normal version numbers are behavior of pre-release and build versions when the normal version numbers are
incremented. See the discussion page https://github.com/mojombo/semver/issues/60. incremented. Below is an example of what I mean:
```java
import com.github.zafarkhaja.semver.Version;
Version v1 = Version.valueOf("1.2.3-alpha+build");
Version v2 = v1.incrementMajorVersion();
String normal = v2.getNormalVersion(); // "2.0.0"
String preRelease = v2.getPreReleaseVersion(); // "" OR "alpha" OR "alpha1" OR "alpha2" ?
String build = v2.getBuildVersion(); // "" OR "build" OR "build1" OR "build2" ?
```
Also, see the discussion page https://github.com/mojombo/semver/issues/60.
TODO TODO
---- ----
* implement ranges * implement ranges
License License
------- -------
Java SemVer is licensed under the MIT License - see the `LICENSE` file for details. Java SemVer is licensed under the MIT License - see the `LICENSE` file for details.