Add tests

Author: alexcheng1982

pom.xml

@@ -6,7 +6,7 @@
 
   <groupId>io.github.alexcheng1982</groupId>
   <artifactId>spring-ai-dashscope-client</artifactId>
-  <version>0.1.1</version>
+  <version>0.2.0</version>
 
   <name>Aliyun Dashscope Spring AI Client</name>
   <description>Aliyun Dashscope Spring AI Client</description>
@@ -65,10 +65,25 @@
       <artifactId>dashscope-sdk-java</artifactId>
       <version>${dashscope-sdk.version}</version>
     </dependency>
+
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-api</artifactId>
+      <version>5.10.2</version>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 
   <build>
     <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>3.2.5</version>
+        <configuration>
+          <excludedGroups>manual</excludedGroups>
+        </configuration>
+      </plugin>
       <plugin>
         <groupId>org.sonatype.central</groupId>
         <artifactId>central-publishing-maven-plugin</artifactId>

src/main/java/io/github/alexcheng1982/springai/dashscope/DashscopeChatClient.java

@@ -30,6 +30,9 @@
 import org.springframework.util.Assert;
 import org.springframework.util.CollectionUtils;
 
+/**
+ * Spring AI {@linkplain ChatClient} for Aliyun Dashscope
+ */
 public class DashscopeChatClient extends
     AbstractFunctionCallSupport<Message, ChatCompletionRequest, GenerationResult> implements
     ChatClient {
@@ -59,6 +62,15 @@ public DashscopeChatClient(DashscopeApi dashscopeApi,
     this.defaultOptions = options;
   }
 
+  /**
+   * Create a {@linkplain DashscopeChatClient} with default options
+   *
+   * @return A {@linkplain DashscopeChatClient}
+   */
+  public static DashscopeChatClient createDefault() {
+    return new DashscopeChatClient(new DashscopeApi());
+  }
+
   @Override
   public ChatResponse call(Prompt prompt) {
     var generationResult = callWithFunctionSupport(createRequest(prompt));

src/main/java/io/github/alexcheng1982/springai/dashscope/DashscopeChatOptions.java

@@ -10,6 +10,11 @@
 import org.springframework.ai.model.function.FunctionCallingOptions;
 import org.springframework.util.Assert;
 
+/**
+ * {@linkplain ChatOptions} of Aliyun Dashscope
+ *
+ * @see DashscopeChatClient
+ */
 public class DashscopeChatOptions implements FunctionCallingOptions,
     ChatOptions {
 

src/main/java/io/github/alexcheng1982/springai/dashscope/api/DashscopeApi.java

@@ -13,6 +13,9 @@
 import java.util.Objects;
 import java.util.Optional;
 
+/**
+ * Dashscope API
+ */
 public class DashscopeApi {
 
   private final Generation generation;

src/main/java/io/github/alexcheng1982/springai/dashscope/metadata/DashscopeChatResponseMetadata.java

@@ -4,6 +4,9 @@
 import org.springframework.ai.chat.metadata.ChatResponseMetadata;
 import org.springframework.ai.chat.metadata.Usage;
 
+/**
+ * {@linkplain ChatResponseMetadata} implementation of Aliyun Dashscope
+ */
 public class DashscopeChatResponseMetadata implements ChatResponseMetadata {
 
   private final DashscopeUsage usage;

src/test/java/io/github/alexcheng1982/springai/dashscope/DashscopeChatClientTest.java

@@ -0,0 +1,19 @@
+package io.github.alexcheng1982.springai.dashscope;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+import org.junit.jupiter.api.Test;
+
+/**
+ * This test requires a Dashscope API key
+ */
+@Manual
+class DashscopeChatClientTest {
+
+  @Test
+  void smokeTest() {
+    var client = DashscopeChatClient.createDefault();
+    var response = client.call("hello");
+    assertNotNull(response);
+  }
+}

src/test/java/io/github/alexcheng1982/springai/dashscope/DashscopeChatOptionsTest.java

@@ -0,0 +1,23 @@
+package io.github.alexcheng1982.springai.dashscope;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import io.github.alexcheng1982.springai.dashscope.api.DashscopeModelName;
+import org.junit.jupiter.api.Test;
+
+class DashscopeChatOptionsTest {
+
+  @Test
+  void testChatOptions() {
+    var options = DashscopeChatOptions.builder()
+        .withModel(DashscopeModelName.QWEN_MAX)
+        .withTemperature(0.2f)
+        .build();
+    assertEquals(DashscopeModelName.QWEN_MAX, options.getModel());
+    assertEquals(0.2f, options.getTemperature());
+    options = DashscopeChatOptions.builder(options)
+        .withTemperature(0.7f)
+        .build();
+    assertEquals(0.7f, options.getTemperature());
+  }
+}

src/test/java/io/github/alexcheng1982/springai/dashscope/Manual.java

@@ -0,0 +1,14 @@
+package io.github.alexcheng1982.springai.dashscope;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+import org.junit.jupiter.api.Tag;
+
+@Target({ElementType.TYPE, ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+@Tag("manual")
+public @interface Manual {
+
+}