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

Author: PeteSong

.github/workflows/ruby-examples.yml

@@ -42,7 +42,7 @@ jobs:
         run: |
           sudo rm -rf $CHROMEWEBDRIVER $EDGEWEBDRIVER $GECKOWEBDRIVER
       - name: Setup Fluxbox and Xvfb
-        if: inputs.os == 'ubuntu'
+        if: matrix.os == 'ubuntu'
         run: |
           sudo apt-get -y install fluxbox libxss1 libappindicator3-1 libindicator7
           Xvfb :99 &
@@ -97,7 +97,7 @@ jobs:
             cd examples/ruby
             bundle exec rspec
           new_command_on_retry: |
-            cd examples/ruby; $env:DEBUG="true"; bundle exec rspec --only-failures
+            cd examples/ruby; $env:DEBUG="true"; bundle exec rspec --only-failures --backtrace
       - name: Run tests on ${{ matrix.os }}
         if: matrix.os != 'windows'
         uses: nick-invision/[email protected]
@@ -109,4 +109,21 @@ jobs:
             bundle exec rspec
           new_command_on_retry: |
             cd examples/ruby
-            DEBUG=true bundle exec rspec --only-failures      
+            DEBUG=true bundle exec rspec --only-failures --backtrace
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout GitHub repo
+        uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+          bundler-cache: true
+      - name: Install dependencies
+        working-directory: ./examples/ruby
+        run: bundle install
+      - name: Run RuboCop
+        working-directory: ./examples/ruby
+        run: bundle exec rubocop

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/kotlin/pom.xml

@@ -9,17 +9,16 @@
     <version>1.0.0</version>
 
     <properties>
-        <kotlin.version>2.1.0</kotlin.version>
+        <kotlin.version>2.1.20</kotlin.version>
 
         <slf4j.version>2.0.17</slf4j.version>
         <logback.version>1.5.18</logback.version>
 
         <junit5.version>5.12.1</junit5.version>
-        <wdm.version>5.2.3</wdm.version>
 
         <maven-surefire-plugin.version>3.5.3</maven-surefire-plugin.version>
 
-        <java.version>1.8</java.version>
+        <java.version>11</java.version>
         <selenium.version>4.31.0</selenium.version>
 
         <maven.compiler.target>${java.version}</maven.compiler.target>

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/.rubocop.yml

@@ -1,9 +1,10 @@
 inherit_from: .rubocop_todo.yml
 
-require: rubocop-rspec
+plugins:
+  - rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.1
   NewCops: enable
   SuggestExtensions:
     rubocop-rake: false