Pyderman (Selenium Web Driver Installer)

This is a fast, simple, dependency-free package that can automatically find & download any version of the Google Chrome (chromeDriver), Firefox (geckoDriver), PhantomJS, Opera (operaDriver), and Edge (edgeDriver)* web drivers.

This project was built to allow developers to seamlessly include selenium support on the user-side, without requiring any manual configuration on their part. It will automatically locate the correct driver binary for the platform & version you choose, as well as setting the os-specific permissions after downloading.

It is tested daily on Windows/Linux/macOS against Python versions 3.5+.

To install the library, run:

pip install pyderman

Then call it in your code like so:

import pyderman as driver
path = driver.install(browser=driver.firefox)
print('Installed geckodriver driver to path: %s' % path)

There are options for the output directory, disabling printout, running chmod on the downloaded executable, automatic overwriting, executable file name, and version number. All parameters are optional, and the default values are listed below.

This example downloads the Chrome Driver instead, by changing browser like so:

import pyderman as dr
path = dr.install(browser=dr.chrome, file_directory='./lib/', verbose=True, chmod=True, overwrite=False, version=None, filename=None, return_info=False)
print('Installed chromedriver to path: %s' % path)

The download is very fast, and will skip downloading if the file already exists. This behavior can be toggled with overwrite.

Note on MS Edge:

Microsoft has switched Edge to use a flavor of Chrome behind the scenes. As of October 2019, Pyderman will download this MS Chromium Driver. There is currently no official release available for Linux, and their driver is experimental, so make sure you know what you're doing if you use this driver. If you require stability, it is recommended you specify a version instead of using the "latest".

Note on macOS

Some versions of macOS have certificate issues with Python. Typically, in recent versions of Python, it will prompt you to install these when you install Python. Since Python needs these installed in order to make https requests, you may need to install these first. Depending on your project, it may also be possible to include a library to automatically import these certificates. Please visit this link to learn more.

Why's it called 'Pyderman'?

Because it installs web-drivers. Get it?