pytest-pw-config-gen

Generate pytest-playwright configuration files (pytest.ini, pyproject.toml, conftest.py) via CLI.

Installation

pip install pytest-pw-config-gen

Quick Mode

Generate a configuration file immediately with sensible defaults — no prompts required.

pytest-pw-config-gen --quick --output pytest.ini
pytest-pw-config-gen --quick --output pyproject.toml
pytest-pw-config-gen --quick --output conftest.py

Pass --force to overwrite an existing file without confirmation:

pytest-pw-config-gen --quick --output pytest.ini --force

Interactive Mode

The full-screen terminal wizard is the default when no flags are provided. Pass --interactive explicitly if needed:

pytest-pw-config-gen
# or
pytest-pw-config-gen --interactive

It opens a keyboard-driven form:

After pressing Ctrl+G you are prompted for an output path (defaulting to the current directory). If the file already exists you are asked to confirm the overwrite before anything is written.

In CI environments without a TTY the tool prints a clear error message and exits non-zero rather than hanging.

Supported Options

pytest.ini / pyproject.toml options

conftest.py options

Output Files

All generated files include a comment header identifying them as auto-generated and inline comments explaining non-obvious options so you know what to adjust after generation.

pytest.ini

Sets [pytest] addopts flags (browser, tracing, video, etc.) and common ini options (testpaths, timeout, markers).

pyproject.toml

Sets [tool.pytest.ini_options] with the same options — suitable when you prefer a single pyproject.toml for all project tooling.

conftest.py

Creates a browser_context_args fixture with Playwright context options (viewport, locale, geolocation, storage state, etc.). Drop this file in your test root alongside the chosen pytest.ini or pyproject.toml.

Requirements

• Python 3.9+
• pytest-playwright (installed separately in your test project)

License

MIT