add test for api ref doc analytics

Author: xinsong-cui

dokka-aws/build.gradle.kts

@@ -18,6 +18,15 @@ description = "Custom Dokka plugin for AWS Kotlin SDK API docs"
 dependencies {
     compileOnly(libs.dokka.base)
     compileOnly(libs.dokka.core)
+
+    testImplementation(libs.jsoup)
+    testImplementation(libs.junit.jupiter)
+    testImplementation(libs.kotest.assertions.core.jvm)
+    testImplementation(libs.kotlin.test.junit5)
+}
+
+tasks.test {
+    useJUnitPlatform()
 }
 
 tasks.withType<KotlinCompile> {

dokka-aws/src/test/kotlin/aws/sdk/kotlin/dokka/DokkaAwsTest.kt

@@ -0,0 +1,38 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package aws.sdk.kotlin.dokka
+
+import org.jsoup.Jsoup
+import org.junit.jupiter.api.Assumptions.assumeTrue
+import org.junit.jupiter.api.Test
+import java.io.File
+import kotlin.test.assertTrue
+
+class DokkaAwsTest {
+    @Test
+    fun testLoadScripts() {
+        val testFile = File("../build/dokka/htmlMultiModule/index.html")
+
+        assumeTrue(
+            testFile.exists(),
+            "Skipping test: test file does not exist"
+        )
+
+        val document = Jsoup.parse(testFile, "UTF-8")
+
+        val expectedScripts = listOf(
+            "awshome_s_code.js"
+        )
+
+        val scripts = document.head().select("script[src]")
+
+        expectedScripts.forEach { expectedScript ->
+            assertTrue(
+                scripts.any { it.attr("src").endsWith(expectedScript) },
+                "Expected script $expectedScript not found"
+            )
+        }
+    }
+}

gradle/libs.versions.toml

@@ -26,6 +26,7 @@ kotlinx-benchmark-version = "0.4.12"
 kotlinx-serialization-version = "1.7.3"
 mockk-version = "1.13.13"
 slf4j-version = "2.0.16"
+jsoup-version = "1.19.1"
 
 [libraries]
 aws-kotlin-repo-tools-build-support = { module="aws.sdk.kotlin.gradle:build-support", version.ref = "aws-kotlin-repo-tools-version" }
@@ -111,6 +112,8 @@ smithy-aws-smoke-test-model = { module = "software.amazon.smithy:smithy-aws-smok
 junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junit-version" }
 junit-jupiter-params = { module = "org.junit.jupiter:junit-jupiter-params", version.ref = "junit-version" }
 
+jsoup = { module = "org.jsoup:jsoup", version.ref = "jsoup-version" }
+
 kotest-assertions-core = { module = "io.kotest:kotest-assertions-core", version.ref = "kotest-version" }
 kotest-assertions-core-jvm = { module = "io.kotest:kotest-assertions-core-jvm", version.ref = "kotest-version" }
 kotest-framework-datatest = { module = "io.kotest:kotest-framework-datatest", version.ref = "kotest-version" }