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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
/*
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
import XCTest
@testable import SwiftDocC
class TopicRenderReferenceTests: XCTestCase {
let testReference = TopicRenderReference(
identifier: RenderReferenceIdentifier("identifier"),
titleVariants: VariantCollection<String>(
defaultValue: "Default value",
objectiveCValue: "Objective-C value"
),
abstractVariants: .init(defaultValue: []),
url: "",
kind: .article,
estimatedTime: nil
)
let encodedReference = """
{
"type": "topic",
"identifier": "myIdentifier",
"title": "myTitle",
"url": "myURL"
}
""".data(using: .utf8)!
// Test for backwards-compatibility.
func testDecoderAcceptsMissingKindKey() {
XCTAssertNoThrow(try JSONDecoder().decode(TopicRenderReference.self, from: encodedReference))
}
// Test for backwards-compatibility via an additional role for symbol references.
func testDecodeTopicReferenceRole() {
let json = """
{
"abstract" : [],
"identifier" : "doc://org.swift.docc.example/mykit/myclass",
"kind" : "symbol",
"title" : "MyClass",
"type" : "topic",
"url" : "/documentation/mykit/myclass",
"role" : "API Collection"
}
""".data(using: .utf8)!
do {
let reference = try JSONDecoder().decode(TopicRenderReference.self, from: json)
XCTAssertEqual(reference.role, "API Collection")
} catch {
XCTFail(error.localizedDescription)
}
}
func testEmitsTitleVariantsDuringEncoding() throws {
let encoder = RenderJSONEncoder.makeEncoder()
_ = try encoder.encode(testReference)
let variantOverrides = try XCTUnwrap(encoder.userInfo[.variantOverrides] as? VariantOverrides)
XCTAssertEqual(variantOverrides.values.count, 1)
let variantOverride = try XCTUnwrap(variantOverrides.values.first)
XCTAssertEqual(variantOverride.traits, [.interfaceLanguage("objc")])
XCTAssertEqual(variantOverride.patch.count, 1)
let operation = try XCTUnwrap(variantOverride.patch.first)
XCTAssertEqual(operation.operation, .replace)
XCTAssertEqual(operation.pointer.pathComponents, ["title"])
}
func testSetsTitleDuringDecoding() throws {
let reference = try JSONDecoder().decode(TopicRenderReference.self, from: encodedReference)
XCTAssertEqual(reference.title, "myTitle")
}
func testSetsTitleVariantsDefaultValueWhenInstantiatingWithTitle() {
let reference = TopicRenderReference(
identifier: RenderReferenceIdentifier("identifier"),
title: "myTitle",
abstract: [],
url: "",
kind: .article,
estimatedTime: nil
)
XCTAssertEqual(reference.titleVariants.defaultValue, "myTitle")
XCTAssert(reference.titleVariants.variants.isEmpty)
}
func testSetsTitleVariantsDefaultValueWhenSettingTitle() {
var reference = testReference
reference.title = "another title"
XCTAssertEqual(reference.titleVariants.defaultValue, "another title")
}
func testGetsTitleVariantsDefaultValueWhenGettingTitle() {
XCTAssertEqual(testReference.title, "Default value")
}
}
|
