From 79d47eb4c377069189e4399ed54cc7da9e660144 Mon Sep 17 00:00:00 2001
From: Aakash Hotchandani <aakash.h@browserstack.com>
Date: Wed, 10 Jun 2026 18:38:30 +0530
Subject: [PATCH 1/3] feat: Vanilla Python (python-generic) Automate sample

---
 .github/workflows/Semgrep.yml | 49 -----------------------------------
 .gitignore                    |  5 ++++
 .npmrc                        |  7 -----
 CODEOWNERS                    |  1 -
 README.md                     |  3 +--
 browserstack.yml              | 26 +++++++++++++++++++
 bstack_local_test.py          | 19 ++++++++++++++
 bstack_sample.py              | 27 +++++++++++++++++++
 requirements.txt              |  3 +++
 9 files changed, 81 insertions(+), 59 deletions(-)
 delete mode 100644 .github/workflows/Semgrep.yml
 create mode 100644 .gitignore
 delete mode 100644 .npmrc
 delete mode 100644 CODEOWNERS
 create mode 100644 browserstack.yml
 create mode 100644 bstack_local_test.py
 create mode 100644 bstack_sample.py
 create mode 100644 requirements.txt

diff --git a/.github/workflows/Semgrep.yml b/.github/workflows/Semgrep.yml
deleted file mode 100644
index 5398af9..0000000
--- a/.github/workflows/Semgrep.yml
+++ /dev/null
@@ -1,49 +0,0 @@
-# Name of this GitHub Actions workflow.
-name: Semgrep
-
-on:
-  # Scan changed files in PRs (diff-aware scanning):
-  # The branches below must be a subset of the branches above
-  pull_request:
-    branches: ["master", "main"]
-  push:
-    branches: ["master", "main"]
-  schedule:
-    - cron: '0 6 * * *'
-
-
-permissions:
-  contents: read
-
-jobs:
-  semgrep:
-    # User definable name of this GitHub Actions job.
-    permissions:
-      contents: read  # for actions/checkout to fetch code
-      security-events: write  # for github/codeql-action/upload-sarif to upload SARIF results
-    name: semgrep/ci 
-    # If you are self-hosting, change the following `runs-on` value: 
-    runs-on: ubuntu-latest
-
-    container:
-      # A Docker image with Semgrep installed. Do not change this.
-      image: returntocorp/semgrep
-
-    # Skip any PR created by dependabot to avoid permission issues:
-    if: (github.actor != 'dependabot[bot]')
-
-    steps:
-      # Fetch project source with GitHub Actions Checkout.
-      - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9 # v3.5.3
-      # Run the "semgrep ci" command on the command line of the docker image.
-      - run: semgrep ci --sarif --output=semgrep.sarif
-        env:
-            # Add the rules that Semgrep uses by setting the SEMGREP_RULES environment variable. 
-            SEMGREP_RULES: p/default # more at semgrep.dev/explore
-
-      - name: Upload SARIF file for GitHub Advanced Security Dashboard
-        uses: github/codeql-action/upload-sarif@6c089f53dd51dc3fc7e599c3cb5356453a52ca9e # v2.20.0
-        with:
-          sarif_file: semgrep.sarif
-        if: always()
-
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d3eba2a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+__pycache__
+.venv
+env
+local.log
+log/
diff --git a/.npmrc b/.npmrc
deleted file mode 100644
index 33911e3..0000000
--- a/.npmrc
+++ /dev/null
@@ -1,7 +0,0 @@
-ignore-scripts=true
-strict-ssl=true
-save-exact=true
-engine-strict=true
-legacy-peer-deps=false
-audit-level=high
-access=public
diff --git a/CODEOWNERS b/CODEOWNERS
deleted file mode 100644
index c4a6041..0000000
--- a/CODEOWNERS
+++ /dev/null
@@ -1 +0,0 @@
-* @browserstack/automate-public-repos
\ No newline at end of file
diff --git a/README.md b/README.md
index ec650b5..736052f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1 @@
-# vanilla-python-browserstack
-We require the following new public repositories under the browserstack GitHub organization to host customer-facing sample projects for the BrowserStack SDK.
+# Vanilla Python with BrowserStack SDK
diff --git a/browserstack.yml b/browserstack.yml
new file mode 100644
index 0000000..589e25c
--- /dev/null
+++ b/browserstack.yml
@@ -0,0 +1,26 @@
+userName: YOUR_USERNAME
+accessKey: YOUR_ACCESS_KEY
+projectName: BrowserStack Samples
+buildName: browserstack build
+buildIdentifier: '#${BUILD_NUMBER}'
+# Vanilla Python (python-generic) — no test framework; run via `browserstack-sdk python <script>`.
+platforms:
+  - os: OS X
+    osVersion: Big Sur
+    browserName: Chrome
+    browserVersion: latest
+  - os: Windows
+    osVersion: 10
+    browserName: Edge
+    browserVersion: latest
+  - deviceName: Samsung Galaxy S22 Ultra
+    browserName: chrome
+    osVersion: 12.0
+parallelsPerPlatform: 1
+browserstackAutomation: true
+browserstackLocal: true
+source: vanilla-python-browserstack:sample-sdk:v1.0
+testObservability: true
+debug: false
+networkLogs: false
+consoleLogs: errors
diff --git a/bstack_local_test.py b/bstack_local_test.py
new file mode 100644
index 0000000..f3ab1b5
--- /dev/null
+++ b/bstack_local_test.py
@@ -0,0 +1,19 @@
+# Vanilla Python local test — verifies the BrowserStack Local tunnel.
+from selenium import webdriver
+
+
+def run():
+    driver = webdriver.Remote(
+        command_executor="https://hub.browserstack.com/wd/hub",
+        options=webdriver.ChromeOptions(),
+    )
+    try:
+        driver.get("http://bs-local.com:45454")
+        assert driver.title == "BrowserStack Local", driver.title
+        print("Vanilla Python local test passed.")
+    finally:
+        driver.quit()
+
+
+if __name__ == "__main__":
+    run()
diff --git a/bstack_sample.py b/bstack_sample.py
new file mode 100644
index 0000000..2a3b108
--- /dev/null
+++ b/bstack_sample.py
@@ -0,0 +1,27 @@
+# Vanilla Python sample — no test framework. The BrowserStack SDK patches
+# selenium webdriver.Remote at import time and runs this script across the
+# platforms in browserstack.yml.  Run:  browserstack-sdk python bstack_sample.py
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+
+
+def run():
+    driver = webdriver.Remote(
+        command_executor="https://hub.browserstack.com/wd/hub",
+        options=webdriver.ChromeOptions(),
+    )
+    try:
+        driver.get("https://bstackdemo.com/")
+        product = driver.find_element(By.XPATH, '//*[@id="1"]/p').text
+        driver.find_element(By.XPATH, '//*[@id="1"]/div[4]').click()
+        driver.find_element(By.CLASS_NAME, "float-cart__content")
+        cart = driver.find_element(
+            By.XPATH, '//*[@id="__next"]/div/div/div[2]/div[2]/div[2]/div/div[3]/p[1]').text
+        assert cart == product, f"cart {cart!r} != product {product!r}"
+        print("Vanilla Python sample passed: cart matches product.")
+    finally:
+        driver.quit()
+
+
+if __name__ == "__main__":
+    run()
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..792b503
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,3 @@
+selenium>=4.0.0
+browserstack-local
+browserstack-sdk @ https://sdk-assets.browserstack.com/python/browserstack_sdk-latest.tar.gz

From 92b56516f4ba6347ddf25d88d76b356f30487372 Mon Sep 17 00:00:00 2001
From: Aakash Hotchandani <aakash.h@browserstack.com>
Date: Thu, 11 Jun 2026 14:16:43 +0530
Subject: [PATCH 2/3] Restore scaffold files dropped by import (Semgrep CI
 workflow, CODEOWNERS, .npmrc)

---
 .github/workflows/Semgrep.yml | 49 +++++++++++++++++++++++++++++++++++
 .npmrc                        |  7 +++++
 CODEOWNERS                    |  1 +
 3 files changed, 57 insertions(+)
 create mode 100644 .github/workflows/Semgrep.yml
 create mode 100644 .npmrc
 create mode 100644 CODEOWNERS

diff --git a/.github/workflows/Semgrep.yml b/.github/workflows/Semgrep.yml
new file mode 100644
index 0000000..5398af9
--- /dev/null
+++ b/.github/workflows/Semgrep.yml
@@ -0,0 +1,49 @@
+# Name of this GitHub Actions workflow.
+name: Semgrep
+
+on:
+  # Scan changed files in PRs (diff-aware scanning):
+  # The branches below must be a subset of the branches above
+  pull_request:
+    branches: ["master", "main"]
+  push:
+    branches: ["master", "main"]
+  schedule:
+    - cron: '0 6 * * *'
+
+
+permissions:
+  contents: read
+
+jobs:
+  semgrep:
+    # User definable name of this GitHub Actions job.
+    permissions:
+      contents: read  # for actions/checkout to fetch code
+      security-events: write  # for github/codeql-action/upload-sarif to upload SARIF results
+    name: semgrep/ci 
+    # If you are self-hosting, change the following `runs-on` value: 
+    runs-on: ubuntu-latest
+
+    container:
+      # A Docker image with Semgrep installed. Do not change this.
+      image: returntocorp/semgrep
+
+    # Skip any PR created by dependabot to avoid permission issues:
+    if: (github.actor != 'dependabot[bot]')
+
+    steps:
+      # Fetch project source with GitHub Actions Checkout.
+      - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9 # v3.5.3
+      # Run the "semgrep ci" command on the command line of the docker image.
+      - run: semgrep ci --sarif --output=semgrep.sarif
+        env:
+            # Add the rules that Semgrep uses by setting the SEMGREP_RULES environment variable. 
+            SEMGREP_RULES: p/default # more at semgrep.dev/explore
+
+      - name: Upload SARIF file for GitHub Advanced Security Dashboard
+        uses: github/codeql-action/upload-sarif@6c089f53dd51dc3fc7e599c3cb5356453a52ca9e # v2.20.0
+        with:
+          sarif_file: semgrep.sarif
+        if: always()
+
diff --git a/.npmrc b/.npmrc
new file mode 100644
index 0000000..33911e3
--- /dev/null
+++ b/.npmrc
@@ -0,0 +1,7 @@
+ignore-scripts=true
+strict-ssl=true
+save-exact=true
+engine-strict=true
+legacy-peer-deps=false
+audit-level=high
+access=public
diff --git a/CODEOWNERS b/CODEOWNERS
new file mode 100644
index 0000000..c4a6041
--- /dev/null
+++ b/CODEOWNERS
@@ -0,0 +1 @@
+* @browserstack/automate-public-repos
\ No newline at end of file

From 537cc227650d560df2bccc328402a49d1315abc6 Mon Sep 17 00:00:00 2001
From: Aakash Hotchandani <aakash.h@browserstack.com>
Date: Fri, 12 Jun 2026 11:38:14 +0530
Subject: [PATCH 3/3] Add BrowserStack SDK sample-test GitHub Actions workflow
 (workflow_dispatch)

---
 .github/workflows/sdk-sample-test.yml | 69 +++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 .github/workflows/sdk-sample-test.yml

diff --git a/.github/workflows/sdk-sample-test.yml b/.github/workflows/sdk-sample-test.yml
new file mode 100644
index 0000000..7a6e273
--- /dev/null
+++ b/.github/workflows/sdk-sample-test.yml
@@ -0,0 +1,69 @@
+# Runs the BrowserStack SDK sample against a given commit and reports a status check.
+# Trigger: Actions tab -> "Vanilla Python SDK sample test" -> Run workflow -> paste the PR's full commit SHA.
+# Requires repo secrets: BROWSERSTACK_USERNAME, BROWSERSTACK_ACCESS_KEY.
+name: Vanilla Python SDK sample test
+
+on:
+  workflow_dispatch:
+    inputs:
+      commit_sha:
+        description: 'The full commit id to build'
+        required: true
+
+jobs:
+  sdk-sample:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      max-parallel: 3
+      matrix:
+        os: [ubuntu-latest]
+        python: ['3.10', '3.11', '3.12']
+    name: vanilla-python Python ${{ matrix.python }} sample
+    env:
+      BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
+      BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}
+    defaults:
+      run:
+        working-directory: .
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.commit_sha }}
+      - name: Mark status check in_progress
+        uses: actions/github-script@v7
+        env:
+          job_name: vanilla-python Python ${{ matrix.python }} sample
+          commit_sha: ${{ github.event.inputs.commit_sha }}
+        with:
+          github-token: ${{ github.token }}
+          script: |
+            await github.rest.checks.create({
+              owner: context.repo.owner, repo: context.repo.repo,
+              name: process.env.job_name, head_sha: process.env.commit_sha,
+              status: 'in_progress'
+            }).catch(e => console.log('check create failed:', e.status));
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install
+        run: |
+          pip install -r requirements.txt
+      - name: Run sample test
+        run: |
+          browserstack-sdk python bstack_sample.py
+      - name: Mark status check completed
+        if: always()
+        uses: actions/github-script@v7
+        env:
+          conclusion: ${{ job.status }}
+          job_name: vanilla-python Python ${{ matrix.python }} sample
+          commit_sha: ${{ github.event.inputs.commit_sha }}
+        with:
+          github-token: ${{ github.token }}
+          script: |
+            await github.rest.checks.create({
+              owner: context.repo.owner, repo: context.repo.repo,
+              name: process.env.job_name, head_sha: process.env.commit_sha,
+              status: 'completed', conclusion: process.env.conclusion
+            }).catch(e => console.log('check create failed:', e.status));