Debug configuration settings

Launch/Attach Settings

Overview

These are the settings that you would use in the Launch/Attach Request in any DAP client.

Code Execution Settings

Property	Type	Launch or Attach	Description
module	string	Launch Only	Name of the module to be debugged.
program	string	Launch Only	Absolute path to the program.
code	string	Launch Only	Code to execute in string form. Example: "code": "import debugpy;print(debugpy.__version__)"
python	Array[string]	Launch Only	Path python executable and interpreter arguments. Example: "python": ["/usr/bin/python", "-E"], For arguments to your script use "args".
args	Array[string]	Launch Only	Command line arguments passed to the program. Example: "args": ["--arg1", "-arg2", "val", ...]
console	Enum	Launch Only	Supported values ["internalConsole", "integratedTerminal", "externalTerminal"]. Sets where to launch the debug target. Default is "integratedTerminal".
cwd	string	Launch Only	Absolute path to the working directory of the program being debugged.
env	Object	Launch Only	Environment variables defined as a key value pair. Property ends up being the Env Variable and the value of the property ends up being the value of the Env Variable.

Debugger Settings

Property	Type	Launch or Attach	Description
django	Boolean	Launch or Attach	When true enables Django templates. Default is false.
gevent	Boolean	Launch or Attach	When true enables debugging of gevent monkey-patched code. Default is false.
jinja	Boolean	Launch or Attach	When true enables Jinja2 template debugging (e.g. Flask). Default is false.
justMyCode	Boolean	Launch or Attach	When true debug only user-written code. To debug standard library or anything outside of "cwd" use false. Default is true.
logToFile	Boolean	Launch or Attach	When true enables logging of debugger events to a log file(s). Default is false.
pathMappings	Array[Object]	Launch or Attach	Map of local and remote paths. Example: "pathMappings": [{"localRoot": "local path", "remoteRoot": "remote path"}, ...].
pyramid	Boolean	Launch or Attach	When true enables debugging Pyramid applications. Default is false.
redirectOutput	Boolean	Launch or Attach	When true redirects output to debug console. Default is false.
showReturnValue	Boolean	Launch or Attach	Shows return value of functions when stepping. The return value is added to the response to Variables Request
stopOnEntry	Boolean	Launch Only	When true debugger stops at first line of user code. When false debugger does not stop until breakpoint, exception or pause.
subProcess	Boolean	Launch or Attach	When true enables debugging multiprocess applications. Default is true.
sudo	Boolean	Launch or Attach	When true runs program program under elevated permissions (on Unix). Default is false.

Examples