A pure Swift version class supporting major, (optional) minor, (optional) patch and (optional) build integer values.
I had the need to parse version strings from JSON and XML encoded files that met the following requirements…
- Optional minor/patch/build fields
- Extract a version from a string representation eg.
"5.6.*" - The ability to use wildcards to support simple version checks
- Version range checking (eg. v4.0 -> v5.0)
- Swift Codable support
This class uses the Numeric status versioning scheme (major.minor.patch.build). Note that you do not need to provide all fields! This class will work quite happily with just the major/minor combo if that's all you need within your project.
let lowerBound = DSFVersion(10,4)
let upperBound = DSFVersion(10,5)
assert(lowerBound < upperBound)
// Simple checks to see version ordering
let testValue = DSFVersion(10,4,5,1001)
assert(testValue > lowerBound)
assert(upperBound > testValue)
// Read from somewhere, and try to convert to a version definition
let strVer = "10.4.5"
let myVersion = try DSFVersion(strVer) // Throws if strVer isn't a compatible version string
assert(myVersion.major.value == 10)
assert(myVersion.minor.value == 4)
assert(myVersion.patch.value == 5)
// Simple comparison to verify if 'myVersion' is greater than our lower bound
assert(lowerBound < myVersion)
// See whether 'myVersion' was within our required version range
let range = lowerBound ..< upperBound
assert(range.contains(myVersion)) Use Swift Package Manager to add https://github.com/dagronf/DSFVersion to your project.
DSFVersion(10,4) ⟺ DSFVersion(10,4,0) ⟺ DSFVersion(10,4,0,0)
DSFVersion("5.6.3") ⟺ DSFVersion(5,6,3,0)A wildcard will match against its position and any lesser significant positions
DSFVersion("14.7.*") ⟺ DSFVersion(14,7,-1) // "14.7.*" is the same as 14.7.-1
DSFVersion(1, -1).contains(DSFVersion(1, 1, 101)) // 1.* contains 1.1.101
DSFVersion(6, 0, 0, -1).contains(DSFVersion(6, 0, 0, 101)) // 6.0.0.* contains 6.0.0.101DSFVersion(1, -1, 1, 101) ⟺ DSFVersion(1, -1) // 1.*.1.101 is equivalent to 1.*let v1 = DSFVersion(1) // 1
let v2 = DSFVersion(2, 56) // 2.56
let v3 = DSFVersion(15, 3, 4) // 15.3.4
let v4 = DSFVersion(15, 3, 4, 10001) // 15.3.4.10001
assert(v4.major.value == 15)
assert(v4.patch.value == 4)let w1 = DSFVersion(1, -1) // 1.*
let w2 = DSFVersion(1, 15, 9, -1) // 1.15.9.*// Version constructor throws if provided an incorrect version string
let v1 = try DSFVersion("10.2.3.*") // OK
let v1-e = try DSFVersion("10..2.3.*") // Throws VersionError.InvalidVersionString
let v2-e = try DSFVersion("1.2.0-rc.3") // Throws VersionError.InvalidVersionString
// Static creator returns nil if provided an incorrect version string
let v2 = DSFVersion.TryParse("15.4.3") // OK
let v2-e = DSFVersion.TryParse("15.a4.3") // returns nilSimple
try DSFVersion("4.5.6") == DSFVersion(4,5,6)
try DSFVersion("12.4.0") == DSFVersion(12,4)A wildcard matches any value from the wildcard position onward
DSFVersion(4,-1) == DSFVersion(4,5,6) // 4.* == 4.5.6
DSFVersion(4,5,6) == DSFVersion(4,-1) // 4.5.6 == 4.*
DSFVersion(4,5,6) == DSFVersion(4,5,-1) // 4.5.6 == 4.5.*The version class supports the standard operators <, >, ==, !=, >=, <=
// Basic comparison
let v0 = DSFVersion(10, 4)
let v1 = DSFVersion(10, 4, 4)
assert(v1 >= v0) // v1 is a later version number
// Wildcard comparison
let v3 = DSFVersion(10, 4, *)
v3.contains(v0) // 10.4.* contains the value 10.4
let v4 = DSFVersion(10, 5, *)
!v4.contains(v0) // 10.5.* DOES NOT contain the value 10.4You can use the standard Swift range operators for version checks
let range = DSFVersion(1,0) ..< DSFVersion(1,2)
XCTAssertTrue(range.contains(DSFVersion(1,1)))A range up to and including the upper bound
let range = DSFVersion(4) ... DSFVersion(5)
range.contains(DSFVersion(4)) // YES
range.contains(DSFVersion(4,5,3)) // YES
range.contains(DSFVersion(5)) // YES
range.contains(DSFVersion(5,1)) // NOA range up to but not including the upper bound
let rangeUpTo = DSFVersion(4) ..< DSFVersion(5)
range.contains(DSFVersion(3,9,100)) // NO
range.contains(DSFVersion(4)) // YES
range.contains(DSFVersion(4,5,3)) // YES
range.contains(DSFVersion(5)) // NOlet rangeAfter = DSFVersion(1,2) ... // All version numbers AFTER and including 1.2
assert(rangeAfter.contains(DSFVersion(1,2,0))
assert(rangeAfter.contains(DSFVersion(3,2))
let rangeBeforeInclusive = ... DSFVersion(7,8,1) // All version numbers BEFORE and including 7.8.1
let rangeBeforeNonInclusive = ..< DSFVersion(7,8,1) // All version numbers BEFORE not including 7.8.1Simple increment support.
let vv12 = DSFVersion(1,2) // Start with v1.2
let vv1201 = try vv12.increment(.build) // Move to v1.2.0.1
assert(vv1201 == DSFVersion(1,2,0,1))
let vv121 = try vv1201.increment(.patch) // Move from v1.2.0.1 -> v1.2.1
assert(vv121 == DSFVersion(1,2,1))
let vv13 = try vv121.increment(.minor) // Move from v1.2.1 -> v1.3
assert(vv13 == DSFVersion(1,3))
let vv2 = try vv13.increment(.major) // Move from v1.3 -> v2.0
assert(vv2 == DSFVersion(2))DSFVersion is fully codable, so you can use DSFVersion objects in your codable structs/classes.
The coded value is the string version of the version (eg. "15.3.*") so that it's easily and clearly interpreted within your coded text.
let v1 = DSFVersion(55, -1)
let data1 = try JSONEncoder().encode(v1)
// Data contains "55.*"
let v2 = DSFVersion(1,3,4,9)
let data2 = try JSONEncoder().encode(v1)
// Data contains "1.3.4.9"
let v2rec = try JSONDecoder().decode(DSFVersion.self, from: data2)
XCTAssertEqual(v2, v2rec)- Now uses
Intrather thanInt32for field values - Changed
TryParse()andinit(versionString)to throwing rather than returningnil. - Parsing a string containing multiple wildcard values (eg.
10.*.*) now throws an error. - Trim whitespace from version string before parsing (more forgiving during JSON/XML parsing)
MIT. Use it for anything you want, just attribute my work. Let me know if you do use it somewhere, I'd love to hear about it!
MIT License
Copyright (c) 2021 Darren Ford
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.