Metadata-Version: 2.4
Name: gecko-web-runtime-client
Version: 1.0.0
Summary: Thin Python client for the Firefox-derived WPR Gecko Worker protocol
Author: WPR project
License: MPL-2.0-compatible client; see the runtime bundle notices
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Python client

The client uses only Python's standard library. From this directory:

```powershell
$env:PYTHONPATH = "$PWD"
python ..\examples\normal_navigation.py
```

The package resolves `runtime/gecko-web-worker.exe` relative to its own
bundle. Override paths with `WPR_RUNTIME_HOME`, `WPR_RUNTIME_DIR`,
`WPR_WORKER_EXE`, `WPR_PROFILE_ROOT`, or `WPR_LOG_ROOT` when embedding it in a
larger application.

To install the pinned runtime automatically from the GitHub Release:

```powershell
python -m gecko_web_runtime install-runtime --version 155
```

The command verifies the pinned SHA256 and stores the selected runtime under
`%LOCALAPPDATA%\WPR\runtime\155`.

For a private GitHub Release, set `GITHUB_TOKEN`, `GH_TOKEN`, or
`WPR_GITHUB_TOKEN`, or configure Git Credential Manager for the GitHub account.
