Add Robot Framework support via PercyLibrary

[neha-sanse]

Summary

Adds native Robot Framework keywords for Percy visual testing directly into percy-selenium-python. No separate SDK needed — users install robotframework and robotframework-seleniumlibrary alongside percy-selenium and get Robot keywords automatically.

What's added

• percy/robot_library.py — Robot Framework library with keywords
• tests/test_robot_library.py — 17 tests covering all functionality
• Graceful import in percy/__init__.py — no impact when robotframework is not installed

Keywords

• Percy Snapshot — capture DOM snapshots with all options (widths, percy_css, scope, labels, regions, responsive capture, layout mode, etc.)
• Percy Screenshot — BrowserStack Automate support with element region handling
• Create Percy Region — build ignore/consider region definitions (CSS, XPath, bounding box, padding, algorithm config)
• Percy Is Running — check Percy CLI availability

Key design decisions

• import robot wrapped in try/except — existing percy-selenium behavior is unchanged when robotframework is not installed
• PercyLibrary delegates to existing percy_snapshot() and percy_automate_screenshot() — no code duplication
• All keyword arguments are parsed from Robot string types (comma-separated, JSON, booleans) into Python types before forwarding
• When robotframework is not installed, a stub PercyLibrary class raises ImportError with a clear message

Usage

*** Settings ***
Library    SeleniumLibrary
Library    percy.robot_library.PercyLibrary

*** Test Cases ***
Homepage Visual Test
    Open Browser    https://example.com    chrome
    Percy Snapshot    Homepage
    Percy Snapshot    Responsive    widths=375,768,1280
    Percy Snapshot    Tagged    labels=regression,v2
    Close Browser

percy exec -- robot tests/

Test plan

• 17 new unit tests passing (parse helpers, keyword dispatch, graceful import)
• Existing tests unaffected (test_cache.py passes)
• Validated on Percy staging with 46 integration tests (Build 🔖 release-v2.0.1 #72, ⬆️👷 Bump actions/setup-node from 3 to 4 #73)
• CI pipeline passes

References

• Tech Spec: Confluence
• Jira: AIVT-582 | PER-7789

🤖 Generated with Claude Code