Initial commit

Author: Donnerbart

.editorconfig

@@ -0,0 +1,38 @@
+name: CI Check
+
+on:
+  push:
+    branches: ["**"]
+
+concurrency:
+  group: unit-test-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit-test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout Split Tests Java
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@7a6d8a8234af8eb26422e24e3006232cccaa061b # v4
+        with:
+          distribution: temurin
+          java-version: 21
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@0bdd871935719febd78681f197cd39af5b6e16a6 # v4
+
+      - name: Gradle check
+        run: ./gradlew check
+
+      - name: Publish test report
+        uses: mikepenz/action-junit-report@ee6b445351cd81e2f73a16a0e52d598aeac2197f # v5
+        if: always()
+        with:
+          annotate_only: true
+          detailed_summary: true
+          job_name: unit-test-report
+          report_paths: '**/build/test-results/test/TEST-*.xml'

.github/workflows/check.yml

@@ -0,0 +1,34 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+
+      - name: Setup Java
+        uses: actions/setup-java@7a6d8a8234af8eb26422e24e3006232cccaa061b # v4
+        with:
+          distribution: temurin
+          java-version: 21
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@0bdd871935719febd78681f197cd39af5b6e16a6 # v4
+
+      - name: Build JAR
+        run: ./gradlew shadowJar
+
+      - name: Upload Release Asset
+        uses: actions/upload-release-asset@e8f9f06c4b078e705bd2ea027f0926603fc9b4d5 # v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ github.event.release.upload_url }}
+          asset_path: ./build/libs/split-tests-java.jar
+          asset_name: split-tests-java-${{ github.event.release.name }}.jar
+          asset_content_type: application/java-archive

.github/workflows/release.yml

@@ -0,0 +1,11 @@
+# Gradle
+.gradle
+build/
+
+# IntelliJ
+out/
+*.iml
+.idea/
+
+.java-version
+.DS_Store

.gitignore

@@ -0,0 +1,68 @@
+# Split Tests Java
+
+Divides a test suite into groups with equal execution time, based on prior test timings.
+
+This ensures optimal parallel execution. Since test file runtimes can vary significantly, splitting them evenly without
+considering timing may result in inefficient grouping.
+
+## Compatibility
+
+This tool was written for Java and released as JAR archive.
+
+## Usage
+
+Download and extract the latest build from the releases page.
+
+### Using the command line
+
+Execute the test split with the required arguments.
+The tool returns the set of test classes for the current split, joined by spaces.
+
+```shell
+java -jar split-tests-java.jar --split-index 0 --split-total 10 --glob '**/*Test.java'
+```
+
+### Using a JUnit report
+
+For example, check out the project into `project` and the JUnit reports into `reports`. 
+
+```
+java -jar split-tests-java.jar --split-index 0 --split-total 10 --glob 'project/**/*Test.java' --junit 'reports/**/*.xml'
+```
+
+## Arguments
+
+```plain
+Usage: <main class> [options]
+  Options:
+    --debug, -d
+      Enables debug logging.
+      Default: false
+    --exclude-glob, -e
+      Glob pattern to exclude test files. Defaults to '**/*Abstract*'. Make 
+      sure to single-quote the pattern to avoid shell expansion.
+  * --glob, -g
+      Glob pattern to find test files. Make sure to single-quote the pattern 
+      to avoid shell expansion.
+    --help, -h
+      Prints the usage.
+    --junit-glob, -j
+      Glob pattern to find JUnit reports. Make sure to single-quote the 
+      pattern to avoid shell expansion.
+  * --split-index, -i
+      This test split index.
+      Default: 0
+  * --split-total, -t
+      Total number of test splits.
+      Default: 0
+    --working-directory, -w
+      The working directory. Defaults to the current directory.
+```
+
+## Compilation
+
+This tool is written in Java and uses Gradle as build tool.
+
+- Install Java 21
+- Checkout the repository
+- `./gradlew shadowJar`

README.md

@@ -0,0 +1,62 @@
+plugins {
+    application
+    java
+    alias(libs.plugins.shadow)
+}
+
+group = "de.donnerbart"
+version = "0.1.0"
+
+application {
+    mainClass = "de.donnerbart.split.TestSplitMain"
+}
+
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+repositories {
+    mavenCentral()
+}
+
+// ********** dependencies **********
+
+dependencies {
+    compileOnly(libs.jetbrains.annotations)
+    implementation(libs.jcommander)
+    implementation(libs.jackson.dataformat.xml)
+    implementation(libs.logback.classic)
+}
+
+// ********** distribution **********
+
+tasks.shadowJar {
+    mergeServiceFiles()
+    archiveBaseName = "split-tests-java"
+    archiveClassifier = ""
+    archiveVersion = ""
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+    manifest {
+        attributes["Main-Class"] = "de.donnerbart.split.TestSplitMain"
+    }
+}
+
+// ********** tests **********
+
+dependencies {
+    testCompileOnly(libs.jetbrains.annotations)
+
+    testImplementation(libs.junit.jupiter)
+    testRuntimeOnly(libs.junit.platform.launcher)
+
+    testImplementation(libs.assertj)
+    testImplementation(libs.equalsVerifier)
+    testImplementation(libs.systemStubs.core)
+    testImplementation(libs.systemStubs)
+}
+
+tasks.test {
+    useJUnitPlatform()
+}

build.gradle.kts

@@ -0,0 +1,24 @@
+[versions]
+assertj = "3.27.3"
+equalsVerifier = "3.17.5"
+jackson = "2.18.2"
+jcommander = "1.82"
+jetbrains-annotations = "26.0.1"
+junit = "5.10.0"
+logback = "1.5.16"
+systemStubs = "2.1.7"
+
+[libraries]
+assertj = { module = "org.assertj:assertj-core", version.ref = "assertj" }
+equalsVerifier = { module = "nl.jqno.equalsverifier:equalsverifier", version.ref = "equalsVerifier" }
+jackson-dataformat-xml = { module = "com.fasterxml.jackson.dataformat:jackson-dataformat-xml", version.ref = "jackson" }
+jcommander = { module = "com.beust:jcommander", version.ref = "jcommander" }
+jetbrains-annotations = { module = "org.jetbrains:annotations", version.ref = "jetbrains-annotations" }
+junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junit" }
+junit-platform-launcher = { module = "org.junit.platform:junit-platform-launcher" }
+logback-classic = { module = "ch.qos.logback:logback-classic", version.ref = "logback" }
+systemStubs-core = { module = "uk.org.webcompere:system-stubs-core", version.ref = "systemStubs" }
+systemStubs = { module = "uk.org.webcompere:system-stubs-jupiter", version.ref = "systemStubs" }
+
+[plugins]
+shadow = { id = "com.gradleup.shadow", version = "8.3.5" }

gradle/libs.versions.toml

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