persistent-breakpoints.nvim
Neovim plugin that saves nvim-dap breakpoints to file and automatically loads them when opening Neovim.
What is persistent-breakpoints.nvim?
Persistent-breakpoints.nvim is a Lua plugin for Neovim that automatically saves nvim-dap debugging breakpoints to a file and reloads them when Neovim starts. It solves the problem of manually recreating breakpoints across editing sessions by providing persistent storage. The plugin is based on community code but includes performance optimizations and bug fixes.
Neovim users who utilize nvim-dap for debugging and want to preserve their breakpoints between sessions. It is particularly useful for developers working on long-term projects where debugging state needs to be maintained.
Developers choose this plugin because it offers a stable, performance-optimized solution for breakpoint persistence without frequent updates. Its flexible configuration and compatibility with session managers make it a reliable addition to the nvim-dap ecosystem.
Overview
Neovim plugin for persistent breakpoints.
Use Cases
Best For
- Preserving nvim-dap breakpoints across Neovim sessions without manual re-creation.
- Debugging long-term projects where breakpoints need to persist between work sessions.
- Integrating persistent breakpoints with session manager plugins via the always_reload option.
- Setting and managing multiple breakpoint types (toggle, conditional, log) with dedicated commands.
- Optimizing debugging workflows in Neovim with a lightweight, stable plugin focused on reliability.
- Customizing breakpoint storage location and load events to fit specific project structures.
Not Ideal For
- Developers not using nvim-dap for debugging in Neovim
- Projects where breakpoints must load instantly on startup without session managers or file buffer dependencies
- Teams seeking plugins with active, frequent updates and new feature additions
- Environments where debugging involves files rarely opened in buffers, as breakpoints only set upon buffer load
Pros & Cons
Pros
Based on community nvim-dap code with improved performance and bug fixes, as highlighted in the README, ensuring efficient breakpoint handling.
Offers customizable settings like save directory, load events, and callback functions through the setup options, allowing adaptation to various project structures.
Supports toggle, conditional, and log breakpoints with dedicated commands, seamlessly integrating with nvim-dap for enhanced debugging workflows.
Includes an always_reload option to work with session manager plugins, ensuring breakpoints load correctly in session contexts without manual intervention.
Cons
Breakpoints are only set when the corresponding file is loaded into a buffer, which can delay debugging setup and requires file access, as noted in the issues section.
Breakpoints saved relative to the project root may fail to load if the working directory changes, often necessitating session managers for reliability, a limitation admitted in the README.
The plugin is designed to be stable with no frequent updates, which could mean slower response to new nvim-dap features or emerging bugs, as stated in the philosophy.
Frequently Asked Questions
Related Projects
nvim-dapDebug Adapter Protocol client implementation for Neovim
nvim-dap-uiA UI for nvim-dap
nvim-dap-virtual-textnvim-dap-virtual-text enhances the debugging experience in Neovim by showing variable values inline as virtual text while using nvim-dap. It integrates with nvim-treesitter to intelligently locate variable definitions and references, making debugging more visual and efficient. ## Key Features - **Inline Variable Display** — Shows variable values directly in the code as virtual text during debugging. - **Changed Value Highlighting** — Highlights variables that have changed since the last step with customizable colors. - **Exception Stop Reasons** — Displays the reason for debugger stops due to exceptions. - **Multi-language Support** — Works with any language supported by nvim-treesitter's locals.scm queries (C/C++, Python, Rust, Go, Java, etc.). - **Customizable Display** — Offers extensive configuration options for virtual text position, formatting, and behavior. - **Frame-aware Display** — Can show variable values from all stack frames, not just the current one. ## Philosophy The plugin follows a minimalistic approach, enhancing the debugging workflow without cluttering the interface, and leverages existing Neovim ecosystems like nvim-treesitter for intelligent parsing.
nvim-dap-viewVisualize debugging sessions in neovim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.