Skip to content

feat(advanced): PER-8195 — advanced example for percy-selenium (Python)#22

Merged
Shivanshu-07 merged 7 commits into
masterfrom
per-8195-phase-1-selenium-python
Jun 12, 2026
Merged

feat(advanced): PER-8195 — advanced example for percy-selenium (Python)#22
Shivanshu-07 merged 7 commits into
masterfrom
per-8195-phase-1-selenium-python

Conversation

@Shivanshu-07

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

Copy link
Copy Markdown
Contributor

Summary

Adds an advanced/ example covering the full applicable percy-selenium Python SDK feature surface. 11 pytest functions in tests/test_todomvc_advanced.py, one per matrix row: widths, min_height, enable_javascript, responsive_snapshot_capture, readiness, sync, labels, test_case, device_pixel_ratio, browsers, plus a snake_case + camelCase dual-naming demo.

scope, dom_transformation, regions, per-snapshot discovery marked N/A — not exposed as kwargs in percy-selenium 2.1.2.

Issue: PER-8195.

CI shape

  • python 3.11 + firefox + selenium-webdriver
  • make test-advanced-ci runs pytest tests/ 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 (Python)

Adds advanced/ exercising the full applicable percy-selenium Python SDK
feature surface. 11 pytest functions in tests/test_todomvc_advanced.py,
one per matrix row: widths, min_height, enable_javascript,
responsive_snapshot_capture, readiness, sync, labels, test_case,
device_pixel_ratio, browsers, snake_case + camelCase dual-naming demo.

scope, dom_transformation, regions, discovery marked N/A — not exposed
as kwargs in percy-selenium 2.1.2.

CI advanced job uses firefox + selenium-webdriver + `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
Shivanshu-07 and others added 2 commits June 8, 2026 10:12
Resolves CodeQL "Workflow does not contain permissions" finding by adding
a top-level permissions: contents: read block.

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

@pranavz28 pranavz28 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.

Tests are failing because percy/exec-action is removed and not found. Remove it from the workflow and add npm test or the specific command itself to run the test

…-8195)

percy/exec-action@v0.3.1 is removed/unresolvable so the basic job failed.
The test script already self-wraps 'percy exec', so run it directly with
PERCY_TOKEN in env.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Shivanshu-07

Copy link
Copy Markdown
Contributor Author

@pranavz28 addressed in b091e77 — removed the unresolvable percy/exec-action@v0.3.1 from the basic job and run make test directly (it already self-wraps percy exec via node_modules/.bin/percy) with PERCY_TOKEN in env. Could you re-review?

…lenium-python

# Conflicts:
#	.github/workflows/test.yml
@Shivanshu-07 Shivanshu-07 merged commit 0a5cdcb into master Jun 12, 2026
11 of 12 checks passed
@Shivanshu-07 Shivanshu-07 deleted the per-8195-phase-1-selenium-python branch June 12, 2026 04:36
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