Metadata-Version: 2.4
Name: pywebview-devtools
Version: 0.1.0
Summary: Native helper for pywebview DevTools MCP
Author: pywebview DevTools MCP contributors
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == 'test'
Description-Content-Type: text/markdown

# pywebview DevTools Helper

`pywebview-devtools` is the optional native helper package for `pywebview-devtools-mcp`.

Install it in the same Python environment as your pywebview app:

```powershell
pip install pywebview-devtools
```

Enable it before creating pywebview windows:

```python
import pywebview_devtools
import webview

pywebview_devtools.enable()

remote_port = pywebview_devtools.remote_debugging_port()
if remote_port:
    webview.settings["REMOTE_DEBUGGING_PORT"] = remote_port

window = webview.create_window("Demo", "https://example.com")
webview.start(debug=True)
```

The helper only starts when `PYWEBVIEW_DEVTOOLS` is enabled. Launch mode in the MCP server sets this automatically. For manual attach mode, set `PYWEBVIEW_DEVTOOLS=1` before starting the app and provide stable helper connection values with `PYWEBVIEW_DEVTOOLS_HOST`, `PYWEBVIEW_DEVTOOLS_PORT`, and `PYWEBVIEW_DEVTOOLS_TOKEN` when needed.

The helper listens on a local HTTP endpoint and requires a Bearer token. Treat the token as sensitive and avoid enabling the helper in production builds unless you have a deliberate debugging workflow.
