Metadata-Version: 2.1
Name: visualdiff
Version: 0.3.3
Summary: Automate chrome browser render diffs for website testing
Home-page: https://github.com/dariosky/visualdiff
Author: Dario Varotto
Author-email: dario.varotto@gmail.com
License: MIT license
Keywords: visualdiff
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: pillow
Requires-Dist: pyppeteer

Visual diff tests for Python
============================

Automate chrome browser render diffs for website testing
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Featuring Puppeteer, headless Chrome and Python image diffing

Installation
------------

.. code:: bash

    pip install visualdiff

Usage
-----

Create your tests calling ``visualdiff.compare(url)``, this will drive a
headless Chrome session rendering the desired URL and comparing the
resulting image with an expected one.

The expectation are stored by default in a ``visualdiff`` subfolder of
the current calling test script.

There are several additional options you can use, we'll see them in the
examples

Examples
--------

.. code:: python

    import visualdiff as vd

    assert not vd.difference('https://example.com')

Credits:
--------

-  It is a long time that I wanted a tool like this one, but thanks to
   `this article from Monica
   Dinculescu <https://meowni.ca/posts/2017-puppeteer-tests/>`__ for
   finally convincing me.
-  Thanks to Mijakogi for `the outstanding work on
   Pyppeteer <https://github.com/miyakogi/pyppeteer/>`__


=======
History
=======

0.3.0 (2018-05-12)
------------------

* Disable CSS animation, allow screenshot delay
* If save_differences==True the diff file will contain an highlighted diff-rect

0.2.3 (2018-04-11)
------------------

* First version in Continuous Integration

0.2.0 (2018-04-06)
------------------

* Beta version, things should work

0.1.0 (2018-02-18)
------------------

* First release on PyPI.


