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
*/
import Foundation
extension SymbolGraph.Symbol {
/**
Availability is described by a *domain* and the versions in which
certain events may have occurred, such as a symbol's appearance in a framework,
its deprecation, obsolescence, or removal.
A symbol may have zero or more availability items.
For example,
a class introduced in iOS 11 would have:
- an availability domain of `"iOS"` and
- an `introduced` version of `11.0.0`.
As another example,
a method `foo` that was renamed to `bar` in iOS 10.1 would have:
- an availability domain of `"iOS"`,
- a `deprecated` version `10.1.0`, and
- a `renamed` string of `"bar"`.
Some symbols may be *unconditionally* unavailable or deprecated.
This means that the availability applies to any version, and
possibly to all domains if the `availabilityDomain` key is undefined.
*/
public struct Availability: Mixin, Codable {
public static let mixinKey = "availability"
public var availability: [AvailabilityItem]
public init(from decoder: Decoder) throws {
let container = try decoder.singleValueContainer()
availability = try container.decode([AvailabilityItem].self)
}
public func encode(to encoder: Encoder) throws {
var container = encoder.singleValueContainer()
try container.encode(availability)
}
public init(availability: [AvailabilityItem]) {
self.availability = availability
}
}
/// Convenience method to fetch the availability mixin value.
public var availability: [Availability.AvailabilityItem]? {
(mixins[Availability.mixinKey] as? Availability)?.availability
}
}
extension UnifiedSymbolGraph.Symbol {
public var availability: [UnifiedSymbolGraph.Selector: [SymbolGraph.Symbol.Availability.AvailabilityItem]] {
mixins.compactMapValues({ mixins in
(mixins[SymbolGraph.Symbol.Availability.mixinKey] as? SymbolGraph.Symbol.Availability)?.availability
})
}
}
|
