Test Script Generator (Windows)

A simple GUI utility to record real browser interactions and export them as a Python script, then replay those actions visibly. Ships with packaging config to build a standalone Windows EXE (no Python required on target machines).

Features

• Record clicks, typing, navigation, and visited sites using Playwright's recorder
• Export a ready-to-run Python script of your session
• Replay the script visibly in a browser
• Build a standalone EXE with PyInstaller

Requirements (for building)

• Windows 10+
• Python 3.10–3.12 on your build machine
• PowerShell

Target machines do not need Python; only the EXE.

Quick Start (run with Python)

1. Create and activate a venv (recommended), then install deps:

python -m venv .venv
. .\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m playwright install chromium

2. Run the app:

python app/main.py

The app will auto-install missing Playwright browsers on first run if needed.

Recording

• Click "Start Recording" to open a fresh Chromium window
• Browse freely; all interactions are recorded
• Click "Stop Recording" to finish; your script is saved in exports/

Replay

• Click "Replay Script" and choose a previously exported .py file
• A browser will open and visibly perform the recorded actions

Build a standalone EXE

Use the provided PowerShell script:

scripts\build.ps1

The built EXE will be under dist/ as TestScriptGenerator.exe.

Notes:

• The first run on any machine may download a browser (Chromium) if missing.
• If corporate proxies are in place, ensure HTTP_PROXY/HTTPS_PROXY are set before first run.

Project Structure

app/
  bootstrap.py
  main.py
  recorder.py
  replayer.py
exports/
requirements.txt
scripts/
  build.ps1

Known Limitations

• Recording relies on Playwright's codegen. The recorder must be closed (via Stop in the app) to finalize and save the script.
• Replay runs the generated script in a separate process. Keep the script unmodified or advanced changes may require dependency adjustments.

License

MIT