refactor: improve code organization and test coverage

- Reorganize imports and method ordering for better readability
- Add comprehensive integration tests for all components
- Update Docker configuration for notebook environment
- Improve error handling and validation in core classes
- Enhance test utilities and base test classes
- Update SpotBugs exclusions for cleaner static analysis

Author: bsbodden

.gitignore

@@ -58,4 +58,11 @@ notebooks/.env
 # IPython
 profile_default/
 ipython_config.py
+
+# Don't commit JAR files to notebooks directory
+notebooks/*.jar
+notebooks/schema.yaml
+notebooks/*_test.ipynb
+notebooks/*_output.ipynb
+
 spotbugs-output.txt

README.md

@@ -1,4 +1,4 @@
-# RedisVL4J
+# RedisVL
 
 The Java client for AI-native applications with Redis.
 
@@ -7,7 +7,7 @@ The Java client for AI-native applications with Redis.
 
 ## Introduction
 
-RedisVL4J is a Java library for building AI-native applications on Redis, providing:
+RedisVL is a Java library for building AI-native applications on Redis, providing:
 
 - Vector similarity search
 - Hybrid queries combining vectors and metadata filters
@@ -18,22 +18,22 @@ RedisVL4J is a Java library for building AI-native applications on Redis, provid
 
 ### Installation
 
-Add RedisVL4J to your project:
+Add RedisVL to your project:
 
 **Maven:**
 
 ```xml
 <dependency>
     <groupId>com.redis</groupId>
-    <artifactId>redisvl4j</artifactId>
+    <artifactId>redisvl</artifactId>
     <version>0.1.0-SNAPSHOT</version>
 </dependency>
 ```
 
 **Gradle:**
 
 ```gradle
-implementation 'com.redis:redisvl4j:0.1.0-SNAPSHOT'
+implementation 'com.redis:redisvl:0.1.0-SNAPSHOT'
 ```
 
 ### Setting up Redis
@@ -317,7 +317,7 @@ The notebooks are available as Jupyter notebooks with Java kernel support. To ru
 
 - Jupyter Lab with Java kernel (JJava)
 - Redis Stack container
-- Pre-installed RedisVL4J library
+- Pre-installed RedisVL library
 - All required dependencies
 
 ## Requirements
@@ -335,4 +335,4 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## Support
 
-This project is supported by Redis, Inc. on a good faith effort basis. To report bugs or request features, please [file an issue](https://github.com/redis/redisvl4j/issues).
+This project is supported by Redis, Inc. on a good faith effort basis. To report bugs or request features, please [file an issue](https://github.com/redis/redisvl/issues).

build.gradle.kts

@@ -135,4 +135,16 @@ subprojects {
 tasks.wrapper {
     gradleVersion = "8.11.1"
     distributionType = Wrapper.DistributionType.ALL
+}
+
+// Task to copy jar to notebooks directory for Jupyter
+tasks.register<Copy>("copyJarToNotebooks") {
+    dependsOn(":core:jar")
+    from("core/build/libs/redisvl-0.0.1.jar")
+    into("notebooks")
+}
+
+// Make build depend on copying jar
+tasks.named("build") {
+    dependsOn("copyJarToNotebooks")
 }

core/build.gradle.kts

@@ -4,64 +4,64 @@ plugins {
     `maven-publish`
 }
 
-description = "RedisVL4J - Vector Library for Java"
+description = "RedisVL - Vector Library for Java"
 
 dependencies {
     // Redis client
     api("redis.clients:jedis:6.2.0")
-    
+
     // JSON processing
     implementation("com.fasterxml.jackson.core:jackson-databind:2.18.2")
     implementation("com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.18.2")
     implementation("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.18.2")
-    
+
     // Validation
     implementation("jakarta.validation:jakarta.validation-api:3.1.0")
     implementation("org.hibernate.validator:hibernate-validator:8.0.1.Final")
-    
+
     // Utilities
     implementation("org.apache.commons:commons-lang3:3.17.0")
     implementation("com.google.guava:guava:33.4.0-jre")
     implementation("com.github.f4b6a3:ulid-creator:5.2.3")
-    
+
     // Lombok for reducing boilerplate
     compileOnly("org.projectlombok:lombok:1.18.36")
     annotationProcessor("org.projectlombok:lombok:1.18.36")
     testCompileOnly("org.projectlombok:lombok:1.18.36")
     testAnnotationProcessor("org.projectlombok:lombok:1.18.36")
-    
+
     // SpotBugs annotations for suppressing false positives
     implementation("com.github.spotbugs:spotbugs-annotations:4.8.3")
-    
+
     // LangChain4J - Core API (required for vectorizers)
     compileOnly("dev.langchain4j:langchain4j:0.36.2")
-    
+
     // LangChain4J Embedding Providers (optional - users include what they need)
     compileOnly("dev.langchain4j:langchain4j-open-ai:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-azure-open-ai:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-hugging-face:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-ollama:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-vertex-ai-gemini:0.36.2")
-    
+
     // LangChain4J Local Embedding Models (optional)
     compileOnly("dev.langchain4j:langchain4j-embeddings-all-minilm-l6-v2:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-embeddings-bge-small-en-v15:0.36.2")
     compileOnly("dev.langchain4j:langchain4j-embeddings-e5-small-v2:0.36.2")
-    
+
     // ONNX Runtime for running models locally
     implementation("com.microsoft.onnxruntime:onnxruntime:1.16.3")
-    
+
     // HTTP client for downloading from HuggingFace
     implementation("com.squareup.okhttp3:okhttp:4.12.0")
-    
+
     // JSON parsing for config.json
     implementation("com.google.code.gson:gson:2.10.1")
-    
+
     // Test dependencies for LangChain4J (include in tests to verify integration)
     testImplementation("dev.langchain4j:langchain4j:0.36.2")
     testImplementation("dev.langchain4j:langchain4j-embeddings-all-minilm-l6-v2:0.36.2")
     testImplementation("dev.langchain4j:langchain4j-hugging-face:0.36.2")
-    
+
     // Additional test dependencies
     testImplementation("com.squareup.okhttp3:mockwebserver:4.12.0")
     testImplementation("org.mockito:mockito-core:5.11.0")
@@ -93,49 +93,49 @@ tasks.register<Test>("slowTest") {
 
 // Configure all JAR tasks to use the desired artifact name
 tasks.jar {
-    archiveBaseName.set("redisvl4j")
+    archiveBaseName.set("redisvl")
 }
 
 tasks.named<Jar>("sourcesJar") {
-    archiveBaseName.set("redisvl4j")
+    archiveBaseName.set("redisvl")
 }
 
 tasks.named<Jar>("javadocJar") {
-    archiveBaseName.set("redisvl4j")
+    archiveBaseName.set("redisvl")
 }
 
 publishing {
     publications {
         create<MavenPublication>("maven") {
             from(components["java"])
-            
+
             // Override the artifactId
-            artifactId = "redisvl4j"
-            
+            artifactId = "redisvl"
+
             pom {
-                name.set("RedisVL4J")
+                name.set("RedisVL")
                 description.set("Vector Library for Java")
-                url.set("https://github.com/redis/redisvl4j")
-                
+                url.set("https://github.com/redis/redisvl")
+
                 licenses {
                     license {
                         name.set("MIT License")
                         url.set("https://opensource.org/licenses/MIT")
                     }
                 }
-                
+
                 developers {
                     developer {
                         id.set("redis")
                         name.set("Redis Team")
                         email.set("[email protected]")
                     }
                 }
-                
+
                 scm {
-                    connection.set("scm:git:git://github.com/redis/redisvl4j.git")
-                    developerConnection.set("scm:git:ssh://github.com:redis/redisvl4j.git")
-                    url.set("https://github.com/redis/redisvl4j")
+                    connection.set("scm:git:git://github.com/redis/redisvl.git")
+                    developerConnection.set("scm:git:ssh://github.com:redis/redisvl.git")
+                    url.set("https://github.com/redis/redisvl")
                 }
             }
         }