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.4.tar.gz
(3.9 kB
view hashes)
Built Distribution
Close
Hashes for percy_selenium-1.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72aedcc7cd59a5041a1eb87895cca9df10248b7be1856e52915c75a3655b57ef |
|
MD5 | 03ebabcd5e5ffb0c6abdb2870dab0944 |
|
BLAKE2b-256 | f09f464e97198d4075b03155dfe8c2a153ec931ea7f53885f4f24a6ff1fdb80a |