{"id":13391838,"url":"https://github.com/daveleroy/SublimeDebugger","last_synced_at":"2025-03-13T16:31:25.082Z","repository":{"id":34217494,"uuid":"155043647","full_name":"daveleroy/SublimeDebugger","owner":"daveleroy","description":"Graphical Debugger for Sublime Text for debuggers that support the debug adapter protocol","archived":false,"fork":false,"pushed_at":"2024-12-22T03:18:46.000Z","size":10062,"stargazers_count":378,"open_issues_count":26,"forks_count":45,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-12-22T04:22:02.946Z","etag":null,"topics":["debug-adapter-protocol","debugger","sublime-text"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daveleroy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-28T06:53:56.000Z","updated_at":"2024-12-22T03:18:50.000Z","dependencies_parsed_at":"2023-10-03T00:34:13.398Z","dependency_job_id":"0b025c72-9fc3-4c04-bdd3-80685e6fbcd2","html_url":"https://github.com/daveleroy/SublimeDebugger","commit_stats":null,"previous_names":["daveleroy/sublimedebugger","daveleroy/sublime_debugger"],"tags_count":55,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveleroy%2FSublimeDebugger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveleroy%2FSublimeDebugger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveleroy%2FSublimeDebugger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveleroy%2FSublimeDebugger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daveleroy","download_url":"https://codeload.github.com/daveleroy/SublimeDebugger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243441364,"owners_count":20291454,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debug-adapter-protocol","debugger","sublime-text"],"created_at":"2024-07-30T15:01:14.765Z","updated_at":"2025-03-13T16:31:24.704Z","avatar_url":"https://github.com/daveleroy.png","language":"Python","readme":"# Sublime Debugger\n\nGraphical Debugger for sublime text for debuggers that support the debug adapter protocol.\n\nSee [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/)\n\n![Image of GUI](docs/images/basic.png)\n\n# Installing\n  Using package control run `Package Control: Install Package` and select `Debugger`.\n\n  or clone into your sublime Packages directory (If you are on Sublime Text 3 use the [st3 branch](https://github.com/daveleroy/sublime_debugger/tree/st3))\n\n# Getting Started\nThis project attempts to match Visual Studio Code's Debugger fairly closely so their documentation can be pretty helpful. See [https://code.visualstudio.com/docs/editor/debugging](https://code.visualstudio.com/docs/editor/debugging)\n\n## Debuggers\nThis project comes with some pre-configured debuggers (They can be installed using ```Debugger: Install adapters```)\n\n##### LLDB\n- See https://github.com/vadimcn/vscode-lldb\n\n##### Chrome\n- See https://github.com/Microsoft/vscode-chrome-debug\n\n##### Firefox\n- See https://github.com/firefox-devtools/vscode-firefox-debug\n\n##### Node\n- For an overview see https://code.visualstudio.com/docs/nodejs/nodejs-debugging\n- See https://github.com/microsoft/vscode-node-debug2\n\n##### Python\n- For an overview see https://code.visualstudio.com/docs/python/debugging\n- See https://github.com/Microsoft/vscode-python\n\n##### Go\n- For an overview see https://github.com/golang/vscode-go/blob/master/docs/debugging.md\n- See https://github.com/golang/vscode-go\n\n##### PHP\n- See https://github.com/felixfbecker/vscode-php-debug\n\n##### Java\n- Requires [LSP](https://packagecontrol.io/packages/LSP) and [LSP-jdtls](https://packagecontrol.io/packages/LSP-jdtls)\n- See https://github.com/redhat-developer/vscode-java\n\n##### Emulicious Debugger\n- See https://github.com/Calindro/emulicious-debugger\n\n## Setup\n- Open the debug panel\n  - from the command palette `Debugger: Open`\n\n- Install a debug adapter by running: ```Debugger: Install adapter``` from the command palette.\n\n- Add a configuration ```Debugger: Add Configuration``` from the command palette (or add one manually, see below).\n  - Configurations are added to `debugger_configurations` to your sublime-project and use the same configuration format as Visual Studio Code\n  - Consult the debugger specific documentation links above for creating a configuration for your debugger. Most debuggers come with some configuration snippets to choose from but I highly recommend looking at the documentation for the debugger.\n  - Variable substitution: variables like `${file}` are supported but the list of supported variables differs from VSCode. The supported values are those listed at http://www.sublimetext.com/docs/build_systems.html#variables plus the VSCode-specific `${workspaceFolder}` that resolves to the path of the first workspace folder.\n\n- Your configuration will look something like the following but with some debugger specific fields.\n```\n\"debugger_configurations\" : [\n    {\n        \"name\" : \"Name of your configuration\",\n        \"request\" : \"launch\"|\"attach\",\n        \"type\" : \"debugger name\",\n         ...\n    }\n]\n```\n\n- Start debugging\n  - click the gear icon to select a configuration to use\n  - click the play icon to start the debugger or run `Debugger: Start` (if no configuration is selected it will ask you to select or create one)\n\n## Tasks\nTasks are based on sublime build_systems with more integration so they can be used more seamlessly while debugging. When errors occur while running a task they are reported in the debugger ui (problem detection is the same as sublime, you must add `file_regex` to your task)\n\nsee https://www.sublimetext.com/docs/build_systems.html\n\nTasks are basically the same as sublime builds but there are a few additional parameters.\n`name` which will show up in the debugger UI and be the name of the panel\n\n```\n\"debugger_tasks\" : [\n    {\n        \"name\" : \"Name of your task\",\n        \"cmd\" : [\"task\", \"command\"],\n         ...\n    }\n]\n```\n- Tasks can be run with `Debugger: Run Tasks`\n- You can run tasks before and after debugging by adding `pre_debug_task` or `post_debug_task` to your configuration specifying the name of the task to run.\n\n\n## Settings\nSettings can be adjusted with `Preferences: Debugger Settings`\n\nfor a full list of settings see [debugger.sublime-settings](Debugger.sublime-settings)\n\n## Troubleshooting\n- To fix issues with things aligning correctly or the last panel not being visible try adjusting the `internal_font_scale` and `internal_width_modifier` in the settings\n- Look in the debug console for errors (usually red)\n- Look in the sublime console for errors\n- Try the same configuration/adapter in Visual Studio Code (There is a good chance your issue is with the adapter so check out the outstanding issues for it)\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveleroy%2FSublimeDebugger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaveleroy%2FSublimeDebugger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveleroy%2FSublimeDebugger/lists"}