Create 'testing' subproject

buildSrc/build.gradle

@@ -0,0 +1,12 @@
+plugins {
+    id 'groovy-gradle-plugin'
+}
+
+dependencies {
+    // Spotless code formatter.
+    implementation('com.diffplug.spotless:com.diffplug.spotless.gradle.plugin:6.25.0')
+}
+
+repositories {
+    gradlePluginPortal()
+}

buildSrc/src/main/groovy/java-common-conventions.gradle

@@ -0,0 +1,50 @@
+plugins {
+    // Apply the java-library plugin for API and implementation separation.
+    id 'java-library'
+    id 'com.diffplug.spotless'
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
+}
+
+tasks.withType(JavaCompile) {
+    // Configure string concat to always inline compile
+    options.compilerArgs.add '-XDstringConcat=inline'
+}
+
+tasks.named('jar') {
+    manifest {
+        attributes(
+                'Implementation-Title': project.name,
+                'Implementation-Version': project.version,
+        )
+    }
+}
+
+spotless {
+    // See https://github.com/diffplug/spotless/tree/main/plugin-gradle
+    format 'misc', {
+        // define the files to apply `misc` to
+        target '.gitattributes', '.gitignore'
+
+        // define the steps to apply to those files
+        trimTrailingWhitespace()
+        indentWithSpaces()
+        endWithNewline()
+    }
+    groovyGradle {
+        greclipse().configFile('../greclipse-gradle.properties')
+    }
+    java {
+        importOrder() // Use the default importOrder configuration (can override)
+        removeUnusedImports()
+
+        // Use Google Java Format
+        // - aosp() causes it to use a four-space indent
+        googleJavaFormat('1.24.0').reflowLongStrings()
+
+        formatAnnotations()  // fix formatting of type annotations
+    }
+}

lib/build.gradle

@@ -7,22 +7,9 @@
  */
 
 plugins {
-    // Apply the java-library plugin for API and implementation separation.
-    id 'java-library'
+    id 'java-common-conventions'
     id 'edu.wpi.first.GradleRIO' version '2025.1.1'
     id 'maven-publish'
-    // Spotless code formatter.
-    id 'com.diffplug.spotless' version '6.25.0'
-}
-
-java {
-    sourceCompatibility = JavaVersion.VERSION_17
-    targetCompatibility = JavaVersion.VERSION_17
-}
-
-tasks.withType(JavaCompile) {
-    // Configure string concat to always inline compile
-    options.compilerArgs.add '-XDstringConcat=inline'
 }
 
 version = '2.0.0-alpha.1'
@@ -59,18 +46,11 @@ dependencies {
 wpi.java.configureTestTasks(test)
 
 tasks.named('test') {
-    // Use JUnit 4 for unit tests.
+    // Support running both JUnit Vintage and JUnit Jupiter tests
     useJUnitPlatform()
     systemProperty 'junit.jupiter.extensions.autodetection.enabled', 'true'
 }
 
-tasks.named('jar') {
-    manifest {
-        attributes('Implementation-Title': project.name,
-        'Implementation-Version': project.version)
-    }
-}
-
 javadoc {
     options.tags = [
         // Converts `@apiNote` paragraph to "Note: " section in the generated javadoc
@@ -80,46 +60,11 @@ javadoc {
     ]
 }
 
-// Generates Javadocs for test libraries under /build/docs/testjavadoc
-// https://discuss.gradle.org/t/how-configure-gradle-to-generate-javadoc-for-testing-classes-junit/12764/6
-task testJavadoc(type: Javadoc) {
-    source = sourceSets.test.allJava
-    classpath = sourceSets.test.compileClasspath
-    destinationDir = file("${buildDir}/docs/testjavadoc")
-    println (title == null ? '<null>' : title)
-}
-
 task sourceJar(type: Jar) {
     from sourceSets.main.allJava
     archiveClassifier = 'sources'
 }
 
-spotless {
-    // See https://github.com/diffplug/spotless/tree/main/plugin-gradle
-    format 'misc', {
-        // define the files to apply `misc` to
-        target '.gitattributes', '.gitignore'
-
-        // define the steps to apply to those files
-        trimTrailingWhitespace()
-        indentWithSpaces()
-        endWithNewline()
-    }
-    groovyGradle {
-        greclipse().configFile('greclipse-gradle.properties')
-    }
-    java {
-        importOrder() // Use the default importOrder configuration (can override)
-        removeUnusedImports()
-
-        // Use Google Java Format
-        // - aosp() causes it to use a four-space indent
-        googleJavaFormat('1.24.0').reflowLongStrings()
-
-        formatAnnotations()  // fix formatting of type annotations
-    }
-}
-
 publishing {
     publications {
         lib2813(MavenPublication) {

limelight/build.gradle

@@ -1,9 +1,9 @@
 plugins {
-    id 'java-library'
+    id 'java-common-conventions'
     id "edu.wpi.first.GradleRIO" version "2025.1.1"
     id 'idea'
     // Spotless code formatter.
-    id 'com.diffplug.spotless' version '6.25.0'
+    id 'com.diffplug.spotless'
 }
 
 idea {
@@ -13,24 +13,20 @@ idea {
     }
 }
 
-java {
-    sourceCompatibility = JavaVersion.VERSION_17
-    targetCompatibility = JavaVersion.VERSION_17
-}
-
 repositories {
     mavenCentral()
 }
 
 dependencies {
     implementation wpi.java.deps.wpilib()
     implementation wpi.java.vendor.java()
+    implementation 'com.google.code.gson:gson:2.12.1'
 
     api "org.json:json:20240205"
 
     testImplementation 'junit:junit:4.13.2'
     testImplementation 'com.google.truth:truth:1.4.4'
-    implementation 'com.google.code.gson:gson:2.12.1'
+    testImplementation project(':testing')
 
     nativeDebug wpi.java.deps.wpilibJniDebug(wpi.platforms.desktop)
     nativeDebug wpi.java.vendor.jniDebug(wpi.platforms.desktop)
@@ -47,29 +43,3 @@ tasks.named('test') {
     // Use JUnit 4 for tests
     useJUnit()
 }
-
-spotless {
-    // See https://github.com/diffplug/spotless/tree/main/plugin-gradle
-    format 'misc', {
-        // define the files to apply `misc` to
-        target '.gitattributes', '.gitignore'
-
-        // define the steps to apply to those files
-        trimTrailingWhitespace()
-        indentWithSpaces()
-        endWithNewline()
-    }
-    groovyGradle {
-        greclipse().configFile('greclipse-gradle.properties')
-    }
-    java {
-        importOrder() // Use the default importOrder configuration (can override)
-        removeUnusedImports()
-
-        // Use Google Java Format
-        // - aosp() causes it to use a four-space indent
-        googleJavaFormat('1.24.0').reflowLongStrings()
-
-        formatAnnotations()  // fix formatting of type annotations
-    }
-}

limelight/src/test/java/com/team2813/lib2813/limelight/LimelightTestCase.java

@@ -2,9 +2,9 @@
 
 import static com.google.common.truth.Truth.assertThat;
 import static com.google.common.truth.Truth.assertWithMessage;
-import static com.team2813.lib2813.limelight.truth.Pose2dSubject.assertThat;
-import static com.team2813.lib2813.limelight.truth.Pose3dSubject.assertThat;
-import static com.team2813.lib2813.limelight.truth.Translation3dSubject.assertThat;
+import static com.team2813.lib2813.testing.truth.Pose2dSubject.assertThat;
+import static com.team2813.lib2813.testing.truth.Pose3dSubject.assertThat;
+import static com.team2813.lib2813.testing.truth.Translation3dSubject.assertThat;
 import static org.junit.Assert.assertEquals;
 
 import edu.wpi.first.math.geometry.Pose2d;

settings.gradle

@@ -9,4 +9,5 @@
 
 rootProject.name = 'lib2813'
 include('lib')
-include('limelight')
+include('limelight')
+include('testing')

testing/build.gradle

@@ -0,0 +1,60 @@
+plugins {
+    id 'java-common-conventions'
+    id 'edu.wpi.first.GradleRIO' version '2025.1.1'
+}
+
+version = '1.0.0-alpha.1'
+
+repositories {
+    // Use Maven Central for resolving dependencies.
+    mavenCentral()
+}
+
+dependencies {
+    implementation wpi.java.deps.wpilib()
+    implementation wpi.java.vendor.java()
+    implementation 'com.google.truth:truth:1.4.4'
+
+    nativeDebug wpi.java.deps.wpilibJniDebug(wpi.platforms.desktop)
+    nativeDebug wpi.java.vendor.jniDebug(wpi.platforms.desktop)
+    simulationDebug wpi.sim.enableDebug()
+
+    nativeRelease wpi.java.deps.wpilibJniRelease(wpi.platforms.desktop)
+    nativeRelease wpi.java.vendor.jniRelease(wpi.platforms.desktop)
+    simulationRelease wpi.sim.enableRelease()
+    testImplementation(platform('org.junit:junit-bom:5.13.1'))
+    testImplementation('org.junit.jupiter:junit-jupiter')
+    testRuntimeOnly('org.junit.platform:junit-platform-launcher')
+}
+
+// the magic line that makes tests work :)
+wpi.java.configureTestTasks(test)
+
+tasks.named('test') {
+    // Support running both JUnit Vintage and JUnit Jupiter tests
+    useJUnitPlatform()
+    systemProperty 'junit.jupiter.extensions.autodetection.enabled', 'true'
+}
+
+javadoc {
+    options.tags = [
+        // Converts `@apiNote` paragraph to "Note: " section in the generated javadoc
+        'apiNote:a:Api Note:',
+        // Converts `@implSpec` paragraph to "Implementation Requirements: " section in the generated javadoc
+        'implSpec:a:Implementation Requirements:'
+    ]
+}
+
+// Generates Javadocs for test libraries under /build/docs/testjavadoc
+// https://discuss.gradle.org/t/how-configure-gradle-to-generate-javadoc-for-testing-classes-junit/12764/6
+task testJavadoc(type: Javadoc) {
+    source = sourceSets.test.allJava
+    classpath = sourceSets.test.compileClasspath
+    destinationDir = file("${buildDir}/docs/testjavadoc")
+    println (title == null ? '<null>' : title)
+}
+
+task sourceJar(type: Jar) {
+    from sourceSets.main.allJava
+    archiveClassifier = 'sources'
+}

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Pose2dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Pose2dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Pose3dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Pose3dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Rotation2dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Rotation2dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Rotation3dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Rotation3dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;

limelight/src/test/java/com/team2813/lib2813/limelight/truth/TolerantComparison.java → testing/src/main/java/com/team2813/lib2813/testing/truth/TolerantComparison.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import org.jspecify.annotations.Nullable;
 

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Translation2dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Translation2dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;

limelight/src/test/java/com/team2813/lib2813/limelight/truth/Translation3dSubject.java → testing/src/main/java/com/team2813/lib2813/testing/truth/Translation3dSubject.java

@@ -1,4 +1,4 @@
-package com.team2813.lib2813.limelight.truth;
+package com.team2813.lib2813.testing.truth;
 
 import static com.google.common.truth.Fact.simpleFact;
 import static com.google.common.truth.Truth.assertAbout;