Add support for downloading browsers

Author: mdmintz

.gitignore

@@ -82,6 +82,20 @@ msedgedriver.exe
 operadriver.exe
 uc_driver.exe
 
+# Chrome for Testing folders
+chrome-mac-arm64
+chrome-mac-x64
+chrome-linux64
+chrome-win64
+chrome-win32
+
+# Chrome-Headless-Shell folders
+chrome-headless-shell-mac-arm64
+chrome-headless-shell-mac-x64
+chrome-headless-shell-linux64
+chrome-headless-shell-win64
+chrome-headless-shell-win32
+
 # msedgedriver requirements
 libc++.dylib
 

help_docs/webdriver_installation.md

@@ -4,7 +4,7 @@
 
 To run web automation, you need webdrivers for each browser you plan on using.  With SeleniumBase, drivers are downloaded automatically (as needed) into the SeleniumBase `drivers/` folder.
 
-You can also download drivers manually with these commands:
+🎛️ You can also download drivers manually with these commands:
 
 ```bash
 seleniumbase get chromedriver
@@ -16,7 +16,7 @@ After running the commands above, web drivers will get downloaded into the `sele
 
 If the necessary driver is not found in this location while running tests, SeleniumBase will instead look for the driver on the System PATH. If the necessary driver is not on the System PATH either, SeleniumBase will automatically attempt to download the required driver.
 
-* You can also download specific versions of drivers. Examples:
+🎛️ You can also download specific versions of drivers. Examples:
 
 ```bash
 sbase get chromedriver 114
@@ -30,7 +30,7 @@ sbase get chromedriver mlatest  # Milestone latest version for detected browser
 sbase get edgedriver 115.0.1901.183
 ```
 
-(NOTE: ``sbase`` is a shortcut for ``seleniumbase``)
+(NOTE: `sbase` is a shortcut for `seleniumbase`)
 
 --------
 
@@ -48,15 +48,15 @@ Here's where you can go to manually get web drivers from the source:
 
 **macOS shortcuts**:
 
-* You can also install drivers by using ``brew`` (aka ``homebrew``):
+🎛️ You can also install drivers by using ``brew`` (aka ``homebrew``):
 
 ```bash
 brew install --cask chromedriver
 
 brew install geckodriver
 ```
 
-You can also upgrade existing webdrivers:
+🎛️ You can also upgrade existing webdrivers:
 
 ```bash
 brew upgrade --cask chromedriver
@@ -66,7 +66,7 @@ brew upgrade geckodriver
 
 **Linux shortcuts**:
 
-If you still need drivers, these scripts download ``chromedriver`` and ``geckodriver`` to a Linux machine:
+🎛️ If you still need drivers, these scripts download `chromedriver` and `geckodriver` to a Linux machine:
 
 ```bash
 wget https://chromedriver.storage.googleapis.com/114.0.5735.90/chromedriver_linux64.zip
@@ -76,12 +76,30 @@ chmod +x /usr/local/bin/chromedriver
 ```
 
 ```bash
-wget https://github.com/mozilla/geckodriver/releases/download/v0.34.0/geckodriver-v0.34.0-linux64.tar.gz
-tar xvfz geckodriver-v0.34.0-linux64.tar.gz
+wget https://github.com/mozilla/geckodriver/releases/download/v0.35.0/geckodriver-v0.35.0-linux64.tar.gz
+tar xvfz geckodriver-v0.35.0-linux64.tar.gz
 mv geckodriver /usr/local/bin/
 chmod +x /usr/local/bin/geckodriver
 ```
 
 To verify that web drivers are working, **[follow these instructions](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/verify_webdriver.md)**.
 
+--------
+
+**Browser Binaries**:
+
+🎛️ Use the `sbase get` command to download the `Chrome for Testing` and `Chrome-Headless-Shell` browser binaries. Example:
+
+```bash
+sbase get cft  # (For `Chrome for Testing`)
+sbase get chs  # (For `Chrome-Headless-Shell`)
+```
+
+Those commands download those binaries into the `seleniumbase/drivers` folder.
+To use the binaries from there in SeleniumBase scripts, set the `binary_location` to `cft` or `chs`.
+
+(Source: https://googlechromelabs.github.io/chrome-for-testing/)
+
+--------
+
 [<img src="https://seleniumbase.github.io/cdn/img/sb_logo_b.png" title="SeleniumBase" width="280">](https://github.com/seleniumbase/SeleniumBase)

seleniumbase/console_scripts/ReadMe.md

@@ -68,10 +68,12 @@ sbase get chromedriver 114.0.5735.90
 sbase get chromedriver stable
 sbase get chromedriver beta
 sbase get chromedriver -p
+sbase get cft 131
+sbase get chs
 ```
 
-(Drivers:  ``chromedriver``, ``geckodriver``, ``edgedriver``,
-           ``iedriver``, ``uc_driver``)
+(Drivers:  ``chromedriver``, ``cft``, ``uc_driver``,
+           ``edgedriver``, ``chs``, ``geckodriver``)
 
 (Options:  A specific driver version or major version integer.
            If not set, the driver version matches the browser.

seleniumbase/console_scripts/run.py

@@ -139,8 +139,8 @@ def show_install_usage():
     print("     OR: seleniumbase get [DRIVER_NAME] [OPTIONS]")
     print("     OR:    sbase install [DRIVER_NAME] [OPTIONS]")
     print("     OR:        sbase get [DRIVER_NAME] [OPTIONS]")
-    print("         (Drivers: chromedriver, geckodriver,")
-    print("                   edgedriver, iedriver, uc_driver)")
+    print("         (Drivers: chromedriver, cft, uc_driver,")
+    print("                   edgedriver, chs, geckodriver)")
     print("  Options:")
     print("     VERSION    Specify the version to download.")
     print("                Tries to detect the needed version.")
@@ -157,11 +157,15 @@ def show_install_usage():
     print("     sbase get chromedriver stable")
     print("     sbase get chromedriver beta")
     print("     sbase get chromedriver -p")
+    print("     sbase get cft 131")
+    print("     sbase get chs")
     print("  Output:")
     print("     Downloads the webdriver to seleniumbase/drivers/")
     print("     (chromedriver is required for Chrome automation)")
     print("     (geckodriver is required for Firefox automation)")
     print("     (edgedriver is required for MS__Edge automation)")
+    print("     (cft is for the `Chrome for Testing` binary exe)")
+    print("     (chs is for the `Chrome-Headless-Shell` binary.)")
     print("")