Skip to content

README-python.md

Latest commit

 

History

History
36 lines (25 loc) · 1.38 KB

README-python.md

File metadata and controls

36 lines (25 loc) · 1.38 KB

Portable Python (embeddable) for release builds

The portable Windows package bundles a Python embeddable distribution (not a venv). The entire python/ folder is copied into release/ProgressTracker/python/ and moves with the install — no Python install on target PCs.

Download

  1. Open Python Windows downloads.
  2. Under Windows embeddable package (64-bit), download Python 3.11 or newer (e.g. python-3.11.9-embed-amd64.zip).
  3. Extract the zip to a folder that contains python.exe at its root, e.g. C:\tools\python-3.11-embed-amd64\.

Use the embeddable zip, not the full installer. Match amd64 to your PHP build.

Build usage

From the repository root:

.\scripts\build-portable.ps1 `
  -PhpRoot "C:\tools\php-8.2-nts" `
  -PythonRoot "C:\tools\python-3.11-embed-amd64" `
  -Zip

The script copies that tree to python/, enables Lib\site-packages, bootstraps pip, and installs extractor/requirements-portable.txt.

Layout after build

ProgressTracker/python/
  python.exe
  python311.zip          # from embed package
  python311._pth         # written by build (enables site-packages)
  Lib/site-packages/     # xlwings, pandas, PyYAML, openpyxl

Laravel uses PYTHON_EXECUTABLE=python/python.exe (relative to install root) in the packaged .env.