End-to-end tests

pip install apostate pytest
apostate install
apostate fonts install windows
git clone https://github.com/heretic-tech/apostate.git
cd apostate/examples/use-cases/end-to-end-tests

import os

import pytest

from apostate import launch
from app import start


@pytest.fixture(scope="session")
def app_url():
    """APP_URL when it is set, for example your staging site; the local app otherwise."""
    if os.environ.get("APP_URL"):
        yield os.environ["APP_URL"]
        return
    server = start()
    yield f"http://127.0.0.1:{server.server_port}/"
    server.shutdown()


@pytest.fixture(scope="session")
def browser():
    # A fixed seed gives every run, on every host, the same machine, so a failure reproduces.
    with launch(fingerprint=42, fingerprint_platform="windows",
                locale="en-US", timezone="America/New_York", geoip=False) as browser:
        yield browser


@pytest.fixture
def page(browser):
    # Pages share the launch's one profile, so clear its cookies between tests.
    browser.contexts[0].clear_cookies()
    page = browser.new_page()
    yield page
    page.close()

from patchright.sync_api import expect


def test_signup(page, app_url):
    page.goto(app_url)
    page.fill("#email", "e2e@example.test")
    page.click("button[type=submit]")
    expect(page.locator("#result")).to_have_text("Account created for e2e@example.test")


def test_persona(page, app_url):
    page.goto(app_url)
    assert page.evaluate("navigator.platform") == "Win32"
    assert page.evaluate("[screen.width, screen.height]") == [1920, 1080]

pytest -q

..                                                                       [100%]
2 passed in 1.37s

APP_URL=https://staging.example.com/ pytest -q

# A GitHub Actions workflow for these tests. Copy it to .github/workflows/e2e.yml
# in your repository.
name: e2e

on: [push, pull_request]

jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      # A pinned version keeps the machine a seed gives from one run to the next.
      # zstandard unpacks the Linux browser archive on Python older than 3.14.
      - run: pip install apostate==0.4.3 pytest zstandard
      - uses: actions/cache@v4
        with:
          path: ~/.cache/apostate
          key: apostate-0.4.3-${{ runner.os }}-${{ runner.arch }}
      - run: apostate install
      - run: apostate fonts install windows
      - run: pytest

import { test as base, expect } from "patchright/test";
import { launch } from "@heretic-tech/apostate";

export const appUrl = process.env.APP_URL ?? "http://127.0.0.1:8767/";

export const test = base.extend({
  // One browser per worker. A fixed seed gives every run the same machine, so a failure reproduces.
  apostate: [async ({}, use) => {
    const browser = await launch({
      fingerprint: 42,
      fingerprintPlatform: "windows",
      locale: "en-US",
      timezone: "America/New_York",
      geoip: false,
    });
    await use(browser);
    await browser.close();
  }, { scope: "worker" }],

  // Replaces Playwright Test's own page, which would open in an off-the-record context.
  page: async ({ apostate }, use) => {
    await apostate.contexts()[0].clearCookies();
    const page = await apostate.newPage();
    await use(page);
    await page.close();
  },
});

export { expect };

import { defineConfig } from "patchright/test";

export default defineConfig({
  testDir: ".",
  // The app under test. Set APP_URL to test a running site instead, such as staging.
  webServer: process.env.APP_URL ? undefined : {
    command: "python3 ../app.py 8767",
    url: "http://127.0.0.1:8767/",
    reuseExistingServer: true,
  },
});

cd node
npm install
npx patchright test

Running 2 tests using 1 worker

  ✓  1 signup.spec.mjs:3:1 › signup (153ms)
  ✓  2 signup.spec.mjs:10:1 › persona (84ms)

  2 passed (977ms)