Metadata-Version: 2.4
Name: gdbrunner
Version: 0.0.2
Summary: GDB debug server launcher for embedded targets
Author-email: "OpenMV, LLC" <info@openmv.io>
License: MIT
Project-URL: Homepage, https://openmv.io
Project-URL: Repository, https://github.com/openmv/gdbrunner
Keywords: gdb,debug,embedded,jlink,stlink
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# gdbrunner

GDB runner - start debug servers and attach GDB.

## Installation

```bash
pip install gdbrunner
```

## Usage

```bash
gdbrunner <backend> [options] elf
```

### Backends

- `jlink` - J-Link GDB server
- `stlink` - ST-Link GDB server

### Examples

```bash
# Start J-Link and attach GDB
gdbrunner jlink --device STM32H743VI firmware.elf

# Start ST-Link and attach GDB
gdbrunner stlink --cube-prog /path/to/cubeprog firmware.elf

# Dry run - print server command without running
gdbrunner jlink --device STM32H743VI --dryrun firmware.elf
```

Run `gdbrunner --help` for all options.

## License

MIT
