Skip to content

Rename waitTillFinished to waitTillStarted on NonInterruptiveEvent - #255

Merged
baubakg merged 3 commits into
mainfrom
rename-waitTillFinished-227
Aug 31, 2026
Merged

baubakg merged 3 commits into
mainfrom
rename-waitTillFinished-227

Conversation

@baubakg

@baubakg baubakg commented Aug 31, 2026

Copy link
Copy Markdown
Member

Summary

  • Closes NIE: rename waitTillFinished to a better wording #227 — waitTillFinished() was misleadingly named; it waits for the startUp stage to be finalized, not for the event to finish.
  • Adds waitTillStarted() as the new name on the public NonInterruptiveEvent class, and keeps waitTillFinished() as a @Deprecated, mutually-forwarding method so existing subclasses (this is a published v9.0.0 API) keep compiling and working without changes. waitTillFinished() is planned for removal in a future major version.
  • Updates the internal PhasedEventManager engine, all first-party event implementations/tests, and both README.md files to use the new name.

Test plan

  • mvn -pl phased-testing-core,phased-testing-test-fixtures,phased-testing-testng,mutational-testing -am compile test-compile — clean build
  • mvn -pl phased-testing-testng test -Dtest=TestPhasedNonInterruptive — passes
  • mvn -pl phased-testing-testng test — 416 tests, 0 failures
  • mvn -pl mutational-testing test — 27 tests, 0 failures
  • Confirmed no remaining references to waitTillFinished outside the deprecated shim itself (grep -rn "waitTillFinished")

🤖 Generated with Claude Code

)

waitTillFinished() was misleadingly named: it waits for the startUp
stage to be finalized, not for the event to finish. Introduce
waitTillStarted() as the new name, keeping waitTillFinished() as a
deprecated, mutually-forwarding method to preserve source compatibility
for existing subclasses of the public NonInterruptiveEvent class.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@codecov

codecov Bot commented Aug 31, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

baubakg and others added 2 commits August 31, 2026 19:20
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…arted mutual recursion

The two forwarding default methods called each other, which Sonar flags as recursion with no guaranteed termination. Only waitTillStarted() now forwards to waitTillFinished() (needed so the engine, which calls waitTillStarted(), keeps invoking old subclasses overrides of waitTillFinished()). The deprecated waitTillFinished() no longer forwards back, since nothing internal calls it once a subclass overrides waitTillStarted(). Also adds since/forRemoval to the @deprecated annotation per Sonar's code-smell suggestion.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@baubakg
baubakg merged commit 58e78e3 into main Aug 31, 2026
8 checks passed
@baubakg
baubakg deleted the rename-waitTillFinished-227 branch August 31, 2026 17:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

NIE: rename waitTillFinished to a better wording

1 participant