Configurable local playwright

[evanqhuang]

Summary

Adds support for connecting to remote Playwright browser instances running in Docker containers for better scalability and isolation.

Key Changes

• Added PlaywrightConfig dataclass with url parameter for WebSocket endpoints
• Enhanced get_flights() and related functions to accept optional playwright_config parameter
• Modified Playwright modules to connect to remote instances via playwright.chromium.connect()
• Updated README with Docker setup instructions and usage examples

Usage

  from fast_flights import get_flights, PlaywrightConfig

  playwright_config = PlaywrightConfig(url="ws://localhost:3000")
  result = get_flights(..., playwright_config=playwright_config)

Docker Setup

  docker run -p 3000:3000 mcr.microsoft.com/playwright:v1.53.0-noble \
    /bin/bash -c "npx playwright install && npx playwright run-server --port=3000"

Benefits

• now you can run playwright within a docker compose stack for completely headless operation
• Container isolation: Browsers run in Docker instead of locally
• Deployment flexibility: Can run browsers on different machines
• Backward compatible - existing code continues to work unchanged.

Testing evidence: