[pull] master from robotframework:master

.gitattributes

@@ -0,0 +1 @@
+*.approved.txt text eol=lf

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"

.github/workflows/CI.yml

@@ -1,63 +1,103 @@
 name: SeleniumLibrary CI
 
-on: [push, pull_request]
+on: workflow_dispatch
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
+    continue-on-error: true
     strategy:
       matrix:
-        python-version: [3.6, 3.9, pypy3]
-        rf-version: [3.2.2, 4.0.1]
+        python-version: [3.10.16, 3.13.5, 3.14.4, pypy-3.10]
+        # python-version: [{earliest: 3.10}, {latest: 3.14.0-rc.3}, {pypy: pypy-3.10}]
+        rf-version: [6.1.1, 7.4.2]
+        selenium-version: [4.29.0, 4.30.0, 4.31.0, 4.32.0, 4.33.0, 4.34.2, 4.43.0]
+        browser: [chrome]  # firefox, chrome, headlesschrome, edge
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }} with Robot Framework ${{ matrix.rf-version }}
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
+    - name: Setup Chrome
+      uses: browser-actions/setup-chrome@v2
+      with:
+        chrome-version: 138
+        install-dependencies: true
+        install-chromedriver: true
+      id: setup-chrome
+    - run: |
+        echo Installed chromium version: ${{ steps.setup-chrome.outputs.chrome-version }}
+        ${{ steps.setup-chrome.outputs.chrome-path }} --version
+    - name: Setup firefox
+      id: setup-firefox
+      uses: browser-actions/setup-firefox@v1
+      with:
+        firefox-version: latest
+    - run: |
+        echo Installed firefox versions: ${{ steps.setup-firefox.outputs.firefox-version }}
+        ${{ steps.setup-firefox.outputs.firefox-path }} --version
     - name: Start xvfb
       run: |
         export DISPLAY=:99.0
         Xvfb -ac :99 -screen 0 1280x1024x16 > /dev/null 2>&1 &
     - name: Install dependencies
-      if: matrix.python-version != 'pypy3'
+      if: matrix.python-version != 'pypy-3.10'
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements-dev.txt
     - name: Install dependencies for pypy
-      if: matrix.python-version == 'pypy3'
+      if: matrix.python-version == 'pypy-3.10'
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install mockito>=1.0.0
         pip install robotstatuschecker>=1.4
-        pip install approvaltests>=0.2.4
-        pip install pytest pytest-mockito pytest-approvaltests requests robotframework-pabot
+        pip install requests robotframework-pabot
+    - name: Install Seleninum v${{ matrix.selenium-version }}
+      run: |
+        pip install --upgrade selenium==${{ matrix.selenium-version }}
     - name: Install RF ${{ matrix.rf-version }}
       run: |
         pip install -U --pre robotframework==${{ matrix.rf-version }}
+    - name: Install drivers via selenium-manager
+      run: |
+        SELENIUM_MANAGER_EXE=$(python -c 'from selenium.webdriver.common.selenium_manager import SeleniumManager; sm=SeleniumManager(); print(f"{str(sm._get_binary())}")')
+        echo "$SELENIUM_MANAGER_EXE"
+        echo "WEBDRIVERPATH=$($SELENIUM_MANAGER_EXE --browser chrome --debug | awk '/INFO[[:space:]]Driver path:/ {print $NF;exit}')" >> "$GITHUB_ENV"
+        echo "$WEBDRIVERPATH"
     - name: Generate stub file for ${{ matrix.python-version }}
-      if: matrix.python-version != 'pypy3'
+      if: matrix.python-version != 'pypy-3.10'
       run: |
         invoke gen-stub
-    - name: Run tests with headless Chrome and with Python != 3.8
-      if: matrix.python-version != '3.8'
-      run: |
-        xvfb-run --auto-servernum python atest/run.py --zip headlesschrome
-    - name: Run tests normal Chrome with Python 3.8
-      if: matrix.python-version == '3.8' && matrix.rf-version != '3.2.2'
-      run: |
-        xvfb-run --auto-servernum python atest/run.py --zip chrome
-    - name: Run tests with Selenium Grid
-      if: matrix.python-version == '3.8' && matrix.rf-version == '3.2.2'
-      run: |
-        wget --no-verbose --output-document=./selenium-server-standalone.jar http://selenium-release.storage.googleapis.com/3.141/selenium-server-standalone-3.141.59.jar
-        sudo chmod u+x ./selenium-server-standalone.jar
-        xvfb-run --auto-servernum python atest/run.py --zip headlesschrome  --grid True
-    - uses: actions/upload-artifact@v1
-      if: success() || failure()
+
+    # Temporarily ignoring pypy execution
+    - name: Run tests with headless Chrome and with PyPy
+      if: startsWith( matrix.python-version, 'pypy') == true
+      run: |
+        xvfb-run --auto-servernum python atest/run.py --nounit --zip headlesschrome
+
+    # - name: Run tests with ${{ matrix.browser }} if CPython
+    #   if: startsWith( matrix.python-version, 'pypy') == false
+    #   run: |
+    #     xvfb-run --auto-servernum python atest/run.py --zip ${{ matrix.browser }}
+
+    - name: Run tests with latest python and latest robot framework
+      if: matrix.python-version == '3.14.4' && matrix.rf-version == '7.4.1'
+      run: |
+        xvfb-run --auto-servernum python atest/run.py --zip ${{ matrix.browser }}
+
+    # - name: Run tests with Selenium Grid
+    #   if: matrix.python-version == '3.11' && matrix.rf-version == '3.2.2' && matrix.python-version != 'pypy-3.10'
+    #   run: |
+    #     wget --no-verbose --output-document=./selenium-server-standalone.jar http://selenium-release.storage.googleapis.com/3.141/selenium-server-standalone-3.141.59.jar
+    #     sudo chmod u+x ./selenium-server-standalone.jar
+    #     xvfb-run --auto-servernum python atest/run.py --zip headlesschrome  --grid True
+
+    - uses: actions/upload-artifact@v7
+      if: failure()
       with:
-        name: Failed Test results
+        name: sl_$${{ matrix.python-version }}_$${{ matrix.rf-version }}_$${{ matrix.selenium-version }}_$${{ matrix.browser }}
         path: atest/zip_results
+        overwrite: true

.github/workflows/Select.yml

@@ -0,0 +1,119 @@
+name: Selected Test Configuration Matrix
+
+on: [push, pull_request]
+
+jobs:
+  test_config:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    strategy:
+      matrix:
+        config:
+          - description: latest
+            python-version: 3.14.4
+            rf-version: 7.4.2
+            selenium-version:  4.44.0
+            browser: chrome
+          - description: previous
+            python-version: 3.12.12
+            rf-version: 7.3.2
+            selenium-version: 4.40.0
+            browser: chrome
+          - description: older_rf_version
+            python-version: 3.11.14
+            rf-version: 6.1.1
+            selenium-version: 4.37.0
+            browser: chrome
+          - description: latest_firefox
+            python-version: 3.14.4
+            rf-version: 7.4.1
+            selenium-version: 4.39.0
+            browser: firefox
+    steps:
+    - uses: actions/checkout@v6
+    - name: Configuration Description
+      run: |
+        echo "${{ matrix.config.description }} configuration"
+        echo "Testing with RF v${{ matrix.config.rf-version }}, Selenium v${{ matrix.config.selenium-version}}, Python v${{ matrix.config.python-version }} under ${{ matrix.config.browser }}"
+    - name: Set up Python ${{ matrix.config.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.config.python-version }}
+    - name: Setup ${{ matrix.config.browser }} browser
+      uses: browser-actions/setup-chrome@v2
+      with:
+        chrome-version: latest
+        install-dependencies: true
+      id: setup-chrome
+    - run: |
+        echo Installed chromium version: ${{ steps.setup-chrome.outputs.chrome-version }}
+        ${{ steps.setup-chrome.outputs.chrome-path }} --version
+    - name: Setup firefox
+      id: setup-firefox
+      uses: browser-actions/setup-firefox@v1
+      with:
+        firefox-version: latest
+    - run: |
+        echo Installed firefox versions: ${{ steps.setup-firefox.outputs.firefox-version }}
+        ${{ steps.setup-firefox.outputs.firefox-path }} --version
+    - name: Start xvfb
+      run: |
+        export DISPLAY=:99.0
+        Xvfb -ac :99 -screen 0 1280x1024x16 > /dev/null 2>&1 &
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+    - name: Install Seleninum v${{ matrix.config.selenium-version }}
+      run: |
+        pip install --upgrade selenium==${{ matrix.config.selenium-version }}
+    - name: Install RF ${{ matrix.config.rf-version }}
+      run: |
+        pip install -U --pre robotframework==${{ matrix.config.rf-version }}
+
+    - name: Run tests under specified config
+      run: |
+        xvfb-run --auto-servernum python atest/run.py --zip ${{ matrix.config.browser }}
+
+    - uses: actions/upload-artifact@v7
+      if: failure()
+      with:
+        name: sl_${{ matrix.config.python-version }}_${{ matrix.config.rf-version }}_${{ matrix.config.selenium-version }}_${{ matrix.config.browser }}
+        path: atest/zip_results
+        overwrite: true
+  ruff:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.14.4"
+
+    - name: Install dev dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+
+    - name: Ruff format check
+      id: format
+      continue-on-error: true
+      run: |
+        python -m invoke formatter --check
+
+    - name: Ruff lint
+      id: lint
+      continue-on-error: true
+      run: |
+        python -m invoke lint
+
+    - name: Fail if any Ruff step failed
+      if: always()
+      run: |
+        echo "format outcome: ${{ steps.format.outcome }}"
+        echo "lint outcome:   ${{ steps.lint.outcome }}"
+        if [ "${{ steps.format.outcome }}" != "success" ] || [ "${{ steps.lint.outcome }}" != "success" ]; then
+          exit 1
+        fi

.gitignore

@@ -1,6 +1,7 @@
 .project
 .pydevproject
 .idea
+.vscode
 atest/results
 atest/zip_results
 utest/output_dir
@@ -10,7 +11,7 @@ utest/output_dir
 MANIFEST
 *.egg-info
 *.egg
-chromedriver.log
+*driver.log
 .pytest_cache
 
 dist

BUILD.rst

@@ -64,7 +64,8 @@ Testing
 -------
 
 Make sure that adequate tests are executed before releases are created.
-See `<test/README.rst>`_ for details.
+For more information about unit tests see `<utest/README.rst>`_ or for
+acceptance tests see `<atest/README.rst>`_.
 
 Preparation
 -----------
@@ -164,22 +165,25 @@ Generate Stub file
 
 Documentation
 -------------
-If generating release candidate or final release documentation, use `invoke kw-docs`
-but if this alpha or beta release, use `invoke kw-docs $VERSION`. The `invoke kw-docs $VERSION`
+If generating release candidate or final release documentation, use ``invoke kw-docs```
+but if this alpha or beta release, use ``invoke kw-docs $VERSION``. The ``invoke kw-docs $VERSION``
 does not replace the previous final release documentation, instead it will create new file
-with docs/SeleniumLibrary-$VERSION.html. From the below, execute either 1.1 or 1.2 step. The step
+with docs/SeleniumLibrary-$VERSION.html. From the below, execute either 1.A or 1.B step. The step
 2. is done always.
 
-Note that this *must* be done after`setting version <Set version>`_ above
+Note that this *must* be done after `setting version <Set version>`_ above
 or docs will have wrong version number.
 
-1.1. Generate pre or final release keyword documentation::
+1. 
+  A. Generate *pre or final release* keyword documentation::
 
       invoke kw-docs
       git commit -m "Generated docs for version $VERSION" docs/SeleniumLibrary.html
       git push
 
-1.2 Generate alpha or beta release keyword documentation::
+  **OR**
+
+  B. Generate *alpha or beta release* keyword documentation::
 
       invoke kw-docs -v $VERSION
       git add docs/SeleniumLibrary-$VERSION.html
@@ -192,7 +196,8 @@ push the new README.rst::
       git commit -m "Add alpha/beta kw docs for version $VERSION in README.rst" README.rst
       git push
 
-2. If README.rst has changed, generate project documentation based on it::
+2. If README.rst has changed, generate project documentation based on it. One can check with
+   the command ``git log <previousversiontag>..HEAD --oneline README.rst``::
 
       invoke project-docs
       git commit -m "Regenerated project docs" docs/index.html