Merge branch 'trunk' into rb_add_argument_for_websocket_port

Author: aguspe

AUTHORS

@@ -11,6 +11,7 @@ abidema <[email protected]>
 Adam Dangoor <[email protected]>
 Adam Demuri <[email protected]>
 Adam Goucher <[email protected]>
+Adam Halbrock <[email protected]>
 Adam Smith <[email protected]>
 AdamPDotty <[email protected]>
 Adi Roiban <[email protected]>
@@ -282,6 +283,7 @@ EwaMarek <[email protected]>
 Fan <[email protected]>
 Felipe Knorr Kuhn <[email protected]>
 Fenil Mehta <[email protected]>
+FloKNetcare <[email protected]>
 Florian Apolloner <[email protected]>
 Florian LOPES <[email protected]>
 Florian Mutter <[email protected]>
@@ -454,6 +456,7 @@ John J. Barton <[email protected]>
 John Pelly <[email protected]>
 Johnny.H <[email protected]>
 Johnson <[email protected]>
+Jolyon Pawlyn <[email protected]>
 joma74 <[email protected]>
 Jon Dufresne <[email protected]>
 Jon Spalding
@@ -685,6 +688,7 @@ orangeudav <[email protected]>
 Oscar Devora <[email protected]>
 Outsider <[email protected]>
 Paladin Wang <[email protected]>
+Pallavi <[email protected]>
 Palmer Bandy <[email protected]>
 Pat Tullmann <[email protected]>
 Patrice Jaton <[email protected]>
@@ -744,6 +748,7 @@ Robert Fletcher <[email protected]>
 Roberto Rivera <[email protected]>
 Robin Stocker <[email protected]>
 Rod McNew <[email protected]>
+Romain Tartière <[email protected]>
 Roman Yurchak <[email protected]>
 Roman Yurchak <[email protected]>
 Roman Zoller <[email protected]>

MODULE.bazel

@@ -176,7 +176,7 @@ maven.install(
         "com.github.stephenc.jcip:jcip-annotations:1.0-1",
         "com.google.code.findbugs:jsr305:3.0.2",
         "com.google.code.gson:gson:2.12.1",
-        "com.google.guava:guava:33.4.0-jre",
+        "com.google.guava:guava:33.4.5-jre",
         "com.google.auto:auto-common:1.2.2",
         "com.google.auto.service:auto-service:1.1.1",
         "com.google.auto.service:auto-service-annotations:1.1.1",
@@ -219,7 +219,7 @@ maven.install(
         "org.junit.platform:junit-platform-commons:1.12.1",
         "org.junit.platform:junit-platform-engine:1.12.1",
         "org.mockito:mockito-core:5.16.1",
-        "org.redisson:redisson:3.45.0",
+        "org.redisson:redisson:3.45.1",
         "org.slf4j:slf4j-api:2.0.17",
         "org.slf4j:slf4j-jdk14:2.0.17",
         "org.tomlj:tomlj:1.1.1",

common/repositories.bzl

@@ -11,8 +11,8 @@ def pin_browsers():
 
     http_archive(
         name = "linux_firefox",
-        url = "https://ftp.mozilla.org/pub/firefox/releases/136.0.1/linux-x86_64/en-US/firefox-136.0.1.tar.xz",
-        sha256 = "326c3dadd05153a6825145c9200f48021e039593cd6d6c434abee326e6096835",
+        url = "https://ftp.mozilla.org/pub/firefox/releases/136.0.2/linux-x86_64/en-US/firefox-136.0.2.tar.xz",
+        sha256 = "7ea3882e814669784f0960e4d6bb50a0ac88997a1d17fb125d0f411961ad763a",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -33,8 +33,8 @@ js_library(
 
     dmg_archive(
         name = "mac_firefox",
-        url = "https://ftp.mozilla.org/pub/firefox/releases/136.0.1/mac/en-US/Firefox%20136.0.1.dmg",
-        sha256 = "416f5edf1e9fb938ccaea798adfe177ef7a4072c95a527cb460f3417d1ef5266",
+        url = "https://ftp.mozilla.org/pub/firefox/releases/136.0.2/mac/en-US/Firefox%20136.0.2.dmg",
+        sha256 = "69a917a6cdfa7c5ac44d8df9c03329faf46cb8b4f969826f2b33c1fd4cb43f08",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -50,8 +50,8 @@ js_library(
 
     http_archive(
         name = "linux_beta_firefox",
-        url = "https://ftp.mozilla.org/pub/firefox/releases/137.0b6/linux-x86_64/en-US/firefox-137.0b6.tar.xz",
-        sha256 = "c8348f336162709f8918178a3e11d2e70f91fbc82a8fb8839d45ffdee1c57367",
+        url = "https://ftp.mozilla.org/pub/firefox/releases/137.0b8/linux-x86_64/en-US/firefox-137.0b8.tar.xz",
+        sha256 = "6d83ac868fab6dfc6226cff129b327a2f7dfde17fc7cc1164ab42c8637615776",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -72,8 +72,8 @@ js_library(
 
     dmg_archive(
         name = "mac_beta_firefox",
-        url = "https://ftp.mozilla.org/pub/firefox/releases/137.0b6/mac/en-US/Firefox%20137.0b6.dmg",
-        sha256 = "1bd8bcef306aaa99e7595a9a5a8fb1df4c977fc661c815d33b7636fb48410154",
+        url = "https://ftp.mozilla.org/pub/firefox/releases/137.0b8/mac/en-US/Firefox%20137.0b8.dmg",
+        sha256 = "1783388e740355ffaf215bf10d32ce0d4aaf65183a9eeef64bee3c0dcce2a6e2",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -123,10 +123,10 @@ js_library(
 
     pkg_archive(
         name = "mac_edge",
-        url = "https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/652efb17-53e6-4847-a085-3db94160e488/MicrosoftEdge-134.0.3124.68.pkg",
-        sha256 = "46a5de4b61594b4742d5f7809ec6045eef1a0f244c4bf846b4eea108e72c8776",
+        url = "https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/d7f65f74-be89-4936-ad8d-c6a5d8ba8efd/MicrosoftEdge-134.0.3124.77.pkg",
+        sha256 = "a768a8708129ba776ef28a1c4d86208398d2eaf898028d89f5dfde465fcdf07e",
         move = {
-            "MicrosoftEdge-134.0.3124.68.pkg/Payload/Microsoft Edge.app": "Edge.app",
+            "MicrosoftEdge-134.0.3124.77.pkg/Payload/Microsoft Edge.app": "Edge.app",
         },
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
@@ -182,8 +182,8 @@ js_library(
 
     http_archive(
         name = "mac_edgedriver",
-        url = "https://msedgedriver.azureedge.net/134.0.3124.68/edgedriver_mac64.zip",
-        sha256 = "fb699791bea79d0e5ba53d92e8745241124a5d476669bdae468db9b28da43b51",
+        url = "https://msedgedriver.azureedge.net/134.0.3124.77/edgedriver_mac64.zip",
+        sha256 = "699918e20020e31f3a8ec186c631d31e90038ad65e793d8d4b25bbc3332cf7c1",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -199,8 +199,8 @@ js_library(
 
     http_archive(
         name = "linux_chrome",
-        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.88/linux64/chrome-linux64.zip",
-        sha256 = "99f05b875209cdbf7490dc431a525fd373788521fb9e8aca68c761fc5fc400e5",
+        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.90/linux64/chrome-linux64.zip",
+        sha256 = "77cea8bb689792cd35a82d26d4025b06ce507852ea84505f5912f691c6448789",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
 package(default_visibility = ["//visibility:public"])
@@ -221,8 +221,8 @@ js_library(
 
     http_archive(
         name = "mac_chrome",
-        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.88/mac-x64/chrome-mac-x64.zip",
-        sha256 = "d42a196a68b4d4fb7d096308df96f7b7311a316934200e842f7a30f93fb6ecdc",
+        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.90/mac-x64/chrome-mac-x64.zip",
+        sha256 = "cbd2aac7add53395b7d6722999f6b63aa1eac5ca20c4255816c369ae1e34b70a",
         strip_prefix = "chrome-mac-x64",
         patch_cmds = [
             "mv 'Google Chrome for Testing.app' Chrome.app",
@@ -243,8 +243,8 @@ js_library(
 
     http_archive(
         name = "linux_chromedriver",
-        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.88/linux64/chromedriver-linux64.zip",
-        sha256 = "58df717d51484b9f3ac188af5231cdc77255daa72d0b2b86481bee54e398ce2f",
+        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.90/linux64/chromedriver-linux64.zip",
+        sha256 = "00c9c9a3f55859424d4bc5f3e325e2eb59f17e0587f31db74c775a252a4b4e62",
         strip_prefix = "chromedriver-linux64",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")
@@ -261,8 +261,8 @@ js_library(
 
     http_archive(
         name = "mac_chromedriver",
-        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.88/mac-x64/chromedriver-mac-x64.zip",
-        sha256 = "30b2ee9abdd73d56e0e1d390bf04fe1a14a88522b765b045b42b768c2be74738",
+        url = "https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.90/mac-x64/chromedriver-mac-x64.zip",
+        sha256 = "6cb5a24c82e0acca8574ccff0e8c6f08d929a9bc9fd2cee47fd3af1b3e8167d4",
         strip_prefix = "chromedriver-mac-x64",
         build_file_content = """
 load("@aspect_rules_js//js:defs.bzl", "js_library")

common/selenium_manager.bzl

@@ -6,22 +6,22 @@ def selenium_manager():
     http_file(
         name = "download_sm_linux",
         executable = True,
-        sha256 = "9d9f1306f11a0b8aee174e01e21195177f031e12a7d473cf565de0db69bd504d",
-        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-14ef6b5/selenium-manager-linux",
+        sha256 = "c684e0a0b18bd16048d911ce6bfcb896185673701fa463785bde84b43468709b",
+        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-7ec0311/selenium-manager-linux",
     )
 
     http_file(
         name = "download_sm_macos",
         executable = True,
-        sha256 = "98bb3c77965ddd0892f2a70168aa4a6b9a6e3ed98cd850783461c428f9dc4ffe",
-        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-14ef6b5/selenium-manager-macos",
+        sha256 = "dfa9839d7c5c4e5c63a0758cd33d4cfbf98c53bfe04a9651005ea81f72a43cd5",
+        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-7ec0311/selenium-manager-macos",
     )
 
     http_file(
         name = "download_sm_windows",
         executable = True,
-        sha256 = "0bb96fafc3a38d35d1dd6e6eb350104dcdebd268a6c4b6f771055b324288718a",
-        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-14ef6b5/selenium-manager-windows.exe",
+        sha256 = "7de20eb677bde09b234807d4cb7a16ed3c874bf8b05e38e75e9242b65f9af85e",
+        url = "https://github.com/SeleniumHQ/selenium_manager_artifacts/releases/download/selenium-manager-7ec0311/selenium-manager-windows.exe",
     )
 
 def _selenium_manager_artifacts_impl(_ctx):

java/maven_install.json

@@ -1,7 +1,7 @@
 {
   "__AUTOGENERATED_FILE_DO_NOT_MODIFY_THIS_FILE_MANUALLY": "THERE_IS_NO_DATA_ONLY_ZUUL",
-  "__INPUT_ARTIFACTS_HASH": 1019110553,
-  "__RESOLVED_ARTIFACTS_HASH": 1116102489,
+  "__INPUT_ARTIFACTS_HASH": 466809341,
+  "__RESOLVED_ARTIFACTS_HASH": -983027519,
   "artifacts": {
     "com.beust:jcommander": {
       "shasums": {
@@ -138,17 +138,17 @@
     },
     "com.google.guava:failureaccess": {
       "shasums": {
-        "jar": "8a8f81cf9b359e3f6dfa691a1e776985c061ef2f223c9b2c80753e1b458e8064",
-        "sources": "dd3bfa5e2ec5bc5397efb2c3cef044c192313ff77089573667ff97a60c6978e0"
+        "jar": "cbfc3906b19b8f55dd7cfd6dfe0aa4532e834250d7f080bd8d211a3e246b59cb",
+        "sources": "6fef4dfd2eb9f961655f2a3c4ea87c023618d9fcbfb6b104c17862e5afe66b97"
       },
-      "version": "1.0.2"
+      "version": "1.0.3"
     },
     "com.google.guava:guava": {
       "shasums": {
-        "jar": "b918c98a7e44dbe94ebd9fe3e40cddaadb5a93e6a78eb6008b42df237241e538",
-        "sources": "55ef6603b6ab1f6e3ae810b127561650ed682eb5f3fb50a212a658a74087b457"
+        "jar": "874b1f0ee75c77c12d069d14c9b8b268b7b2cbd7ce679655c225f4a9942dc9c8",
+        "sources": "1abdc24ae4f84d2f4022254b089aa6dec26bd0f7edf3fb2e3d3691fd6910bb21"
       },
-      "version": "33.4.0-jre"
+      "version": "33.4.5-jre"
     },
     "com.google.guava:listenablefuture": {
       "shasums": {
@@ -739,10 +739,10 @@
     },
     "org.redisson:redisson": {
       "shasums": {
-        "jar": "e29893a0fd9bd63e5a3963d9b534f44a864872405b373ddd2f93ac96e43374e8",
-        "sources": "fea7fba78f076717a33b8826af4dec7063f2014b653987e3d0b68e50b6c4f1d2"
+        "jar": "3a0bbc732cd52ccd14ad2192b4afa9ee2415e1965373dbe870c70e0bc51596c1",
+        "sources": "c4acc5210d271ab7854e421cc3fcb900685e81c97711a4553ee49a01b383f6b8"
       },
-      "version": "3.45.0"
+      "version": "3.45.1"
     },
     "org.slf4j:slf4j-api": {
       "shasums": {
@@ -846,12 +846,11 @@
       "com.google.guava:guava"
     ],
     "com.google.guava:guava": [
-      "com.google.code.findbugs:jsr305",
       "com.google.errorprone:error_prone_annotations",
       "com.google.guava:failureaccess",
       "com.google.guava:listenablefuture",
       "com.google.j2objc:j2objc-annotations",
-      "org.checkerframework:checker-qual"
+      "org.jspecify:jspecify"
     ],
     "com.graphql-java:graphql-java": [
       "com.graphql-java:java-dataloader",

py/docs/README.rst

@@ -11,61 +11,72 @@ How to build docs
 =================
 
 One can build the Python documentation without doing a full bazel build. The
-following instructions will build the setup a virtual environment and installs tox, clones the
-selenium repo and then runs ``tox -c py/tox.ini`` building the Python documentation.
+following instructions will build the setup a virtual environment and installs tox,
+clones the selenium repo and then runs ``tox -c py/tox.ini -e docs``, building the
+Python documentation.
 
 .. code-block:: console
 
-    virtualenv test-py38-env
-    source test-py38-env/bin/activate
+    python3 -m venv venv
+    source venv/bin/activate
     pip install tox
     git clone [email protected]:SeleniumHQ/selenium.git
     cd selenium/
     # uncomment and switch to your development branch if needed 
     #git switch -c feature-branch origin/feature-branch
-    tox -c py/tox.ini
+    tox -c py/tox.ini -e docs
+
+This works in a similar manner as the larger selenium bazel build, but does just the Python
+documentation portion.
 
-Works in similar manner as the larger selenium bazel doing just the python documentation portion.
 
 What is happening under the covers of tox, sphinx
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-tox is essentially a build tool for Python. Here it setups its own virtualenv and installs the
-documentation packages (sphinx and jinja2) as well as the required selenium python
-dependencies. Then tox runs the sphinx generate autodoc stub files and then builds the docs.
+
+tox is essentially a build tool for Python. Here it sets up its own virtual env and installs
+the documentation packages (sphinx and jinja2) as well as the required selenium python
+dependencies. Then tox runs the ``sphinx-autogen`` command to generate autodoc stub pages.
+Then it runs ``sphinx-build`` to build the HTML docs.
 
 Sphinx is .. well a much larger topic then what we could cover here. Most important to say
-here is that the docs are using the "classic" theme and than the majority of the api documentation
-is autogenerated. There is plenty of information available and currently the documentation is
-fairly small and not complex. So some basic understanding of restructed text and the Sphinx tool chain
-should be sufficient to contribute and develop the Python docs.
+here is that the docs are using the "sphinx-material" theme (AKA "Material for Sphinx" theme)
+and the the majority of the api documentation is autogenerated. There is plenty of information
+available and currently the documentation is fairly small and not complex. So some basic
+understanding of reStructuredText and the Sphinx tool chain should be sufficient to contribute
+and develop the Python docs.
+
+
+To clean up the build assets and tox cache
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To clean up the build / tox cache
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Although there is a Sphinx Makefile option to clean up using the tox environment above one can
-manually clean the build by deleting the build directory on the root (selenium/build using the
-default directory on git clone). Noting that both Sphinx and tox cache parts of their build and
-recognize changes to speed up their respective builds. But at times one wants to start fresh
-deleting the aformentioned directory will clean the Sphinx cache or removing selenium/py/.tox 
-directory for cleaning the tox environment.
+Although there is a Sphinx Makefile option, to clean up using the tox environment above, one can
+manually clean the build assets by deleting the ``build`` directory on the root (``selenium/build``
+using the default directory on git clone). Note that tox caches parts of the build and recognizes
+changes to speed up the build. To start fresh, delete the aformentioned directory to clean the
+Sphinx build assets and delete the ``selenium/py/.tox`` directory to clean the tox environment.
 
 
 Known documentation issues
 ==========================
+
 The API Reference primarily builds from the source code. But currently the initial template stating
-which modules to document is hard coded within py/docs/source/api.rst. So if modules are added or
-removed then the generated docs will be inaccurate. It would be preferred that the API docs generate
-soley from the code if possible. This is being tracked in `#14178 <https://github.com/SeleniumHQ/selenium/issues/14178>`_
+which modules to document is hard coded within ``py/docs/source/api.rst``. So if modules are added or
+removed, then the generated docs will be inaccurate. It would be preferred that the API docs generate
+soley from the code if possible. This is being tracked in
+`#14178 <https://github.com/SeleniumHQ/selenium/issues/14178>`_
 
-We are working through the Sphinx build Warnings and Errors trying to clean up botht the syntax and
+We are working through the Sphinx build warnings and errors, trying to clean up both the syntax and
 the build.
 
+
 Contributing to Python docs
 ===========================
+
 First it is recommended that you read the main `CONTRIBUTING.md <https://github.com/SeleniumHQ/selenium/blob/trunk/CONTRIBUTING.md>`_.
 
-Some steps for contibuting to the Python documentation ..
+Some steps for contibuting to the Python documentation ...
 
-- Check out changes locally using instruction above.
-- Try to resolve any warnings/issues.
-  - If too arduous either ask for help or add to list of known issue.
-- If this process is updated please update this doc as well to help the next person.
+- Check out changes locally using instructions above.
+- Try to resolve any warnings/errors.
+  - If too arduous, either ask for help or add to the list of known issues.
+- If this process is updated, please update this doc as well to help the next person.

py/docs/requirements.txt

@@ -1,2 +1,3 @@
-Jinja2==3.1.5
-Sphinx==7.1.2
+Jinja2==3.1.6
+Sphinx==7.4.7
+sphinx-material==0.0.36