docs(python): added docs for pyinstaller (#7784)
Co-authored-by: Max Schmitt <max@schmitt.mx>
This commit is contained in:
parent
c1d6c4b25e
commit
5701292a53
|
|
@ -4,6 +4,7 @@ title: "Getting Started"
|
||||||
---
|
---
|
||||||
|
|
||||||
<!-- TOC -->
|
<!-- TOC -->
|
||||||
|
|
||||||
- [Release notes](./release-notes.md)
|
- [Release notes](./release-notes.md)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
@ -135,6 +136,45 @@ python -m asyncio
|
||||||
>>> await playwright.stop()
|
>>> await playwright.stop()
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Pyinstaller
|
||||||
|
|
||||||
|
You can use Playwright with [Pyinstaller](https://www.pyinstaller.org/) to create standalone executables.
|
||||||
|
|
||||||
|
```py
|
||||||
|
# main.py
|
||||||
|
from playwright.sync_api import sync_playwright
|
||||||
|
|
||||||
|
with sync_playwright() as p:
|
||||||
|
browser = p.chromium.launch()
|
||||||
|
page = browser.new_page()
|
||||||
|
page.goto("http://whatsmyuseragent.org/")
|
||||||
|
page.screenshot(path="example.png")
|
||||||
|
browser.close()
|
||||||
|
```
|
||||||
|
|
||||||
|
If you want to bundle browsers with the executables:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Linux/macOS
|
||||||
|
PLAYWRIGHT_BROWSERS_PATH=0 playwright install chromium
|
||||||
|
pyinstaller -F main.py
|
||||||
|
|
||||||
|
# Windows with cmd.exe
|
||||||
|
set PLAYWRIGHT_BROWSERS_PATH=0
|
||||||
|
playwright install chromium
|
||||||
|
pyinstaller -F main.py
|
||||||
|
|
||||||
|
# Windows with PowerShell
|
||||||
|
$env:PLAYWRIGHT_BROWSERS_PATH="0"
|
||||||
|
playwright install chromium
|
||||||
|
pyinstaller -F main.py
|
||||||
|
```
|
||||||
|
|
||||||
|
:::note
|
||||||
|
Bundling the browsers with the executables will generate bigger binaries.
|
||||||
|
It is recommended to only bundle the browsers you use.
|
||||||
|
:::
|
||||||
|
|
||||||
## Known issues
|
## Known issues
|
||||||
|
|
||||||
### `time.sleep()` leads to outdated state
|
### `time.sleep()` leads to outdated state
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue