Metadata-Version: 1.1
Name: dfrnt
Version: 0.2
Summary: A Library for visual diffs
Home-page: https://github.com/LesterTheTester/dfrnt
Author: Bryan Lester
Author-email: lester@bittorrent.com
License: LICENSE.txt
Download-URL: https://github.com/LesterTheTester/dfrnt/tarball/0.2
Description: dfrnt is a library for comparing PNG screenshots during automated testing and producing visual diffs.
        
        dfrnt will compare images with identical names from automation and produce a result "diff" image that red-highlights regions
        in the image that differ.
        
        dfrnt requires a minimum of 3 folders to be specified:
        
        run_dir is the directory of screenshots from your run, aka 'actual screenshots'
        gold_dir directory of screenshots that are compared against, aka 'expected screenshots'
        diff_dir is the directory to output the visual diff images into
        
        Invoking:
        
        1. You have a directory of images from your latest test run in "test/run" (test.png)
        2. You have a directory of the expected images in "test/gold" (test.png)
        3. You want the output of visual diffs to be placed in directory "test/diff"
        
        from dfrnt import dfrnt
        
        visual_diffs = dfrnt(run_dir="test/run", gold_dir="test/gold", diff_dir="test/diff")
        
        visual_diffs.diff()
        
        Output:
        Diff failed! test.png is not identical enough
        
        A red-lined image showing the differences between run/test.png and gold/test.png is generated in diff/test.png
        
        Optional Features:
        mask_dir is the directory to contain images with highlighted areas you wish to ignore in the diff.
        This is useful for ignoring portions of an image that always change, like date / time.
        These mask images should be transparent background PNGs
        
        fuzzy is a "fuzziness" factor of how different images can be and still pass.
        If you experience jitter you should experimentally determine the lowest acceptable number you can use.
        Default is None, starting your binary search around '40' is recommended
        
        visual_diffs = visual_diffs = dfrnt(run_dir="run", gold_dir="gold", diff_dir="diff", mask_dir="mask", fuzzy=40)
        
        Why is this project called 'dfrnt'?
        To mock the modern practice of dropping vowels in software names to sound unique. Be glad I didn't name it dfrntzlyr.
Keywords: testing,visual diff,visdiff,automation,screenshot
Platform: UNKNOWN
