/selenium Email Testing

pip install selenium requests webdriver-manager

export OPENINBOX_API_KEY="your-premium-api-key"

import os, re, time, requests

API = "https://api.openinbox.io/api"
HEADERS = {"X-API-KEY": os.environ["OPENINBOX_API_KEY"]}


def create_inbox() -> dict:
    """Create a disposable inbox (no auth required)."""
    r = requests.post(f"{API}/inbox")
    r.raise_for_status()
    return r.json()  # { "id", "email", "expiresAt", ... }


def wait_for_otp(inbox_email: str, timeout: int = 30) -> str:
    """Poll the inbox until an email arrives, then return the OTP from textBody."""
    deadline = time.time() + timeout
    while time.time() < deadline:
        r = requests.get(
            f"{API}/inbound/api/emails",
            params={"inboxEmail": inbox_email},
            headers=HEADERS,
        )
        emails = r.json().get("emails", [])
        if emails:
            match = re.search(r"\b\d{4,8}\b", emails[0].get("textBody") or "")
            if match:
                return match.group(0)
        time.sleep(2)
    raise TimeoutError("No OTP email arrived in time")

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from openinbox import create_inbox, wait_for_otp


def test_email_otp_signup():
    inbox = create_inbox()

    options = webdriver.ChromeOptions()
    options.add_argument("--headless=new")
    driver = webdriver.Chrome(options=options)

    try:
        # 1. Open signup and submit the disposable address
        driver.get("https://staging.yourapp.com/signup")
        driver.find_element(By.NAME, "email").send_keys(inbox["email"])
        driver.find_element(By.CSS_SELECTOR, "button[type=submit]").click()

        WebDriverWait(driver, 10).until(
            EC.visibility_of_element_located(
                (By.XPATH, "//*[contains(text(), 'Check your email')]")
            )
        )

        # 2. Pull the OTP from the inbox and enter it
        otp = wait_for_otp(inbox["email"])
        driver.find_element(By.CSS_SELECTOR, "[data-testid=otp]").send_keys(otp)
        driver.find_element(By.XPATH, "//button[contains(., 'Verify')]").click()

        # 3. Assert we reached the dashboard
        WebDriverWait(driver, 15).until(EC.url_contains("/dashboard"))
        assert driver.find_element(
            By.CSS_SELECTOR, "[data-testid=user-menu]"
        ).is_displayed()
    finally:
        driver.quit()

name: Selenium E2E
on: [push]
jobs:
  selenium:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install selenium requests webdriver-manager pytest
      - run: pytest test_signup.py
        env:
          OPENINBOX_API_KEY: ${{ secrets.OPENINBOX_API_KEY }}