Merge branch 'trunk' into 14143-fix-ff-profile

.github/release.yml

@@ -0,0 +1,6 @@
+changelog:
+  exclude:
+    labels:
+      -dependencies
+    authors:
+      - selenium-ci

.github/workflows/stage-release.yml

@@ -0,0 +1,59 @@
+name: Release Staging
+
+on:
+  pull_request:
+    types: [closed]
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  github-release:
+    if: >
+      github.event.pull_request.merged == true &&
+      github.repository_owner == 'seleniumhq' &&
+      startsWith(github.event.pull_request.head.ref, 'release-preparation-')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+      - name: Extract version from branch name
+        id: extract_version
+        run: |
+          BRANCH_NAME="${{ github.event.pull_request.head.ref }}"
+          VERSION=$(echo $BRANCH_NAME | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Tag Release
+        run: |
+          git tag selenium-${{ env.VERSION }}
+          git push origin selenium-${{ env.VERSION }}
+      - name: Update Nightly Tag to Remove pre-release
+        run: |
+          git fetch --tags
+          git tag -d nightly || echo "Nightly tag not found"
+          git tag nightly
+          git push origin refs/tags/nightly --force
+      - name: Setup Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: 17
+          distribution: 'temurin'
+      - name: Build and Stage Packages
+        run: ./go all:package[--config=release]
+      - name: Generate Draft Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: Selenium ${{ env.VERSION }}
+          body: |
+              ## Detailed Changelogs by Component
+              <img src="https://www.selenium.dev/images/programming/java.svg" width="20" height="20"> **[Java](https://github.com/SeleniumHQ/selenium/blob/trunk/java/CHANGELOG)** &nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;<img src="https://www.selenium.dev/images/programming/python.svg" width="20" height="20"> **[Python](https://github.com/SeleniumHQ/selenium/blob/trunk/py/CHANGES)** &nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;<img src="https://www.selenium.dev/images/programming/csharp.svg" width="20" height="20"> **[DotNet](https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG)** &nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;<img src="https://www.selenium.dev/images/programming/ruby.svg" width="20" height="20"> **[Ruby](https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES)** &nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;<img src="https://www.selenium.dev/images/programming/javascript.svg" width="20" height="20"> **[JavaScript](https://github.com/SeleniumHQ/selenium/blob/trunk/javascript/node/selenium-webdriver/CHANGES.md)** &nbsp;&nbsp;&nbsp; | &nbsp;&nbsp;&nbsp;<img src="https://www.selenium.dev/images/browsers/internet-explorer.svg" width="20" height="20"> **[IEDriver](https://github.com/SeleniumHQ/selenium/blob/trunk/cpp/iedriverserver/CHANGELOG)**
+              <br>
+          tag_name: selenium-${{ env.VERSION }}
+          draft: true
+          generate_release_notes: true
+          prerelease: false
+          files: build/dist/*.*

.github/workflows/update-documentation.yml

@@ -0,0 +1,211 @@
+name: Update Documentation
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Release tag (e.g. selenium-4.21.0)
+        required: true
+        type: string
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  java-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Get updated Rakefile
+        run: |
+          git fetch origin auto_docs
+          git checkout origin/auto_docs -- Rakefile
+      - name: Setup Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: 17
+          distribution: 'temurin'
+      - name: Update Documentation
+        run: ./go java:docs
+      - name: Create patch for changes
+        run: |
+          git format-patch -1 HEAD --stdout > java-docs.patch
+      - name: Upload patch
+        uses: actions/upload-artifact@v2
+        with:
+          name: java-docs-patch
+          path: java-docs.patch
+
+  ruby-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Get updated Rakefile
+        run: |
+          git fetch origin auto_docs
+          git checkout origin/auto_docs -- Rakefile
+      - name: Setup Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: 17
+          distribution: 'temurin'
+      - name: Update Documentation
+        run: ./go rb:docs
+      - name: Create patch for changes
+        run: |
+          git format-patch -1 HEAD --stdout > ruby-docs.patch
+      - name: Upload patch
+        uses: actions/upload-artifact@v2
+        with:
+          name: ruby-docs-patch
+          path: ruby-docs.patch
+
+  python-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Get updated Rakefile
+        run: |
+          git fetch origin auto_docs
+          git checkout origin/auto_docs -- Rakefile
+      - name: Set up Python 3.8
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.8
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+      - name: Update Documentation
+        run: ./go py:docs
+      - name: Create patch for changes
+        run: |
+          git format-patch -1 HEAD --stdout > python-docs.patch
+      - name: Upload patch
+        uses: actions/upload-artifact@v2
+        with:
+          name: python-docs-patch
+          path: python-docs.patch
+
+  dotnet-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Get updated Rakefile
+        run: |
+          git fetch origin auto_docs
+          git checkout origin/auto_docs -- Rakefile
+      - name: Install specific version of DocFX tool
+        #  Pinning to 2.75.3 to avoid breaking changes in newer versions
+        #  See https://github.com/dotnet/docfx/issues/9855
+        run: dotnet tool install --global --version 2.75.3 docfx
+      - name: Update Documentation
+        run: ./go dotnet:docs
+      - name: Create patch for changes
+        run: |
+          git format-patch -1 HEAD --stdout > dotnet-docs.patch
+      - name: Upload patch
+        uses: actions/upload-artifact@v2
+        with:
+          name: dotnet-docs-patch
+          path: dotnet-docs.patch
+
+  node-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - name: Prep git
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+      - name: Get updated Rakefile
+        run: |
+          git fetch origin auto_docs
+          git checkout origin/auto_docs -- Rakefile
+      - name: Install npm dependencies
+        run: |
+          npm install
+          npm install --prefix javascript/node/selenium-webdriver
+      - name: Update Documentation
+        run: ./go node:docs
+      - name: Create patch for changes
+        run: |
+          git format-patch -1 HEAD --stdout > node-docs.patch
+      - name: Upload patch
+        uses: actions/upload-artifact@v2
+        with:
+          name: node-docs-patch
+          path: node-docs.patch
+
+  merge-patches:
+    runs-on: ubuntu-latest
+    needs: [java-docs, ruby-docs, python-docs, dotnet-docs, node-docs]
+    steps:
+      - name: Checkout  documentation branch
+        uses: actions/checkout@v4
+        with:
+          ref: 'gh-pages'
+      - name: Create and checkout new branch
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "Selenium CI Bot"
+          git checkout -b api-docs-${{ inputs.tag }}
+      - name: Download patches
+        uses: actions/download-artifact@v2
+        with:
+          name: java-docs-patch
+          path: patches/
+      - uses: actions/download-artifact@v2
+        with:
+          name: ruby-docs-patch
+          path: patches/
+      - uses: actions/download-artifact@v2
+        with:
+          name: python-docs-patch
+          path: patches/
+      - uses: actions/download-artifact@v2
+        with:
+          name: dotnet-docs-patch
+          path: patches/
+      - uses: actions/download-artifact@v2
+        with:
+          name: node-docs-patch
+          path: patches/
+      - name: Apply patches
+        run: |
+          for patch in patches/*.patch; do
+            git am < "$patch"
+          done
+      - name: Push Branch
+        run: git push origin api-docs-${{ inputs.tag }}

AUTHORS

@@ -41,6 +41,7 @@ Alex Savchuk <[email protected]>
 Alexander Bayandin <[email protected]>
 Alexander Dobrynin <[email protected]>
 Alexander Kavanaugh <[email protected]>
+Alexander Millin <[email protected]>
 Alexandr Savchuk <[email protected]>
 Alexandre Abreu <[email protected]>
 Alexei Barantsev <[email protected]>
@@ -63,6 +64,7 @@ Andras Hatvani <[email protected]>
 Andre Wiggins <[email protected]>
 Andreas Tolf Tolfsen <[email protected]>
 Andreas Tolfsen <[email protected]>
+Andrei <[email protected]>
 Andrei Botalov <[email protected]>
 Andrei Rusu <[email protected]>
 Andrei Solntsev <[email protected]>
@@ -88,6 +90,7 @@ Ashley Trinh <[email protected]>
 Aslak Hellesøy <[email protected]>
 asmundak <[email protected]>
 Atsushi Tatsuma <[email protected]>
+Augustin Gottlieb Pequeno <[email protected]>
 Aurélien Pupier <[email protected]>
 Austin Michael Wilkins <[email protected]>
 BaerMitUmlaut <[email protected]>
@@ -98,6 +101,7 @@ Ben Kucera <[email protected]>
 Ben Lamm <[email protected]>
 Ben Sedat <[email protected]>
 Benjamin Forehand Jr <[email protected]>
+bgermann <[email protected]>
 bhecquet <[email protected]>
 bhkwan <[email protected]>
 Bill Agee <[email protected]>
@@ -364,6 +368,7 @@ James Garbutt <[email protected]>
 James Hilliard <[email protected]>
 James Martin <[email protected]>
 James Strachen
+James Yuzawa <[email protected]>
 jamespdo <[email protected]>
 Jan Trejbal <[email protected]>
 Jan Weitz <[email protected]>
@@ -696,6 +701,7 @@ reichsta <[email protected]>
 Reinaldo Rossetti <[email protected]>
 Reinhold Degenfellner <[email protected]>
 Remco <[email protected]>
+renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
 richard.hines <[email protected]>
 RichCrook <[email protected]>
 richseviora <[email protected]>

CONTRIBUTING.md

@@ -89,6 +89,40 @@ to check that your approach aligns with the project's
 ideas. Nothing is more frustrating than seeing your hard work go to
 waste because your vision doesn't align with the project's.
 
+#### Dependencies Managed by Bazel
+
+##### Java
+
+Edit `MODULE.bazel`, and either update or add the dependency you want
+using the regular maven coordinates to the `maven.install` with the
+name `maven`. Once done, run `REPIN=1 bazel run @maven//:pin` to
+update the lock file, create a PR and check the change in.
+
+##### JS
+
+We use `pnpm` for JS development in the project, and we also use [pnpm
+workspaces](https://pnpm.io/workspaces). Take a look at the top-level
+`pnpm-workspace.yaml` file to find them all, but the main thing to
+know is that each of the workspaces has its own `package.json`. You
+can add dependencies to specific workspaces either by using `pnpm`
+installed on your local machine, or by executing:
+
+```shell
+# Example of adding a dep to the JS webdriver bindings 
+cd javascript/node/selenium-webdriver
+bazel run javascript:pnpm -- install my-amazing-dep --dir $PWD
+```
+
+This will install the dependency using the same version of `pnpm` we
+build the project with for a single JS project.
+
+To update all dependencies in the tree to the latest version:
+
+`bazel run javascript:pnpm -- -r up --dir $PWD`
+
+This will also update the lock file, so once a change is made, create
+a PR and commit all the changed files.
+
 #### License Headers
 
 Every file in the Selenium project must carry the following license