Metadata-Version: 2.4
Name: susatest-agent
Version: 0.2.0
Summary: Local agent for SUSATest — connects your Android device to the cloud testing platform
Author-email: SUSATest <support@susatest.com>
License: MIT
Project-URL: Homepage, https://susatest.com
Project-URL: Documentation, https://susatest.com/docs
Project-URL: Repository, https://github.com/modernmysitc/SUSA
Keywords: testing,android,qa,automation,adb,mobile-testing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Testing
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"

# susatest-agent

Local agent for [SUSATest](https://susatest.com) — connects your Android device to the cloud testing platform.

## Install

```bash
pip install susatest-agent
```

## Usage

1. Get your API key from [susatest.com/app/settings](https://susatest.com/app/settings)
2. Connect your Android device via USB (USB debugging enabled)
3. Run:

```bash
susatest-agent connect --api-key susa_YOUR_API_KEY
```

Your device will appear in the SUSATest dashboard. Upload an APK and tests run directly on your phone.

## Requirements

- Python 3.9+
- ADB installed (`adb` in PATH) — comes with [Android Studio](https://developer.android.com/studio)
- Android device connected via USB with USB debugging enabled

## Commands

```bash
# Connect to SUSATest (default server)
susatest-agent connect --api-key susa_xxxx

# Connect specific device (if multiple)
susatest-agent connect --api-key susa_xxxx --device R5CR1234567

# Custom server URL
susatest-agent connect --api-key susa_xxxx --server wss://your-server.com

# Custom ADB path
susatest-agent connect --api-key susa_xxxx --adb-path /path/to/adb
```

## How It Works

The agent creates a WebSocket tunnel between your local machine and susatest.com. When you start a test on the website:

1. Server sends commands (tap, screenshot, swipe, etc.) through the tunnel
2. Agent executes them via ADB on your local device
3. Results stream back to the server in real-time

No ports need to be opened — the connection is outbound only.

## License

MIT
