Skip to content

feat(advanced): PER-8195 — advanced example for percy-selenium (Ruby gem)#7

Open
Shivanshu-07 wants to merge 6 commits into
masterfrom
per-8195-phase-1-ruby-selenium
Open

feat(advanced): PER-8195 — advanced example for percy-selenium (Ruby gem)#7
Shivanshu-07 wants to merge 6 commits into
masterfrom
per-8195-phase-1-ruby-selenium

Conversation

@Shivanshu-07

@Shivanshu-07 Shivanshu-07 commented May 21, 2026

Copy link
Copy Markdown

Summary

Adds an advanced/ example covering the full applicable percy-selenium Ruby gem feature surface. 12 RSpec examples in spec/todomvc_advanced_spec.rb, one per matrix row: widths, min_height, enable_javascript, responsive_snapshot_capture, readiness, labels, test_case, device_pixel_ratio, browsers, regions, sync, plus a snake_case + camelCase dual-naming demo.

scope, dom_transformation, per-snapshot discovery marked N/A — not exposed in percy-selenium 1.1.2 options hash.

Issue: PER-8195.

CI shape

  • ruby 3.4 (ruby/setup-ruby@v1) + firefox + selenium-webdriver
  • WEBrick-based server (mirrors basic example)
  • make test-advanced-ci runs bundle exec rspec spec/ wrapped in percy exec --testing and captures /test/requests
  • shared assertion helper (D8 placeholder URL)
  • @percy/cli pinned to ^1.31.13 via npm install --no-save

Open question (D8)

Same shared-helper hosting question.

Test plan

  • Wait for the advanced CI job to run green.
  • Verify matrix-row coverage assertion exits 0.

🤖 Generated with Claude Code

Shivanshu-07 and others added 2 commits May 20, 2026 10:52
Phase 1 stub for PER-8195 (advanced example for every Percy SDK sample
repo). matrix.yml populated from SDK API research, README placeholder
notes test code is TO BE WRITTEN.

Carries the Phase 0 pattern: per-SDK matrix.yml is the canonical
machine-readable source of truth; advanced/README.md table + the
aggregate docs/advanced-example-feature-matrix.md grid are generated
downstream.

No test code committed — needs per-SDK smoke-test validation against
the matching SDK toolchain (next step). Most rows currently 'Planned';
some 'Covered' rows reflect behavior automatic via the basic SDK usage
(cross-origin iframe handling, cookie capture, environmentInfo).

See parent: docs/plans/2026-05-19-001-feat-per-8195-advanced-sdk-examples-plan.md
…enium (Ruby gem)

Adds advanced/ exercising the full applicable Ruby SDK feature surface.
12 RSpec examples in spec/todomvc_advanced_spec.rb, one per matrix row:
widths, min_height, enable_javascript, responsive_snapshot_capture,
readiness, labels, test_case, device_pixel_ratio, browsers, regions,
sync, snake_case + camelCase dual-naming demo.

scope, dom_transformation, discovery marked N/A — not exposed in
percy-selenium ruby 1.1.2 options hash.

CI advanced job uses ruby/setup-ruby@v1 (3.4) + bundle exec rspec
wrapped in `percy exec --testing` and asserts via the shared helper.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Comment thread .github/workflows/test.yml Fixed
@Shivanshu-07 Shivanshu-07 marked this pull request as ready for review May 27, 2026 13:41
@Shivanshu-07 Shivanshu-07 requested a review from a team as a code owner May 27, 2026 13:41
… helper (PER-8195)

The advanced job fetched an assertion helper from
percy/percy-public-repos-parent/main/scripts/ — that repo is private and the
script was never published, so curl -f 404d and failed every advanced run.

Master has no --testing mode / matrix-coverage gate; it just runs the spec
under percy exec with the repo PERCY_TOKEN. Mirror that: run the advanced
suite (which already wraps percy exec) with PERCY_TOKEN, dropping the jq/yq
install, the external curl helper, the --testing /test/requests capture, and
the matrix assertion.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread .github/workflows/test.yml Fixed
…rcy (PER-8195)

The advanced Makefile installs @percy/cli with `npm install --no-save` and then
runs `$(NPM)/percy` (= advanced/node_modules/.bin/percy). With no
advanced/package.json, npm walked up to the repo-root package.json and
installed percy into root/node_modules, so advanced/node_modules/.bin/percy was
missing and `make test-advanced` failed with "node_modules/.bin/percy: No such
file or directory" (exit 127). A minimal advanced/package.json anchors the
install to advanced/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
prklm10
prklm10 previously approved these changes Jun 5, 2026
…PER-8195)

The advanced suite serves the app from its served root, but index.html
linked node_modules/todomvc-app-css/index.css which only exists after a
repo-root npm install the advanced flow never runs -> CSS 404'd and
snapshots rendered unstyled. Vendor index.css beside index.html and point
the href at css/index.css (matches java-selenium's existing approach).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Resolves CodeQL "Workflow does not contain permissions" on test.yml.

Co-Authored-By: Claude Opus 4.8 (1M context) <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.

3 participants