Metadata-Version: 2.4
Name: aws-browser-client
Version: 0.1.0
Summary: Signed Selenium connector for remotely hosted browser sessions
License-Expression: MIT
Keywords: selenium,webdriver,remote-browser,hmac
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: selenium<5,>=4.18
Dynamic: license-file

# AWS Browser Client

Python connector for an HMAC-signed remote Selenium gateway.

## Install

Install from PyPI:

```powershell
python -m pip install aws-browser-client
```

For local development, install this source directory:

```powershell
python -m pip install .
```

## Use

```python
import os
from aws_webdriver import connect

driver = connect(
    os.environ["AWS_BROWSER_BASE_URL"],
    os.environ["AWS_BROWSER_API_KEY"],
    os.environ["AWS_BROWSER_SESSION_ID"],
)

try:
    driver.get("https://app.notion.com")
finally:
    driver.quit()
```

Recommended `.env` values:

```dotenv
AWS_BROWSER_BASE_URL=https://browser.example.com
AWS_BROWSER_API_KEY=replace-with-generated-key
AWS_BROWSER_SESSION_ID=replace-with-session-id
```

Never commit API keys or session IDs to source control.

