https://github.com/microsoft/vscode-mock-debug
Starter sample for developing debug adapters for VSCode.
https://github.com/microsoft/vscode-mock-debug
Last synced: 7 days ago
JSON representation
Starter sample for developing debug adapters for VSCode.
- Host: GitHub
- URL: https://github.com/microsoft/vscode-mock-debug
- Owner: microsoft
- License: other
- Created: 2015-10-07T09:21:19.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-03-31T16:45:22.000Z (15 days ago)
- Last Synced: 2025-03-31T22:17:28.555Z (14 days ago)
- Language: TypeScript
- Size: 1.15 MB
- Stars: 323
- Watchers: 41
- Forks: 193
- Open Issues: 15
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-github-star - vscode-mock-debug
README
# VS Code Mock Debug
This is a starter sample for developing VS Code debug adapters.
**Mock Debug** simulates a debug adapter for Visual Studio Code.
It supports *step*, *continue*, *breakpoints*, *exceptions*, and
*variable access* but it is not connected to any real debugger.
The sample is meant as an educational piece showing how to implement a debug
adapter for VS Code. It can be used as a starting point for developing a real adapter.
More information about how to develop a new debug adapter can be found
[here](https://code.visualstudio.com/docs/extensions/example-debuggers).
## Using Mock Debug
* Install the **Mock Debug** extension in VS Code.
* Create a new 'program' file `readme.md` and enter several lines of arbitrary text.
* Switch to the debug viewlet and press the gear dropdown.
* Select the debug environment "Mock Debug".
* Press the green 'play' button to start debugging.
You can now 'step through' the `readme.md` file, set and hit breakpoints, and run into exceptions (if the word exception appears in a line).
## Build and Run
* Clone the project [https://github.com/Microsoft/vscode-mock-debug.git](https://github.com/Microsoft/vscode-mock-debug.git)
* Open the project folder in VS Code.
* Press `F5` to build and launch Mock Debug in another VS Code window.
* In the explorer view of the new window open the 'program' file `readme.md`
* Set some breakpoints
* From the editor's "Run and Debug" toolbar dropdown menu select "Debug File"