https://github.com/cloudwalk/flex-version

Flexible version numbers inspired by Ruby's Gem::Version
https://github.com/cloudwalk/flex-version

Last synced: about 1 year ago
JSON representation

Flexible version numbers inspired by Ruby's Gem::Version

• Host: GitHub
• URL: https://github.com/cloudwalk/flex-version
• Owner: cloudwalk
• License: mit
• Created: 2021-12-21T18:36:58.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-02-07T15:08:48.000Z (over 4 years ago)
• Last Synced: 2025-03-09T08:04:23.369Z (about 1 year ago)
• Language: Rust
• Homepage:
• Size: 16.6 KB
• Stars: 0
• Watchers: 9
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Flex Version

[![Crates.io](https://img.shields.io/crates/v/flex-version?style=flat-square)](https://crates.io/crates/flex-version)

[![Crates.io](https://img.shields.io/crates/d/flex-version?style=flat-square)](https://crates.io/crates/flex-version)

[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/cloudwalk/flex-version/blob/master/LICENSE-MIT)

[![Contributors](https://img.shields.io/github/contributors/cloudwalk/flex-version?style=flat-square)](https://github.com/cloudwalk/flex-version/graphs/contributors)

A crate for flexible version numbers, mostly inspired by [Ruby's Gem::Version](https://ruby-doc.org/stdlib-3.0.3/libdoc/rubygems/rdoc/Gem/Version.html). This crate provides a flexible versioning structure which is compatible with [Semantic Versioning](https://semver.org/), and some other obscure versioning schemas used in the wild.

## Syntax

Versions are defined as components separated by dots, minus or plus signs. Each component might be either a number, or an alphabetic string. 

| Version string | Canonical representation |

|:---------------|:-------------------------|

| `0`            | `0`                      |

| `0.9`          | `0.9`                    |

| `0.9a`         | `0.9.a`                  |

| `0.9.a`        | `0.9.a`                  |

| `1.0`          | `1.0`                    |

| `1.0.5.4-b.3`  | `1.0.5.4.b.3`            |

## Ordering

Versions have a total order, which is mainly determined by the order of numeric components. Alphabetic components are inferior to all numeric components, and lexicographic between themselves. When comparing Versions, missing trailing components are treated as zero.

### Example

The following versions are ordered from lower to higher. Equal versions are presented in the same line.

1. `0.9`

2. `1.0.a.2`

3. `1.0.b1`

4. `1.0`, `1`, `1.0.0.0`

6. `1.0.1`