Metadata-Version: 2.1
Name: driloader
Version: 1.2.1
Summary: Driver downloader for Selenium
Home-page: UNKNOWN
Author: Lucas Trajano; Felipe Viegas; Jonatha Daguerre
License: MIT
Description: # Driloader
        
        [![pypi version](https://img.shields.io/pypi/v/driloader.svg)](https://pypi.python.org/pypi/driloader) [![license](https://img.shields.io/pypi/l/driloader.svg)](https://pypi.python.org/pypi/driloader) [![python versions](https://img.shields.io/pypi/pyversions/driloader.svg)](https://pypi.python.org/pypi/driloader) [![contributors](https://img.shields.io/github/contributors/lucasmello/Driloader.svg)](https://github.com/lucasmello/Driloader/graphs/contributors) [![Build Status](https://travis-ci.org/lucasmello/Driloader.svg?branch=master)](https://travis-ci.org/lucasmello/Driloader)
        
        Selenium drivers downloader tool with standalone CLI support.
        
         ## Why is it for?
         
         Selenium needs a specific driver to work with each browser. Every driver has a version that works with specific browser
         versions, and it's really annoying reading the changelogs to check if the current driver will work with the new browser
         version. Plus, a lot of times a test crashes because the browser has updated and the driver is not compatible anymore.
         That's why Driloader exists: To make this process so much easier! Driloader autodetect the browser version (it supports Chrome, Firefox and Internet Explorer) and download the driver according to it's version.
        
        ## Requires
        * Python 3.4 or higher
        
        ## Setup the project
        This project uses [Pipenv](https://github.com/pypa/pipenv) as packaging tool. Please make sure you have it installed in your system.
        
        Also, we use [make](https://www.gnu.org/software/make/) as task runner, so you can see the available tasks by running `make help`.
        
        ```bash
        # Clone the project
        bash: $ git clone https://github.com/lucasmello/Driloader.git
        bash: $ cd Driloader
        # Install dependencies
        bash: $ make install
        pipenv install --dev
        Installing dependencies from Pipfile.lock…
          🐍   ▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉▉ 20/20 — 00:00:03
        # Active virtual env
        bash: $ pipenv shell
        source ~/.local/share/virtualenvs/driloader-ZPASDPNJ/bin/activate
        # Run linter and tests
        (driloader-ZPASDPNJ) driloader: $ make lint test
        
        ```
        
        ## Installing
        ```
         pip install driloader
        ```
        
        ## Usage with Firefox
        ```python
        from driloader import driloader
        from selenium.webdriver import Firefox
        
        driver_path = driloader.download_gecko_driver()
        browser = Firefox(executable_path=driver_path)
        browser.get("http://www.google.com")
        browser.quit()
        ```
        
        ## Usage with Chrome
        ```python
        from driloader import driloader
        from selenium.webdriver import Chrome
        
        driver_path = driloader.download_chrome_driver()
        browser = Chrome(executable_path=driver_path)
        browser.get("http://www.google.com")
        browser.quit()
        ```
        
        ## Usage with Internet Explorer
        ```python
        from driloader import driloader
        from selenium.webdriver import Ie
        
        driver_path = driloader.download_ie_driver()
        browser = Ie(executable_path=driver_path)
        browser.get("http://www.google.com")
        browser.quit()
        ```
        
        ## CLI and standalone usage
        ```bash
        python -m driloader
        
        usage: driloader [-h] (--firefox | --chrome | --internet-explorer | --all)
        
        optional arguments:
          -h, --help            show this help message and exit
          --firefox, -f         get Firefox version.
          --chrome, -c          get Google Chrome version.
          --internet-explorer, -i
                                get Internet Explorer version.
          --all                 look for browsers an get their versions.
        ```
        ### Retrieve Firefox version
        ```bash
        $  python -m driloader --firefox
        45
        ```
        
        ### Retrieve Google Chrome version
        ```bash
        $  python -m driloader --chrome
        58
        ```
        
        ### Retrieve Internet Explorer version (Windows system)
        ```cmd
        > python -m driloader -i
        11
        ```
        
        ### Retrieve all browsers version (Windows system)
        ```bash
        > python -m driloader --all
        Internet Explorer: 11
        Firefox: 45
        Google Chrome: 58
        
        ```
        
        ### Retrieve all browsers version (non-Windows system)
        ```bash
        # Getting from a non-Windows system
        $  python -m driloader --all
        Internet Explorer: Error: Unable to get the Internet Explorer version.
                Cause: Error: Unable to retrieve IE version..
                Cause: System is not Windows.
        Firefox: 45
        Google Chrome: 58
        
        ```
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Description-Content-Type: text/markdown
