https://github.com/authomatic/chromedriver_installer
ChromeDriver installer for Python
https://github.com/authomatic/chromedriver_installer
Last synced: about 2 months ago
JSON representation
ChromeDriver installer for Python
- Host: GitHub
- URL: https://github.com/authomatic/chromedriver_installer
- Owner: authomatic
- Created: 2015-03-11T18:11:04.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2019-06-25T22:54:49.000Z (over 6 years ago)
- Last Synced: 2025-11-27T17:36:57.603Z (3 months ago)
- Language: Python
- Size: 29.3 KB
- Stars: 15
- Watchers: 0
- Forks: 34
- Open Issues: 7
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
ChromeDriver Installer for Python
=================================
.. image:: https://travis-ci.org/peterhudec/chromedriver_installer.svg?branch=master
:target: https://travis-ci.org/peterhudec/chromedriver_installer
Installs `ChromeDriver executable `__
with **pip** or **setup.py**.
Usage
-----
Manual Installation
^^^^^^^^^^^^^^^^^^^
Clone the repository:
.. code-block:: bash
(e)$ git clone https://github.com/peterhudec/chromedriver_installer.git
Install the most recent **ChromeDriver** version without verifying checksum.
.. code-block:: bash
(e)$ python setup.py install
Install specific **ChromeDriver** version without verifying checksum.
.. code-block:: bash
(e)$ python setup.py install --chromedriver-version=2.10
Install specific **ChromeDriver** version and verify checksum.
Note that you can pass multiple coma-separated checksums to the
``--chromedriver-checksums`` option. This is useful if you plan to install
**ChromeDriver** on various platforms because there is separate version with
different checksum for each platform. You can get the checksums for specific
version/platform combinations at the
`chromedriver download URL `__.
.. code-block:: bash
(e)$ python setup.py install \
--chromedriver-version=2.10 \
--chromedriver-checksums=4fecc99b066cb1a346035bf022607104,058cd8b7b4b9688507701b5e648fd821
After install, there should be the ``chromedriver`` executable
available in your path:
.. code-block:: bash
(e)$ which chromedriver
/home/andypipkin/e/bin/chromedriver
(e)$ chromedriver --version
ChromeDriver 2.10.267518
(e)$ chromedriver
Starting ChromeDriver (v2.10.267518) on port 9515
Only local connections are allowed.
Installation With PIP
^^^^^^^^^^^^^^^^^^^^^
The same as before except you need to pass the install options wrapped in pip's
``--install-option=""`` option.
.. code-block:: bash
(e)$ pip install chromedriver_installer \
--install-option="--chromedriver-version=2.10" \
--install-option="--chromedriver-checksums=4fecc99b066cb1a346035bf022607104,058cd8b7b4b9688507701b5e648fd821"
Installation With easy_install
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
I can't seem to find a way to make **easy_install** pass *user options* to
**setup.py** so you only can install the most recent
**ChromeDriver** version with **easy_install**.
How it Works
------------
The **build_scripts** command of the **setup.py** script invoked by
``python setup.py install`` downloads, the **ChromeDriver** zip archive version
specified in the ``--chromedriver-version`` option from
http://chromedriver.storage.googleapis.com/index.html
to the **temp** directory of the operating system.
If the ``--chromedriver-checksums`` option is set, the archive is validated
against the supplied checksums
(you can get the checksums at the aforementioned URL).
If the validation failed, the installation exits with an error.
If the validation was successful or if the ``--chromedriver-checksums`` option
is not set, the archive will be unzipped to the *build directory* and installed
as an executable to the *bin directory*.
If the ``--chromedriver-version`` option is ommited, it installs the most recent
chromedriver version without checksum validation.
Testing
-------
You need `tox `__ to run the tests.
.. code-block:: bash
(e)$ git clone https://github.com/peterhudec/chromedriver_installer.git
(e)$ pip install -r requirements.txt
(e)$ tox