Metadata-Version: 2.4
Name: playwright-browser-emulator
Version: 1.0.0
Summary: A wrapper tool to launch the playwright browser emulator for use in manual headed mode
Author-email: Christian Ekiza <ekiza23@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Eki23/playwright-browser-emulator
Project-URL: Repository, https://github.com/Eki23/playwright-browser-emulator
Project-URL: BugTracker, https://github.com/Eki23/playwright-browser-emulator/issues
Keywords: browser,emulator,playwright
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: install_playwright
Dynamic: license-file

# playwright-browser-emulator

This is a wrapper for playwright's browser emulator that provides access to browsers for manual testing.

## Features

-  Headed browser emulator for manual exploratory testing across Chromium, Firefox, and WebKit.

    Launch kwargs follow a two-level layered pattern:
      - Emulator-level kwargs are passed at instantiation and apply to every start() call.
      - Method-level kwargs are passed directly to start() and merge over the emulator-level
        ones for that call only, overriding any key they share.

    Any kwarg accepted by Playwright's browser.launch() can be used at either level.
    headless is always forced to False and cannot be overridden.

## Usage Examples

-  emulator = BrowserEmulator( prefix="My Browser Emulator", slow_mo=300)
-  emulator.start(BrowserEmulator.CHROMIUM,
                  url="https://example.com/report",
                  downloads_path="C:/downloads/chromium") 

-  emulator.start(BrowserEmulator.FIREFOX,
                  url="https://example.com/report",
                  downloads_path="C:/downloads/firefox",
                  slow_mo=800)                          

 -  emulator.start(BrowserEmulator.SAFARI_WEBKIT,
                   url="https://example.com/report",
                   downloads_path="C:/downloads/webkit") 

```bash
pip install playwright-browser-emulator
```

## License

This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
