# selenium_driver_updater
[![PyPI version](https://badge.fury.io/py/selenium-driver-updater.svg)](https://badge.fury.io/py/selenium-driver-updater)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater)](https://pepy.tech/project/selenium-driver-updater)
[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater/month)](https://pepy.tech/project/selenium-driver-updater)
[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater/week)](https://pepy.tech/project/selenium-driver-updater)
[![Donate with Bitcoin](https://en.cryptobadges.io/badge/micro/32GJnnDrPkSKVzrRho84KwD5RsMW4ywMiW)](https://en.cryptobadges.io/donate/32GJnnDrPkSKVzrRho84KwD5RsMW4ywMiW)
[![Donate with Ethereum](https://en.cryptobadges.io/badge/micro/0xf2691CC12a70B4589edf081E059fD4A1c457417D)](https://en.cryptobadges.io/donate/0xf2691CC12a70B4589edf081E059fD4A1c457417D)
[![Windows](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/windows-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/windows-tests.yml)
[![macOS](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/macOS-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/macOS-tests.yml)
[![Ubuntu](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/ubuntu-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/ubuntu-tests.yml)
It is a fast and convenience package that can automatically download or update Selenium webdriver binaries and their browsers for different OS.
## Installation
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install selenium_driver_updater.
```
pip install selenium-driver-updater
```
## Usage in code
This example shows how you can use this library to download chromedriver binary and use it immediately.
```python
from selenium_driver_updater import DriverUpdater
from selenium import webdriver
import os
base_dir = os.path.dirname(os.path.abspath(__file__))
filename = DriverUpdater.install(path=base_dir, driver_name=DriverUpdater.chromedriver, upgrade=True, check_driver_is_up_to_date=True)
driver = webdriver.Chrome(filename)
driver.get('https://google.com')
```
Or you can use library to download and update chromedriver and geckodriver binaries at the same time.
```python
from selenium_driver_updater import DriverUpdater
from selenium import webdriver
import os
base_dir = os.path.dirname(os.path.abspath(__file__))
list_drivers = [DriverUpdater.chromedriver, DriverUpdater.geckodriver]
filenames = DriverUpdater.install(path=base_dir, driver_name=list_drivers, upgrade=True, check_driver_is_up_to_date=True)
print(filenames)
driver_chrome = webdriver.Chrome(filename[0])
driver_chrome.get('https://google.com')
driver_firefox = webdriver.Firefox(filename[1])
driver_firefox.get('https://google.com')
```
## Usage with help of command line
Use
```bash
selenium-driver-updater --help
```
To see all available arguments and commands
This example shows how you can use this console updater to download chromedriver to current dir
```bash
selenium-driver-updater -d chromedriver
```
Or you can use console updater to download chromedriver and geckodriver at the same time
```bash
selenium-driver-updater -d chromedriver,geckodriver
```
# Supported Selenium Binaries
### ``Chromedriver``
#### ``DriverUpdater.chromedriver``
For installing or updating [chromedriver binary](https://chromedriver.chromium.org)
All supported OS for this driver are:
- Windows
- Linux
- MacOS
- MacOS with M1
### ``Geckodriver``
#### ``DriverUpdater.geckodriver``
For installing or updating [geckodriver binary](https://github.com/mozilla/geckodriver/releases)
All supported OS's for this driver are:
- Windows
- Windows ARM
- Linux
- Linux ARM
- MacOS
- MacOS with M1
### ``Operadriver``
#### ``DriverUpdater.operadriver``
For installing or updating [operadriver binary](https://github.com/operasoftware/operachromiumdriver)
All supported OS's for this driver are:
- Windows
- Linux
- MacOS
### ``Edgedriver``
#### ``DriverUpdater.edgedriver``
For installing or updating [edgedriver binary](https://developer.microsoft.com/ru-ru/microsoft-edge/tools/webdriver/)
All supported OS's for this driver are:
- Windows
- Windows ARM
- MacOS
- MacOS with M1
- Linux
### ``PhantomJS``
#### ``DriverUpdater.phantomjs``
For installing or updating [phantomjs binary](https://phantomjs.org/)
All supported OS's for this driver are:
- Windows
- MacOS
- Linux
### ``SafariDriver``
#### ``DriverUpdater.safaridriver``
For installing or updating [safaridriver binary](https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari)
All supported OS's for this driver are:
- MacOS
# Supported browsers for updates
### ``Chrome Browser``
For updating [chrome browser](https://www.google.com/chrome/)
All supported OS's for this browser are:
- MacOS
### ``Firefox Browser``
For updating [firefox browser](https://www.mozilla.org/en-US/firefox/)
All supported OS's for this browser are:
- MacOS
### ``Opera Browser``
For updating [opera browser](https://www.opera.com)
All supported OS's for this browser are:
- Windows 32 / 64 / ARM
- MacOS
### ``Edge Browser``
For updating [edge browser](https://www.microsoft.com/en-us/edge)
All supported OS's for this browser are:
- MacOS
Raw data
{
"_id": null,
"home_page": "https://github.com/Svinokur/selenium_driver_updater",
"name": "selenium-driver-updater",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "chromedriver,operadriver,edgedriver,safaridriver,selenium,seleniumdriver,chromedriver-binary,selenium-binary,selenium-python,selenium-driver,geckodriver,geckodriver-binary,operadriver-binary,edgedriver-binary,safaridriver-binary,chromebrowser,chrome-browser,firefox,firefox-browser,selenium-update,selenium-updater,updater",
"author": "Stanislav Vinokur",
"author_email": "stasvinokur@yahoo.com",
"download_url": "https://files.pythonhosted.org/packages/71/42/8b0aa2548675ffe0bf8074357d7f9a51baa8934deb370937e2ac725b849e/selenium_driver_updater-6.0.3.tar.gz",
"platform": null,
"description": "# selenium_driver_updater\n\n[![PyPI version](https://badge.fury.io/py/selenium-driver-updater.svg)](https://badge.fury.io/py/selenium-driver-updater)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater)](https://pepy.tech/project/selenium-driver-updater)\n[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater/month)](https://pepy.tech/project/selenium-driver-updater)\n[![Downloads](https://static.pepy.tech/badge/selenium-driver-updater/week)](https://pepy.tech/project/selenium-driver-updater)\n[![Donate with Bitcoin](https://en.cryptobadges.io/badge/micro/32GJnnDrPkSKVzrRho84KwD5RsMW4ywMiW)](https://en.cryptobadges.io/donate/32GJnnDrPkSKVzrRho84KwD5RsMW4ywMiW)\n[![Donate with Ethereum](https://en.cryptobadges.io/badge/micro/0xf2691CC12a70B4589edf081E059fD4A1c457417D)](https://en.cryptobadges.io/donate/0xf2691CC12a70B4589edf081E059fD4A1c457417D)\n\n[![Windows](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/windows-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/windows-tests.yml)\n[![macOS](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/macOS-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/macOS-tests.yml)\n[![Ubuntu](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/ubuntu-tests.yml/badge.svg)](https://github.com/Svinokur/selenium_driver_updater/actions/workflows/ubuntu-tests.yml)\n\nIt is a fast and convenience package that can automatically download or update Selenium webdriver binaries and their browsers for different OS.\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install selenium_driver_updater.\n\n```\npip install selenium-driver-updater\n```\n\n## Usage in code\nThis example shows how you can use this library to download chromedriver binary and use it immediately.\n```python\nfrom selenium_driver_updater import DriverUpdater\nfrom selenium import webdriver\nimport os\n\nbase_dir = os.path.dirname(os.path.abspath(__file__))\n\nfilename = DriverUpdater.install(path=base_dir, driver_name=DriverUpdater.chromedriver, upgrade=True, check_driver_is_up_to_date=True)\n\ndriver = webdriver.Chrome(filename)\ndriver.get('https://google.com')\n\n```\n\nOr you can use library to download and update chromedriver and geckodriver binaries at the same time.\n```python\nfrom selenium_driver_updater import DriverUpdater\nfrom selenium import webdriver\nimport os\n\nbase_dir = os.path.dirname(os.path.abspath(__file__))\nlist_drivers = [DriverUpdater.chromedriver, DriverUpdater.geckodriver]\n\nfilenames = DriverUpdater.install(path=base_dir, driver_name=list_drivers, upgrade=True, check_driver_is_up_to_date=True)\nprint(filenames)\n\ndriver_chrome = webdriver.Chrome(filename[0])\ndriver_chrome.get('https://google.com')\n\ndriver_firefox = webdriver.Firefox(filename[1])\ndriver_firefox.get('https://google.com')\n\n```\n\n## Usage with help of command line\nUse \n```bash\nselenium-driver-updater --help\n```\nTo see all available arguments and commands\n\nThis example shows how you can use this console updater to download chromedriver to current dir \n```bash\nselenium-driver-updater -d chromedriver\n```\n\nOr you can use console updater to download chromedriver and geckodriver at the same time\n```bash\nselenium-driver-updater -d chromedriver,geckodriver\n```\n\n# Supported Selenium Binaries\n\n### ``Chromedriver`` \n#### ``DriverUpdater.chromedriver``\n\nFor installing or updating [chromedriver binary](https://chromedriver.chromium.org)\n\nAll supported OS for this driver are:\n\n- Windows\n- Linux\n- MacOS\n- MacOS with M1\n\n### ``Geckodriver`` \n#### ``DriverUpdater.geckodriver``\n\nFor installing or updating [geckodriver binary](https://github.com/mozilla/geckodriver/releases)\n\nAll supported OS's for this driver are:\n\n- Windows\n- Windows ARM\n- Linux\n- Linux ARM\n- MacOS\n- MacOS with M1\n\n### ``Operadriver`` \n#### ``DriverUpdater.operadriver``\n\nFor installing or updating [operadriver binary](https://github.com/operasoftware/operachromiumdriver)\n\nAll supported OS's for this driver are:\n\n- Windows\n- Linux\n- MacOS\n\n### ``Edgedriver`` \n#### ``DriverUpdater.edgedriver``\n\nFor installing or updating [edgedriver binary](https://developer.microsoft.com/ru-ru/microsoft-edge/tools/webdriver/)\n\nAll supported OS's for this driver are:\n\n- Windows\n- Windows ARM\n- MacOS\n- MacOS with M1\n- Linux\n\n### ``PhantomJS`` \n#### ``DriverUpdater.phantomjs``\n\nFor installing or updating [phantomjs binary](https://phantomjs.org/)\n\nAll supported OS's for this driver are:\n\n- Windows\n- MacOS\n- Linux\n\n### ``SafariDriver`` \n#### ``DriverUpdater.safaridriver``\n\nFor installing or updating [safaridriver binary](https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari)\n\nAll supported OS's for this driver are:\n\n- MacOS\n\n# Supported browsers for updates\n\n### ``Chrome Browser``\n\nFor updating [chrome browser](https://www.google.com/chrome/)\n\nAll supported OS's for this browser are:\n\n- MacOS\n\n### ``Firefox Browser``\n\nFor updating [firefox browser](https://www.mozilla.org/en-US/firefox/)\n\nAll supported OS's for this browser are:\n\n- MacOS\n\n### ``Opera Browser``\n\nFor updating [opera browser](https://www.opera.com)\n\nAll supported OS's for this browser are:\n\n- Windows 32 / 64 / ARM\n- MacOS\n\n### ``Edge Browser``\n\nFor updating [edge browser](https://www.microsoft.com/en-us/edge)\n\nAll supported OS's for this browser are:\n\n- MacOS\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Download or update your Selenium driver binaries and their browsers automatically with this package",
"version": "6.0.3",
"project_urls": {
"Homepage": "https://github.com/Svinokur/selenium_driver_updater"
},
"split_keywords": [
"chromedriver",
"operadriver",
"edgedriver",
"safaridriver",
"selenium",
"seleniumdriver",
"chromedriver-binary",
"selenium-binary",
"selenium-python",
"selenium-driver",
"geckodriver",
"geckodriver-binary",
"operadriver-binary",
"edgedriver-binary",
"safaridriver-binary",
"chromebrowser",
"chrome-browser",
"firefox",
"firefox-browser",
"selenium-update",
"selenium-updater",
"updater"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "71428b0aa2548675ffe0bf8074357d7f9a51baa8934deb370937e2ac725b849e",
"md5": "ae5d5635695c1f572b90f3bafaad0e82",
"sha256": "b2cd3ccf4aadb8170ba8113c878693e12883fb9cd56ca891e3646ff2683517e5"
},
"downloads": -1,
"filename": "selenium_driver_updater-6.0.3.tar.gz",
"has_sig": false,
"md5_digest": "ae5d5635695c1f572b90f3bafaad0e82",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 27706,
"upload_time": "2024-03-07T10:35:50",
"upload_time_iso_8601": "2024-03-07T10:35:50.654208Z",
"url": "https://files.pythonhosted.org/packages/71/42/8b0aa2548675ffe0bf8074357d7f9a51baa8934deb370937e2ac725b849e/selenium_driver_updater-6.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-07 10:35:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Svinokur",
"github_project": "selenium_driver_updater",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "selenium-driver-updater"
}