Metadata-Version: 2.4
Name: vsdebug
Version: 0.1.5
Summary: Lightweight helper for managing VS Code C++ launch.json debug configurations.
Author: Ben O'Neill
License: MIT
Project-URL: Homepage, https://github.com/benoneillnz/cmd-debug
Project-URL: Source, https://github.com/benoneillnz/cmd-debug/tree/main/python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# vsdebug

`vsdebug` is a lightweight helper for managing VS Code C++ debug configurations.

It automates common workflows around `.vscode/launch.json`, including:

- Adding or updating a launch configuration and immediately starting the debugger
- Running an existing configuration outside the debugger
- Spawning MPI jobs under `mpirun` and generating per-rank attach configurations plus an `MPI` compound
- Backing up, listing, clearing, and reverting `launch.json`


## Installation

```bash
pip install vsdebug
```

## Command-line usage

```bash
vsdebug PUT my_config ./a.out arg1 arg2
vsdebug RUN my_config
vsdebug MPI 4 ./a.out arg1 arg2
```
## Launch the Debugger

To enable support for starting the debugger from the script, you will need to install 
the vscode extension "CMD Debug Trigger". To install the extension, search for it in 
the vscode marketplace and install. 
