kotlin support

Author: pileks

docusaurus.config.js

@@ -150,7 +150,8 @@ const config = {
         darkTheme: darkCodeTheme,
         additionalLanguages: [
           "rust",
-          "swift"
+          "swift",
+          "kotlin"
         ]
       },
     }),

package.json

@@ -72,7 +72,7 @@
   },
   "doc-snippets": {
     "extract": {
-      "include": "./**/*.{ts,tsx,js,json,yaml,txt,md,graphql,cue}",
+      "include": "./**/*.{ts,tsx,js,json,yaml,txt,md,graphql,cue,kt,kts}",
       "ignore": [
         "./**/node_modules/**",
         "./**/.polywrap/**",

sidebars.js

@@ -20,6 +20,7 @@ const sidebars = {
       label: 'Quick Start',
       items: [
         'quick-start/javascript',
+        'quick-start/kotlin',
         'quick-start/swift',
       ]
     },

snippets/quick-start/kt/.gitattributes

@@ -0,0 +1,9 @@
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
+

snippets/quick-start/kt/.gitignore

@@ -0,0 +1,5 @@
+# Ignore Gradle project-specific cache directory
+.gradle
+
+# Ignore Gradle build output directory
+build

snippets/quick-start/kt/app/build.gradle.kts

@@ -0,0 +1,54 @@
+/*
+ * This file was generated by the Gradle 'init' task.
+ *
+ * This generated file contains a sample Kotlin application project to get you started.
+ * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.3/userguide/building_java_projects.html in the Gradle documentation.
+ */
+
+// $start: quickstart-kt-gradle-plugins
+plugins {
+  id("org.jetbrains.kotlin.jvm") version "1.9.0"
+  
+  // The versions of the JVM and serialization plugins must be the same
+  id("org.jetbrains.kotlin.plugin.serialization") version "1.9.0"
+
+  application
+}
+// $end
+
+repositories {
+  // Use Maven Central for resolving dependencies.
+  mavenCentral()
+}
+
+dependencies {
+  // Use the Kotlin JUnit 5 integration.
+  testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
+
+  // Use the JUnit 5 integration.
+  testImplementation("org.junit.jupiter:junit-jupiter-engine:5.9.3")
+
+  testRuntimeOnly("org.junit.platform:junit-platform-launcher")
+
+  // This dependency is used by the application.
+  implementation("com.google.guava:guava:32.1.1-jre")
+
+  // $start: quickstart-kt-gradle-dependencies
+  // Add the polywrap-client and serialization dependency required by the Polywrap Client
+  implementation("io.polywrap:polywrap-client:0.10.4")
+  implementation("org.jetbrains.kotlinx:kotlinx-serialization-core:1.5.1")
+  // $end
+}
+
+// Apply a specific Java toolchain to ease working on different environments.
+java { toolchain { languageVersion.set(JavaLanguageVersion.of(17)) } }
+
+application {
+  // Define the main class for the application.
+  mainClass.set("quickstartkt.AppKt")
+}
+
+tasks.named<Test>("test") {
+  // Use JUnit Platform for unit tests.
+  useJUnitPlatform()
+}

snippets/quick-start/kt/app/src/main/kotlin/quickstartkt/App.kt

@@ -0,0 +1,76 @@
+/*
+ * This Kotlin source file was generated by the Gradle 'init' task.
+ */
+package quickstartkt
+
+// $start: quickstart-kt-import-client
+import io.polywrap.configBuilder.polywrapClient // Import of the Polywrap Client itself
+import io.polywrap.core.resolution.Uri // The Polywrap Client uses the Uri class for invocations
+
+// $end
+
+fun main() {
+  // $start: quickstart-kt-init-client
+  val client = polywrapClient { addDefaults() }
+  // $end
+
+  // $start: quickstart-kt-invoke-client
+  val result =
+      client.invoke<String>(
+          uri = Uri("wrapscan.io/polywrap/sha3@1.0"),
+          method = "sha3_256",
+          args = mapOf("message" to "Hello Polywrap!")
+      )
+
+  if (result.isFailure) {
+    throw result.exceptionOrNull()!!
+  }
+
+  println(result)
+  // $end
+
+  // $start: quickstart-kt-uniswap
+  val wethResult =
+      client.invoke<Map<String, Any>>(
+          uri = Uri("wrapscan.io/polywrap/uniswap-v3@1.0"),
+          method = "fetchToken",
+          args =
+              mapOf(
+                  "address" to "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+                  "chainId" to "MAINNET"
+              )
+      )
+
+  // Log the invocation error and stop execution if the invocation fails
+  println(wethResult.getOrThrow())
+
+  val usdcResult =
+      client.invoke<Map<String, Any>>(
+          uri = Uri("wrapscan.io/polywrap/uniswap-v3@1.0"),
+          method = "fetchToken",
+          args =
+              mapOf(
+                  "address" to "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                  "chainId" to "MAINNET"
+              )
+      )
+
+  // Log the invocation error and stop execution if the invocation fails
+  println(usdcResult.getOrThrow())
+
+  val poolAddressResult =
+      client.invoke<String>(
+          uri = Uri("wrapscan.io/polywrap/uniswap-v3@1.0"),
+          method = "getPoolAddress",
+          args =
+              mapOf(
+                  "tokenA" to wethResult.getOrDefault(null),
+                  "tokenB" to usdcResult.getOrDefault(null),
+                  "fee" to "MEDIUM"
+              )
+      )
+
+  // Log the invocation error and stop execution if the invocation fails
+  println(poolAddressResult.getOrThrow())
+  // $end
+}

snippets/quick-start/kt/app/src/test/kotlin/quickstartkt/AppTest.kt

@@ -0,0 +1,14 @@
+/*
+ * This Kotlin source file was generated by the Gradle 'init' task.
+ */
+package quickstartkt
+
+import kotlin.test.Test
+import kotlin.test.assertNotNull
+
+class AppTest {
+    @Test fun appHasAGreeting() {
+        val classUnderTest = App()
+        assertNotNull(classUnderTest.greeting, "app should have a greeting")
+    }
+}

snippets/quick-start/kt/gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists