swaits
e9089b63a2
Rename from tiny-debugger to turbo-debug — inspired by Turbo Pascal, the first IDE with a real visual debugger. This thing isn't tiny, it's turbo charged. CHANGELOG for 0.1.0: Features: - Zero-config debugging — one line install, everything works - Modal keybindings (c/s/d/r/q/x/X/D/W/K/E/R/?), active only during debug mode, cleanly removed on exit - Persistent breakpoints via persistent-breakpoints.nvim - Inline virtual text — variable values in source code - Hover (K), watch (W), REPL eval (E) from the code window - Help splash (3s auto-dismiss) + manual help (?) - Debug mode chrome — winbar indicator, cursor highlight - dapui integration — controls toolbar, labeled panels - which-key support — <leader>d debug group auto-registered - quit_exits_mode option Adapters (12 languages): - Python (debugpy + venv detection) - Rust (codelldb + cargo build + vim.ui.select picker) - Go (delve), C/C++/Swift (codelldb) - JavaScript/TypeScript (js-debug-adapter) - C# (netcoredbg), Java, Kotlin, PHP, Ruby, Lua (osv) Keybindings: - <leader>dd — toggle debug mode - <leader>dx / <leader>dX / <leader>dD — breakpoints (always) - c s d r C x X D W K E q R ? — modal (debug mode only)
56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
# turbo-debug.nvim
|
|
|
|
A zero-config debugging experience for Neovim 0.12+. One plugin install, full
|
|
IDE-class debugging: inline variable values, hover inspection, persistent
|
|
breakpoints, watch expressions, and modal keybindings that just work.
|
|
|
|
## Install
|
|
|
|
```lua
|
|
vim.pack.add("swaits/turbo-debug.nvim")
|
|
```
|
|
|
|
That's it. No other config needed. See `:help turbo-debug` for customization.
|
|
|
|
## Usage
|
|
|
|
Everything lives under `<leader>d` (with which-key support if installed):
|
|
|
|
| Key | Action | Available |
|
|
|-----|--------|-----------|
|
|
| `<leader>dd` | Toggle debug mode | Always |
|
|
| `<leader>dx` | Toggle breakpoint | Always |
|
|
| `<leader>dX` | Conditional breakpoint | Always |
|
|
| `<leader>dD` | Clear all breakpoints | Always |
|
|
|
|
During debug mode, single-key controls:
|
|
|
|
| Key | Action | Key | Action |
|
|
|-----|--------|-----|--------|
|
|
| `c` | Continue | `x` | Toggle breakpoint |
|
|
| `s` | Step over | `X` | Conditional breakpoint |
|
|
| `d` | Step into | `D` | Clear all breakpoints |
|
|
| `r` | Step out | `W` | Watch expression |
|
|
| `C` | Run to cursor | `K` | Hover / inspect |
|
|
| `q` | Terminate session | `E` | Eval in REPL |
|
|
| `R` | Restart session | `?` | Help popup |
|
|
|
|
All navigation keys preserved. Modal keybindings vanish when you exit debug mode.
|
|
|
|
## Supported Languages
|
|
|
|
Adapter binaries must be installed (via mason, package manager, etc).
|
|
|
|
| Language | Adapter | Language | Adapter |
|
|
|----------|---------|----------|---------|
|
|
| Python | debugpy | C# | netcoredbg |
|
|
| JavaScript / TS | js-debug | Java | java-debug-adapter |
|
|
| Go | delve | Kotlin | kotlin-debug |
|
|
| C / C++ | codelldb | PHP | php-debug |
|
|
| Rust | codelldb | Ruby | rdbg |
|
|
| Swift | codelldb | Lua (Neovim) | osv |
|
|
|
|
## License
|
|
|
|
MIT
|