SemanticVersioningKit is a small library to create and parse Semantic Versioning conforming representations.

To integrate using Apple's Swift Package Manager, add the following as a dependency to your Package.swift:

dependencies: [
    .package(url: "https://github.com/alexanderwe/SemanticVersioningKit.git", from: "2.1.2")
]

Alternatively navigate to your Xcode project, select Swift Packages and click the + icon to search for SemanticVersioningKit.

If you prefer not to use any of the aforementioned dependency managers, you can integrate SemanticVersioningKit into your project manually. Simply drag the Sources Folder into your Xcode project.

At first import SemanticVersioningKit

import SemanticVersioningKit

Define a SemanticVersion instance

let version = SemanticVersion(major: 1, minor: 0, patch: 0) // "1.0.0"
let versionWithAdditions = SemanticVersion(major: 1, minor: 0, patch: 0, preReleaseIdentifiers: ["alpha", "1"], buildIdentifiers: ["exp","sha","5114f85"]) // "1.0.0-alpha.1+exp.sha.5114f85"

It is also possible to create a SemanticVersion from a String representation. Just be aware that the initialization can fail due to the used String not conforming to the Semantic Versioning format.

let version = try SemanticVersion(input: "1.0.0")
let failed = try SemanticVersion(input: ".0.0")

Contributions are very welcome 🙌