Vagrant >= 2.4
Hyper-V enabled (Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All)
Inno Setup 6 installed (default path or ISCC.exe in PATH)
Poetry environment set up (poetry install)

Setup (one-time)

cd vagrant
vagrant up --provider=hyperv
vagrant snapshot save clean

Note: Vagrant will prompt for your Windows credentials to set up the SMB synced folder. You can set VAGRANT_SMB_USERNAME and VAGRANT_SMB_PASSWORD environment variables to skip the prompt.

Running Tests

From the repo root:

.\scripts\windows\run_vagrant_tests.ps1

This will:

Build the installer locally (PyInstaller + Inno Setup)
Restore the VM to the clean snapshot
Push the installer to the VM via WinRM
Run the installer silently inside the VM
Verify installation (directory, exe, shortcuts, registry)
Launch the app, find the window, take a GUI screenshot
Run silent uninstall and verify cleanup
Retrieve results CSV + screenshots to vagrant_test_results\<timestamp>\
Print a summary table to the CLI
Revert the VM back to the clean snapshot

Options

Flag	Description
`-SkipBuild`	Skip the local build step (use an existing installer in `dist\`)
`-SkipRevert`	Leave the VM in post-test state (useful for debugging)
`-SnapshotName <name>`	Use a different snapshot name (default: `clean`)
`-LocalResultsDir <path>`	Override where results are saved

What Gets Tested

#	Test	Description
1	Installer exists	Checks the built `.exe` is present
2	Silent install	Runs the Inno Setup installer with `/VERYSILENT`
3	Install directory	Verifies `C:\Program Files\Android File Handler` exists
4	Executable present	Checks the app `.exe` is in the install directory
5	Start Menu shortcut	Verifies the Start Menu entry was created
6	Registry entry	Checks Add/Remove Programs registration
7	App launches	Starts the app and confirms it stays running
8	Window found	Finds the main window by its title
9	Silent uninstall	Runs the uninstaller and verifies cleanup

File Structure

vagrant/
├── Vagrantfile          # VM definition (Windows 11 Enterprise, Hyper-V)
├── provision.ps1        # VM provisioning (nircmd for screenshots)
├── test_installer.ps1   # Test script that runs inside the VM
└── README.md            # This file
scripts/windows/
└── run_vagrant_tests.ps1  # Host-side orchestrator (builds, pushes, tests, reverts)

Troubleshooting

VM won't start: Ensure Hyper-V is enabled and you are running the terminal as Administrator.

WinRM connection fails: The box uses plaintext WinRM on port 55985. Ensure no firewall blocks it.

SMB share prompt: Set VAGRANT_SMB_USERNAME and VAGRANT_SMB_PASSWORD environment variables to avoid interactive credential prompts.

Inno Setup not found: Install Inno Setup 6 to the default path or add ISCC.exe to your PATH.

Want to inspect the VM manually: Use vagrant rdp or pass -SkipRevert.