Version is a one file library that provides a Version data structure, designed to represent a software version.
It follows the [Semantic Versioning 2.0 specification][1], providing validation whenever a Version is initialised.
- Simple one file implementation
- Conforms to
Comparable,HashableandCodable - Enforces versions conform to the SemVer 2.0 specification.
- MIT license
When using semantic versioning, there are strict rules about what is and is not a valid version string.
For this reasion, the standard initialiser is marked with throws, leaving it up to the caller to decide what to do if an error arrises.
let version = try Version(major: 1)
let version = try Version(major: 1, minor: 2)
let version = try Version(major: 1, minor: 2, patch: 3)
let version = try Version(major: 1, minor: 2, patch: 3, prerelease: "beta")
let version = try Version(major: 1, minor: 2, patch: 3, metadata: "qwer.asdf")
let version = try Version(major: 1, minor: 2, patch: 3, prerelease: "beta", metadata: "qwer.asdf")
let version = try Version(major: 1, minor: 2, patch: 3, prereleaseIdentifiers: ["beta"], metadataIdentifiers: ["qwer", "asdf"])You can however also initialise a Version directly from a String.
let version: Version = "1"
let version: Version = "1.2"
let version: Version = "1.2.3"
let version: Version = "1.2.3-beta"
let version: Version = "1.2.3+qwer.asdf"
let version: Version = "1.2.3-beta+qwer.asdf"This initialiser cannot fail, as that is required by the protocol ExpressibleByStringLiteral.
For this reason, if an invalid value is provided, an error message will be logged and the version 0.0.0 returned.
The Version struct conforms to the Comparable protocol.
if version1 < version2 { ... }
if version1 > version2 { ... }
if version1 == version2 { ... } // ignores metadata
if version1 === version2 { ... } // includes metadataThe following are requirements according to the semantic versioning specification. These requirements are however often overlooked, and thus are a common source of error.
- Major, minor and patch must be positive integers
- Prerelease string must only contain letters, numbers and hyphens. A period (.) can also be included to delimeter identifiers.
- Metadata string must only contain letters, numbers and hyphens. A period (.) can also be included to delimeter identifiers.
Xcode 11 enables you to easily add packages from the project settings for iOS and Mac applications.
Simply copy the link git@github.com:nathanblamires/Version.git , and paste it into the search box that appears when adding a package.
Add the following line to your Package.swift file.
package.append(.package(url: "https://github.com/nathanblamires/Version.git", from: "1.0.0"))
This is a lightweight library contained entierely in one file. For this reason, you may wish to simply copy/paste the Version file into your project.