Metadata-Version: 2.1
Name: undetected-chromedriver
Version: 1.5.0
Summary: 
                Optimized Selenium/Chromedriver drop-in replacement for selenium.webdriver, using the same interface for Chrome and ChromeOptions, but which does NOT trigger anti-bot services like Distil / Imperva / DataDome / Botprotect.io and such.
                All required anti-detection settings are built-in, yet overridable if you'd really want. Be aware: any customization in settings could potentially trigger detection,
                For more information check out the README.
Home-page: https://github.com/ultrafunkamsterdam/undetected_chromedriver
Author: UltrafunkAmsterdam
Author-email: info@blackhat-security.nl
License: GPL-3.0
Description: # undetected_chromedriver
        
        https://github.com/ultrafunkamsterdam/undetected-chromedriver
        
        Optimized Selenium Chromedriver patch which does not trigger anti-bot services like Distill Network / Imperva / DataDome / Botprotect.io
        Automatically downloads the driver binary and patches it.
        
        * **Tested on version 75,76,77,78,79,80,81,83,84,85,86**
        
        * **patching also works on MS Edge (chromium-based) webdriver binary**
        
        
        ## New ##
        
        By default, the console log function is disabled to prevent certain detections.
        Until a cleaner solution is found, use the following to manually enable it
        
        ```python
        import undetected_chromedriver as uc
        driver = uc.Chrome(enable_console_log=True)
        ```
        
        ## Installation ##
        ```
        pip install undetected-chromedriver
        ```
        
        ## Usage ##
        
        To prevent unnecessary hair-pulling and issue-rasing, please mind the **[important note at the end of this document](#important-note) .**
        
        <br>
        
        #### the easy way (recommended) ####
        ```python
        import undetected_chromedriver as uc
        driver = uc.Chrome()
        driver.get('https://distilnetworks.com')
        
        # To target specific version
        
        import undetected_chromedriver as uc
        uc.TARGET_VERSION = 85
        driver = uc.Chrome()
        ```
        
        
        #### patches selenium module  ####
        Needs to be done before importing from selenium package
        
        ```python
        import undetected_chromedriver as uc
        uc.install()
        from selenium.webdriver import Chrome
        driver = Chrome()
        driver.get('https://distilnetworks.com')
        ```` 
        
        
        #### the customized way ####
        ```python
        import undetected_chromedriver as uc
        
        #specify chromedriver version to download and patch
        #this did not work correctly until 1.2.1
        uc.TARGET_VERSION = 78    
        
        # or specify your own chromedriver binary to patch
        undetected_chromedriver.install(
            executable_path='c:/users/user1/chromedriver.exe',
        )
        from selenium.webdriver import Chrome, ChromeOptions
        opts = ChromeOptions()
        opts.add_argument(f'--proxy-server=socks5://127.0.0.1:9050')
        driver = Chrome(options=opts)
        driver.get('https://distilnetworks.com')
        ```
        
        
        ### datadome.co ####
        These guys have actually a powerful product, and a link to this repo, which makes me wanna test their product.
        Make sure you use a "clean" ip for this one. 
        ```
        # STANDARD chromedriver
        from selenium import webdriver
        chrome = webdriver.Chrome()
        chrome.get('https://datadome.co/customers-stories/toppreise-ends-web-scraping-and-content-theft-with-datadome/')
        chrome.save_screenshot('datadome_regular_webdriver.png')
        True  
        # after this detectioon, you'll keep being nagged with puzzles, even if you use another machine from the same same network (they use a very tight but effective regime, possibly combination of fingerprinting and ip-flagging).
        
        
        # UNDETECTED chromedriver (headless,even)
        
        import undetected_chromedriver as uc
        options = uc.ChromeOptions()
        options.headless=True
        options.add_argument('--headless')
        chrome = uc.Chrome(options=options)
        chrome.get('https://datadome.co/customers-stories/toppreise-ends-web-scraping-and-content-theft-with-datadome/')
        chrome.save_screenshot('datadome_undetected_webddriver.png')
        
        ```
        **Check both saved screenhots [here](https://imgur.com/a/fEmqadP)**
        
        
        
        ## important note ##
        
        the default blank page on start plays a BIG role in the anti-detection workings of the module. You will only become undetectable from the moment you use driver.get(url) to navigate to some url (and next and next and next). This automatically means that if you enter a url in the browser screen by hand right after launch, you are NOT protected! New Tabs: same story. If you really need multi-tabs, then open the tab with the blank page (hint: url is  `data:,`  including comma, and yes, driver accepts it) and do your thing as usual. If you follow these "rules" (actually its default behaviour), then you will have a great time for now. 
        
        TL;DR and for the visual-minded:
        
        ```python
        In [1]: import undetected_chromedriver as uc
        In [2]: driver = uc.Chrome()
        In [3]: driver.execute_script('return navigator.webdriver')
        Out[3]: True  # Detectable
        In [4]: driver.get('https://distilnetworks.com') # starts magic
        In [4]: driver.execute_script('return navigator.webdriver')
        In [5]: None  # Undetectable!
        ```
        ## end important note ##
        
        
        
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
