Skip to content

Say what a shared TestKit home saves - #833

Merged
alexander-yevsyukov merged 2 commits into
masterfrom
claude/testkit-home-kdoc
Nov 3, 2026
Merged

alexander-yevsyukov merged 2 commits into
masterfrom
claude/testkit-home-kdoc

Conversation

@alexander-yevsyukov

Copy link
Copy Markdown
Contributor

Summary

Corrects the KDoc of SHARED_TESTKIT_HOME, which #831 added. No behaviour changes.

  • What a cold TestKit home costs. The KDoc said an empty one makes the first worker build download its dependencies and generate the Gradle API JARs. A filled shared directory from tool-base's tests has no generated Gradle API JARs, and only 12 downloaded files (13 MB). Most of it is Gradle's instrumented copies of the JARs on the classpath of the plugin under test (198 MB of transforms, such as the Kotlin Gradle plugin), plus the test projects' compiled build scripts (36 MB). The KDoc now says so, naming Gradle's instrumentation so that it is not read as JaCoCo's.
  • When a pull request run starts warm. setup-gradle saves entries only on the default branch, so a pull request run finds the directory warm only after such a run has saved it. The KDoc now says that too, and drops the claim that caches/ is the only part of the Gradle user home the action keeps: it keeps the wrapper distributions as well.

#831's description repeats the old claim in its "Why" and "First cold run" bullets. The same correction for plugin-testlib's KDoc is in SpineEventEngine/tool-base#207.

Test plan

  • ./gradlew :buildSrc:build detekt
  • review-docs: approved with changes; its findings are applied.

🤖 Generated with Claude Code

alexander-yevsyukov and others added 2 commits November 3, 2026 17:41
The worker builds generate no Gradle API JARs and download few files. Their
Gradle user home mostly holds the instrumented JARs of the plugin classpath.
Also say that a pull request run finds the directory warm only after a run on
the default branch has saved it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Also say that only runs on the default branch save the directory.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings November 3, 2026 17:46
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-03T17:48:06.608452Z 114a401 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approved

No active review issues are reported for the KDoc clarification of shared TestKit cache contents and CI reuse.

No open issues 🎉

What changed in this PR

Corrects the SHARED_TESTKIT_HOME KDoc introduced in #831 to explain what the shared TestKit directory caches and when CI runs can reuse it. No runtime behavior changes.

Changes:

  • Identifies Gradle-instrumented plugin classpath JARs and compiled test-project build scripts as the main cached content.
  • Clarifies that pull request runs start warm only after a default-branch run saves the cache.
  • Removes the inaccurate claim that setup-gradle preserves only caches/.
File Description
buildSrc/​src/​main/​kotlin/​io/​spine/​gradle/​testing/​TestKitCoverage.kt Corrects KDoc describing shared TestKit cache contents and CI reuse.

Review effort: Balanced

@alexander-yevsyukov alexander-yevsyukov moved this to In Review in v2.0 Nov 3, 2026
@alexander-yevsyukov
alexander-yevsyukov merged commit cef6c50 into master Nov 3, 2026
3 checks passed
@alexander-yevsyukov
alexander-yevsyukov deleted the claude/testkit-home-kdoc branch November 3, 2026 17:59
@github-project-automation github-project-automation Bot moved this from In Review to ✅ Done in v2.0 Nov 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

2 participants