Merge branch 'master' into add-get-css-property-value-keyword

Author: b-vamsipunnam

.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,6 +1,6 @@
 name: SeleniumLibrary CI
 
-on: [push, pull_request]
+on: workflow_dispatch
 
 jobs:
   build:

.github/workflows/Select.yml

@@ -0,0 +1,79 @@
+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.13.10
+            rf-version: 7.4.1
+            selenium-version:  4.39.0
+            browser: chrome
+          - description: previous
+            python-version: 3.12.12
+            rf-version: 7.3.2
+            selenium-version: 4.38.0
+            browser: chrome
+          - description: older_rf_version
+            python-version: 3.11.14
+            rf-version: 6.1.1
+            selenium-version: 4.37.0
+            browser: chrome
+
+    steps:
+    - uses: actions/checkout@v4
+    - 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@v5
+      with:
+        python-version: ${{ matrix.config.python-version }}
+    - name: Setup ${{ matrix.config.browser }} browser
+      uses: browser-actions/setup-chrome@v1
+      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@v4
+      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

atest/acceptance/keywords/cookies.robot

@@ -9,8 +9,11 @@ Library           DateTime
 *** Test Cases ***
 Get Cookies
     ${cookies}=    Get Cookies
+    Should Contain    ${cookies}    test=seleniumlibrary
+    Should Contain    ${cookies}    another=value
+    Should Contain    ${cookies}    far_future=timemachine
     Should Match Regexp    ${cookies}
-    ...    ^(test=seleniumlibrary; another=value)|(another=value; test=seleniumlibrary)$
+    ...    ^(?:test=seleniumlibrary|another=value|far_future=timemachine)(?:; (?:test=seleniumlibrary|another=value|far_future=timemachine)){2}$
 
 Get Cookies As Dict
     ${cookies}=    Get Cookies        as_dict=True
@@ -36,15 +39,21 @@ Add Cookie When Secure Is False
     Should Be Equal    ${cookie.secure}       ${False}
 
 Add Cookie When Expiry Is Epoch
-    Add Cookie    Cookie1    value1    expiry=1761755100
+    # To convert epoch to formatted string
+    #    from time import strftime, localtime
+    #    strftime('%Y-%m-%d %H:%M:%S', localtime(1793247900))
+    # To update time each September (as Chrome limits cookies to one year expiry date) use
+    #    import datetime
+    #    print (datetime.datetime.strptime("2027-10-29 12:25:00", "%Y-%m-%d %I:%M:%S").timestamp())
+    Add Cookie    Cookie1    value1    expiry=1793247900
     ${cookie} =    Get Cookie    Cookie1
-    ${expiry} =    Convert Date    ${1761755100}    exclude_millis=True
+    ${expiry} =    Convert Date    ${1793247900}    exclude_millis=True
     Should Be Equal As Strings    ${cookie.expiry}    ${expiry}
 
 Add Cookie When Expiry Is Human Readable Data&Time
-    Add Cookie    Cookie12    value12    expiry=2025-10-29 12:25:00
+    Add Cookie    Cookie12    value12    expiry=2026-10-29 12:25:00
     ${cookie} =    Get Cookie    Cookie12
-    Should Be Equal As Strings    ${cookie.expiry}    2025-10-29 12:25:00
+    Should Be Equal As Strings    ${cookie.expiry}    2026-10-29 12:25:00
 
 Delete Cookie
     [Tags]    Known Issue Safari
@@ -114,20 +123,20 @@ Test Get Cookie Keyword Logging
     ...    domain=localhost
     ...    secure=False
     ...    httpOnly=False
-    ...    expiry=2025-09-01 *:25:00
+    ...    expiry=2026-09-01 *:25:00
     ...    extra={'sameSite': 'Lax'}
     ${cookie} =    Get Cookie     far_future
 
 *** Keywords ***
 Add Cookies
     # To update time each September (as Chrome limits cookies to one year expiry date) use
     #    import datetime
-    #    print (datetime.datetime.strptime("2025-09-01 12:25:00", "%Y-%m-%d %I:%M:%S").timestamp())
+    #    print (datetime.datetime.strptime("2027-09-01 12:25:00", "%Y-%m-%d %I:%M:%S").timestamp())
     Delete All Cookies
     Add Cookie    test       seleniumlibrary
     ${now} =    Get Current Date
     ${tomorrow_thistime} =    Add Time To Date    ${now}    1 day
     ${tomorrow_thistime_datetime} =    Convert Date    ${tomorrow_thistime}    datetime
     Set Suite Variable    ${tomorrow_thistime_datetime}
     Add Cookie    another    value   expiry=${tomorrow_thistime}
-    Add Cookie    far_future    timemachine    expiry=1756700700    # 2025-09-01 12:25:00
+    Add Cookie    far_future    timemachine    expiry=1788240300    # 2026-09-01 12:25:00

docs/SeleniumLibrary.html

@@ -13,8 +13,6 @@
 Operating System :: OS Independent
 Programming Language :: Python
 Programming Language :: Python :: 3
-Programming Language :: Python :: 3.8
-Programming Language :: Python :: 3.9
 Programming Language :: Python :: 3.10
 Programming Language :: Python :: 3.11
 Programming Language :: Python :: 3.12

setup.py

@@ -202,20 +202,20 @@ class SeleniumLibrary(DynamicCore):
     used to specify multiple locators. This is useful, is some part of locator would match as the locator separator
     but it should not. Or if there is need to existing WebElement as locator.
 
-    Although all locators support chaining, some locator strategies do not abey the chaining. This is because
+    Although all locators support chaining, some locator strategies do not obey the chaining. This is because
     some locator strategies use JavaScript to find elements and JavaScript is executed for the whole browser context
     and not for the element found be the previous locator. Chaining is supported by locator strategies which
     are based on Selenium API, like `xpath` or `css`, but example chaining is not supported by `sizzle` or `jquery
 
     Examples:
-    | `Click Element` | css:.bar >> xpath://a | # To find a link which is present after an element with class "bar" |
+    | `Click Element` | css:.bar >> xpath: //a | # To find a link which is present after an element with class "bar" |
 
     List examples:
-    | ${locator_list} =             | `Create List`   | css:div#div_id            | xpath://*[text(), " >> "] |
-    | `Page Should Contain Element` | ${locator_list} |                           |                           |
-    | ${element} =                  | Get WebElement  | xpath://*[text(), " >> "] |                           |
-    | ${locator_list} =             | `Create List`   | css:div#div_id            | ${element}                |
-    | `Page Should Contain Element` | ${locator_list} |                           |                           |
+    | ${locator_list} =             | `Create List`   | css:div#div_id             | xpath: //*[text(), " >> "] |
+    | `Page Should Contain Element` | ${locator_list} |                            |                            |
+    | ${element} =                  | Get WebElement  | xpath: //*[text(), " >> "] |                            |
+    | ${locator_list} =             | `Create List`   | css:div#div_id             | ${element}                 |
+    | `Page Should Contain Element` | ${locator_list} |                            |                            |
 
     Chaining locators in new in SeleniumLibrary 5.0
 

src/SeleniumLibrary/__init__.py

@@ -216,7 +216,7 @@ def open_browser(
         if service_log_path:
             self.warn("service_log_path is being deprecated. Please use service to configure log_output or equivalent service attribute.")
         if executable_path:
-            self.warn("exexcutable_path is being deprecated. Please use service to configure the driver's executable_path as per documentation.")
+            self.warn("executable_path is being deprecated. Please use service to configure the driver's executable_path as per documentation.")
         return self._make_new_browser(
             url,
             browser,