{"id":24229,"library":"percy-selenium","title":"Percy Selenium Python","description":"Python client for visual testing with Percy. Integrates with Selenium to capture screenshots and perform visual regression testing via Percy's cloud service. Current version 2.1.4, supports Python >=3.6, and is maintained by BrowserStack.","status":"active","version":"2.1.4","language":"python","source_language":"en","source_url":"https://github.com/percy/percy-selenium-python","tags":["visual-testing","selenium","percy","screenshot","regression"],"install":[{"cmd":"pip install percy-selenium","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required for Selenium WebDriver integration.","package":"selenium","optional":false}],"imports":[{"wrong":"from percy_selenium import Percy","symbol":"PercyLibrary","correct":"from percy import PercyLibrary"},{"wrong":"from percy_selenium import percy_snapshot","symbol":"percy_snapshot","correct":"from percy import percy_snapshot"},{"wrong":"from percy_selenium import percy_screenshot","symbol":"percy_screenshot","correct":"from percy import percy_screenshot"}],"quickstart":{"code":"from selenium import webdriver\nfrom percy_selenium import Percy\n\n# Initialize Percy with driver\ndriver = webdriver.Chrome()\npercy = Percy(driver)\n\n# Navigate and snapshot\ndriver.get('https://example.com')\npercy.snapshot('Homepage')","lang":"python","description":"Captures a visual snapshot of the current page using the Percy SDK."},"warnings":[{"fix":"Update imports to `from percy_selenium import Percy`. Replace `desired_capabilities` with `options`.","message":"In v2.0.0, the import path changed from `percy` to `percy_selenium`. Old imports (`from percy import Percy`) will break. Additionally, the `Percy` class no longer supports `desired_capabilities`; use `webdriver.Options` instead.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Set `PERCY_TOKEN` to your project's token from the Percy dashboard.","message":"The `PERCY_TOKEN` environment variable must be set for snapshot uploads. If missing, snapshots are silently skipped.","severity":"gotcha","affected_versions":"All"},{"fix":"Use `percy.snapshot('name', wait=True)` or call `percy.flush()` after all snapshots.","message":"The `snapshot()` method is asynchronous by default; snapshots are queued and processed after the test. To wait for upload, use `snapshot(name, wait=True)` or call `percy.flush()`.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"search_vec":"'2.1.4':29 '3.6':32 'browserstack':37 'captur':15 'client':5 'cloud':25 'current':27 'integr':11 'maintain':35 'perci':1,10,23,42 'perform':18 'python':3,4,31 'regress':20,44 'screenshot':16,43 'selenium':2,13,41 'servic':26 'support':30 'test':8,21,40 'version':28 'via':22 'visual':7,19,39 'visual-test':38","created_at":"2026-05-01T08:11:58.682478+00:00","updated_at":"2026-05-01T08:11:58.682478+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.2.0","cli_name":"percy","cli_version":"sh: 1: percy: not found","type":"library","homepage":"https://percy.io","github":"https://github.com/percy/percy-selenium-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/percy-selenium/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing","http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}