blob: b0b5869e8d97c4f70b5252da50a37c9ecad7f6a1 [file] [edit]
================
Selenium Manager
================
Selenium Manager discovers the browsers installed on a machine, downloads the
matching drivers, and prints the paths back as JSON. It is the component the
Selenium bindings already shell out to; this distribution publishes it on its
own so it can be used without installing a binding.
Running it
==========
No install needed::
uvx selenium-manager --browser chrome
Or install it into an environment::
pip install selenium-manager
selenium-manager --browser chrome
It also runs as a module::
python -m selenium_manager --browser chrome
Pass ``--help`` for the full command set.
Platform packages
=================
``selenium-manager`` carries no binary itself. Installing it pulls in exactly
one platform package for the machine doing the install:
============================ =====================================
Platform Package
============================ =====================================
Linux x86-64 ``selenium-manager-linux-x86-64``
Linux aarch64 ``selenium-manager-linux-aarch64``
macOS (Intel and Apple Si) ``selenium-manager-macos``
Windows (x86, x64, arm64) ``selenium-manager-windows-x86``
============================ =====================================
The architecture in a package name is the binary's, not the machine's, which is
why one package answers every Windows platform: that binary is i686, and Windows
runs it on x64 and arm64 as well. macOS needs no suffix because its binary is
universal.
Using it from Python
====================
``binary_path()`` resolves the binary without launching it, for callers that
want to run it themselves::
from selenium_manager import binary_path
subprocess.run([binary_path(), "--browser", "chrome", "--output", "json"])
Setting ``SE_MANAGER_PATH`` overrides the resolved path, the same way it does in
every Selenium binding.
Usage statistics
================
Selenium Manager can report anonymous usage statistics. When it is launched
through this package (``selenium-manager``, ``python -m selenium_manager`` or
``uvx selenium-manager``) they are opt-in: the launcher sets
``SE_AVOID_STATS=true`` unless you have set it yourself. Set
``SE_AVOID_STATS=false``, or ``avoid-stats = false`` in ``se-config.toml``, to
send them. Callers that run ``binary_path()`` themselves make that choice
through the same variable.
Links
=====
* Source: https://github.com/SeleniumHQ/selenium/tree/trunk/py/selenium-manager
* Documentation: https://www.selenium.dev/documentation/selenium_manager
* Issues: https://github.com/SeleniumHQ/selenium/issues