Prepare for next release

Author: baron1405

CHANGELOG.md

@@ -7,8 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [unreleased]
 
+## [5.1.0] - 2026-02-01
+
 ### Added
 
+- Support for Debian package versions
 - Improved Javadoc for a number of version parsing methods.
 
 ## [5.0.0] - 2024-10-25
@@ -115,7 +118,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Parsing versions of various formats using the `Version` class.
 
-[unreleased]: https://github.com/cthing/versionparser/compare/5.0.0...HEAD
+[unreleased]: https://github.com/cthing/versionparser/compare/5.1.0...HEAD
+[5.1.0]: https://github.com/cthing/versionparser/releases/tag/5.1.0
 [5.0.0]: https://github.com/cthing/versionparser/releases/tag/5.0.0
 [4.5.0]: https://github.com/cthing/versionparser/releases/tag/4.5.0
 [4.4.0]: https://github.com/cthing/versionparser/releases/tag/4.4.0

README.md

@@ -18,6 +18,7 @@ The following version and version constraint schemes are supported:
 * [RubyGems](https://rubygems.org/)
 * [Semantic Versioning](https://semver.org/)
 * [Calendar Versioning](https://calver.org/)
+* [Debian Package Versioning](https://www.debian.org/doc/debian-policy/ch-controlfields.html#version)
 
 ## Usage
 See the [examples folder](examples) for complete working code demonstrating the usage of this library. The
@@ -27,19 +28,20 @@ following Maven dependency:
 <dependency>
   <groupId>org.cthing</groupId>
   <artifactId>versionparser</artifactId>
-  <version>5.0.0</version>
+  <version>5.1.0</version>
 </dependency>
 ```
 or the following Gradle dependency:
 ```kotlin
-implementation("org.cthing:versionparser:5.0.0")
+implementation("org.cthing:versionparser:5.1.0")
 ```
 
 ### Versioning Overview
 
 | Scheme   | Version Factory                                   | Version Constraint Factory                    |
 |----------|---------------------------------------------------|-----------------------------------------------|
 | Calendar | `CalendarVersionScheme.parse(String)`<sup>1</sup> | N/A                                           |
+| Debian   | `DebVersionScheme.parseVersion(String)`           | `DebVersionScheme.parseConstraint(String)`    |
 | Gradle   | `GradleVersionScheme.parseVersion(String)`        | `GradleVersionScheme.parseConstraint(String)` |                           
 | Java     | `JavaVersionScheme.parseVersion(String)`          | `JavaVersionScheme.parseRange(String)`        |                           
 | Maven    | `MvnVersionScheme.parseVersion(String)`           | `MvnVersionScheme.parseConstraint(String)`    |                           
@@ -321,6 +323,34 @@ assertThat(component1.getCategory()).isEqualTo(ComponentCategory.YEAR);
 assertThat(version2.compareTo(version3)).isEqualTo(-1);
 ```
 
+### Debian Packageg Versioning
+Support is provided for parsing Debian package versions and version constraints.
+
+```java
+// Parse versions
+final DebVersion version1 = DebVersionScheme.parseVersion("22.07.5-2ubuntu1.5");
+final Version version2 = DebVersionScheme.parseVersion("20.01.2-1ubuntu1.5");
+
+// Obtain information from the parsed version
+assertThat(version1.getOriginalVersion()).isEqualTo("22.07.5-2ubuntu1.5");
+assertThat(version1.isPreRelease()).isFalse();
+assertThat(version1.getEpoch()).isEqualTo(0);
+assertThat(version1.getUpstream()).isEqualTo("22.07.5");
+assertThat(version1.getRevision()).isEqualTo("2ubuntu1.5");
+
+// Verify ordering
+assertThat(version1.compareTo(version2)).isEqualTo(1);
+
+// Parse version constraints
+final VersionConstraint constraint1 = DebVersionScheme.parseConstraint(">20");
+final VersionConstraint constraint2 = DebVersionScheme.parseConstraint(">21 <=23");
+
+// Perform constraint checking
+assertThat(constraint1.allows(version2)).isTrue();
+assertThat(constraint2.allows(version1)).isTrue();
+assertThat(constraint2.allows(version2)).isFalse();
+```
+
 ## Additional Information
 In preparation for creating this library, a [survey of many popular versioning schemes](docs/VersioningSurvey.md) was conducted.
 Among other things, this lead to the recognition that all version constraint specifications could be expressed using a single notation.

build.gradle.kts

@@ -32,7 +32,7 @@ plugins {
     alias(libs.plugins.versions)
 }
 
-version = ProjectVersion("5.1.0", BuildType.release)
+version = ProjectVersion("5.1.1", BuildType.snapshot)
 group = "org.cthing"
 description = "Parses version numbers, ranges and constraints in a variety of formats."