DataLoom/docs/windows-build.md

Windows 11 portable build

The final portable executable must be built on Windows 11 because PyInstaller produces a platform-specific executable.

Requirements

• Windows 11 64-bit
• Python 3.11 or newer from python.org, with the Python launcher (py) available
• Git, or a ZIP copy of this repository
• Internet access during the one-time dependency installation only

Build

Open PowerShell in the repository root and run:

Set-ExecutionPolicy -Scope Process Bypass
.\\build-windows.ps1

The script creates a project-local virtual environment, installs the application and build/test dependencies, runs the synthetic tests, and creates:

dist\\DataLoom.exe

The executable is intended to be portable and does not require Python on the destination Windows machine.

Validation checklist

• Launch dist\\DataLoom.exe on Windows 11.
• Import tests\\fixtures\\sample-export-a.json and sample-export-b.json.
• Confirm 8 loaded, 7 included, 1 exact duplicate removed, and 2 review groups.
• Confirm secret logging is unchecked by default.
• Confirm the duplicate detail view shows both records and the newer revision preference.
• Export a merged JSON file and verify the displayed output and audit-log paths.
• Test on a second Windows 11 machine or clean user profile if practical.

Sensitive data

Do not copy real Bitwarden exports, merged vaults, audit logs, .venv, build, or dist contents into the repository. Use copies of vault exports only for local testing.