[rust] Automated Firefox management (#11680 and #11682)

[bonigarcia]

Description

This PR implements Firefox's automated browser management feature for the latest (stable) and given versions (unstable -beta, dev, nightly- and fixed versions -e.g., 116, 117, etc.-).

The minimum manageable Firefox versions by SM are the following (although it is improbable that ancient versions could be automated with Selenium):

• Firefox in Windows: 13
• Firefox in macOS: 4
• Firefox in Linux: 4

Some examples:

$ ./selenium-manager --debug --browser firefox --browser-version stable
DEBUG	geckodriver not found in PATH
DEBUG	firefox detected at /usr/lib/firefox/firefox.sh
DEBUG	Running command: /usr/lib/firefox/firefox.sh -v
DEBUG	Output: "Mozilla Firefox 116.0.1"
DEBUG	Detected browser: firefox 116.0.1
DEBUG	Discovered online firefox version (116) is the same as the detected local firefox version
DEBUG	Required driver: geckodriver 0.33.0
DEBUG	Downloading geckodriver 0.33.0 from https://github.com/mozilla/geckodriver/releases/download/v0.33.0/geckodriver-v0.33.0-linux64.tar.gz
INFO	Driver path: /home/boni/.cache/selenium/geckodriver/linux64/0.33.0/geckodriver
INFO	Browser path: /usr/lib/firefox/firefox.sh

$ ./selenium-manager --debug --browser firefox --browser-version beta
DEBUG	geckodriver not found in PATH
DEBUG	firefox detected at /usr/lib/firefox/firefox.sh
DEBUG	Running command: /usr/lib/firefox/firefox.sh -v
DEBUG	Output: "Mozilla Firefox 116.0.1"
DEBUG	Detected browser: firefox 116.0.1
DEBUG	Discovered online firefox version (117) is different to the detected local firefox version (116)
DEBUG	Required browser: firefox 117.0b9
DEBUG	Downloading firefox 117.0b9 from https://ftp.mozilla.org/pub/firefox/releases/117.0b9/linux-x86_64/en-US/firefox-117.0b9.tar.bz2
DEBUG	firefox 117.0b9 has been downloaded at /home/boni/.cache/selenium/firefox/linux64/117.0b9/firefox
DEBUG	Required driver: geckodriver 0.33.0
DEBUG	geckodriver 0.33.0 already in the cache
INFO	Driver path: /home/boni/.cache/selenium/geckodriver/linux64/0.33.0/geckodriver
INFO	Browser path: /home/boni/.cache/selenium/firefox/linux64/117.0b9/firefox

$ ./selenium-manager --debug --browser firefox --browser-version 80
DEBUG	geckodriver not found in PATH
DEBUG	firefox detected at /usr/lib/firefox/firefox.sh
DEBUG	Running command: /usr/lib/firefox/firefox.sh -v
DEBUG	Output: "Mozilla Firefox 116.0.1"
DEBUG	Detected browser: firefox 116.0.1
DEBUG	Discovered browser version (116) different to specified browser version (80)
DEBUG	Required browser: firefox 80.0.1
DEBUG	Downloading firefox 80.0.1 from https://ftp.mozilla.org/pub/firefox/releases/80.0.1/linux-x86_64/en-US/firefox-80.0.1.tar.bz2
DEBUG	firefox 80.0.1 has been downloaded at /home/boni/.cache/selenium/firefox/linux64/80.0.1/firefox
DEBUG	Required driver: geckodriver 0.33.0
DEBUG	geckodriver 0.33.0 already in the cache
INFO	Driver path: /home/boni/.cache/selenium/geckodriver/linux64/0.33.0/geckodriver
INFO	Browser path: /home/boni/.cache/selenium/firefox/linux64/80.0.1/firefox

As a plus, this PR includes a new argument called --avoid-browser-download, which prevents browser download even when the browser version is specified. This argument is irrelevant to the bindings. I implemented it to ease some tests and just in case someone using SM as a CLI tool needs it (like --force-browser-download).

Motivation and Context

This PR implements #11680 and #11682, and it has been tested on:

• Windows (10)
• Linux (Ubuntu 22.04.2 and 22.10)
• macOS (Big Sur 11.0.1)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• I have read the contributing document.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.