From c8fff617d4c2a3b0dbc95c7ced8ff9b50d00cac6 Mon Sep 17 00:00:00 2001 From: titusfortner Date: Fri, 28 Jul 2023 17:03:54 -0500 Subject: [PATCH 1/2] update readme with future plans --- README.md | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 57bfaa5a..d3775fd3 100644 --- a/README.md +++ b/README.md @@ -5,22 +5,40 @@ Run Selenium tests more easily with automatic installation and updates for all supported webdrivers. -## Update: Selenium Manager +## Update: Future of this Project -Selenium is working to make all 3rd party driver managers obsolete with a single solution that works in all -languages. The new Selenium Manager is [still in beta](https://github.com/orgs/SeleniumHQ/projects/5), -but if you are using Selenium 4.6+ you may not need this gem. +With Google's new Chrome for Testing project, a number of things have changed that affect this project. -The current logic (as of Selenium 4.8) determines driver path in this order: -* Specified in a `Service` constructor provided as an argument in the `Driver` constructor -* Specified by `driver_path` attribute accessor for the `Service` class (which is what this gem does) -* Located in a directory included in the `PATH` environment variable -* Located in the directory Selenium Manager has downloaded it to - -If you don't have any drivers in locations on `PATH`, you can try not requiring this gem and see if you still need it. +Selenium 4.11 implements driver management (and more!) in a more maintainable way than this gem +with the new [Selenium Manager](https://www.selenium.dev/documentation/selenium_manager/). +If you can update to Selenium 4.11, please do so and stop requiring this gem. Please provide feedback or raise issues with [Selenium Project](https://github.com/SeleniumHQ/selenium/issues/new/choose) +If you cannot update to Selenium 4.11 but are using Selenium 4, the next release of this gem should provide +proper support for downloading Chromedriver 115+. + +If you cannot update to Selenium 4, you can set the required version of chromedriver to v114 +(`Webdrivers.required_version = '114.0.5735.90'`) and +[Disable the build check](https://www.selenium.dev/documentation/webdriver/browsers/chrome/#disabling-build-check). +This is not guaranteed to continue working and will not receive bug fixes. The goal is to have a +Webdrivers 6 that provides support for older versions of Ruby and Selenium. + +The current plan: + +**Webdrivers 5.3.0** +* Merge https://github.com/titusfortner/webdrivers/pull/249 to get a basic fix +* Set the maximum Selenium version to 4.10 + +**Webdrivers 5.3.1** +* add a `#post_install_message` telling people to update to Selenium 4.11 and not to require this gem + +**Webdrivers 6.0** +* create a `selenium-manager.gem` based off of https://github.com/SeleniumHQ/selenium/pull/12429 +* re-implement this gem to wrap `selenium-manager.gem` +* make this gem less restrictive to versions of Selenium / Ruby + + ## Description `webdrivers` downloads drivers and directs Selenium to use them. Currently supports: From 361dba07581d8c890bea45bf6223158a186bd636 Mon Sep 17 00:00:00 2001 From: titusfortner Date: Sun, 30 Jul 2023 15:44:49 -0500 Subject: [PATCH 2/2] clarifications and update versions --- README.md | 30 ++++++++++++++---------------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index d3775fd3..f9af7539 100644 --- a/README.md +++ b/README.md @@ -7,37 +7,35 @@ Run Selenium tests more easily with automatic installation and updates for all s ## Update: Future of this Project -With Google's new Chrome for Testing project, a number of things have changed that affect this project. +With Google's new [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) project, +and Selenium's new [Selenium Manager](https://www.selenium.dev/documentation/selenium_manager/) feature, +what is required of this gem has changed.. -Selenium 4.11 implements driver management (and more!) in a more maintainable way than this gem -with the new [Selenium Manager](https://www.selenium.dev/documentation/selenium_manager/). - -If you can update to Selenium 4.11, please do so and stop requiring this gem. +If you can update to to the latest version of Selenium, please do so and stop requiring this gem. +Selenium 4.10 will work for Chrome v115 (ignore the warning), and Selenium 4.11 will work for everything going forward. Please provide feedback or raise issues with [Selenium Project](https://github.com/SeleniumHQ/selenium/issues/new/choose) -If you cannot update to Selenium 4.11 but are using Selenium 4, the next release of this gem should provide -proper support for downloading Chromedriver 115+. - -If you cannot update to Selenium 4, you can set the required version of chromedriver to v114 +If you cannot upgrade to the latest version of Selenium, you can set the required version of chromedriver to v114 (`Webdrivers.required_version = '114.0.5735.90'`) and [Disable the build check](https://www.selenium.dev/documentation/webdriver/browsers/chrome/#disabling-build-check). -This is not guaranteed to continue working and will not receive bug fixes. The goal is to have a -Webdrivers 6 that provides support for older versions of Ruby and Selenium. +This is not guaranteed to continue working and will not receive bug fixes. The current plan: **Webdrivers 5.3.0** -* Merge https://github.com/titusfortner/webdrivers/pull/249 to get a basic fix +* Merge https://github.com/titusfortner/webdrivers/pull/249 to get a basic fix for Chrome for Testing support * Set the maximum Selenium version to 4.10 +* Continue to support Ruby 2.6+ and Selenium 4+ **Webdrivers 5.3.1** -* add a `#post_install_message` telling people to update to Selenium 4.11 and not to require this gem +* Add a `#post_install_message` telling people to update to Selenium 4.11 and not to require this gem **Webdrivers 6.0** -* create a `selenium-manager.gem` based off of https://github.com/SeleniumHQ/selenium/pull/12429 -* re-implement this gem to wrap `selenium-manager.gem` -* make this gem less restrictive to versions of Selenium / Ruby +* Create a `selenium-manager.gem` based off of https://github.com/SeleniumHQ/selenium/pull/12429 +* Re-implement this gem to wrap `selenium-manager.gem` +* Add support for Selenium 3.142 and investigate support for Ruby 2.4 / 2.5 +If anyone would like to help get Webdrivers 6 working, please let us know. ## Description