auto-playwright

Plain-English .flow files → Playwright (Python) runner.

Install

Poetry

poetry install

Dev tools (pytest/formatters) via extras:

poetry install --extras dev
# or
poetry install --all-extras

pip

pip install .

# Dev tools
pip install '.[dev]'

Run

poetry run ap examples/amazon_search.flow

Safety / Logging env vars

• AUTO_PLAYWRIGHT_ALLOWED_DOMAINS (optional): comma-separated hostname allowlist for top-level navigations.

  • Supports exact hosts (example.com) and wildcards (*.example.com).
  • If unset/empty, no allowlist is enforced.

• AUTO_PLAYWRIGHT_POLICY_FILE (optional): YAML policy file path.

  • allowed_domains: additional domain allowlist.
  • blocked_actions: DSL actions to block globally (for governance), e.g. ["sleep"].
  • Example policy: tools/runtime_policy.example.yaml

• AUTO_PLAYWRIGHT_PERSISTENT_PROFILE (optional, default 0): use persistent browser profile (1/true) vs isolated ephemeral context (default).

• AUTO_PLAYWRIGHT_PROFILE_DIR (optional): profile path used when persistent profile is enabled.

• Logs and run_report.* are automatically redacted for common secrets (tokens/keys in env + URL query params).

Run a directory (batch mode):

poetry run ap examples/

Artifacts / Output layout

Each run writes all artifacts under:

output/<flow>/<timestamp>/
  run_report.json
  run_report.html
  artifacts/
    trace.zip              (optional)
    video/                 (optional)
    errors/error_step_*.png
    code/                  (debug/dump-code)
    final/                 (final healed test)
    flows/                 (generated flow, if different)

Debug / code generation

Generate both plain + intelligent code and keep the browser open:

poetry run ap examples/amazon_search.flow --debug

Generate code only (no execution):

poetry run ap examples/amazon_search.flow --dump-code

Tracing / Video / Screenshots

poetry run ap examples/amazon_search.flow --trace on
poetry run ap examples/amazon_search.flow --trace on-failure

poetry run ap examples/amazon_search.flow --video on
poetry run ap examples/amazon_search.flow --video on-failure

# enabled by default; use --no-screenshot-on-failure to disable
poetry run ap examples/amazon_search.flow --no-screenshot-on-failure

Tests (unit / smoke)

No real browser/network is used in tests.

poetry run pytest