Python client for visual testing with Percy
Project description
percy-selenium-python
Percy visual testing for Python Selenium.
Installation
npm install @percy/cli
:
$ npm install --save-dev @percy/cli
pip install Percy selenium package:
$ pip install percy-selenium
Usage
This is an example test using the percy_snapshot
function.
from percy import percy_snapshot
browser = webdriver.Firefox()
browser.get('http://example.com')
# take a snapshot
percy_snapshot(browser, 'Python example')
Running the test above normally will result in the following log:
[percy] Percy is not running, disabling snapshots
When running with percy exec
, and your project's
PERCY_TOKEN
, a new Percy build will be created and snapshots will be uploaded to your project.
$ export PERCY_TOKEN=[your-project-token]
$ percy exec -- [python test command]
[percy] Percy has started!
[percy] Created build #1: https://percy.io/[your-project]
[percy] Snapshot taken "Python example"
[percy] Stopping percy...
[percy] Finalized build #1: https://percy.io/[your-project]
[percy] Done!
Configuration
percy_snapshot(driver, name[, **kwargs])
driver
(required) - A selenium-webdriver driver instancename
(required) - The snapshot name; must be unique to each snapshot- Additional snapshot options (overrides any project options) (
**kwargs**
):widths
- An array of widths to take screenshots atmin_height
- The minimum viewport height to take screenshots atpercy_css
- Percy specific CSS only applied in Percy's rendering environmentrequest_headers
- Headers that should be used during asset discoveryenable_javascript
- Enable JavaScript in Percy's rendering environment
Migrating Config
If you have a previous Percy configuration file, migrate it to the newest version with the
config:migrate
command:
$ percy config:migrate
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
percy-selenium-1.0.2.tar.gz
(3.7 kB
view hashes)
Built Distribution
Close
Hashes for percy_selenium-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8782e254231219993a9ffd492dcec928459bc14965aee29fbd393ddf3e7bbdeb |
|
MD5 | 2f366738793344b66f76e4953ea45359 |
|
BLAKE2b-256 | 33ff439b8dba4a021246b4c3a50bc6ede827f6eff34311186ca996a18438c3d7 |