Merged with master. Stripping of leading context segments in randomized context derivation.

Author: dweiss

README.md

@@ -11,3 +11,18 @@ for current features, their requirement descriptions and migration from junit4.
 See [LICENSE.txt](LICENSE.txt) to make your company's lawyer happy.
 
 See [CHANGES.txt](CHANGES.txt) for API changes and updates.
+
+## Snapshot artifacts and releases
+
+We do not publish snapshot artifacts. If you'd like to work with a snapshot,
+use gradle's composite build or install maven artifacts locally with:
+
+```
+./gradlew publishToMavenLocal
+```
+
+## Release publishing
+
+```
+./gradlew publishToSonatype closeSonatypeStagingRepository
+```

build-options.properties

@@ -0,0 +1 @@
+project.version=0.2.0-SNAPSHOT

build.gradle

@@ -1,15 +1,38 @@
 plugins {
   alias(libs.plugins.spotless) apply false
+  alias(libs.plugins.nexus.publish)
+  alias(libs.plugins.opts)
+  alias(libs.plugins.buildinfra) apply false
+}
+
+apply plugin: com.carrotsearch.gradle.buildinfra.testing.TestingEnvPlugin
+apply from: file('gradle/scripts/publishing-sonatype-central.gradle')
+
+buildOptions {
+  addOption("project.version", "Project version")
 }
 
 allprojects {
   group = 'com.carrotsearch.randomizedtesting'
-  version = '0.1.0-SNAPSHOT'
+  version = buildOptions["project.version"].get()
+}
+
+nexusPublishing {
+  repositories {
+    sonatype {
+      nexusUrl = uri("https://ossrh-staging-api.central.sonatype.com/service/local/")
+      snapshotRepositoryUrl = uri("https://central.sonatype.com/repository/maven-snapshots/")
+      username = findProperty("nexusUsername") ?: ""
+      password = findProperty("nexusPassword") ?: ""
+    }
+  }
 }
 
 subprojects {
   apply plugin: 'java-library'
   apply plugin: 'com.diffplug.spotless'
+  apply plugin: libs.plugins.opts.get().getPluginId()
+  apply plugin: com.carrotsearch.gradle.buildinfra.testing.TestingEnvPlugin
 
   repositories {
     mavenCentral()

etc/junit4-missing-features.txt

@@ -1,46 +1,34 @@
 [ai generated overview of junit4 features]
 
-4. Shuffled test execution order and seed annotations
-   - @Seed on a class fixes the main seed, making execution fully deterministic
-   - @Seeds / @Seed on a method pins a per-method seed for regression coverage
-     while still running once with a fresh random seed
-
-6. Repeating tests with @Repeat
-   - @Repeat(iterations = N, useConstantSeed = true) reruns a test N times with
-     the same seed (verifies determinism or checks if failure is consistent)
-   - @Repeat(iterations = N, useConstantSeed = false) reruns with a new
-     pseudo-random seed each time (measures failure frequency)
-
-8. Timeouts
-   - Standard JUnit @Test(timeout=N) is honoured
-   - @Timeout(millis=N) annotation provides an explicit alternative
-   - Termination sequence: Thread.interrupt() → Thread.stop() → zombie
-     detection; all attempts are logged with stack traces
-
-9. Thread-leak detection
-   - Threads that escape a test's ThreadGroup boundary are killed and cause
-     a test failure
-   - Encourages explicit Thread.join() before a test method returns
-
-10. Lingering threads and advanced thread-leak control
-    - @ThreadLeakLingering(linger=N) waits up to N ms for stray threads to
-      finish naturally (useful for Executor pools or other uncontrolled threads)
-    - Additional annotations for fine-grained policy:
-        @ThreadLeakScope  – suite vs. test scope
-        @ThreadLeakAction – warn vs. fail
-        @ThreadLeakZombies – ignore vs. fail on zombie threads
-
 11. Nightly / scaled tests
     - @Nightly marks a test that only runs when nightly mode is active
       (-Dtests.nightly=true)
-    - scaledRandomIntBetween() and multiplier() scale input sizes based on
+    - scaledrandomIntInRange() and multiplier() scale input sizes based on
       nightly vs. daily mode
 
 2. RandomizedTest base class and RandomizedContext
    - Extend RandomizedTest for convenient access to a per-test Random instance
    - Access the context directly via RandomizedContext.current()
+   - Utility methods on RandomizedTest: randomInt(), randomIntInRange(),
 
 3. Randomized input generation
-   - Utility methods on RandomizedTest: randomInt(), randomIntBetween(),
      randomBoolean(), randomFloat(), etc.
    - Encourages testing over a broad input domain rather than fixed values
+
+* utility rules (require assertions, etc.)
+
+* reproduce-failure line info listener?
+
+[possibly doable with a custom test engine]
+
+- predictably shuffled test execution order
+- blowing up test reps using tests.iters
+
+[to check/ add tests of]
+
+- is the seed stack trace frame injected for leaked threads + randomized testing ext?
+- can we enforce the order of extensions (randomized testing > leaked threads)
+- how are jupiter timeouts working together with leaked threads ext.?
+- maybe bring back thread leak zombies annotation (if we can't cleanly terminate leaked threads, ignore all remaining tests).
+- maybe move some of the implementation details to a non-exposed package?
+- regenerate the javadocs with public API only.

etc/problems-thoughts.md

@@ -2,7 +2,8 @@
 assertj = "3.27.7"
 googleJavaFormat = "1.34.1"
 junit = "6.0.3"
-spotless = "8.2.1"
+nexus-publish = "2.0.0"
+spotless = "8.4.0"
 
 [libraries]
 assertj = { module = "org.assertj:assertj-core", version.ref = "assertj" }
@@ -12,4 +13,7 @@ junit-platform-launcher = { module = "org.junit.platform:junit-platform-launcher
 junit-platform-testkit = { module = "org.junit.platform:junit-platform-testkit", version.ref = "junit" }
 
 [plugins]
+nexus-publish = { id = "io.github.gradle-nexus.publish-plugin", version.ref = "nexus-publish" }
 spotless = { id = "com.diffplug.spotless", version.ref = "spotless" }
+opts = { id = "com.carrotsearch.gradle.opts", version = "0.2.1" }
+buildinfra = "com.carrotsearch.gradle.buildinfra:0.0.21"

gradle/libs.versions.toml

@@ -0,0 +1,69 @@
+def published = [
+  ":randomizedtesting-jupiter"
+]
+
+configure(subprojects.findAll { it.path in published }) {
+  apply plugin: 'maven-publish'
+  apply plugin: 'signing'
+
+  // Hack: do not generate or publish gradle metadata files.
+  tasks.withType(GenerateModuleMetadata).configureEach {
+    enabled = false
+  }
+
+  plugins.withType(JavaPlugin).configureEach {
+    java {
+      withSourcesJar()
+      withJavadocJar()
+    }
+
+    publishing {
+      def configurePom = {
+        name = "${project.name}"
+        description = "${project.name}"
+        url = 'https://github.com/randomizedtesting/randomizedtesting-jupiter'
+        inceptionYear = "2026"
+
+        licenses {
+          license {
+            name = 'ASL 2.0 License'
+            url = 'https://github.com/randomizedtesting/randomizedtesting-jupiter/blob/main/LICENSE.txt'
+          }
+        }
+
+        organization {
+          name = "Carrot Search s.c."
+          url = "https://www.carrotsearch.com"
+        }
+
+        developers {
+          developer {
+            id = 'dawid.weiss'
+            name = 'Dawid Weiss'
+            email = 'dawid.weiss@carrotsearch.com'
+          }
+        }
+        scm {
+          connection = 'scm:git:git@github.com:randomizedtesting/randomizedtesting-jupiter.git'
+          developerConnection = 'scm:git:git@github.com:randomizedtesting/randomizedtesting-jupiter.git'
+          url = 'https://github.com/randomizedtesting/randomizedtesting-jupiter'
+        }
+      }
+
+      publications {
+        jars(MavenPublication) {
+          from components.java
+          groupId = project.group
+          artifactId = project.base.archivesName.get()
+
+          pom(configurePom)
+        }
+      }
+    }
+
+    signing {
+      required = { !project.version.endsWith('-SNAPSHOT') }
+      sign publishing.publications.jars
+    }
+  }
+}

gradle/scripts/publishing-sonatype-central.gradle

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