docs: consolidate canonical specs and preserve PBS reference IDs
This commit is contained in:
+29
@@ -9,6 +9,35 @@ import java.util.*;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
class PbsDocumentationTest {
|
||||
@Test void publishedFeatureIdsResolveToTheSameCanonicalChapterResourceAndHash() throws Exception {
|
||||
// These IDs were published before the chapters were numbered.
|
||||
var legacyIds = List.of("typed-arrays-and-optional-execution.md",
|
||||
"first-class-functions-and-captures.md", "generic-contracts.md",
|
||||
"generic-structs-and-free-functions.md", "input-and-existing-type-runtime-alignment.md",
|
||||
"service-constants-and-runtime-math.md", "runtime-random-integration.md",
|
||||
"sdk-list-and-cursor.md", "sdk-linked-and-cursor.md", "sdk-set-and-identity.md",
|
||||
"sdk-map-and-keyval.md", "sdk-stack-and-queue.md");
|
||||
var references = new PbsDocumentation().references(1, AppMode.Game).stream()
|
||||
.collect(java.util.stream.Collectors.toMap(FrontendReferenceProvider.Reference::id, ref -> ref));
|
||||
var entries = new HashMap<String, com.fasterxml.jackson.databind.JsonNode>();
|
||||
try (var stream = getClass().getClassLoader().getResourceAsStream("pbs-knowledge/index.json")) {
|
||||
assertNotNull(stream);
|
||||
new com.fasterxml.jackson.databind.ObjectMapper().readTree(stream).get("references")
|
||||
.forEach(entry -> entries.put(entry.get("id").asText(), entry));
|
||||
}
|
||||
for (int i = 0; i < legacyIds.size(); i++) {
|
||||
String oldId = "pbs:spec:" + legacyIds.get(i);
|
||||
String chapterId = "pbs:spec:" + (14 + i);
|
||||
assertNotNull(references.get(oldId), oldId);
|
||||
assertNotNull(references.get(chapterId), chapterId);
|
||||
assertEquals(references.get(chapterId).text(), references.get(oldId).text(), oldId);
|
||||
assertEquals(references.get(chapterId).kind(), references.get(oldId).kind(), oldId);
|
||||
assertEquals(entries.get(chapterId).get("resource"), entries.get(oldId).get("resource"), oldId);
|
||||
assertEquals(entries.get(chapterId).get("sha256"), entries.get(oldId).get("sha256"), oldId);
|
||||
assertTrue(entries.get(oldId).get("resource").asText().startsWith("pbs-knowledge/specs/" + (14 + i) + ". "));
|
||||
}
|
||||
}
|
||||
|
||||
@Test void installedIndexHasAllKindsUniqueIdsAndExactSdkSources() throws Exception {
|
||||
var references = new PbsDocumentation().references(1, AppMode.Game);
|
||||
assertEquals(references.size(), references.stream().map(FrontendReferenceProvider.Reference::id).distinct().count());
|
||||
|
||||
Reference in New Issue
Block a user