Metadata-Version: 2.4
Name: gunkata
Version: 0.2.0
Summary: Tools to improve security research workflows for Android devices
Author: Finn
Author-email: Finn <theskyabovetheport@bratanmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Testing
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: pydantic-settings>=2.15.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: typer>=0.12
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/theskyabovetheport/gunkata
Project-URL: Repository, https://github.com/theskyabovetheport/gunkata
Description-Content-Type: text/markdown

# gunkata

*Designed by a human. Implemented by an LLM.*

Tools to improve security research workflows for Android devices.

## Layout

Single package, `src/` layout: `src/gunkata/`. `main.py` holds the Typer CLI
(installs the `gunkata` console script); everything else is library code.

## Development

Managed with [uv](https://docs.astral.sh/uv/).

```bash
uv sync            # create .venv, install gunkata + deps
uv run gunkata     # run the CLI
uv run gunkata version
```

Tests marked `emulator` need a live adb-attached device. `scripts/run_emulator.sh`
boots one locally (installing the emulator package, a system image, and the AVD
on first run) and leaves it running:

```bash
scripts/run_emulator.sh
uv run pytest -m emulator
```
