Merge branch 'trunk' into renovate/gradle-8.x

Author: harsha509

examples/python/README.md

@@ -1,38 +1,61 @@
-# Running all tests from Selenium python example
+# Running tests from Selenium Python examples
 
-Follow these steps to run all test example from selenium python
-
-1. Clone this repository
+#### 1. Clone this repository
 
 ```
 git clone https://github.com/SeleniumHQ/seleniumhq.github.io.git
 ```
 
-2. Navigate to `python` directory
+#### 2. Navigate to `python` directory
 
 ```
 cd seleniumhq.github.io/examples/python
 ```
 
-3. Install dependencies using pip
+#### 3. Create a virtual environment
+
+- On Windows:
+
+```
+py -m venv venv
+venv\Scripts\activate
+```
+
+- On Linux/Mac:
+
+```
+python3 -m venv venv
+source venv/bin/activate
+```
+
+#### 4. Install dependencies:
 
 ```
 pip install -r requirements.txt
 ```
-> if you are on a different python version, for example python3.x you may have to replace `pip` with `pip3`
 
-4. Run all tests
+> for help, see: https://packaging.python.org/en/latest/tutorials/installing-packages
+
+#### 5. Run tests
+
+- Run all tests with the default Python interpreter:
 
 ```
 pytest
 ```
 
-> Please keep some patience - If you are doing it for the first time, it will take a little while to verify and download the browser drivers
+- Run all tests with every installed/supported Python interpreter:
 
-## Execute a specific example
-To run a specific Selenium Python example, use the following command:
-```bash
+```
+tox
+```
+
+> Please have some patience - If you are doing it for the first time, it will take a little while to download the browser drivers
+
+- Run a specific example:
+
+```
 pytest path/to/test_script.py
 ```
 
-Make sure to replace `path/to/test_script.py` with the path and name of the example you want to run.
+> Make sure to replace `path/to/test_script.py` with the path and name of the example you want to run

examples/python/requirements.txt

@@ -5,3 +5,4 @@ pytest-trio==0.8.0
 pytest-rerunfailures==15.0
 flake8==7.2.0
 requests==2.32.3
+tox==4.25.0

examples/python/tox.ini

@@ -0,0 +1,30 @@
+# Tox (https://tox.wiki/) is a tool for running tests in multiple
+# virtualenvs. This configuration file will run the test suite on all
+# supported python versions. To use it, run "tox" from this directory.
+#
+# For a specific environment, run: "tox -e <env>" (i.e.: "tox -e py313")
+#
+# This tox configuration will skip any Python interpreters that can't be found.
+# To manage multiple Python interpreters for covering all versions, you can use
+# pyenv: https://github.com/pyenv/pyenv
+
+
+[tox]
+env_list =
+    py39
+    py310
+    py311
+    py312
+    py313
+skip_missing_interpreters = True
+
+[testenv]
+description = run tests
+passenv = *
+deps =
+    -r requirements.txt
+commands =
+    # "-vv" means extra verbose
+    # "-r fEsxXp" means show extra test summary info as specified by:
+    #   (f)ailed, (E)rror, (s)kipped, (x)failed, (X)passed, (p)assed
+    pytest -vv -r fEsxXp {posargs:.}

website_and_docs/content/documentation/grid/components.ja.md

@@ -1,5 +1,5 @@
 ---
-title: "Serenium Grid のコンポーネント"
+title: "Selenium Grid のコンポーネント"
 linkTitle: "コンポーネント"
 weight: 6
 description: >

website_and_docs/content/documentation/webdriver/bidi/logging.zh-cn.md

@@ -1,24 +1,26 @@
 ---
-title: "WebDriver BiDi Logging Features"
-linkTitle: "Logging"
+title: "WebDriver BiDi 日志功能"
+linkTitle: "日志"
 weight: 1
 description: >
-  These features are related to logging. Because "logging" can refer to so many
-  different things, these methods are made available via a "script" namespace.
+  这些功能与日志记录有关。
+  由于"logging"可以指代许多不同的事物,
+  因此这些方法通过"script"命名空间提供.
 aliases: [
   "/documentation/zh-cn/webdriver/bidirectional/bidirectional_w3c/log",
   "/documentation/webdriver/bidirectional/webdriver_bidi/log"
 ]
 ---
 
-Remember that to use WebDriver BiDi, you must enable it in Options. 
-For more details, see [Enabling BiDi]({{< ref "BiDi" >}})
+请记住, 要使用 WebDriver BiDi,
+您必须在选项中启用它. 
+更多详情, 请参阅 [启用 BiDi]({{< ref "BiDi" >}}) .
 
-## Console Message Handlers
+## 控制台消息处理程序
 
-Record or take actions on `console.log` events.
+记录或对 `console.log` 事件采取行动.
 
-### Add Handler
+### 添加处理程序
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
@@ -41,9 +43,9 @@ Record or take actions on `console.log` events.
 {{< /tab >}}
 {{< /tabpane >}}
 
-### Remove Handler
+### 删除处理程序
 
-You need to store the ID returned when adding the handler to delete it.
+您需要存储添加处理程序时返回的 ID 以便将其删除.
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
@@ -66,11 +68,11 @@ You need to store the ID returned when adding the handler to delete it.
 {{< /tab >}}
 {{< /tabpane >}}
 
-## JavaScript Exception Handlers
+## JavaScript 异常处理程序
 
-Record or take actions on JavaScript exception events.
+记录或对 JavaScript 异常事件采取行动.
 
-### Add Handler
+### 添加处理程序
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
@@ -93,9 +95,9 @@ Record or take actions on JavaScript exception events.
 {{< /tab >}}
 {{< /tabpane >}}
 
-### Remove Handler
+### 删除处理程序
 
-You need to store the ID returned when adding the handler to delete it.
+您需要存储添加处理程序时返回的 ID 以便将其删除.
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}