Skip to content

feat(config): zero-config first run — make selenium-boot.yml optional - #66

Merged
shossain786 merged 1 commit into
masterfrom
feat/zero-config-first-run
Sep 20, 2026
Merged

shossain786 merged 1 commit into
masterfrom
feat/zero-config-first-run

Conversation

@shossain786

Copy link
Copy Markdown
Contributor

What

selenium-boot.yml is no longer required. ConfigurationLoader now:

  • No default file anywhere (no -Dselenium.boot.config, no profile, none in working dir/classpath) → runs on built-in defaults and prints one notice line.
  • Missing fields / empty file → default: browser.name=chrome (skipped when browser.matrix is set), execution.mode=local, timeouts.explicit=10, timeouts.pageLoad=30.
  • Still an error: a requested profile or explicit path that doesn't exist (a typo must not silently run on defaults); present-but-invalid values (unknown execution.mode, negative timeout).
  • SeleniumBootDefaults overrides take precedence over the built-ins and now apply before validation.

Adds ConfigurationLoader.load(File workingDir, ClassLoader) so the no-file path is testable.

Why

#41, #43 and #47 all trace back to the config file being required on first run.

Verification

  • mvn clean verify: 515 tests, 0 failures (508 existing + 7 new in ConfigurationLoaderTest).
  • Before/after: on the previous code an empty file throws NullPointerException: Configuration must not be null and a partial file throws Execution mode must be specified; both now load.
  • Docs updated: configuration.md, getting-started.md, CLAUDE.md. No changelog entry — to be added at release time.

🤖 Generated with Claude Code

- No default selenium-boot.yml anywhere -> run on built-in defaults and
  print one notice line. A requested profile / explicit path that is
  missing still throws (a typo must not silently run on defaults).
- Fields a file omits (and empty files) fall back to: browser.name=chrome
  (unless browser.matrix set), execution.mode=local, timeouts 10s/30s.
  Present-but-invalid values (unknown mode, negative timeout) still fail.
- SeleniumBootDefaults overrides take precedence over built-ins and now
  apply before validation.
- Adds ConfigurationLoader.load(File, ClassLoader) for tests.

Traces back to #41/#43/#47 (cold-start friction on the config file).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@shossain786
shossain786 merged commit 27ed654 into master Sep 20, 2026
2 checks passed
@shossain786
shossain786 deleted the feat/zero-config-first-run branch September 20, 2026 05:26
shossain786 added a commit that referenced this pull request Sep 21, 2026
Covers #66 (zero-config first run), #67/#68 (terminal Locator actions
wait and re-resolve on every poll) and #64 (junit-jupiter-api 6.1.3).
No version bump: the release decision is the maintainer's.

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
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.

1 participant