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
|
/*
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
*/
extension SymbolGraph {
/// A [semantic version](https://semver.org).
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
self.prerelease = prerelease
self.buildMetadata = buildMetadata
}
public init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
major = try container.decode(Int.self, forKey: .major)
minor = try container.decodeIfPresent(Int.self, forKey: .minor) ?? 0
patch = try container.decodeIfPresent(Int.self, forKey: .patch) ?? 0
prerelease = try container.decodeIfPresent(String.self, forKey: .prerelease)
buildMetadata = try container.decodeIfPresent(String.self, forKey: .buildMetadata)
}
public var description: String {
var result = "\(major).\(minor).\(patch)"
if let prerelease = prerelease {
result += "-\(prerelease)"
}
if let buildMetadata = buildMetadata {
result += "+\(buildMetadata)"
}
return result
}
}
}
|
