# Pic-Diff-Recognizer

**Repository Path**: amazingTest/Pic-Diff-Recognizer

## Basic Information

- **Project Name**: Pic-Diff-Recognizer
- **Description**: 基于图像差异识别与页面遍历探索的 Selenium UI自动化测试插件库
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 53
- **Forks**: 14
- **Created**: 2020-07-09
- **Last Updated**: 2024-09-24

## Categories & Tags

**Categories**: testing

**Tags**: None

## README

# Pic-Diff-Recognizer

+ [Pic-Diff-Recognizer 中文文档](https://github.com/amazingTest/Pic-Diff-Recognizer/blob/master/README_CN.md)

Selenium plugin library based on image difference recognition and page intelligent exploration.

# installation
    
    pip install -r requirements.txt
    
    pip install pic-diff-recognizer
    
    
# best practice

    from pic_diff_recognizer.searchHandler import SearchHandler
    from violent_webdriver import Chrome
    from selenium.webdriver.chrome.options import Options
    
    
    # add some useful options :)
    chrome_options = Options()
    chrome_options.add_argument("--headless")
    chrome_options.add_argument("disable-infobars")
    chrome_options.add_experimental_option("excludeSwitches", ['enable-automation'])
    
    # init driver , executable_path should be your own path!
    dr = Chrome.violent_chromedriver(chrome_options=chrome_options,
                                     executable_path='/usr/local/bin/chromedriver')
    
    # init searchHandler
    search_handler = SearchHandler(browser=dr)
    
    # search and saving baseline images in current directory named baseline
    search_handler.traverse_href(origin_url='https://gitbook.cn/gitchat/author/5cea0bfbb78cc870612d8bba')
    
    # -------------------- assuming after some iterations of current project -----------------------------
    
    search_handler.url_histories = []
    
    # load baseline images
    search_handler.picture_handler.load_base_line()
    
    # search and comparing screen shots and baseline images
    search_handler.traverse_href(origin_url='https://gitbook.cn/gitchat/author/5cea0bfbb78cc870612d8bba',
                                 compare_baseline_and_screen_shots=True)
    
    # generate_diff_between_base_line_and_screen_shot and output diffResults to current directory
    search_handler.picture_handler.generate_diff_between_base_line_and_screen_shot()
    
    # output testReport.txt to current directory
    search_handler.picture_handler.export_picture_comparison_result()
    
    
# contact me

email address：523314409@qq.com