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
|
/*
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 hierarchy tree node that represents a chapter in a tutorial series.
public struct RenderHierarchyChapter: Codable, Equatable {
/// The topic reference for the chapter.
public var reference: RenderReferenceIdentifier
/// The tutorials in the chapter.
public var tutorials: [RenderHierarchyTutorial] = []
/// Creates a new hierarchy chapter.
/// - Parameter identifier: The topic reference for the chapter.
public init(identifier: RenderReferenceIdentifier) {
self.reference = identifier
}
enum CodingKeys: String, CodingKey {
case reference
// Both "tutorials" and "projects" correspond to the
// same `tutorials` property for legacy reasons.
case tutorials, projects
}
public init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
self.reference = try container.decode(RenderReferenceIdentifier.self, forKey: .reference)
// Decode using the new key if its present, otherwise decode using the previous key
let tutorialsKey = container.contains(.tutorials) ? CodingKeys.tutorials : CodingKeys.projects
self.tutorials = try container.decode([RenderHierarchyTutorial].self, forKey: tutorialsKey)
}
public func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
try container.encode(reference, forKey: .reference)
try container.encode(tutorials, forKey: .projects) // Encode using the previous key for compatibility
}
}
|
