Merge branch 'trunk' into petesong/add-practice-example

Author: PeteSong

examples/dotnet/SeleniumDocs/SeleniumManager/UsageTest.cs

@@ -0,0 +1,20 @@
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using OpenQA.Selenium.Chrome;
+
+namespace SeleniumDocs.SeleniumManagerTest
+{
+    [TestClass]
+    public class UsageTest
+    {
+        [TestMethod]
+        public void TestWithSeleniumManager()
+        {
+            // Before
+            // using var driver = new ChromeDriver("path/to/chromedriver");
+
+            // Now
+            using var driver = new ChromeDriver();
+            driver.Navigate().GoToUrl("https://www.selenium.dev/documentation/selenium_manager/");
+        }
+    }
+}

examples/javascript/test/selenium_manager/usage.spec.js

@@ -0,0 +1,32 @@
+const Chrome = require('selenium-webdriver/chrome');
+const {Browser, Builder} = require("selenium-webdriver");
+const options = new Chrome.Options();
+
+describe('Usage Test', function () {
+  it('Creates driver wit Selenium Manager', async function () {
+
+    let driver = new Builder()
+        .forBrowser(Browser.CHROME)
+        .build();
+
+    await driver.get('https://www.selenium.dev/selenium/web/blank.html');
+    await driver.quit();
+  });
+
+  // it('Creates driver with Selenium Manager', async function () {
+  //   let driverPath = '/path/to/chromedriver';
+  //   let browserPath = '/path/to/chrome';
+
+  //   options.setChromeBinaryPath(browserPath)
+
+  //   let service = new Chrome.ServiceBuilder().setPath(driverPath)
+
+  //   let driver = new Builder()
+  //       .forBrowser(Browser.CHROME)
+  //       .setChromeService(service)
+  //       .build();
+
+  //   await driver.get('https://www.selenium.dev/selenium/web/blank.html');
+  //   await driver.quit();
+  // });
+});

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

@@ -1,7 +1,8 @@
 selenium==4.31.0
 pytest==8.3.5
-trio==0.29.0
+trio==0.30.0
 pytest-trio==0.8.0
 pytest-rerunfailures==15.0
 flake8==7.2.0
 requests==2.32.3
+tox==4.25.0

examples/python/tests/interactions/test_cookies.py

@@ -1,15 +1,15 @@
 from selenium import webdriver
 
 
-def add_cookie():
+def test_add_cookie():
     driver = webdriver.Chrome()
     driver.get("http://www.example.com")
 
     # Adds the cookie into current browser context
     driver.add_cookie({"name": "key", "value": "value"})
 
 
-def get_named_cookie():
+def test_get_named_cookie():
     driver = webdriver.Chrome()
     driver.get("http://www.example.com")
 
@@ -20,7 +20,7 @@ def get_named_cookie():
     print(driver.get_cookie("foo"))
 
 
-def get_all_cookies():
+def test_get_all_cookies():
     driver = webdriver.Chrome()
 
     driver.get("http://www.example.com")
@@ -31,7 +31,7 @@ def get_all_cookies():
     # Get all available cookies
     print(driver.get_cookies())
 
-def delete_cookie():
+def test_delete_cookie():
     driver = webdriver.Chrome()
 
     driver.get("http://www.example.com")
@@ -43,7 +43,7 @@ def delete_cookie():
     driver.delete_cookie("test1")
 
 
-def delete_all_cookies():
+def test_delete_all_cookies():
     driver = webdriver.Chrome()
 
     driver.get("http://www.example.com")
@@ -55,7 +55,7 @@ def delete_all_cookies():
     driver.delete_all_cookies()
 
 
-def same_side_cookie_attr():
+def test_same_side_cookie_attr():
     driver = webdriver.Chrome()
 
     driver.get("http://www.example.com")

examples/python/tests/support/test_expected_conditions.py

@@ -1,2 +1,18 @@
-from selenium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.wait import WebDriverWait
 
+# Expected Conditions API Documentation:
+# https://www.selenium.dev/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.expected_conditions.html
+
+
+def test_expected_condition(driver):
+    driver.get("https://www.selenium.dev/selenium/web/dynamic.html")
+    revealed = driver.find_element(By.ID, "revealed")
+    driver.find_element(By.ID, "reveal").click()
+
+    wait = WebDriverWait(driver, timeout=2)
+    wait.until(EC.visibility_of_element_located((By.ID, "revealed")))
+
+    revealed.send_keys("Displayed")
+    assert revealed.get_property("value") == "Displayed"

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:.}

examples/ruby/spec/bidi/logging_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'spec_helper'
 
 RSpec.describe 'Logging' do

examples/ruby/spec/browsers/chrome_spec.rb

@@ -131,7 +131,8 @@
         'offline' => false,
         'latency' => 100,
         'download_throughput' => 200,
-        'upload_throughput' => 200)
+        'upload_throughput' => 200
+      )
     end
 
     it 'gets the browser logs' do

examples/ruby/spec/browsers/edge_spec.rb

@@ -131,7 +131,8 @@
         'offline' => false,
         'latency' => 100,
         'download_throughput' => 200,
-        'upload_throughput' => 200)
+        'upload_throughput' => 200
+      )
     end
 
     it 'gets the browser logs' do
@@ -164,6 +165,6 @@ def driver_finder
 
   def permission(name)
     @driver.execute_async_script('callback = arguments[arguments.length - 1];' \
-                                   'callback(navigator.permissions.query({name: arguments[0]}));', name)['state']
+                                 'callback(navigator.permissions.query({name: arguments[0]}));', name)['state']
   end
 end