webdrivers 2.3.2 → 4.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: be63f40b8706535bc265158e0f481b2620886679
-  data.tar.gz: 7f6f4c8584e86f1f7826ffaf24c596bcaa8e6f5d
+SHA256:
+  metadata.gz: 124d154092dc8915735f459f0476c7700e47300bec986e9b88ba214b2db8b92c
+  data.tar.gz: 9db15712e5227ef9b92db34a7d1714ba9613ca2bd30563b85cf5dbeee5322063
 SHA512:
-  metadata.gz: bda8a2749978eda9c85b2e2f7373844f8a45764f4803cfa64211cae6b0e14c0d80fcfb9fa8055b89089a84ace9c0822055947845242a196e7dac0a0079b312af
-  data.tar.gz: 9b7be7499c0807a35ddca73705d275dcd062427450b6bd3001f53030d4b6f8d3123e0c5e86a174aedd0a1f9bc5c02928db5da1813cf0bf6f371bdc85590dde2c
+  metadata.gz: 727a676f6b025291ecc30fff84b16159820607f4dba0c1216b3c1487f56b5bb4da8679b69b464a5234dc78d872da4b63112b11d60efd3fbb72cfbaf61ea57223
+  data.tar.gz: 744f5a8173676d02b2f94ff3eda885ec77d47a4e2e04cbfaa04876262e500e906313f6280d0a12e93274ba7f558886a035879d72b0264903fc695c2139b4ca83

data/CHANGELOG.md

@@ -1,106 +1,254 @@
-Changelog
-==========
+# 4.7.0 (2021-10-14)
+* Add support for Selenium 4.x #218 (thanks yahonda )
+* Allow Edge on Linux
+* Update required Selenium > 3.141 because of a change in 4.6
+* Require Selenium 2.6+
+* Fix IE downloads with the change in location of assets
+
+# 4.6.1 (2021-08-19)
+* Fix bug in IEdriver caused by bad formatting in recent release
+
+# 4.6.0 (2021-02-26)
+* Update `Edgedriver` naming to support Selenium 4 beta (([#206](https://github.com/titusfortner/webdrivers/pull/206))
+
+# 4.5.0 (2021-01-19)
+* Improve format of README usage section. Thanks, [okuramasafumi](https://github.com/okuramasafumi)!
+* `chromedriver` - Add support for Apple M1 specific builds ([#193](https://github.com/titusfortner/webdrivers/pull/193)). Thanks, [MichaelHoste](https://github.com/MichaelHoste)!
+* `msedgedriver` - Add support for Apple M1 specific builds.
+* `msedgedriver` - Added automatic selection of 32-bit vs 64-bit builds on Windows and WSLv1.  
+* When using this gem in WSLv2, Chrome installed on the Linux filesystem will be automatically used ([#196](https://github.com/titusfortner/webdrivers/pull/196)). 
+  WSLv1 continues to automatically use Chrome from the Windows filesystem though. Thanks, [fabioxgn](https://github.com/fabioxgn)!
+  * We'll aim to make the behavior consistent in a future release.
+
+### 4.4.2 (2020-12-29)
+* Use new powershell if available to enhance WSL support ([#176](https://github.com/titusfortner/webdrivers/issues/176), 
+  [#186](https://github.com/titusfortner/webdrivers/pull/186)). Thanks, [G-Rath](https://github.com/G-Rath) and 
+  [131](https://github.com/131)!
+* Update rubocop version (development dependency only) ([#178](https://github.com/titusfortner/webdrivers/pull/178)).
+  Thanks, [utkarsh2102](https://github.com/utkarsh2102)!
+* Replace `git ls-files` with `dir` in the gemspec for better Debian support ([#179](https://github.com/titusfortner/webdrivers/pull/179),
+  [#184](https://github.com/titusfortner/webdrivers/issues/184)).
+  Thanks again, [utkarsh2102](https://github.com/utkarsh2102)!
+* Update README with `require: false` when adding gem to Gemfile ([#183](https://github.com/titusfortner/webdrivers/pull/183)).
+* Make WSL detection more generic ([#187](https://github.com/titusfortner/webdrivers/pull/187)).
+  [rbclark](https://github.com/rbclark)!
+  
+### 4.4.1 (2020-06-01)
+* Do not include binstubs used for troubleshooting only. Fixes [#174](https://github.com/titusfortner/webdrivers/issues/174).
+
+### 4.4.0 (2020-05-31)
+* Implement support for `chromedriver` in Windows Subsystem for Linux (WSL) v1 ([#172](https://github.com/titusfortner/webdrivers/issues/172)). 
+  Thanks, [G-Rath](https://github.com/G-Rath)!
+* Chrome/Edgedriver - Fix [#171](https://github.com/titusfortner/webdrivers/issues/171) by making sure the cached
+driver build version matches the browser build version before using it.
+* Chrome/Edgedriver - Driver version check now matches the driver and browser `major.minor.build` versions instead of just 
+the major version to be fully compliant with the `chromedriver` version selection
+[document](https://chromedriver.chromium.org/downloads/version-selection).
+
+### 4.3.0 (2020-04-14)
+* Add support for Microsoft Edge (Chromium) stable
+* Drop support for Ruby < 2.4.0
+
+### 4.2.0 (2019-12-27)
+* Add support for Microsoft Edge (Chromium) Beta releases ([#155](https://github.com/titusfortner/webdrivers/pull/155))
+* Use tilde expansion to resolve user's home directory ([#166](https://github.com/titusfortner/webdrivers/pull/161))
+* Add support for Chromium installed using Snap on Ubuntu ([#163](https://github.com/titusfortner/webdrivers/pull/163)). Thanks Tietew!
+
+### 4.1.3 (2019-10-07)
+* Require rubyzip version 1.3.0 or higher to fix [rubyzip#403](https://github.com/rubyzip/rubyzip/pull/403). Thanks rhymes! ([#153](https://github.com/titusfortner/webdrivers/pull/153))
+* Fix a bug where the file deletion confirmation was printed even when there were no files to delete.
+
+### 4.1.2 (2019-07-29)
+* Fix a bug related to raising `BrowserNotFound`.
+
+### 4.1.1 (2019-07-18)
+* Raise `BrowserNotFound` if Chrome and Edge binary are not found (issue [#144](https://github.com/titusfortner/webdrivers/issues/144)).
+
+### 4.1.0 (2019-07-03)
+* Add support for `msedgedriver` (issue [#93](https://github.com/titusfortner/webdrivers/issues/93))
+* Allow users to provide a custom binary path via `WD_CHROME_PATH` 
+and `WD_EDGE_CHROME_ATH` environment variables (issues #[137](https://github.com/titusfortner/webdrivers/issues/137) 
+and [#93](https://github.com/titusfortner/webdrivers/issues/93))
+* Fix a bug where the user given Chrome binary path via `Selenium::WebDriver::Chrome.path` 
+was not properly escaped (issue [#139](https://github.com/titusfortner/webdrivers/issues/139))
+* Fix miscellaneous code warnings.
+* ~~**Announcement**: As of 06/21/2019, `heroku-buildpack-google-chrome` 
+no longer requires a [workaround](https://github.com/titusfortner/webdrivers/wiki/Heroku-buildpack-google-chrome) 
+to work with this gem. See [heroku-buildpack-google-chrome#73](https://github.com/heroku/heroku-buildpack-google-chrome/pull/73) 
+for more information.~~
+
+### 4.0.1 (2019-06-12)
+* Cache time now defaults to 86,400 Seconds (24 hours). Please note the special exception for `chromedriver` in the [README](https://github.com/titusfortner/webdrivers#special-exception-for-chromedriver-and-msedgedriver) (issue [#132](https://github.com/titusfortner/webdrivers/issues/132))
+* Properly escape Chrome binary path when using JRuby on Windows (issue [#130](https://github.com/titusfortner/webdrivers/issues/130))
+* Allow use of `selenium-webdriver` v4 (pre-releases only)
+
+### 4.0.0 (2019-05-28)
+
+No changes since rc2. Please report any issues [here](https://github.com/titusfortner/webdrivers/issues)
+or join us in the `#webdrivers-gem` channel on [Slack](https://seleniumhq.herokuapp.com/) if you 
+have questions.
+
+### 4.0.0.rc2 (2019-05-21)
+* Fix a bug with `WD_CACHE_TIME` when using the rake tasks (issue [#123](https://github.com/titusfortner/webdrivers/pull/123))
+
+### 4.0.0.rc1 (2019-05-20)
+* Locate Chrome binary the same way as chromedriver to ensure the correct browser version is 
+obtained by default (issue [#45](https://github.com/titusfortner/webdrivers/issues/45))
+* Add rake tasks for update, remove and version 
+(issues [#28](https://github.com/titusfortner/webdrivers/issues/28) 
+[#77](https://github.com/titusfortner/webdrivers/issues/77))
+* Removed all deprecated code
+
+### 3.9.4 (2019-05-20)
+* Fix bug from bug fix that warned users about setting cache time when it was already set (issue [#118](https://github.com/titusfortner/webdrivers/pull/118)) 
+* Make #base_url public for easier mocking (issue [#109](https://github.com/titusfortner/webdrivers/issues/109))
 
-2.3.2 - 2016-11-26
-----------
+### 3.9.3 (2019-05-17)
+* Fix the bug that warned users about setting cache time when it was already set 
+([#118](https://github.com/titusfortner/webdrivers/pull/118), thanks Eduardo Gutierrez)
 
-* Bug fixes for Windows
+### 3.9.2 (2019-05-14)
+* Allow webdrivers to handle network mocking ([#116](https://github.com/titusfortner/webdrivers/pull/116))
+* Fix a Windows specific bug when decompressing the driver packages 
+([#114](https://github.com/titusfortner/webdrivers/pull/114))
 
+### 3.9.1 (2019-05-09)
+* Fix bug throwing nil warnings (issue #107)
+* Fix bug preventing running on older versions of Selenium
 
-2.3.1 - 2016-11-26
-----------
+### 3.9.0 (2019-05-07)
+* Make public methods more obvious and deprecate unnecessary methods (issue #36)
+* Allow geckodriver binaries to be downloaded directly (issue #30)
+* Allow drivers to be cached to reduce unnecessary network calls (issue #29)
+* MSWebdriver class is removed as no longer supported 
+* Refactored to minimize network calls (issue #80)
+* Fix warnings about instance variables not initialized
+* Add support for managing specific drivers (issue #95)
 
-* Bug fixes for Windows
+### 3.8.1 (2019-05-04)
+* Downloads chromedriver with direct URL instead of parsing the downloads page
+* Raises exception if version of Chrome does not have a known version of the driver (issue #79)
+* Fixed bug warning of non-initialized variables (issue #62)
+* Fixed bug with threads/processes colliding by downloading to temp files
+* Fixed bug for file locking issue on Windows
 
+### 3.8.0 (2019-04-17)
+* Add support for `selenium-webdriver` v4. See [#69](https://github.com/titusfortner/webdrivers/pull/69).
+* Remove dependency on `net_http_ssl_fix` gem. `Webdrivers.net_http_ssl_fix` now raises an exception and 
+points to other solutions. See [#60](https://github.com/titusfortner/webdrivers/pull/60) and 
+[#68](https://github.com/titusfortner/webdrivers/pull/68) (thanks Samuel Williams & Maik Arnold).
 
-2.3.0 - 2016-11-26
-----------
+### 3.7.2 (2019-04-01)
+* Fix bugs in methods that retrieve Chrome/Chromium version. 
+See [#43](https://github.com/titusfortner/webdrivers/pull/43) 
+and [#52](https://github.com/titusfortner/webdrivers/issues/52) (Thanks Ochko). 
+* Add workaround for a Jruby bug when retrieving Chrome version on Windows. 
+See [#41](https://github.com/titusfortner/webdrivers/issues/41).
+* Update README with more information.
 
-* Implement IEDriver support
-* Implement MicrosoftWebDriver support
+### 3.7.1 (2019-03-25)
+* Use `Selenium::WebDriver::Chrome#path` to check for a user given browser executable 
+before defaulting to Google Chrome. Addresses [#38](https://github.com/titusfortner/webdrivers/issues/38).
+* Download `chromedriver` v2.46 if Chrome/Chromium version is less than 70.
 
+### 3.7.0 (2019-03-19)
 
-2.2.1 - 2016-11-26
-----------
+* `chromedriver` version now matches the installed Chrome version. 
+See [#32](https://github.com/titusfortner/webdrivers/pull/32).
 
-* Bug fixes for Windows
+### 3.6.0 (2018-12-30)
 
+* Put net_http_ssl_fix inside a toggle since it can cause other issues
 
-2.2.0 - 2016-11-26
-----------
+### 3.5.2 (2018-12-16)
 
-* Implement phantomjs support
+* Use net_http_ssl_fix to address Net::HTTP issues on windows
 
+### 3.5.1 (2018-12-16)
 
-2.1.1 - 2016-11-26
-----------
+### 3.5.0 (2018-12-15)
 
-* Improve Decompression Approach
+### 3.5.0.beta1 (2018-12-15)
 
+* Allow version to be specified
 
-2.1.0 - 2016-11-25
-----------
+### 3.4.3 (2018-10-22)
 
-* Implemented geckodriver support
+* Fix bug with JRuby and geckodriver (thanks twalpole)
 
+### 3.4.2 (2018-10-15)
 
-2.0.0 - 2016-11-25
-----------
+* Use chromedriver latest version 
 
-* Renamed fork from chromedriver-helper to webdrivers
-* Re-implemented chromedriver usage
+### 3.4.1 (2018-09-17)
 
+* Hardcode latest chromedriver version to 2.42 until we figure out chromedriver 70 
 
-1.0.0 - 2015-06-06
-----------
+### 3.4.0 (2018-09-07)
 
-* Updated gemspec info. Happy 1.0!
+* Allow public access to `#install_dir` and `#binary`
+* Allow user to set the default download directory
+* Improve version comparisons with use of `Gem::Version` 
 
+### 3.3.3 (2018-08-14)
 
-0.0.9 - 2015-06-06
-----------
+* Fix Geckodriver since Github changed its html again
 
-* No longer require 'curl' or 'wget', or 'unzip' utilities to be installed. You know, for Windows. (Thanks, @elementc!)
-* Support JRuby by removing dependency on native-C-extension gem. (Thanks, Marques Lee!)
+### 3.3.2 (2018-05-04)
 
+* Fix bug with IEDriver versioning (Thanks Aleksei Gusev)
 
-0.0.8 - 2015-01-23
-----------
+### 3.3.1 (2018-05-04)
 
-* Guaranteeing that we get the *latest* version of chromedriver. (#15) (Thanks, @AlexRiedler!)
+* Fix bug with MSWebdriver to fetch the correct driver instead of latest (Thanks kapoorlakshya) 
 
+### 3.3.0 (2018-04-29)
 
-0.0.7 - 26 Aug 2014
-----------
+* Ensures downloading correct MSWebdriver version (Thanks kapoorlakshya) 
 
-* Added support for windows binaries. (Thanks, @elementc!)
+### 3.2.4 (2017-01-04)
 
+* Improve error message when unable to find the latest driver
 
-0.0.6 - 26 Aug 2014
-----------
+### 3.2.3 (2017-12-12)
 
-* Fixed to work with new Google download page. #7 (Thanks, @mars!)
+* Fixed bug with finding geckodriver on updated Github release pages
 
+### 3.2.2 (2017-11-20)
 
-0.0.5 - 15 Aug 2012
-----------
+* Fixed bug in `#untargz_file` (thanks Jake Goulding)
 
-* Fixed support for JRuby on non-Windows platforms. #4 (Thanks, Tim Olsen!)
+### 3.2.1 (2017-09-06)
 
+* Fixed Proxy support so it actually works (thanks Cheezy) 
 
-0.0.4 - 1 Aug 2012
-----------
+### 3.2.0 (2017-08-21)
 
-* Including `chromedriver-update` to easily allow people to force-upgrade. #3
+* Implemented Proxy support 
 
+### 3.1.0 (2017-08-21)
 
-0.0.3 - 20 Mar 2012
-----------
+* Implemented Logging functionality 
 
-* Updated download URL. #2 (Thanks, Alistair Hutchison!)
+### 3.0.1 (2017-08-18)
 
+* Create ~/.webdrivers directory if doesn't already exist 
 
-0.0.2 - 6 December 2011
-----------
+### 3.0.0 (2017-08-17)
 
-* Birthday!
+* Removes unnecessary downloads 
+
+### 3.0.0.beta3 (2017-08-17)
+
+* Supports Windows
+* Supports mswebdriver and iedriver
+
+### 3.0.0.beta2 (2017-08-16)
+
+* Supports geckodriver on Mac and Linux
+
+### 3.0.0.beta1 (2017-08-15)
+
+* Complete Rewrite of 2.x
+* Implemented with Monkey Patch not Shims
+* Supports chromedriver on Mac and Linux

data/LICENSE.txt

@@ -1,7 +1,7 @@
 (The MIT License)
 
-Copyright (c) 2011,2012,2013,2014,2015: [Mike Dalessio](http://mike.daless.io)
-Copyright (c) 2016: Titus Fortner
+Copyright (c) 2017-2019: Titus Fortner
+Copyright (c) 2019: Lakshya Kapoor, Thomas Walpole
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,37 +1,273 @@
 # Webdrivers
 
-[![Build status](https://api.travis-ci.org/titusfortner/webdrivers.svg)](https://travis-ci.org/titusfortner/webdrivers)
+[![Gem Version](https://badge.fury.io/rb/webdrivers.svg)](https://badge.fury.io/rb/webdrivers)
+![Tests](https://github.com/titusfortner/webdrivers/workflows/Tests/badge.svg)
 
-Run Selenium tests more easily with install and updates for all supported webdrivers.
+Run Selenium tests more easily with automatic installation and updates for all supported webdrivers.
 
-# Description
+## Description
 
-`webdrivers` installs driver executables, in your gem path.
-`chromedriver` and `geckodriver` are currently supported.
+`webdrivers` downloads drivers and directs Selenium to use them. Currently supports:
 
-Drivers are stored in `~/.webdrivers` directory and used within the context of your gem path
+* [chromedriver](http://chromedriver.chromium.org/)
+* [geckodriver](https://github.com/mozilla/geckodriver)
+* [IEDriverServer](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)
+* [msedgedriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/)
 
+Works on macOS, Linux, Windows, and Windows Subsystem for Linux (WSL) v1 and v2. And do see the browser and OS specific
+notes at the bottom.
 
-# Usage
+## Usage
 
-`gem install webdrivers`
+In your Gemfile:
 
-or in your Gemfile: 
+```ruby
+gem 'webdrivers', '~> 4.0', require: false
+```
 
-`gem "webdrivers", "~> 2.1"`
+In your project:
 
+```ruby
+require 'webdrivers'
+```
 
-# License
+The drivers will now be automatically downloaded or updated when you launch a browser
+through Selenium.
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT), 
-see LICENSE.txt for full details and copyright.
+### Specific Drivers
 
+If you want webdrivers to only manage specific drivers you can specify one or more as follows:
 
-# Contributing
+```ruby
+require 'webdrivers/chromedriver'
+require 'webdrivers/geckodriver'
+require 'webdrivers/iedriver'
+require 'webdrivers/edgedriver'
+```
 
-Bug reports and pull requests are welcome [on GitHub](https://github.com/titusfortner/webdrivers).
+### Download Location
+
+The default download location is `~/.webdrivers` directory, and this is configurable:
+
+ ```ruby
+ Webdrivers.install_dir = '/webdrivers/install/dir'
+```
+
+Alternatively, you can define the path via the `WD_INSTALL_DIR` environment
+variable.
+
+### Version Pinning
+
+If you would like to use a specific (older or beta) version, you can specify it for each driver. Otherwise,
+the latest (stable) driver will be downloaded and passed to Selenium.
+
+```ruby
+# Chrome
+Webdrivers::Chromedriver.required_version = '2.46'
+
+# Firefox
+Webdrivers::Geckodriver.required_version  = '0.23.0'
+
+# Internet Explorer
+Webdrivers::IEdriver.required_version     = '3.14.0'
+
+# Edge (Chromium)
+Webdrivers::Edgedriver.required_version   = '76.0.183.0'
+```
+
+You can explicitly trigger the update in your code, but this will happen
+automatically when the driver is initialized:
+
+```ruby
+Webdrivers::Chromedriver.update
+```
+
+### Caching Drivers
+
+You can set Webdrivers to only look for updates if the previous check
+was longer ago than a specified number of seconds.
+
+```ruby
+Webdrivers.cache_time = 86_400 # Default: 86,400 Seconds (24 hours)
+```
+
+Alternatively, you can define this value via the `WD_CACHE_TIME` environment
+variable. **Only set one to avoid confusion**.
+
+##### Special exception for chromedriver and msedgedriver
+
+Cache time will be respected as long as a driver binary exists and the major.minor.build versions of
+the browser and the driver match. For example, if you update Chrome or Edge to v76.0.123 and its driver is
+still at v76.0.100, `webdrivers` will ignore the cache time and update the driver to make sure you're
+using a compatible build version.
+
+### Proxy
+
+If there is a proxy between you and the Internet then you will need to configure
+the gem to use the proxy.  You can do this by calling the `configure` method.
+
+````ruby
+Webdrivers.configure do |config|
+  config.proxy_addr = 'myproxy_address.com'
+  config.proxy_port = '8080'
+  config.proxy_user = 'username'
+  config.proxy_pass = 'password'
+end
+````
+
+### `SSL_connect` errors
+
+If you are getting an error like this (especially common on Windows):
+
+`SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed`
+
+Add the following to your Gemfile:
+
+```ruby
+gem "net_http_ssl_fix"
+```
+
+Add the following to your code:
+
+````ruby
+require 'net_http_ssl_fix'
+````
+
+Other solutions are documented on the RubyGems [website](https://guides.rubygems.org/ssl-certificate-update/).
+
+### Rake tasks
+
+Each driver has its own set of `rake` tasks (with `Railtie` support) that
+you can call once before executing the tests. These are especially
+useful if you're running tests in parallel and want to avoid performing
+an update check per thread.
+
+If you are using Rails default configuration the `webdrivers` gem will only be loaded in the test group
+so you will need to specify the test environment when using the tasks:
+
+```ruby
+RAILS_ENV=test rails webdrivers:chromedriver:update
+```
+
+If you are not using Rails, you'll need to load them into your Rakefile like this:
+
+```ruby
+require 'webdrivers'
+load 'webdrivers/Rakefile'
+```
 
+The full list of available tasks is:
 
-# Credit
+```bash
+$ bundle exec rake -T
+rake webdrivers:chromedriver:remove           # Force remove chromedriver
+rake webdrivers:chromedriver:update[version]  # Remove and download updated chromedriver if necessary
+rake webdrivers:chromedriver:version          # Print current chromedriver version
+rake webdrivers:edgedriver:remove             # Force remove msedgedriver
+rake webdrivers:edgedriver:update[version]    # Remove and download updated msedgedriver if necessary
+rake webdrivers:edgedriver:version            # Print current msedgedriver version
+rake webdrivers:geckodriver:remove            # Force remove geckodriver
+rake webdrivers:geckodriver:update[version]   # Remove and download updated geckodriver if necessary
+rake webdrivers:geckodriver:version           # Print current geckodriver version
+rake webdrivers:iedriver:remove               # Force remove IEDriverServer
+rake webdrivers:iedriver:update[version]      # Remove and download updated IEDriverServer if necessary
+rake webdrivers:iedriver:version              # Print current IEDriverServer version
+```
 
-This is a fork of [chromedriver-helper](https://github.com/flavorjones/chromedriver-helper) gem
+These tasks respect the `WD_INSTALL_DIR`, `WD_CACHE_TIME`, `WD_CHROME_PATH`,
+and `WD_EDGE_CHROME_PATH` environment variables, which can also be passed
+through the `rake` command:
+
+```bash
+$ bundle exec rake webdrivers:chromedriver:update[2.46] webdrivers:geckodriver:update[0.24.0] WD_CACHE_TIME=86_400 WD_INSTALL_DIR='my_dir'
+2019-05-20 19:03:01 INFO Webdrivers Updated to chromedriver 2.46.628388
+2019-05-20 19:03:04 INFO Webdrivers Updated to geckodriver 0.24.0
+```
+
+Please note that these tasks do not use any of the configurations from your
+project (code) and only respect the `ENV` variables and the version (optional)
+passed to the `rake` tasks.
+
+### Logging
+
+The logging level can be configured for debugging purpose:
+
+```ruby
+Webdrivers.logger.level = :DEBUG
+```
+
+### Browser & OS Specific Notes
+
+#### Chrome/Chromium
+
+The version of `chromedriver` will depend on the version of Chrome you are using it with:
+
+ * For versions >= 70, the downloaded version of `chromedriver` will match the installed version of Google Chrome.
+ More information [here](http://chromedriver.chromium.org/downloads/version-selection).
+ * For versions <=  69, `chromedriver` version 2.41 will be downloaded.
+ * For beta versions, you'll have to require the beta version of `chromedriver`
+ using `Webdrivers::Chromedriver.required_version`.
+
+The gem looks for the Chrome/Chromium version that `chromedriver` will use by default.
+You can override this behavior by providing a path to the browser binary you want to use:
+
+```ruby
+Selenium::WebDriver::Chrome.path = '/chromium/install/path/to/binary'
+```
+
+Alternatively, you can define the path via the `WD_CHROME_PATH` environment
+variable.
+
+This is also required if Google Chrome is not installed in its
+[default location](https://github.com/SeleniumHQ/selenium/wiki/ChromeDriver).
+
+#### Chrome on Heroku
+
+Follow the specific instructions [here](https://github.com/titusfortner/webdrivers/wiki/Heroku-buildpack-google-chrome) if you're using `heroku-buildpack-google-chrome`.
+
+#### Microsoft Edge (Chromium)
+
+Microsoft Edge (Chromium) support was added in v4.1.0. Notes
+from the [Chrome/Chromium](https://github.com/titusfortner/webdrivers#chromechromium)
+section apply to this browser as well.
+
+Please note that `msedgedriver` requires `selenium-webdriver` v4.
+
+#### WSLv1 support
+
+While WSLv1 is not designed to run headful applications like Chrome, it can run exes; as such when found to be running
+in WSL, `webdrivers` will use Chrome on the Windows filesystem.
+
+It's recommended that you install the new PowerShell (PS7) to avoid [a known issue](https://github.com/microsoft/terminal/issues/367)
+with the console font being changed when calling the old PowerShell (PS5).
+
+#### WSLv2 support
+
+Webdrivers will detect WSLv2 as running on Linux and use Chrome on the Linux filesystem.
+
+WSLv2 doesn't support connecting to host ports out of the box, so it isn't possible to connect to Chromedriver on
+Windows without extra configurations, see: https://github.com/microsoft/WSL/issues/4619. The simplest way to use 
+Chromedriver with WSLv2 is to run Chrome headless on Linux.
+
+#### Chrome and Edge on Apple M1 (`arm64`)
+
+If you're switching from Intel to M1, you'll have to manually delete the existing Intel (`mac64`) driver before the 
+M1 (`arm64`) build can be downloaded. Otherwise, you'll get an error: `Bad CPU type in executable - ~/.webdrivers/chromedriver (Errno::E086)`
+
+## Wiki
+
+Please see the [wiki](https://github.com/titusfortner/webdrivers/wiki)
+for solutions to commonly reported issues.
+
+Join us in the `#webdrivers-gem` channel on [Slack](https://seleniumhq.herokuapp.com/)
+if you have any questions.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT),
+see LICENSE.txt for full details and copyright.
+
+## Contributing
+
+Bug reports and pull requests are welcome [on GitHub](https://github.com/titusfortner/webdrivers).
+Run `bundle exec rake` and squash the commits in your PRs.

data/lib/webdrivers/Rakefile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'webdrivers'
+
+path = File.expand_path(__dir__)
+Dir.glob("#{path}/tasks/*.rake").each { |f| import f }