1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021 Apple Inc. and the Swift project authors
Licensed under Apache License v2.0 with Runtime Library Exception
See https://swift.org/LICENSE.txt for license information
See https://swift.org/CONTRIBUTORS.txt for Swift project authors
*/
/// A semantic version.
///
/// A version that follows the [Semantic Versioning](https://semver.org) specification.
public struct SemanticVersion: Codable, Equatable, CustomStringConvertible {
/// The major version number.
///
/// For example, the `1` in `1.2.3`
public var major: Int
/// The minor version number.
///
/// For example, the `2` in `1.2.3`
public var minor: Int
/// The patch version number.
///
/// For example, the `3` in `1.2.3`
public var patch: Int
/// The optional prerelease version component, which may contain non-numeric characters.
///
/// For example, the `4` in `1.2.3-4`.
public var prerelease: String?
/// Optional build metadata.
public var buildMetadata: String?
public init(major: Int, minor: Int, patch: Int, prerelease: String? = nil, buildMetadata: String? = nil) {
self.major = major
self.minor = minor
self.patch = patch
}
public init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
self.major = try container.decode(Int.self, forKey: .major)
self.minor = try container.decodeIfPresent(Int.self, forKey: .minor) ?? 0
self.patch = try container.decodeIfPresent(Int.self, forKey: .patch) ?? 0
self.prerelease = try container.decodeIfPresent(String.self, forKey: .prerelease)
self.buildMetadata = try container.decodeIfPresent(String.self, forKey: .buildMetadata)
}
public var description: String {
var result = "\(major).\(minor).\(patch)"
if let prerelease {
result += "-\(prerelease)"
}
if let buildMetadata {
result += "+\(buildMetadata)"
}
return result
}
}
// Diffable conformance
extension SemanticVersion: RenderJSONDiffable {
/// Returns the differences between this SemanticVersion and the given one.
func difference(from other: SemanticVersion, at path: CodablePath) -> JSONPatchDifferences {
var diffBuilder = DifferenceBuilder(current: self, other: other, basePath: path)
diffBuilder.addDifferences(atKeyPath: \.major, forKey: CodingKeys.major)
diffBuilder.addDifferences(atKeyPath: \.minor, forKey: CodingKeys.minor)
diffBuilder.addDifferences(atKeyPath: \.patch, forKey: CodingKeys.patch)
return diffBuilder.differences
}
}
|
