autoplay-l7

Playwright automation scaffold installer for L7 projects.

Installation

pip install autoplay-l7

Usage

Inside your project root, run:

autoplay init

Behavior

• If tests/ exists → installs scaffold into tests/automation/
• If tests/automation/ already exists → merges scaffold files into it (existing files are not deleted)
• If no tests/ folder exists → creates tests/automation/ with the full scaffold

Options

autoplay init [--target DIR]

  --target DIR   Project root to install into (default: current directory)

Example

cd my-project/
autoplay init
# → tests/automation/ is created or updated

What gets installed

tests/automation/
├── conftest.py
├── pytest.ini
├── requirements.txt
├── playwright.sh
├── utils/
│   ├── commands.py
│   ├── networks.py
│   └── utility_functions.py
├── pages/
│   ├── base_page.py
│   ├── homepage.py
│   └── ...
├── e2e/
│   ├── base_tc.py
│   ├── placeholder/
│   └── Test case Templates/
└── fixtures/
    └── index_seed.yml

Configuration

Port & Host

The automation connects to your app using environment variables. The defaults are defined in tests/automation/pages/base_page.py:

DEFAULT_PORT = "8002"

HOST = os.getenv("ESP_HOST", "localhost")
PORT = os.getenv("ESP_PORT", DEFAULT_PORT)

To change the port, update DEFAULT_PORT in base_page.py to match the port exposed by your Docker container:

DEFAULT_PORT = "8080"  # replace with your Docker port

This single change propagates automatically to:

• The browser navigation URLs (BasePage.build_url)
• The esp CLI commands in utils/commands.py
• The default value in playwright.sh

Alternatively, you can pass the port at runtime without changing any file:

ESP_PORT=8080 ./playwright.sh -t "e2e/placeholder/placeholder.py"

Or for Docker mode:

ESP_HOST=localhost ESP_PORT=8080 ./playwright.sh -t "e2e/placeholder/placeholder.py" -D

Running tests

cd tests/automation/
./playwright.sh -t "e2e/placeholder/placeholder.py"

For Docker mode:

./playwright.sh -t "e2e/placeholder/placeholder.py" -D