Mercurial > vim
changeset 35344:f5da3a15e222
runtime(termdebug): convert termdebug plugin to Vim9 script
Commit: https://github.com/vim/vim/commit/23f29ffc64276dd790581f98b86a0a6435b7eb22
Author: Ubaldo Tiberi <ubaldo.tiberi@volvo.com>
Date: Wed Jun 5 21:27:38 2024 +0200
runtime(termdebug): convert termdebug plugin to Vim9 script
closes: https://github.com/vim/vim/issues/14903
Signed-off-by: Ubaldo Tiberi <ubaldo.tiberi@volvo.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Wed, 05 Jun 2024 21:45:03 +0200 |
parents | 794c3c4831a7 |
children | 7d325ff9356c |
files | runtime/doc/terminal.txt runtime/pack/dist/opt/termdebug/plugin/termdebug.vim |
diffstat | 2 files changed, 1216 insertions(+), 1140 deletions(-) [+] |
line wrap: on
line diff
--- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 9.1. Last change: 2024 Mar 17 +*terminal.txt* For Vim version 9.1. Last change: 2024 Jun 05 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1332,8 +1332,8 @@ Put focus on the gdb window to type comm *:Run* *:Arguments* In the window showing the source code these commands can be used to control gdb: - `:Run` [args] run the program with [args] or the previous arguments - `:Arguments` {args} set arguments for the next `:Run` + :Run [args] run the program with [args] or the previous arguments + :Arguments {args} set arguments for the next `:Run` *:Break* set a breakpoint at the cursor position :Break {position} @@ -1379,10 +1379,10 @@ breakpoint, or use the "Clear breakpoint Inspecting variables ~ *termdebug-variables* *:Evaluate* - `:Evaluate` evaluate the expression under the cursor - `K` same (see |termdebug_map_K| to disable) - `:Evaluate` {expr} evaluate {expr} - `:'<,'>Evaluate` evaluate the Visually selected text + :Evaluate evaluate the expression under the cursor + K same (see |termdebug_map_K| to disable) + :Evaluate {expr} evaluate {expr} + :'<,'>Evaluate evaluate the Visually selected text This is similar to using "print" in the gdb window. You can usually shorten `:Evaluate` to `:Ev`. @@ -1390,14 +1390,14 @@ You can usually shorten `:Evaluate` to ` Navigating stack frames ~ *termdebug-frames* *:Frame* *:Up* *:Down* - `:Frame` [frame] select frame [frame], which is a frame number, + :Frame [frame] select frame [frame], which is a frame number, address, or function name (default: current frame) - `:Up` [count] go up [count] frames (default: 1; the frame that + :Up [count] go up [count] frames (default: 1; the frame that called the current) - `+` same (see |termdebug_map_plus| to disable) - `:Down` [count] go down [count] frames (default: 1; the frame called + + same (see |termdebug_map_plus| to disable) + :Down [count] go down [count] frames (default: 1; the frame called by the current) - `-` same (see |termdebug_map_minus| to disable) + - same (see |termdebug_map_minus| to disable) Other commands ~
--- a/runtime/pack/dist/opt/termdebug/plugin/termdebug.vim +++ b/runtime/pack/dist/opt/termdebug/plugin/termdebug.vim @@ -1,419 +1,480 @@ -" Debugger plugin using gdb. -" -" Author: Bram Moolenaar -" Copyright: Vim license applies, see ":help license" -" Last Change: 2023 Nov 02 -" -" WORK IN PROGRESS - The basics works stable, more to come -" Note: In general you need at least GDB 7.12 because this provides the -" frame= response in MI thread-selected events we need to sync stack to file. -" The one included with "old" MingW is too old (7.6.1), you may upgrade it or -" use a newer version from http://www.equation.com/servlet/equation.cmd?fa=gdb -" -" There are two ways to run gdb: -" - In a terminal window; used if possible, does not work on MS-Windows -" Not used when g:termdebug_use_prompt is set to 1. -" - Using a "prompt" buffer; may use a terminal window for the program -" -" For both the current window is used to view source code and shows the -" current statement from gdb. -" -" USING A TERMINAL WINDOW -" -" Opens two visible terminal windows: -" 1. runs a pty for the debugged program, as with ":term NONE" -" 2. runs gdb, passing the pty of the debugged program -" A third terminal window is hidden, it is used for communication with gdb. -" -" USING A PROMPT BUFFER -" -" Opens a window with a prompt buffer to communicate with gdb. -" Gdb is run as a job with callbacks for I/O. -" On Unix another terminal window is opened to run the debugged program -" On MS-Windows a separate console is opened to run the debugged program -" -" The communication with gdb uses GDB/MI. See: -" https://sourceware.org/gdb/current/onlinedocs/gdb/GDB_002fMI.html +vim9script + +# Debugger plugin using gdb. + +# Author: Bram Moolenaar +# Copyright: Vim license applies, see ":help license" +# Last Change: 2024 Jun 03 +# Converted to Vim9: Ubaldo Tiberi <ubaldo.tiberi@volvo.com> + +# WORK IN PROGRESS - The basics works stable, more to come +# Note: In general you need at least GDB 7.12 because this provides the +# frame= response in MI thread-selected events we need to sync stack to file. +# The one included with "old" MingW is too old (7.6.1), you may upgrade it or +# use a newer version from http://www.equation.com/servlet/equation.cmd?fa=gdb + +# There are two ways to run gdb: +# - In a terminal window; used if possible, does not work on MS-Windows +# Not used when g:termdebug_use_prompt is set to 1. +# - Using a "prompt" buffer; may use a terminal window for the program -" In case this gets sourced twice. -if exists(':Termdebug') +# For both the current window is used to view source code and shows the +# current statement from gdb. + +# USING A TERMINAL WINDOW + +# Opens two visible terminal windows: +# 1. runs a pty for the debugged program, as with ":term NONE" +# 2. runs gdb, passing the pty of the debugged program +# A third terminal window is hidden, it is used for communication with gdb. + +# USING A PROMPT BUFFER + +# Opens a window with a prompt buffer to communicate with gdb. +# Gdb is run as a job with callbacks for I/O. +# On Unix another terminal window is opened to run the debugged program +# On MS-Windows a separate console is opened to run the debugged program + +# The communication with gdb uses GDB/MI. See: +# https://sourceware.org/gdb/current/onlinedocs/gdb/GDB_002fMI.html + +# In case this gets sourced twice. +if exists('g:termdebug_loaded') finish endif +g:termdebug_loaded = true -" Need either the +terminal feature or +channel and the prompt buffer. -" The terminal feature does not work with gdb on win32. +var way = 'terminal' +var err = 'no errors' + +var pc_id = 12 +var asm_id = 13 +var break_id = 14 # breakpoint number is added to this +var stopped = 1 +var running = 0 + +var parsing_disasm_msg = 0 +var asm_lines = [] +var asm_addr = '' + +# These shall be constants but cannot be initialized here +# They indicate the buffer numbers of the main buffers used +var gdbbuf = 0 +var varbuf = 0 +var asmbuf = 0 +var promptbuf = 0 +# This is for the "debugged program" thing +var ptybuf = 0 +var commbuf = 0 + +var gdbjob = null_job +var gdb_channel = null_channel +# These changes because they relate to windows +var pid = 0 +var gdbwin = 0 +var varwin = 0 +var asmwin = 0 +var ptywin = 0 +var sourcewin = 0 + +# Contains breakpoints that have been placed, key is a string with the GDB +# breakpoint number. +# Each entry is a dict, containing the sub-breakpoints. Key is the subid. +# For a breakpoint that is just a number the subid is zero. +# For a breakpoint "123.4" the id is "123" and subid is "4". +# Example, when breakpoint "44", "123", "123.1" and "123.2" exist: +# {'44': {'0': entry}, '123': {'0': entry, '1': entry, '2': entry}} +var breakpoints = {} + +# Contains breakpoints by file/lnum. The key is "fname:lnum". +# Each entry is a list of breakpoint IDs at that position. +var breakpoint_locations = {} +var BreakpointSigns: list<string> = [] + + +var evalFromBalloonExpr = 0 +var evalFromBalloonExprResult = '' +var ignoreEvalError = 0 +var evalexpr = '' +# Remember the old value of 'signcolumn' for each buffer that it's set in, so +# that we can restore the value for all buffers. +var signcolumn_buflist = [bufnr()] +var save_columns = 0 + +var allleft = 0 +# This was s:vertical but I cannot use vertical as variable name +var vvertical = 0 + +var winbar_winids = [] +var plus_map_saved = {} +var minus_map_saved = {} +var k_map_saved = {} +var saved_mousemodel = '' + + +# Need either the +terminal feature or +channel and the prompt buffer. +# The terminal feature does not work with gdb on win32. if has('terminal') && !has('win32') - let s:way = 'terminal' + way = 'terminal' elseif has('channel') && exists('*prompt_setprompt') - let s:way = 'prompt' + way = 'prompt' else if has('terminal') - let s:err = 'Cannot debug, missing prompt buffer support' + err = 'Cannot debug, missing prompt buffer support' else - let s:err = 'Cannot debug, +channel feature is not supported' + err = 'Cannot debug, +channel feature is not supported' endif - command -nargs=* -complete=file -bang Termdebug echoerr s:err - command -nargs=+ -complete=file -bang TermdebugCommand echoerr s:err + command -nargs=* -complete=file -bang Termdebug echoerr err + command -nargs=+ -complete=file -bang TermdebugCommand echoerr err finish endif -let s:keepcpo = &cpo -set cpo&vim -" The command that starts debugging, e.g. ":Termdebug vim". -" To end type "quit" in the gdb window. -command -nargs=* -complete=file -bang Termdebug call s:StartDebug(<bang>0, <f-args>) -command -nargs=+ -complete=file -bang TermdebugCommand call s:StartDebugCommand(<bang>0, <f-args>) +# The command that starts debugging, e.g. ":Termdebug vim". +# To end type "quit" in the gdb window. +command -nargs=* -complete=file -bang Termdebug StartDebug(<bang>0, <f-args>) +command -nargs=+ -complete=file -bang TermdebugCommand StartDebugCommand(<bang>0, <f-args>) + -let s:pc_id = 12 -let s:asm_id = 13 -let s:break_id = 14 " breakpoint number is added to this -let s:stopped = 1 -let s:running = 0 - -let s:parsing_disasm_msg = 0 -let s:asm_lines = [] -let s:asm_addr = '' +# Take a breakpoint number as used by GDB and turn it into an integer. +# The breakpoint may contain a dot: 123.4 -> 123004 +# The main breakpoint has a zero subid. +def Breakpoint2SignNumber(id: number, subid: number): number + return break_id + id * 1000 + subid +enddef -" Take a breakpoint number as used by GDB and turn it into an integer. -" The breakpoint may contain a dot: 123.4 -> 123004 -" The main breakpoint has a zero subid. -func s:Breakpoint2SignNumber(id, subid) - return s:break_id + a:id * 1000 + a:subid -endfunction +# Define or adjust the default highlighting, using background "new". +# When the 'background' option is set then "old" has the old value. +def Highlight(init: bool, old: string, new: string) + var default = init ? 'default ' : '' + if new ==# 'light' && old !=# 'light' + exe "hi " .. default .. "debugPC term=reverse ctermbg=lightblue guibg=lightblue" + elseif new ==# 'dark' && old !=# 'dark' + exe "hi " .. default .. "debugPC term=reverse ctermbg=darkblue guibg=darkblue" + endif +enddef -" Define or adjust the default highlighting, using background "new". -" When the 'background' option is set then "old" has the old value. -func s:Highlight(init, old, new) - let default = a:init ? 'default ' : '' - if a:new ==# 'light' && a:old !=# 'light' - exe "hi " . default . "debugPC term=reverse ctermbg=lightblue guibg=lightblue" - elseif a:new ==# 'dark' && a:old !=# 'dark' - exe "hi " . default . "debugPC term=reverse ctermbg=darkblue guibg=darkblue" - endif -endfunc - -" Define the default highlighting, using the current 'background' value. -func s:InitHighlight() - call s:Highlight(1, '', &background) +# Define the default highlighting, using the current 'background' value. +def InitHighlight() + Highlight(1, '', &background) hi default debugBreakpoint term=reverse ctermbg=red guibg=red hi default debugBreakpointDisabled term=reverse ctermbg=gray guibg=gray -endfunc +enddef -" Setup an autocommand to redefine the default highlight when the colorscheme -" is changed. -func s:InitAutocmd() +# Setup an autocommand to redefine the default highlight when the colorscheme +# is changed. +def InitAutocmd() augroup TermDebug autocmd! - autocmd ColorScheme * call s:InitHighlight() + autocmd ColorScheme * InitHighlight() augroup END -endfunc +enddef -" Get the command to execute the debugger as a list, defaults to ["gdb"]. -func s:GetCommand() +# Get the command to execute the debugger as a list, defaults to ["gdb"]. +def GetCommand(): list<string> + var cmd = 'gdb' if exists('g:termdebug_config') - let cmd = get(g:termdebug_config, 'command', 'gdb') + cmd = get(g:termdebug_config, 'command', 'gdb') elseif exists('g:termdebugger') - let cmd = g:termdebugger - else - let cmd = 'gdb' + cmd = g:termdebugger endif return type(cmd) == v:t_list ? copy(cmd) : [cmd] -endfunc +enddef -func s:Echoerr(msg) - echohl ErrorMsg | echom '[termdebug] ' .. a:msg | echohl None -endfunc +def Echoerr(msg: string) + echohl ErrorMsg | echom '[termdebug] ' .. msg | echohl None +enddef -func s:StartDebug(bang, ...) - " First argument is the command to debug, second core file or process ID. - call s:StartDebug_internal({'gdb_args': a:000, 'bang': a:bang}) -endfunc +def StartDebug(bang: bool, ...gdb_args: list<string>) + # First argument is the command to debug, second core file or process ID. + StartDebug_internal({'gdb_args': gdb_args, 'bang': bang}) +enddef -func s:StartDebugCommand(bang, ...) - " First argument is the command to debug, rest are run arguments. - call s:StartDebug_internal({'gdb_args': [a:1], 'proc_args': a:000[1:], 'bang': a:bang}) -endfunc +def StartDebugCommand(bang: bool, ...args: list<string>) + # First argument is the command to debug, rest are run arguments. + StartDebug_internal({'gdb_args': [args[0]], 'proc_args': args[1:], 'bang': bang}) +enddef -func s:StartDebug_internal(dict) - if exists('s:gdbwin') - call s:Echoerr('Terminal debugger already running, cannot run two') + +def StartDebug_internal(dict: dict<any>) + if gdbwin > 0 + Echoerr('Terminal debugger already running, cannot run two') return endif - let gdbcmd = s:GetCommand() + var gdbcmd = GetCommand() if !executable(gdbcmd[0]) - call s:Echoerr('Cannot execute debugger program "' .. gdbcmd[0] .. '"') + Echoerr('Cannot execute debugger program "' .. gdbcmd[0] .. '"') return endif - let s:ptywin = 0 - let s:pid = 0 - let s:asmwin = 0 - let s:asmbuf = 0 - let s:varwin = 0 - let s:varbuf = 0 - if exists('#User#TermdebugStartPre') doauto <nomodeline> User TermdebugStartPre endif - " Uncomment this line to write logging in "debuglog". - " call ch_logfile('debuglog', 'w') - - let s:sourcewin = win_getid() + # Assume current window is the source code window + sourcewin = win_getid() + var wide = 0 - " Remember the old value of 'signcolumn' for each buffer that it's set in, so - " that we can restore the value for all buffers. - let b:save_signcolumn = &signcolumn - let s:signcolumn_buflist = [bufnr()] - - let s:save_columns = 0 - let s:allleft = 0 - let wide = 0 if exists('g:termdebug_config') - let wide = get(g:termdebug_config, 'wide', 0) + wide = get(g:termdebug_config, 'wide', 0) elseif exists('g:termdebug_wide') - let wide = g:termdebug_wide + wide = g:termdebug_wide endif if wide > 0 if &columns < wide - let s:save_columns = &columns - let &columns = wide - " If we make the Vim window wider, use the whole left half for the debug - " windows. - let s:allleft = 1 + save_columns = &columns + &columns = wide + # If we make the Vim window wider, use the whole left half for the debug + # windows. + allleft = 1 endif - let s:vertical = 1 + vvertical = 1 else - let s:vertical = 0 + vvertical = 0 endif - " Override using a terminal window by setting g:termdebug_use_prompt to 1. - let use_prompt = 0 + # Override using a terminal window by setting g:termdebug_use_prompt to 1. + var use_prompt = 0 if exists('g:termdebug_config') - let use_prompt = get(g:termdebug_config, 'use_prompt', 0) + use_prompt = get(g:termdebug_config, 'use_prompt', 0) elseif exists('g:termdebug_use_prompt') - let use_prompt = g:termdebug_use_prompt + use_prompt = g:termdebug_use_prompt endif if has('terminal') && !has('win32') && !use_prompt - let s:way = 'terminal' + way = 'terminal' else - let s:way = 'prompt' + way = 'prompt' endif - if s:way == 'prompt' - call s:StartDebug_prompt(a:dict) + if way == 'prompt' + StartDebug_prompt(dict) else - call s:StartDebug_term(a:dict) + StartDebug_term(dict) endif - if s:GetDisasmWindow() - let curwinid = win_getid() - call s:GotoAsmwinOrCreateIt() - call win_gotoid(curwinid) + if GetDisasmWindow() + var curwinid = win_getid() + GotoAsmwinOrCreateIt() + win_gotoid(curwinid) endif - if s:GetVariablesWindow() - let curwinid = win_getid() - call s:GotoVariableswinOrCreateIt() - call win_gotoid(curwinid) + if GetVariablesWindow() + var curwinid = win_getid() + GotoVariableswinOrCreateIt() + win_gotoid(curwinid) endif if exists('#User#TermdebugStartPost') doauto <nomodeline> User TermdebugStartPost endif -endfunc +enddef -" Use when debugger didn't start or ended. -func s:CloseBuffers() - exe 'bwipe! ' . s:ptybuf - exe 'bwipe! ' . s:commbuf - if s:asmbuf > 0 && bufexists(s:asmbuf) - exe 'bwipe! ' . s:asmbuf +# Use when debugger didn't start or ended. +def CloseBuffers() + exe 'bwipe! ' .. ptybuf + exe 'bwipe! ' .. commbuf + if asmbuf > 0 && bufexists(asmbuf) + exe 'bwipe! ' .. asmbuf + endif + if varbuf > 0 && bufexists(varbuf) + exe 'bwipe! ' .. varbuf endif - if s:varbuf > 0 && bufexists(s:varbuf) - exe 'bwipe! ' . s:varbuf + running = 0 + gdbwin = 0 +enddef + +# IsGdbRunning(): bool may be a better name? +def CheckGdbRunning(): string + var gdbproc = term_getjob(gdbbuf) + var gdbproc_status = 'unknown' + if type(gdbproc) == v:t_job + gdbproc_status = job_status(gdbproc) endif - let s:running = 0 - unlet! s:gdbwin -endfunc - -func s:CheckGdbRunning() - let gdbproc = term_getjob(s:gdbbuf) - if gdbproc == v:null || job_status(gdbproc) !=# 'run' - call s:Echoerr(string(s:GetCommand()[0]) . ' exited unexpectedly') - call s:CloseBuffers() + if gdbproc == v:null || gdbproc_status !=# 'run' + Echoerr(string(GetCommand()[0]) .. ' exited unexpectedly') + CloseBuffers() return '' endif return 'ok' -endfunc +enddef -" Open a terminal window without a job, to run the debugged program in. -func s:StartDebug_term(dict) - let s:ptybuf = term_start('NONE', { - \ 'term_name': 'debugged program', - \ 'vertical': s:vertical, - \ }) - if s:ptybuf == 0 - call s:Echoerr('Failed to open the program terminal window') +# Open a terminal window without a job, to run the debugged program in. +def StartDebug_term(dict: dict<any>) + ptybuf = term_start('NONE', { + \ 'term_name': 'debugged program', + \ 'vertical': vvertical, + \ }) + if ptybuf == 0 + Echoerr('Failed to open the program terminal window') return endif - let pty = job_info(term_getjob(s:ptybuf))['tty_out'] - let s:ptywin = win_getid() - if s:vertical - " Assuming the source code window will get a signcolumn, use two more - " columns for that, thus one less for the terminal window. - exe (&columns / 2 - 1) . "wincmd |" - if s:allleft - " use the whole left column + var pty = job_info(term_getjob(ptybuf))['tty_out'] + ptywin = win_getid() + if vvertical + # Assuming the source code window will get a signcolumn, use two more + # columns for that, thus one less for the terminal window. + exe ":" .. (&columns / 2 - 1) .. "wincmd |" + if allleft + # use the whole left column wincmd H endif endif - " Create a hidden terminal window to communicate with gdb - let s:commbuf = term_start('NONE', { - \ 'term_name': 'gdb communication', - \ 'out_cb': function('s:CommOutput'), - \ 'hidden': 1, - \ }) - if s:commbuf == 0 - call s:Echoerr('Failed to open the communication terminal window') - exe 'bwipe! ' . s:ptybuf + # Create a hidden terminal window to communicate with gdb + commbuf = term_start('NONE', { + \ 'term_name': 'gdb communication', + \ 'out_cb': function('CommOutput'), + \ 'hidden': 1, + \ }) + if commbuf == 0 + Echoerr('Failed to open the communication terminal window') + exe 'bwipe! ' .. ptybuf return endif - let commpty = job_info(term_getjob(s:commbuf))['tty_out'] + var commpty = job_info(term_getjob(commbuf))['tty_out'] - let gdb_args = get(a:dict, 'gdb_args', []) - let proc_args = get(a:dict, 'proc_args', []) + var gdb_args = get(dict, 'gdb_args', []) + var proc_args = get(dict, 'proc_args', []) - let gdb_cmd = s:GetCommand() + var gdb_cmd = GetCommand() if exists('g:termdebug_config') && has_key(g:termdebug_config, 'command_add_args') - let gdb_cmd = g:termdebug_config.command_add_args(gdb_cmd, pty) + gdb_cmd = g:termdebug_config.command_add_args(gdb_cmd, pty) else - " Add -quiet to avoid the intro message causing a hit-enter prompt. - let gdb_cmd += ['-quiet'] - " Disable pagination, it causes everything to stop at the gdb - let gdb_cmd += ['-iex', 'set pagination off'] - " Interpret commands while the target is running. This should usually only - " be exec-interrupt, since many commands don't work properly while the - " target is running (so execute during startup). - let gdb_cmd += ['-iex', 'set mi-async on'] - " Open a terminal window to run the debugger. - let gdb_cmd += ['-tty', pty] - " Command executed _after_ startup is done, provides us with the necessary - " feedback - let gdb_cmd += ['-ex', 'echo startupdone\n'] + # Add -quiet to avoid the intro message causing a hit-enter prompt. + gdb_cmd += ['-quiet'] + # Disable pagination, it causes everything to stop at the gdb + gdb_cmd += ['-iex', 'set pagination off'] + # Interpret commands while the target is running. This should usually only + # be exec-interrupt, since many commands don't work properly while the + # target is running (so execute during startup). + gdb_cmd += ['-iex', 'set mi-async on'] + # Open a terminal window to run the debugger. + gdb_cmd += ['-tty', pty] + # Command executed _after_ startup is done, provides us with the necessary + # feedback + gdb_cmd += ['-ex', 'echo startupdone\n'] endif if exists('g:termdebug_config') && has_key(g:termdebug_config, 'command_filter') - let gdb_cmd = g:termdebug_config.command_filter(gdb_cmd) + gdb_cmd = g:termdebug_config.command_filter(gdb_cmd) endif - " Adding arguments requested by the user - let gdb_cmd += gdb_args + # Adding arguments requested by the user + gdb_cmd += gdb_args - call ch_log('executing "' . join(gdb_cmd) . '"') - let s:gdbbuf = term_start(gdb_cmd, { - \ 'term_finish': 'close', - \ }) - if s:gdbbuf == 0 - call s:Echoerr('Failed to open the gdb terminal window') - call s:CloseBuffers() + ch_log('executing "' .. join(gdb_cmd) .. '"') + gdbbuf = term_start(gdb_cmd, { + \ 'term_name': 'gdb', + \ 'term_finish': 'close', + \ }) + if gdbbuf == 0 + Echoerr('Failed to open the gdb terminal window') + CloseBuffers() return endif - let s:gdbwin = win_getid() + gdbwin = win_getid() - " Wait for the "startupdone" message before sending any commands. - let try_count = 0 - while 1 - if s:CheckGdbRunning() != 'ok' + # Wait for the "startupdone" message before sending any commands. + var counter = 0 + var counter_max = 300 + var success = false + while success == false && counter < counter_max + if CheckGdbRunning() != 'ok' + # Failure. If NOK just return. return endif for lnum in range(1, 200) - if term_getline(s:gdbbuf, lnum) =~ 'startupdone' - let try_count = 9999 - break + if term_getline(gdbbuf, lnum) =~ 'startupdone' + success = true endif endfor - let try_count += 1 - if try_count > 300 - " done or give up after five seconds - break - endif + + # Each count is 10ms + counter += 1 sleep 10m endwhile - " Set arguments to be run. + if success == false + Echoerr('Failed to startup the gdb program.') + CloseBuffers() + return + endif + + # ---- gdb started. Next, let's set the MI interface. --- + # Set arguments to be run. if len(proc_args) - call term_sendkeys(s:gdbbuf, 'server set args ' . join(proc_args) . "\r") + term_sendkeys(gdbbuf, 'server set args ' .. join(proc_args) .. "\r") endif - " Connect gdb to the communication pty, using the GDB/MI interface. - " Prefix "server" to avoid adding this to the history. - call term_sendkeys(s:gdbbuf, 'server new-ui mi ' . commpty . "\r") + # Connect gdb to the communication pty, using the GDB/MI interface. + # Prefix "server" to avoid adding this to the history. + term_sendkeys(gdbbuf, 'server new-ui mi ' .. commpty .. "\r") - " Wait for the response to show up, users may not notice the error and wonder - " why the debugger doesn't work. - let try_count = 0 - while 1 - if s:CheckGdbRunning() != 'ok' + # Wait for the response to show up, users may not notice the error and wonder + # why the debugger doesn't work. + counter = 0 + counter_max = 300 + success = false + while success == false && counter < counter_max + if CheckGdbRunning() != 'ok' return endif - let response = '' + var response = '' for lnum in range(1, 200) - let line1 = term_getline(s:gdbbuf, lnum) - let line2 = term_getline(s:gdbbuf, lnum + 1) + var line1 = term_getline(gdbbuf, lnum) + var line2 = term_getline(gdbbuf, lnum + 1) if line1 =~ 'new-ui mi ' - " response can be in the same line or the next line - let response = line1 . line2 + # response can be in the same line or the next line + response = line1 .. line2 if response =~ 'Undefined command' - call s:Echoerr('Sorry, your gdb is too old, gdb 7.12 is required') - " CHECKME: possibly send a "server show version" here - call s:CloseBuffers() + Echoerr('Sorry, your gdb is too old, gdb 7.12 is required') + # CHECKME: possibly send a "server show version" here + CloseBuffers() return endif if response =~ 'New UI allocated' - " Success! - break + # Success! + success = true endif elseif line1 =~ 'Reading symbols from' && line2 !~ 'new-ui mi ' - " Reading symbols might take a while, try more times - let try_count -= 1 + # Reading symbols might take a while, try more times + counter -= 1 endif endfor if response =~ 'New UI allocated' break endif - let try_count += 1 - if try_count > 100 - call s:Echoerr('Cannot check if your gdb works, continuing anyway') - break - endif + counter += 1 sleep 10m endwhile - call job_setoptions(term_getjob(s:gdbbuf), {'exit_cb': function('s:EndTermDebug')}) + if success == false + Echoerr('Cannot check if your gdb works, continuing anyway') + return + endif - " Set the filetype, this can be used to add mappings. + job_setoptions(term_getjob(gdbbuf), {'exit_cb': function('EndTermDebug')}) + + # Set the filetype, this can be used to add mappings. set filetype=termdebug - call s:StartDebugCommon(a:dict) -endfunc + StartDebugCommon(dict) +enddef -" Open a window with a prompt buffer to run gdb in. -func s:StartDebug_prompt(dict) - if s:vertical +# Open a window with a prompt buffer to run gdb in. +def StartDebug_prompt(dict: dict<any>) + if vvertical vertical new else new endif - let s:gdbwin = win_getid() - let s:promptbuf = bufnr('') - call prompt_setprompt(s:promptbuf, 'gdb> ') + gdbwin = win_getid() + promptbuf = bufnr('') + prompt_setprompt(promptbuf, 'gdb> ') set buftype=prompt if empty(glob('gdb')) @@ -421,108 +482,108 @@ func s:StartDebug_prompt(dict) elseif empty(glob('Termdebug-gdb-console')) file Termdebug-gdb-console else - call s:Echoerr("You have a file/folder named 'gdb' + Echoerr("You have a file/folder named 'gdb' \ or 'Termdebug-gdb-console'. \ Please exit and rename them because Termdebug may not work as expected.") endif - call prompt_setcallback(s:promptbuf, function('s:PromptCallback')) - call prompt_setinterrupt(s:promptbuf, function('s:PromptInterrupt')) + prompt_setcallback(promptbuf, function('PromptCallback')) + prompt_setinterrupt(promptbuf, function('PromptInterrupt')) - if s:vertical - " Assuming the source code window will get a signcolumn, use two more - " columns for that, thus one less for the terminal window. - exe (&columns / 2 - 1) . "wincmd |" + if vvertical + # Assuming the source code window will get a signcolumn, use two more + # columns for that, thus one less for the terminal window. + exe ":" .. (&columns / 2 - 1) .. "wincmd |" endif - let gdb_args = get(a:dict, 'gdb_args', []) - let proc_args = get(a:dict, 'proc_args', []) + var gdb_args = get(dict, 'gdb_args', []) + var proc_args = get(dict, 'proc_args', []) - let gdb_cmd = s:GetCommand() - " Add -quiet to avoid the intro message causing a hit-enter prompt. - let gdb_cmd += ['-quiet'] - " Disable pagination, it causes everything to stop at the gdb, needs to be run early - let gdb_cmd += ['-iex', 'set pagination off'] - " Interpret commands while the target is running. This should usually only - " be exec-interrupt, since many commands don't work properly while the - " target is running (so execute during startup). - let gdb_cmd += ['-iex', 'set mi-async on'] - " directly communicate via mi2 - let gdb_cmd += ['--interpreter=mi2'] + var gdb_cmd = GetCommand() + # Add -quiet to avoid the intro message causing a hit-enter prompt. + gdb_cmd += ['-quiet'] + # Disable pagination, it causes everything to stop at the gdb, needs to be run early + gdb_cmd += ['-iex', 'set pagination off'] + # Interpret commands while the target is running. This should usually only + # be exec-interrupt, since many commands don't work properly while the + # target is running (so execute during startup). + gdb_cmd += ['-iex', 'set mi-async on'] + # directly communicate via mi2 + gdb_cmd += ['--interpreter=mi2'] - " Adding arguments requested by the user - let gdb_cmd += gdb_args + # Adding arguments requested by the user + gdb_cmd += gdb_args - call ch_log('executing "' . join(gdb_cmd) . '"') - let s:gdbjob = job_start(gdb_cmd, { - \ 'exit_cb': function('s:EndPromptDebug'), - \ 'out_cb': function('s:GdbOutCallback'), - \ }) - if job_status(s:gdbjob) != "run" - call s:Echoerr('Failed to start gdb') - exe 'bwipe! ' . s:promptbuf + ch_log('executing "' .. join(gdb_cmd) .. '"') + gdbjob = job_start(gdb_cmd, { + \ 'exit_cb': function('EndPromptDebug'), + \ 'out_cb': function('GdbOutCallback'), + \ }) + if job_status(gdbjob) != "run" + Echoerr('Failed to start gdb') + exe 'bwipe! ' .. promptbuf return endif - exe $'au BufUnload <buffer={s:promptbuf}> ++once ' .. - \ 'call job_stop(s:gdbjob, ''kill'')' - " Mark the buffer modified so that it's not easy to close. + exe $'au BufUnload <buffer={promptbuf}> ++once ' .. + \ 'call job_stop(gdbjob, ''kill'')' + # Mark the buffer modified so that it's not easy to close. set modified - let s:gdb_channel = job_getchannel(s:gdbjob) + gdb_channel = job_getchannel(gdbjob) - let s:ptybuf = 0 + ptybuf = 0 if has('win32') - " MS-Windows: run in a new console window for maximum compatibility - call s:SendCommand('set new-console on') + # MS-Windows: run in a new console window for maximum compatibility + SendCommand('set new-console on') elseif has('terminal') - " Unix: Run the debugged program in a terminal window. Open it below the - " gdb window. - belowright let s:ptybuf = term_start('NONE', { - \ 'term_name': 'debugged program', - \ }) - if s:ptybuf == 0 - call s:Echoerr('Failed to open the program terminal window') - call job_stop(s:gdbjob) + # Unix: Run the debugged program in a terminal window. Open it below the + # gdb window. + belowright ptybuf = term_start('NONE', { + \ 'term_name': 'debugged program', + \ }) + if ptybuf == 0 + Echoerr('Failed to open the program terminal window') + job_stop(gdbjob) return endif - let s:ptywin = win_getid() - let pty = job_info(term_getjob(s:ptybuf))['tty_out'] - call s:SendCommand('tty ' . pty) + ptywin = win_getid() + var pty = job_info(term_getjob(ptybuf))['tty_out'] + SendCommand('tty ' .. pty) - " Since GDB runs in a prompt window, the environment has not been set to - " match a terminal window, need to do that now. - call s:SendCommand('set env TERM = xterm-color') - call s:SendCommand('set env ROWS = ' . winheight(s:ptywin)) - call s:SendCommand('set env LINES = ' . winheight(s:ptywin)) - call s:SendCommand('set env COLUMNS = ' . winwidth(s:ptywin)) - call s:SendCommand('set env COLORS = ' . &t_Co) - call s:SendCommand('set env VIM_TERMINAL = ' . v:version) + # Since GDB runs in a prompt window, the environment has not been set to + # match a terminal window, need to do that now. + SendCommand('set env TERM = xterm-color') + SendCommand('set env ROWS = ' .. winheight(ptywin)) + SendCommand('set env LINES = ' .. winheight(ptywin)) + SendCommand('set env COLUMNS = ' .. winwidth(ptywin)) + SendCommand('set env COLORS = ' .. &t_Co) + SendCommand('set env VIM_TERMINAL = ' .. v:version) else - " TODO: open a new terminal, get the tty name, pass on to gdb - call s:SendCommand('show inferior-tty') + # TODO: open a new terminal, get the tty name, pass on to gdb + SendCommand('show inferior-tty') endif - call s:SendCommand('set print pretty on') - call s:SendCommand('set breakpoint pending on') + SendCommand('set print pretty on') + SendCommand('set breakpoint pending on') - " Set arguments to be run + # Set arguments to be run if len(proc_args) - call s:SendCommand('set args ' . join(proc_args)) + SendCommand('set args ' .. join(proc_args)) endif - call s:StartDebugCommon(a:dict) + StartDebugCommon(dict) startinsert -endfunc +enddef -func s:StartDebugCommon(dict) - " Sign used to highlight the line where the program has stopped. - " There can be only one. - call sign_define('debugPC', #{linehl: 'debugPC'}) +def StartDebugCommon(dict: dict<any>) + # Sign used to highlight the line where the program has stopped. + # There can be only one. + sign_define('debugPC', {'linehl': 'debugPC'}) - " Install debugger commands in the text window. - call win_gotoid(s:sourcewin) - call s:InstallCommands() - call win_gotoid(s:gdbwin) + # Install debugger commands in the text window. + win_gotoid(sourcewin) + InstallCommands() + win_gotoid(gdbwin) - " Enable showing a balloon with eval info + # Enable showing a balloon with eval info if has("balloon_eval") || has("balloon_eval_term") set balloonexpr=TermDebugBalloonExpr() if has("balloon_eval") @@ -533,243 +594,238 @@ func s:StartDebugCommon(dict) endif endif - " Contains breakpoints that have been placed, key is a string with the GDB - " breakpoint number. - " Each entry is a dict, containing the sub-breakpoints. Key is the subid. - " For a breakpoint that is just a number the subid is zero. - " For a breakpoint "123.4" the id is "123" and subid is "4". - " Example, when breakpoint "44", "123", "123.1" and "123.2" exist: - " {'44': {'0': entry}, '123': {'0': entry, '1': entry, '2': entry}} - let s:breakpoints = {} - - " Contains breakpoints by file/lnum. The key is "fname:lnum". - " Each entry is a list of breakpoint IDs at that position. - let s:breakpoint_locations = {} - augroup TermDebug - au BufRead * call s:BufRead() - au BufUnload * call s:BufUnloaded() - au OptionSet background call s:Highlight(0, v:option_old, v:option_new) + au BufRead * BufRead() + au BufUnload * BufUnloaded() + au OptionSet background Highlight(0, v:option_old, v:option_new) augroup END - " Run the command if the bang attribute was given and got to the debug - " window. - if get(a:dict, 'bang', 0) - call s:SendResumingCommand('-exec-run') - call win_gotoid(s:ptywin) + # Run the command if the bang attribute was given and got to the debug + # window. + if get(dict, 'bang', 0) + SendResumingCommand('-exec-run') + win_gotoid(ptywin) endif -endfunc +enddef -" Send a command to gdb. "cmd" is the string without line terminator. -func s:SendCommand(cmd) - call ch_log('sending to gdb: ' . a:cmd) - if s:way == 'prompt' - call ch_sendraw(s:gdb_channel, a:cmd . "\n") +# Send a command to gdb. "cmd" is the string without line terminator. +def SendCommand(cmd: string) + ch_log('sending to gdb: ' .. cmd) + if way == 'prompt' + ch_sendraw(gdb_channel, cmd .. "\n") else - call term_sendkeys(s:commbuf, a:cmd . "\r") + term_sendkeys(commbuf, cmd .. "\r") endif -endfunc +enddef -" This is global so that a user can create their mappings with this. -func TermDebugSendCommand(cmd) - if s:way == 'prompt' - call ch_sendraw(s:gdb_channel, a:cmd . "\n") +# This is global so that a user can create their mappings with this. +def TermDebugSendCommand(cmd: string) + if way == 'prompt' + ch_sendraw(gdb_channel, cmd .. "\n") else - let do_continue = 0 - if !s:stopped - let do_continue = 1 + var do_continue = 0 + if !stopped + do_continue = 1 Stop sleep 10m endif - " TODO: should we prepend CTRL-U to clear the command? - call term_sendkeys(s:gdbbuf, a:cmd . "\r") + # TODO: should we prepend CTRL-U to clear the command? + term_sendkeys(gdbbuf, cmd .. "\r") if do_continue Continue endif endif -endfunc +enddef -" Send a command that resumes the program. If the program isn't stopped the -" command is not sent (to avoid a repeated command to cause trouble). -" If the command is sent then reset s:stopped. -func s:SendResumingCommand(cmd) - if s:stopped - " reset s:stopped here, it may take a bit of time before we get a response - let s:stopped = 0 - call ch_log('assume that program is running after this command') - call s:SendCommand(a:cmd) +# Send a command that resumes the program. If the program isn't stopped the +# command is not sent (to avoid a repeated command to cause trouble). +# If the command is sent then reset stopped. +def SendResumingCommand(cmd: string) + if stopped + # reset stopped here, it may take a bit of time before we get a response + stopped = 0 + ch_log('assume that program is running after this command') + SendCommand(cmd) else - call ch_log('dropping command, program is running: ' . a:cmd) + ch_log('dropping command, program is running: ' .. cmd) endif -endfunc +enddef -" Function called when entering a line in the prompt buffer. -func s:PromptCallback(text) - call s:SendCommand(a:text) -endfunc +# Function called when entering a line in the prompt buffer. +def PromptCallback(text: string) + SendCommand(text) +enddef -" Function called when pressing CTRL-C in the prompt buffer and when placing a -" breakpoint. -func s:PromptInterrupt() - call ch_log('Interrupting gdb') +# Function called when pressing CTRL-C in the prompt buffer and when placing a +# breakpoint. +def PromptInterrupt() + ch_log('Interrupting gdb') if has('win32') - " Using job_stop() does not work on MS-Windows, need to send SIGTRAP to - " the debugger program so that gdb responds again. - if s:pid == 0 - call s:Echoerr('Cannot interrupt gdb, did not find a process ID') + # Using job_stop() does not work on MS-Windows, need to send SIGTRAP to + # the debugger program so that gdb responds again. + if pid == 0 + Echoerr('Cannot interrupt gdb, did not find a process ID') else - call debugbreak(s:pid) + debugbreak(pid) endif else - call job_stop(s:gdbjob, 'int') + job_stop(gdbjob, 'int') endif -endfunc - -" Function called when gdb outputs text. -func s:GdbOutCallback(channel, text) - call ch_log('received from gdb: ' . a:text) +enddef - " Disassembly messages need to be forwarded as-is. - if s:parsing_disasm_msg - call s:CommOutput(a:channel, a:text) - return - end +# Function called when gdb outputs text. +def GdbOutCallback(channel: channel, text: string) + ch_log('received from gdb: ' .. text) - " Drop the gdb prompt, we have our own. - " Drop status and echo'd commands. - if a:text == '(gdb) ' || a:text == '^done' || - \ (a:text[0] == '&' && a:text !~ '^&"disassemble') + # Disassembly messages need to be forwarded as-is. + if parsing_disasm_msg > 0 + CommOutput(channel, text) return endif - if a:text =~ '^\^error,msg=' - let text = s:DecodeMessage(a:text[11:], v:false) - if exists('s:evalexpr') && text =~ 'A syntax error in expression, near\|No symbol .* in current context' - " Silently drop evaluation errors. - unlet s:evalexpr + + # Drop the gdb prompt, we have our own. + # Drop status and echo'd commands. + if text == '(gdb) ' || text == '^done' || + \ (text[0] == '&' && text !~ '^&"disassemble') + return + endif + + var decoded_text = '' + if text =~ '^\^error,msg=' + decoded_text = DecodeMessage(text[11 : ], false) + if exists('evalexpr') && decoded_text =~ 'A syntax error in expression, near\|No symbol .* in current context' + # Silently drop evaluation errors. + evalexpr = null_string return endif - elseif a:text[0] == '~' - let text = s:DecodeMessage(a:text[1:], v:false) + elseif text[0] == '~' + decoded_text = DecodeMessage(text[1 : ], false) else - call s:CommOutput(a:channel, a:text) + CommOutput(channel, text) return endif - let curwinid = win_getid() - call win_gotoid(s:gdbwin) + var curwinid = win_getid() + win_gotoid(gdbwin) - " Add the output above the current prompt. - call append(line('$') - 1, text) + # Add the output above the current prompt. + append(line('$') - 1, decoded_text) set modified - call win_gotoid(curwinid) -endfunc + win_gotoid(curwinid) +enddef -" Decode a message from gdb. "quotedText" starts with a ", return the text up -" to the next unescaped ", unescaping characters: -" - remove line breaks (unless "literal" is v:true) -" - change \" to " -" - change \\t to \t (unless "literal" is v:true) -" - change \0xhh to \xhh (disabled for now) -" - change \ooo to octal -" - change \\ to \ -func s:DecodeMessage(quotedText, literal) - if a:quotedText[0] != '"' - call s:Echoerr('DecodeMessage(): missing quote in ' . a:quotedText) - return +# Decode a message from gdb. "quotedText" starts with a ", return the text up +# to the next unescaped ", unescaping characters: +# - remove line breaks (unless "literal" is v:true) +# - change \" to " +# - change \\t to \t (unless "literal" is v:true) +# - change \0xhh to \xhh (disabled for now) +# - change \ooo to octal +# - change \\ to \ +def DecodeMessage(quotedText: string, literal: bool): string + if quotedText[0] != '"' + Echoerr('DecodeMessage(): missing quote in ' .. quotedText) + return '' endif - let msg = a:quotedText + var msg = quotedText \ ->substitute('^"\|[^\\]\zs".*', '', 'g') \ ->substitute('\\"', '"', 'g') - "\ multi-byte characters arrive in octal form - "\ NULL-values must be kept encoded as those break the string otherwise - \ ->substitute('\\000', s:NullRepl, 'g') - \ ->substitute('\\\o\o\o', {-> eval('"' .. submatch(0) .. '"')}, 'g') - "\ Note: GDB docs also mention hex encodings - the translations below work - "\ but we keep them out for performance-reasons until we actually see - "\ those in mi-returns - "\ \ ->substitute('\\0x\(\x\x\)', {-> eval('"\x' .. submatch(1) .. '"')}, 'g') - "\ \ ->substitute('\\0x00', s:NullRepl, 'g') + #\ multi-byte characters arrive in octal form + #\ NULL-values must be kept encoded as those break the string otherwise + \ ->substitute('\\000', NullRepl, 'g') + \ ->substitute('\\\(\o\o\o\)', (m) => nr2char(str2nr(m[1], 8)), 'g') + #\ Note: GDB docs also mention hex encodings - the translations below work + #\ but we keep them out for performance-reasons until we actually see + #\ those in mi-returns + #\ \ ->substitute('\\0x\(\x\x\)', {-> eval('"\x' .. submatch(1) .. '"')}, 'g') + #\ \ ->substitute('\\0x00', NullRepl, 'g') \ ->substitute('\\\\', '\', 'g') - \ ->substitute(s:NullRepl, '\\000', 'g') - if !a:literal + \ ->substitute(NullRepl, '\\000', 'g') + if !literal return msg - \ ->substitute('\\t', "\t", 'g') - \ ->substitute('\\n', '', 'g') + \ ->substitute('\\t', "\t", 'g') + \ ->substitute('\\n', '', 'g') else return msg endif -endfunc -const s:NullRepl = 'XXXNULLXXX' +enddef +const NullRepl = 'XXXNULLXXX' -" Extract the "name" value from a gdb message with fullname="name". -func s:GetFullname(msg) - if a:msg !~ 'fullname' +# Extract the "name" value from a gdb message with fullname="name". +def GetFullname(msg: string): string + if msg !~ 'fullname' return '' endif - let name = s:DecodeMessage(substitute(a:msg, '.*fullname=', '', ''), v:true) + + var name = DecodeMessage(substitute(msg, '.*fullname=', '', ''), true) if has('win32') && name =~ ':\\\\' - " sometimes the name arrives double-escaped - let name = substitute(name, '\\\\', '\\', 'g') + # sometimes the name arrives double-escaped + name = substitute(name, '\\\\', '\\', 'g') endif + return name -endfunc +enddef -" Extract the "addr" value from a gdb message with addr="0x0001234". -func s:GetAsmAddr(msg) - if a:msg !~ 'addr=' +# Extract the "addr" value from a gdb message with addr="0x0001234". +def GetAsmAddr(msg: string): string + if msg !~ 'addr=' return '' endif - let addr = s:DecodeMessage(substitute(a:msg, '.*addr=', '', ''), v:false) + + var addr = DecodeMessage(substitute(msg, '.*addr=', '', ''), false) return addr -endfunc +enddef -func s:EndTermDebug(job, status) + +def EndTermDebug(job: any, status: any) if exists('#User#TermdebugStopPre') doauto <nomodeline> User TermdebugStopPre endif - exe 'bwipe! ' . s:commbuf - unlet s:gdbwin - call s:EndDebugCommon() -endfunc + if bufexists(commbuf) + exe 'bwipe! ' .. commbuf + endif + gdbwin = 0 + EndDebugCommon() +enddef -func s:EndDebugCommon() - let curwinid = win_getid() +def EndDebugCommon() + var curwinid = win_getid() - if exists('s:ptybuf') && s:ptybuf - exe 'bwipe! ' . s:ptybuf - endif - if s:asmbuf > 0 && bufexists(s:asmbuf) - exe 'bwipe! ' . s:asmbuf + if bufexists(ptybuf) + exe 'bwipe! ' .. ptybuf endif - if s:varbuf > 0 && bufexists(s:varbuf) - exe 'bwipe! ' . s:varbuf + if bufexists(asmbuf) + exe 'bwipe! ' .. asmbuf endif - let s:running = 0 + if bufexists(varbuf) + exe 'bwipe! ' .. varbuf + endif + running = 0 - " Restore 'signcolumn' in all buffers for which it was set. - call win_gotoid(s:sourcewin) - let was_buf = bufnr() - for bufnr in s:signcolumn_buflist + # Restore 'signcolumn' in all buffers for which it was set. + win_gotoid(sourcewin) + var was_buf = bufnr() + for bufnr in signcolumn_buflist if bufexists(bufnr) - exe bufnr .. "buf" + exe ":" .. bufnr .. "buf" if exists('b:save_signcolumn') - let &signcolumn = b:save_signcolumn + &signcolumn = b:save_signcolumn unlet b:save_signcolumn endif endif endfor if bufexists(was_buf) - exe was_buf .. "buf" + exe ":" .. was_buf .. "buf" endif - call s:DeleteCommands() + DeleteCommands() - call win_gotoid(curwinid) + win_gotoid(curwinid) - if s:save_columns > 0 - let &columns = s:save_columns + if save_columns > 0 + &columns = save_columns endif if has("balloon_eval") || has("balloon_eval_term") @@ -787,262 +843,274 @@ func s:EndDebugCommon() endif au! TermDebug -endfunc +enddef -func s:EndPromptDebug(job, status) +def EndPromptDebug(job: any, status: any) if exists('#User#TermdebugStopPre') doauto <nomodeline> User TermdebugStopPre endif - if bufexists(s:promptbuf) - exe 'bwipe! ' . s:promptbuf + if bufexists(promptbuf) + exe 'bwipe! ' .. promptbuf endif - call s:EndDebugCommon() - unlet s:gdbwin - call ch_log("Returning from EndPromptDebug()") -endfunc + EndDebugCommon() + gdbwin = 0 + ch_log("Returning from EndPromptDebug()") +enddef + -" Disassembly window - added by Michael Sartain -" -" - CommOutput: &"disassemble $pc\n" -" - CommOutput: ~"Dump of assembler code for function main(int, char**):\n" -" - CommOutput: ~" 0x0000555556466f69 <+0>:\tpush rbp\n" -" ... -" - CommOutput: ~" 0x0000555556467cd0:\tpop rbp\n" -" - CommOutput: ~" 0x0000555556467cd1:\tret \n" -" - CommOutput: ~"End of assembler dump.\n" -" - CommOutput: ^done +# Disassembly window - added by Michael Sartain +# +# - CommOutput: &"disassemble $pc\n" +# - CommOutput: ~"Dump of assembler code for function main(int, char**):\n" +# - CommOutput: ~" 0x0000555556466f69 <+0>:\tpush rbp\n" +# ... +# - CommOutput: ~" 0x0000555556467cd0:\tpop rbp\n" +# - CommOutput: ~" 0x0000555556467cd1:\tret \n" +# - CommOutput: ~"End of assembler dump.\n" +# - CommOutput: ^done -" - CommOutput: &"disassemble $pc\n" -" - CommOutput: &"No function contains specified address.\n" -" - CommOutput: ^error,msg="No function contains specified address." -func s:HandleDisasmMsg(msg) - if a:msg =~ '^\^done' - let curwinid = win_getid() - if win_gotoid(s:asmwin) - silent! %delete _ - call setline(1, s:asm_lines) +# - CommOutput: &"disassemble $pc\n" +# - CommOutput: &"No function contains specified address.\n" +# - CommOutput: ^error,msg="No function contains specified address." +def HandleDisasmMsg(msg: string) + if msg =~ '^\^done' + var curwinid = win_getid() + if win_gotoid(asmwin) + silent! :%delete _ + setline(1, asm_lines) set nomodified set filetype=asm - let lnum = search('^' . s:asm_addr) + var lnum = search('^' .. asm_addr) if lnum != 0 - call sign_unplace('TermDebug', #{id: s:asm_id}) - call sign_place(s:asm_id, 'TermDebug', 'debugPC', '%', #{lnum: lnum}) + sign_unplace('TermDebug', {'id': asm_id}) + sign_place(asm_id, 'TermDebug', 'debugPC', '%', {'lnum': lnum}) endif - call win_gotoid(curwinid) + win_gotoid(curwinid) endif - let s:parsing_disasm_msg = 0 - let s:asm_lines = [] - elseif a:msg =~ '^\^error,msg=' - if s:parsing_disasm_msg == 1 - " Disassemble call ran into an error. This can happen when gdb can't - " find the function frame address, so let's try to disassemble starting - " at current PC - call s:SendCommand('disassemble $pc,+100') + parsing_disasm_msg = 0 + asm_lines = [] + + elseif msg =~ '^\^error,msg=' + if parsing_disasm_msg == 1 + # Disassemble call ran into an error. This can happen when gdb can't + # find the function frame address, so let's try to disassemble starting + # at current PC + SendCommand('disassemble $pc,+100') endif - let s:parsing_disasm_msg = 0 - elseif a:msg =~ '^&"disassemble \$pc' - if a:msg =~ '+100' - " This is our second disasm attempt - let s:parsing_disasm_msg = 2 + parsing_disasm_msg = 0 + elseif msg =~ '^&"disassemble \$pc' + if msg =~ '+100' + # This is our second disasm attempt + parsing_disasm_msg = 2 endif - elseif a:msg !~ '^&"disassemble' - let value = substitute(a:msg, '^\~\"[ ]*', '', '') - let value = substitute(value, '^=>[ ]*', '', '') - let value = substitute(value, '\\n\"\r$', '', '') - let value = substitute(value, '\\n\"$', '', '') - let value = substitute(value, '\r', '', '') - let value = substitute(value, '\\t', ' ', 'g') + elseif msg !~ '^&"disassemble' + var value = substitute(msg, '^\~\"[ ]*', '', '') + value = substitute(value, '^=>[ ]*', '', '') + value = substitute(value, '\\n\"\r$', '', '') + value = substitute(value, '\\n\"$', '', '') + value = substitute(value, '\r', '', '') + value = substitute(value, '\\t', ' ', 'g') - if value != '' || !empty(s:asm_lines) - call add(s:asm_lines, value) + if value != '' || !empty(asm_lines) + add(asm_lines, value) endif endif -endfunc +enddef + -func s:ParseVarinfo(varinfo) - let dict = {} - let nameIdx = matchstrpos(a:varinfo, '{name="\([^"]*\)"') - let dict['name'] = a:varinfo[nameIdx[1] + 7 : nameIdx[2] - 2] - let typeIdx = matchstrpos(a:varinfo, ',type="\([^"]*\)"') - " 'type' maybe is a url-like string, - " try to shorten it and show only the /tail - let dict['type'] = (a:varinfo[typeIdx[1] + 7 : typeIdx[2] - 2])->fnamemodify(':t') - let valueIdx = matchstrpos(a:varinfo, ',value="\(.*\)"}') +def ParseVarinfo(varinfo: string): dict<any> + var dict = {} + var nameIdx = matchstrpos(varinfo, '{name="\([^"]*\)"') + dict['name'] = varinfo[nameIdx[1] + 7 : nameIdx[2] - 2] + var typeIdx = matchstrpos(varinfo, ',type="\([^"]*\)"') + # 'type' maybe is a url-like string, + # try to shorten it and show only the /tail + dict['type'] = (varinfo[typeIdx[1] + 7 : typeIdx[2] - 2])->fnamemodify(':t') + var valueIdx = matchstrpos(varinfo, ',value="\(.*\)"}') if valueIdx[1] == -1 - let dict['value'] = 'Complex value' + dict['value'] = 'Complex value' else - let dict['value'] = a:varinfo[valueIdx[1] + 8 : valueIdx[2] - 3] + dict['value'] = varinfo[valueIdx[1] + 8 : valueIdx[2] - 3] endif return dict -endfunc - -func s:HandleVariablesMsg(msg) - let curwinid = win_getid() - if win_gotoid(s:varwin) +enddef - silent! %delete _ - let spaceBuffer = 20 - call setline(1, 'Type' . - \ repeat(' ', 16) . - \ 'Name' . - \ repeat(' ', 16) . - \ 'Value') - let cnt = 1 - let capture = '{name=".\{-}",\%(arg=".\{-}",\)\{0,1\}type=".\{-}"\%(,value=".\{-}"\)\{0,1\}}' - let varinfo = matchstr(a:msg, capture, 0, cnt) +def HandleVariablesMsg(msg: string) + var curwinid = win_getid() + if win_gotoid(varwin) + silent! :%delete _ + var spaceBuffer = 20 + setline(1, 'Type' .. + \ repeat(' ', 16) .. + \ 'Name' .. + \ repeat(' ', 16) .. + \ 'Value') + var cnt = 1 + var capture = '{name=".\{-}",\%(arg=".\{-}",\)\{0,1\}type=".\{-}"\%(,value=".\{-}"\)\{0,1\}}' + var varinfo = matchstr(msg, capture, 0, cnt) + while varinfo != '' - let vardict = s:ParseVarinfo(varinfo) - call setline(cnt + 1, vardict['type'] . - \ repeat(' ', max([20 - len(vardict['type']), 1])) . - \ vardict['name'] . - \ repeat(' ', max([20 - len(vardict['name']), 1])) . - \ vardict['value']) - let cnt += 1 - let varinfo = matchstr(a:msg, capture, 0, cnt) + var vardict = ParseVarinfo(varinfo) + setline(cnt + 1, vardict['type'] .. + \ repeat(' ', max([20 - len(vardict['type']), 1])) .. + \ vardict['name'] .. + \ repeat(' ', max([20 - len(vardict['name']), 1])) .. + \ vardict['value']) + cnt += 1 + varinfo = matchstr(msg, capture, 0, cnt) endwhile endif - call win_gotoid(curwinid) -endfunc + win_gotoid(curwinid) +enddef + -" Handle a message received from gdb on the GDB/MI interface. -func s:CommOutput(chan, msg) - let msgs = split(a:msg, "\r") +# Handle a message received from gdb on the GDB/MI interface. +def CommOutput(chan: channel, message: string) + # We may use the standard MI message formats? See #10300 on github that mentions + # the following links: + # https://sourceware.org/gdb/current/onlinedocs/gdb.html/GDB_002fMI-Input-Syntax.html#GDB_002fMI-Input-Syntax + # https://sourceware.org/gdb/current/onlinedocs/gdb.html/GDB_002fMI-Output-Syntax.html#GDB_002fMI-Output-Syntax - for msg in msgs - " remove prefixed NL - if msg[0] == "\n" - let msg = msg[1:] + var msgs = split(message, "\r") + + var msg = '' + for received_msg in msgs + # remove prefixed NL + if received_msg[0] == "\n" + msg = received_msg[1 : ] + else + msg = received_msg endif - if s:parsing_disasm_msg - call s:HandleDisasmMsg(msg) + if parsing_disasm_msg > 0 + HandleDisasmMsg(msg) elseif msg != '' if msg =~ '^\(\*stopped\|\*running\|=thread-selected\)' - call s:HandleCursor(msg) + HandleCursor(msg) elseif msg =~ '^\^done,bkpt=' || msg =~ '^=breakpoint-created,' - call s:HandleNewBreakpoint(msg, 0) + HandleNewBreakpoint(msg, 0) elseif msg =~ '^=breakpoint-modified,' - call s:HandleNewBreakpoint(msg, 1) + HandleNewBreakpoint(msg, 1) elseif msg =~ '^=breakpoint-deleted,' - call s:HandleBreakpointDelete(msg) + HandleBreakpointDelete(msg) elseif msg =~ '^=thread-group-started' - call s:HandleProgramRun(msg) + HandleProgramRun(msg) elseif msg =~ '^\^done,value=' - call s:HandleEvaluate(msg) + HandleEvaluate(msg) elseif msg =~ '^\^error,msg=' - call s:HandleError(msg) + HandleError(msg) elseif msg =~ '^&"disassemble' - let s:parsing_disasm_msg = 1 - let s:asm_lines = [] - call s:HandleDisasmMsg(msg) + parsing_disasm_msg = 1 + asm_lines = [] + HandleDisasmMsg(msg) elseif msg =~ '^\^done,variables=' - call s:HandleVariablesMsg(msg) + HandleVariablesMsg(msg) endif endif endfor -endfunc +enddef -func s:GotoProgram() +def GotoProgram() if has('win32') if executable('powershell') - call system(printf('powershell -Command "add-type -AssemblyName microsoft.VisualBasic;[Microsoft.VisualBasic.Interaction]::AppActivate(%d);"', s:pid)) + system(printf('powershell -Command "add-type -AssemblyName microsoft.VisualBasic;[Microsoft.VisualBasic.Interaction]::AppActivate(%d);"', pid)) endif else - call win_gotoid(s:ptywin) + win_gotoid(ptywin) endif -endfunc +enddef -" Install commands in the current window to control the debugger. -func s:InstallCommands() - let save_cpo = &cpo - set cpo&vim +# Install commands in the current window to control the debugger. +def InstallCommands() - command -nargs=? Break call s:SetBreakpoint(<q-args>) - command -nargs=? Tbreak call s:SetBreakpoint(<q-args>, v:true) - command Clear call s:ClearBreakpoint() - command Step call s:SendResumingCommand('-exec-step') - command Over call s:SendResumingCommand('-exec-next') - command -nargs=? Until call s:Until(<q-args>) - command Finish call s:SendResumingCommand('-exec-finish') - command -nargs=* Run call s:Run(<q-args>) - command -nargs=* Arguments call s:SendResumingCommand('-exec-arguments ' . <q-args>) + command -nargs=? Break SetBreakpoint(<q-args>) + command -nargs=? Tbreak SetBreakpoint(<q-args>, true) + command Clear ClearBreakpoint() + command Step SendResumingCommand('-exec-step') + command Over SendResumingCommand('-exec-next') + command -nargs=? Until Until(<q-args>) + command Finish SendResumingCommand('-exec-finish') + command -nargs=* Run Run(<q-args>) + command -nargs=* Arguments SendResumingCommand('-exec-arguments ' .. <q-args>) - if s:way == 'prompt' - command Stop call s:PromptInterrupt() - command Continue call s:SendCommand('continue') + if way == 'prompt' + command Stop PromptInterrupt() + command Continue SendCommand('continue') else - command Stop call s:SendCommand('-exec-interrupt') - " using -exec-continue results in CTRL-C in the gdb window not working, - " communicating via commbuf (= use of SendCommand) has the same result - "command Continue call s:SendCommand('-exec-continue') - command Continue call term_sendkeys(s:gdbbuf, "continue\r") + command Stop SendCommand('-exec-interrupt') + # using -exec-continue results in CTRL-C in the gdb window not working, + # communicating via commbuf (= use of SendCommand) has the same result + command Continue SendCommand('-exec-continue') + # command Continue term_sendkeys(gdbbuf, "continue\r") endif - command -nargs=* Frame call s:Frame(<q-args>) - command -count=1 Up call s:Up(<count>) - command -count=1 Down call s:Down(<count>) + command -nargs=* Frame Frame(<q-args>) + command -count=1 Up Up(<count>) + command -count=1 Down Down(<count>) - command -range -nargs=* Evaluate call s:Evaluate(<range>, <q-args>) - command Gdb call win_gotoid(s:gdbwin) - command Program call s:GotoProgram() - command Source call s:GotoSourcewinOrCreateIt() - command Asm call s:GotoAsmwinOrCreateIt() - command Var call s:GotoVariableswinOrCreateIt() - command Winbar call s:InstallWinbar(1) + command -range -nargs=* Evaluate Evaluate(<range>, <q-args>) + command Gdb win_gotoid(gdbwin) + command Program GotoProgram() + command Source GotoSourcewinOrCreateIt() + command Asm GotoAsmwinOrCreateIt() + command Var GotoVariableswinOrCreateIt() + command Winbar InstallWinbar(1) - let map = 1 + var map = 1 if exists('g:termdebug_config') - let map = get(g:termdebug_config, 'map_K', 1) + map = get(g:termdebug_config, 'map_K', 1) elseif exists('g:termdebug_map_K') - let map = g:termdebug_map_K + map = g:termdebug_map_K endif + if map - let s:k_map_saved = maparg('K', 'n', 0, 1) - if !empty(s:k_map_saved) && !s:k_map_saved.buffer || empty(s:k_map_saved) + k_map_saved = maparg('K', 'n', 0, 1) + if !empty(k_map_saved) && !k_map_saved.buffer || empty(k_map_saved) nnoremap K :Evaluate<CR> endif endif - let map = 1 + map = 1 if exists('g:termdebug_config') - let map = get(g:termdebug_config, 'map_plus', 1) + map = get(g:termdebug_config, 'map_plus', 1) endif if map - let s:plus_map_saved = maparg('+', 'n', 0, 1) - if !empty(s:plus_map_saved) && !s:plus_map_saved.buffer || empty(s:plus_map_saved) + plus_map_saved = maparg('+', 'n', 0, 1) + if !empty(plus_map_saved) && !plus_map_saved.buffer || empty(plus_map_saved) nnoremap <expr> + $'<Cmd>{v:count1}Up<CR>' endif endif - let map = 1 + map = 1 if exists('g:termdebug_config') - let map = get(g:termdebug_config, 'map_minus', 1) + map = get(g:termdebug_config, 'map_minus', 1) endif if map - let s:minus_map_saved = maparg('-', 'n', 0, 1) - if !empty(s:minus_map_saved) && !s:minus_map_saved.buffer || empty(s:minus_map_saved) + minus_map_saved = maparg('-', 'n', 0, 1) + if !empty(minus_map_saved) && !minus_map_saved.buffer || empty(minus_map_saved) nnoremap <expr> - $'<Cmd>{v:count1}Down<CR>' endif endif if has('menu') && &mouse != '' - call s:InstallWinbar(0) + InstallWinbar(0) - let popup = 1 + var pup = 1 if exists('g:termdebug_config') - let popup = get(g:termdebug_config, 'popup', 1) + pup = get(g:termdebug_config, 'popup', 1) elseif exists('g:termdebug_popup') - let popup = g:termdebug_popup + pup = g:termdebug_popup endif - if popup - let s:saved_mousemodel = &mousemodel - let &mousemodel = 'popup_setpos' + + if pup + saved_mousemodel = &mousemodel + &mousemodel = 'popup_setpos' an 1.200 PopUp.-SEP3- <Nop> an 1.210 PopUp.Set\ breakpoint :Break<CR> an 1.220 PopUp.Clear\ breakpoint :Clear<CR> @@ -1051,32 +1119,29 @@ func s:InstallCommands() endif endif - let &cpo = save_cpo -endfunc - -let s:winbar_winids = [] +enddef -" Install the window toolbar in the current window. -func s:InstallWinbar(force) - " install the window toolbar by default, can be disabled in the config - let winbar = 1 +# Install the window toolbar in the current window. +def InstallWinbar(force: number) + # install the window toolbar by default, can be disabled in the config + var winbar = 1 if exists('g:termdebug_config') - let winbar = get(g:termdebug_config, 'winbar', 1) + winbar = get(g:termdebug_config, 'winbar', 1) endif - if has('menu') && &mouse != '' && (winbar || a:force) + if has('menu') && &mouse != '' && (winbar || force) nnoremenu WinBar.Step :Step<CR> nnoremenu WinBar.Next :Over<CR> nnoremenu WinBar.Finish :Finish<CR> nnoremenu WinBar.Cont :Continue<CR> nnoremenu WinBar.Stop :Stop<CR> nnoremenu WinBar.Eval :Evaluate<CR> - call add(s:winbar_winids, win_getid()) + add(winbar_winids, win_getid()) endif -endfunc +enddef -" Delete installed debugger commands in the current window. -func s:DeleteCommands() +# Delete installed debugger commands in the current window. +def DeleteCommands() delcommand Break delcommand Tbreak delcommand Clear @@ -1099,53 +1164,53 @@ func s:DeleteCommands() delcommand Var delcommand Winbar - if exists('s:k_map_saved') - if !empty(s:k_map_saved) && !s:k_map_saved.buffer + if exists('k_map_saved') + if !empty(k_map_saved) && !k_map_saved.buffer nunmap K - call mapset(s:k_map_saved) - elseif empty(s:k_map_saved) + mapset(k_map_saved) + elseif empty(k_map_saved) nunmap K endif - unlet s:k_map_saved + k_map_saved = {} endif - if exists('s:plus_map_saved') - if !empty(s:plus_map_saved) && !s:plus_map_saved.buffer + if exists('plus_map_saved') + if !empty(plus_map_saved) && !plus_map_saved.buffer nunmap + - call mapset(s:plus_map_saved) - elseif empty(s:plus_map_saved) + mapset(plus_map_saved) + elseif empty(plus_map_saved) nunmap + endif - unlet s:plus_map_saved + plus_map_saved = {} endif - if exists('s:minus_map_saved') - if !empty(s:minus_map_saved) && !s:minus_map_saved.buffer + if exists('minus_map_saved') + if !empty(minus_map_saved) && !minus_map_saved.buffer nunmap - - call mapset(s:minus_map_saved) - elseif empty(s:minus_map_saved) + mapset(minus_map_saved) + elseif empty(minus_map_saved) nunmap - endif - unlet s:minus_map_saved + minus_map_saved = {} endif if has('menu') - " Remove the WinBar entries from all windows where it was added. - let curwinid = win_getid() - for winid in s:winbar_winids + # Remove the WinBar entries from all windows where it was added. + var curwinid = win_getid() + for winid in winbar_winids if win_gotoid(winid) - aunmenu WinBar.Step - aunmenu WinBar.Next - aunmenu WinBar.Finish - aunmenu WinBar.Cont - aunmenu WinBar.Stop - aunmenu WinBar.Eval + aunmenu WinBar.Step + aunmenu WinBar.Next + aunmenu WinBar.Finish + aunmenu WinBar.Cont + aunmenu WinBar.Stop + aunmenu WinBar.Eval endif endfor - call win_gotoid(curwinid) - let s:winbar_winids = [] + win_gotoid(curwinid) + winbar_winids = [] - if exists('s:saved_mousemodel') - let &mousemodel = s:saved_mousemodel - unlet s:saved_mousemodel + if exists('saved_mousemodel') + &mousemodel = saved_mousemodel + saved_mousemodel = null_string aunmenu PopUp.-SEP3- aunmenu PopUp.Set\ breakpoint aunmenu PopUp.Clear\ breakpoint @@ -1154,279 +1219,285 @@ func s:DeleteCommands() endif endif - call sign_unplace('TermDebug') - unlet s:breakpoints - unlet s:breakpoint_locations + sign_unplace('TermDebug') + breakpoints = {} + breakpoint_locations = {} - call sign_undefine('debugPC') - call sign_undefine(s:BreakpointSigns->map("'debugBreakpoint' .. v:val")) - let s:BreakpointSigns = [] -endfunc + sign_undefine('debugPC') + sign_undefine(BreakpointSigns->map("'debugBreakpoint' .. v:val")) + BreakpointSigns = [] +enddef + + +# :Until - Execute until past a specified position or current line +def Until(at: string) -" :Until - Execute until past a specified position or current line -func s:Until(at) - if s:stopped - " reset s:stopped here, it may take a bit of time before we get a response - let s:stopped = 0 - call ch_log('assume that program is running after this command') - " Use the fname:lnum format - let at = empty(a:at) ? - \ fnameescape(expand('%:p')) . ':' . line('.') : a:at - call s:SendCommand('-exec-until ' . at) + if stopped + # reset stopped here, it may take a bit of time before we get a response + stopped = 0 + ch_log('assume that program is running after this command') + + # Use the fname:lnum format + var AT = empty(at) ? + \ fnameescape(expand('%:p')) .. ':' .. line('.') : at + SendCommand('-exec-until ' .. AT) else - call ch_log('dropping command, program is running: exec-until') + ch_log('dropping command, program is running: exec-until') endif -endfunc +enddef -" :Break - Set a breakpoint at the cursor position. -func s:SetBreakpoint(at, tbreak=v:false) - " Setting a breakpoint may not work while the program is running. - " Interrupt to make it work. - let do_continue = 0 - if !s:stopped - let do_continue = 1 +# :Break - Set a breakpoint at the cursor position. +def SetBreakpoint(at: string, tbreak=false) + # Setting a breakpoint may not work while the program is running. + # Interrupt to make it work. + var do_continue = 0 + if !stopped + do_continue = 1 Stop sleep 10m endif - " Use the fname:lnum format, older gdb can't handle --source. - let at = empty(a:at) ? - \ fnameescape(expand('%:p')) . ':' . line('.') : a:at - if a:tbreak - let cmd = '-break-insert -t ' . at + # Use the fname:lnum format, older gdb can't handle --source. + var AT = empty(at) ? + \ fnameescape(expand('%:p')) .. ':' .. line('.') : at + var cmd = '' + if tbreak + cmd = '-break-insert -t ' .. AT else - let cmd = '-break-insert ' . at + cmd = '-break-insert ' .. AT endif - call s:SendCommand(cmd) + # OK + # echom "cmsd: " .. cmd + SendCommand(cmd) if do_continue Continue endif -endfunc +enddef -" :Clear - Delete a breakpoint at the cursor position. -func s:ClearBreakpoint() - let fname = fnameescape(expand('%:p')) - let lnum = line('.') - let bploc = printf('%s:%d', fname, lnum) - if has_key(s:breakpoint_locations, bploc) - let idx = 0 - let nr = 0 - for id in s:breakpoint_locations[bploc] - if has_key(s:breakpoints, id) - " Assume this always works, the reply is simply "^done". - call s:SendCommand('-break-delete ' . id) - for subid in keys(s:breakpoints[id]) - call sign_unplace('TermDebug', - \ #{id: s:Breakpoint2SignNumber(id, subid)}) +def ClearBreakpoint() + var fname = fnameescape(expand('%:p')) + var lnum = line('.') + var bploc = printf('%s:%d', fname, lnum) + var nr = 0 + if has_key(breakpoint_locations, bploc) + var idx = 0 + for id in breakpoint_locations[bploc] + if has_key(breakpoints, id) + # Assume this always works, the reply is simply "^done". + SendCommand('-break-delete ' .. id) + for subid in keys(breakpoints[id]) + sign_unplace('TermDebug', + \ {'id': Breakpoint2SignNumber(id, str2nr(subid))}) endfor - unlet s:breakpoints[id] - unlet s:breakpoint_locations[bploc][idx] - let nr = id + remove(breakpoints, id) + remove(breakpoint_locations[bploc], idx) + nr = id break else - let idx += 1 + idx += 1 endif endfor + if nr != 0 - if empty(s:breakpoint_locations[bploc]) - unlet s:breakpoint_locations[bploc] + if empty(breakpoint_locations[bploc]) + remove(breakpoint_locations, bploc) endif - echomsg 'Breakpoint ' . id . ' cleared from line ' . lnum . '.' + echomsg 'Breakpoint ' .. nr .. ' cleared from line ' .. lnum .. '.' else - call s:Echoerr('Internal error trying to remove breakpoint at line ' . lnum . '!') + Echoerr('Internal error trying to remove breakpoint at line ' .. lnum .. '!') endif else - echomsg 'No breakpoint to remove at line ' . lnum . '.' + echomsg 'No breakpoint to remove at line ' .. lnum .. '.' endif -endfunc +enddef -func s:Run(args) - if a:args != '' - call s:SendResumingCommand('-exec-arguments ' . a:args) +def Run(args: string) + if args != '' + SendResumingCommand('-exec-arguments ' .. args) endif - call s:SendResumingCommand('-exec-run') -endfunc + SendResumingCommand('-exec-run') +enddef -" :Frame - go to a specific frame in the stack -func s:Frame(arg) - " Note: we explicit do not use mi's command - " call s:SendCommand('-stack-select-frame "' . a:arg .'"') - " as we only get a "done" mi response and would have to open the file - " 'manually' - using cli command "frame" provides us with the mi response - " already parsed and allows for more formats - if a:arg =~ '^\d\+$' || a:arg == '' - " specify frame by number - call s:SendCommand('-interpreter-exec mi "frame ' . a:arg .'"') - elseif a:arg =~ '^0x[0-9a-fA-F]\+$' - " specify frame by stack address - call s:SendCommand('-interpreter-exec mi "frame address ' . a:arg .'"') +# :Frame - go to a specific frame in the stack +def Frame(arg: string) + # Note: we explicit do not use mi's command + # call SendCommand('-stack-select-frame "' . arg .'"') + # as we only get a "done" mi response and would have to open the file + # 'manually' - using cli command "frame" provides us with the mi response + # already parsed and allows for more formats + if arg =~ '^\d\+$' || arg == '' + # specify frame by number + SendCommand('-interpreter-exec mi "frame ' .. arg ..'"') + elseif arg =~ '^0x[0-9a-fA-F]\+$' + # specify frame by stack address + SendCommand('-interpreter-exec mi "frame address ' .. arg ..'"') else - " specify frame by function name - call s:SendCommand('-interpreter-exec mi "frame function ' . a:arg .'"') + # specify frame by function name + SendCommand('-interpreter-exec mi "frame function ' .. arg ..'"') endif -endfunc +enddef -" :Up - go a:count frames in the stack "higher" -func s:Up(count) - " the 'correct' one would be -stack-select-frame N, but we don't know N - call s:SendCommand($'-interpreter-exec console "up {a:count}"') -endfunc +# :Up - go count frames in the stack "higher" +def Up(count: number) + # the 'correct' one would be -stack-select-frame N, but we don't know N + SendCommand($'-interpreter-exec console "up {count}"') +enddef -" :Down - go a:count frames in the stack "below" -func s:Down(count) - " the 'correct' one would be -stack-select-frame N, but we don't know N - call s:SendCommand($'-interpreter-exec console "down {a:count}"') -endfunc +# :Down - go count frames in the stack "below" +def Down(count: number) + # the 'correct' one would be -stack-select-frame N, but we don't know N + SendCommand($'-interpreter-exec console "down {count}"') +enddef -func s:SendEval(expr) - " check for "likely" boolean expressions, in which case we take it as lhs - if a:expr =~ "[=!<>]=" - let exprLHS = a:expr - else - " remove text that is likely an assignment - let exprLHS = substitute(a:expr, ' *=.*', '', '') +def SendEval(expr: string) + # check for "likely" boolean expressions, in which case we take it as lhs + var exprLHS = substitute(expr, ' *=.*', '', '') + if expr =~ "[=!<>]=" + exprLHS = expr endif - " encoding expression to prevent bad errors - let expr = a:expr - let expr = substitute(expr, '\\', '\\\\', 'g') - let expr = substitute(expr, '"', '\\"', 'g') - call s:SendCommand('-data-evaluate-expression "' . expr . '"') - let s:evalexpr = exprLHS -endfunc + # encoding expression to prevent bad errors + var expr_escaped = expr + \ ->substitute('\\', '\\\\', 'g') + \ ->substitute('"', '\\"', 'g') + SendCommand('-data-evaluate-expression "' .. expr_escaped .. '"') + evalexpr = exprLHS +enddef -" :Evaluate - evaluate what is specified / under the cursor -func s:Evaluate(range, arg) - let expr = s:GetEvaluationExpression(a:range, a:arg) - let s:ignoreEvalError = 0 - call s:SendEval(expr) -endfunc +# :Evaluate - evaluate what is specified / under the cursor +def Evaluate(range: number, arg: string) + var expr = GetEvaluationExpression(range, arg) + #echom "expr:" .. expr + ignoreEvalError = 0 + SendEval(expr) +enddef + -" get what is specified / under the cursor -func s:GetEvaluationExpression(range, arg) - if a:arg != '' - " user supplied evaluation - let expr = s:CleanupExpr(a:arg) - " DSW: replace "likely copy + paste" assignment - let expr = substitute(expr, '"\([^"]*\)": *', '\1=', 'g') - elseif a:range == 2 - " no evaluation but provided but range set - let pos = getcurpos() - let reg = getreg('v', 1, 1) - let regt = getregtype('v') +# get what is specified / under the cursor +def GetEvaluationExpression(range: number, arg: string): string + var expr = '' + if arg != '' + # user supplied evaluation + expr = CleanupExpr(arg) + # DSW: replace "likely copy + paste" assignment + expr = substitute(expr, '"\([^"]*\)": *', '\1=', 'g') + elseif range == 2 + # no evaluation but provided but range set + var pos = getcurpos() + var regst = getreg('v', 1, 1) + var regt = getregtype('v') normal! gv"vy - let expr = s:CleanupExpr(@v) - call setpos('.', pos) - call setreg('v', reg, regt) + expr = CleanupExpr(@v) + setpos('.', pos) + setreg('v', regst, regt) else - " no evaluation provided: get from C-expression under cursor - " TODO: allow filetype specific lookup #9057 - let expr = expand('<cexpr>') + # no evaluation provided: get from C-expression under cursor + # TODO: allow filetype specific lookup #9057 + expr = expand('<cexpr>') endif return expr -endfunc +enddef -" clean up expression that may get in because of range -" (newlines and surrounding whitespace) -" As it can also be specified via ex-command for assignments this function -" may not change the "content" parts (like replacing contained spaces) -func s:CleanupExpr(expr) - " replace all embedded newlines/tabs/... - let expr = substitute(a:expr, '\_s', ' ', 'g') +# clean up expression that may get in because of range +# (newlines and surrounding whitespace) +# As it can also be specified via ex-command for assignments this function +# may not change the "content" parts (like replacing contained spaces) +def CleanupExpr(passed_expr: string): string + # replace all embedded newlines/tabs/... + var expr = substitute(passed_expr, '\_s', ' ', 'g') if &filetype ==# 'cobol' - " extra cleanup for COBOL: - " - a semicolon nmay be used instead of a space - " - a trailing comma or period is ignored as it commonly separates/ends - " multiple expr - let expr = substitute(expr, ';', ' ', 'g') - let expr = substitute(expr, '[,.]\+ *$', '', '') + # extra cleanup for COBOL: + # - a semicolon nmay be used instead of a space + # - a trailing comma or period is ignored as it commonly separates/ends + # multiple expr + expr = substitute(expr, ';', ' ', 'g') + expr = substitute(expr, '[,.]\+ *$', '', '') endif - " get rid of leading and trailing spaces - let expr = substitute(expr, '^ *', '', '') - let expr = substitute(expr, ' *$', '', '') + # get rid of leading and trailing spaces + expr = substitute(expr, '^ *', '', '') + expr = substitute(expr, ' *$', '', '') return expr -endfunc - -let s:ignoreEvalError = 0 -let s:evalFromBalloonExpr = 0 +enddef -" Handle the result of data-evaluate-expression -func s:HandleEvaluate(msg) - let value = a:msg - \ ->substitute('.*value="\(.*\)"', '\1', '') - \ ->substitute('\\"', '"', 'g') - \ ->substitute('\\\\', '\\', 'g') - "\ multi-byte characters arrive in octal form, replace everything but NULL values - \ ->substitute('\\000', s:NullRepl, 'g') - \ ->substitute('\\\o\o\o', {-> eval('"' .. submatch(0) .. '"')}, 'g') - "\ Note: GDB docs also mention hex encodings - the translations below work - "\ but we keep them out for performance-reasons until we actually see - "\ those in mi-returns - "\ ->substitute('\\0x00', s:NullRep, 'g') - "\ ->substitute('\\0x\(\x\x\)', {-> eval('"\x' .. submatch(1) .. '"')}, 'g') - \ ->substitute(s:NullRepl, '\\000', 'g') - if s:evalFromBalloonExpr - if s:evalFromBalloonExprResult == '' - let s:evalFromBalloonExprResult = s:evalexpr . ': ' . value +def HandleEvaluate(msg: string) + var value = msg + \ ->substitute('.*value="\(.*\)"', '\1', '') + \ ->substitute('\\"', '"', 'g') + \ ->substitute('\\\\', '\\', 'g') + #\ multi-byte characters arrive in octal form, replace everything but NULL values + \ ->substitute('\\000', NullRepl, 'g') + # \ ->substitute('\\\o\o\o', {-> eval('"' .. submatch(0) .. '"')}, 'g') + \ ->substitute('\\\(\o\o\o\)', (m) => nr2char(str2nr(m[1], 8)), 'g') + #\ Note: GDB docs also mention hex encodings - the translations below work + #\ but we keep them out for performance-reasons until we actually see + #\ those in mi-returns + #\ ->substitute('\\0x00', NullRep, 'g') + #\ ->substitute('\\0x\(\x\x\)', {-> eval('"\x' .. submatch(1) .. '"')}, 'g') + \ ->substitute(NullRepl, '\\000', 'g') + if evalFromBalloonExpr + if evalFromBalloonExprResult == '' + evalFromBalloonExprResult = evalexpr .. ': ' .. value else - let s:evalFromBalloonExprResult .= ' = ' . value + evalFromBalloonExprResult ..= ' = ' .. value endif - call balloon_show(s:evalFromBalloonExprResult) + balloon_show(evalFromBalloonExprResult) else - echomsg '"' . s:evalexpr . '": ' . value + echomsg '"' .. evalexpr .. '": ' .. value endif - if s:evalexpr[0] != '*' && value =~ '^0x' && value != '0x0' && value !~ '"$' - " Looks like a pointer, also display what it points to. - let s:ignoreEvalError = 1 - call s:SendEval('*' . s:evalexpr) + if evalexpr[0] != '*' && value =~ '^0x' && value != '0x0' && value !~ '"$' + # Looks like a pointer, also display what it points to. + ignoreEvalError = 1 + SendEval('*' .. evalexpr) else - let s:evalFromBalloonExpr = 0 + evalFromBalloonExpr = 0 endif -endfunc +enddef + -" Show a balloon with information of the variable under the mouse pointer, -" if there is any. -func TermDebugBalloonExpr() - if v:beval_winid != s:sourcewin +# Show a balloon with information of the variable under the mouse pointer, +# if there is any. +def TermDebugBalloonExpr(): string + if v:beval_winid != sourcewin return '' endif - if !s:stopped - " Only evaluate when stopped, otherwise setting a breakpoint using the - " mouse triggers a balloon. + if !stopped + # Only evaluate when stopped, otherwise setting a breakpoint using the + # mouse triggers a balloon. return '' endif - let s:evalFromBalloonExpr = 1 - let s:evalFromBalloonExprResult = '' - let s:ignoreEvalError = 1 - let expr = s:CleanupExpr(v:beval_text) - call s:SendEval(expr) + evalFromBalloonExpr = 1 + evalFromBalloonExprResult = '' + ignoreEvalError = 1 + var expr = CleanupExpr(v:beval_text) + SendEval(expr) return '' -endfunc +enddef -" Handle an error. -func s:HandleError(msg) - if s:ignoreEvalError - " Result of s:SendEval() failed, ignore. - let s:ignoreEvalError = 0 - let s:evalFromBalloonExpr = 0 +# Handle an error. +def HandleError(msg: string) + if ignoreEvalError + # Result of SendEval() failed, ignore. + ignoreEvalError = 0 + evalFromBalloonExpr = 0 return endif - let msgVal = substitute(a:msg, '.*msg="\(.*\)"', '\1', '') - call s:Echoerr(substitute(msgVal, '\\"', '"', 'g')) -endfunc + var msgVal = substitute(msg, '.*msg="\(.*\)"', '\1', '') + Echoerr(substitute(msgVal, '\\"', '"', 'g')) +enddef -func s:GotoSourcewinOrCreateIt() - if !win_gotoid(s:sourcewin) +def GotoSourcewinOrCreateIt() + if !win_gotoid(sourcewin) new - let s:sourcewin = win_getid() - call s:InstallWinbar(0) + sourcewin = win_getid() + InstallWinbar(0) endif -endfunc +enddef -func s:GetDisasmWindow() + +def GetDisasmWindow(): number if exists('g:termdebug_config') return get(g:termdebug_config, 'disasm_window', 0) endif @@ -1434,9 +1505,9 @@ func s:GetDisasmWindow() return g:termdebug_disasm_window endif return 0 -endfunc +enddef -func s:GetDisasmWindowHeight() +def GetDisasmWindowHeight(): number if exists('g:termdebug_config') return get(g:termdebug_config, 'disasm_window_height', 0) endif @@ -1444,16 +1515,16 @@ func s:GetDisasmWindowHeight() return g:termdebug_disasm_window endif return 0 -endfunc +enddef -func s:GotoAsmwinOrCreateIt() - if !win_gotoid(s:asmwin) - let mdf = '' - if win_gotoid(s:sourcewin) - " 60 is approx spaceBuffer * 3 +def GotoAsmwinOrCreateIt() + var mdf = '' + if !win_gotoid(asmwin) + if win_gotoid(sourcewin) + # 60 is approx spaceBuffer * 3 if winwidth(0) > (78 + 60) - let mdf = 'vert' - exe mdf .. ' ' .. 60 .. 'new' + mdf = 'vert' + exe mdf .. ' ' .. ':60' .. 'new' else exe 'rightbelow new' endif @@ -1461,7 +1532,7 @@ func s:GotoAsmwinOrCreateIt() exe 'new' endif - let s:asmwin = win_getid() + asmwin = win_getid() setlocal nowrap setlocal number @@ -1471,35 +1542,35 @@ func s:GotoAsmwinOrCreateIt() setlocal signcolumn=no setlocal modifiable - if s:asmbuf > 0 && bufexists(s:asmbuf) - exe 'buffer' . s:asmbuf + if asmbuf > 0 && bufexists(asmbuf) + exe 'buffer' .. asmbuf elseif empty(glob('Termdebug-asm-listing')) silent file Termdebug-asm-listing - let s:asmbuf = bufnr('Termdebug-asm-listing') + asmbuf = bufnr('Termdebug-asm-listing') else - call s:Echoerr("You have a file/folder named 'Termdebug-asm-listing'. + Echoerr("You have a file/folder named 'Termdebug-asm-listing'. \ Please exit and rename it because Termdebug may not work as expected.") endif - if mdf != 'vert' && s:GetDisasmWindowHeight() > 0 - exe 'resize ' .. s:GetDisasmWindowHeight() + if mdf != 'vert' && GetDisasmWindowHeight() > 0 + exe 'resize ' .. GetDisasmWindowHeight() endif endif - if s:asm_addr != '' - let lnum = search('^' . s:asm_addr) + if asm_addr != '' + var lnum = search('^' .. asm_addr) if lnum == 0 - if s:stopped - call s:SendCommand('disassemble $pc') + if stopped + SendCommand('disassemble $pc') endif else - call sign_unplace('TermDebug', #{id: s:asm_id}) - call sign_place(s:asm_id, 'TermDebug', 'debugPC', '%', #{lnum: lnum}) + sign_unplace('TermDebug', {'id': asm_id}) + sign_place(asm_id, 'TermDebug', 'debugPC', '%', {'lnum': lnum}) endif endif -endfunc +enddef -func s:GetVariablesWindow() +def GetVariablesWindow(): number if exists('g:termdebug_config') return get(g:termdebug_config, 'variables_window', 0) endif @@ -1507,9 +1578,9 @@ func s:GetVariablesWindow() return g:termdebug_variables_window endif return 0 -endfunc +enddef -func s:GetVariablesWindowHeight() +def GetVariablesWindowHeight(): number if exists('g:termdebug_config') return get(g:termdebug_config, 'variables_window_height', 0) endif @@ -1517,16 +1588,17 @@ func s:GetVariablesWindowHeight() return g:termdebug_variables_window endif return 0 -endfunc +enddef + -func s:GotoVariableswinOrCreateIt() - if !win_gotoid(s:varwin) - let mdf = '' - if win_gotoid(s:sourcewin) - " 60 is approx spaceBuffer * 3 +def GotoVariableswinOrCreateIt() + var mdf = '' + if !win_gotoid(varwin) + if win_gotoid(sourcewin) + # 60 is approx spaceBuffer * 3 if winwidth(0) > (78 + 60) - let mdf = 'vert' - exe mdf .. ' ' .. 60 .. 'new' + mdf = 'vert' + exe mdf .. ' ' .. ':60' .. 'new' else exe 'rightbelow new' endif @@ -1534,7 +1606,7 @@ func s:GotoVariableswinOrCreateIt() exe 'new' endif - let s:varwin = win_getid() + varwin = win_getid() setlocal nowrap setlocal noswapfile @@ -1543,284 +1615,288 @@ func s:GotoVariableswinOrCreateIt() setlocal signcolumn=no setlocal modifiable - if s:varbuf > 0 && bufexists(s:varbuf) - exe 'buffer' . s:varbuf + if varbuf > 0 && bufexists(varbuf) + exe 'buffer' .. varbuf elseif empty(glob('Termdebug-variables-listing')) silent file Termdebug-variables-listing - let s:varbuf = bufnr('Termdebug-variables-listing') + varbuf = bufnr('Termdebug-variables-listing') else - call s:Echoerr("You have a file/folder named 'Termdebug-variables-listing'. + Echoerr("You have a file/folder named 'Termdebug-variables-listing'. \ Please exit and rename it because Termdebug may not work as expected.") endif - if mdf != 'vert' && s:GetVariablesWindowHeight() > 0 - exe 'resize ' .. s:GetVariablesWindowHeight() + if mdf != 'vert' && GetVariablesWindowHeight() > 0 + exe 'resize ' .. GetVariablesWindowHeight() endif endif - if s:running - call s:SendCommand('-stack-list-variables 2') + if running + SendCommand('-stack-list-variables 2') endif -endfunc +enddef -" Handle stopping and running message from gdb. -" Will update the sign that shows the current position. -func s:HandleCursor(msg) - let wid = win_getid() +# Handle stopping and running message from gdb. +# Will update the sign that shows the current position. +def HandleCursor(msg: string) + var wid = win_getid() - if a:msg =~ '^\*stopped' - call ch_log('program stopped') - let s:stopped = 1 - if a:msg =~ '^\*stopped,reason="exited-normally"' - let s:running = 0 + if msg =~ '^\*stopped' + ch_log('program stopped') + stopped = 1 + if msg =~ '^\*stopped,reason="exited-normally"' + running = 0 endif - elseif a:msg =~ '^\*running' - call ch_log('program running') - let s:stopped = 0 - let s:running = 1 + elseif msg =~ '^\*running' + ch_log('program running') + stopped = 0 + running = 1 endif - if a:msg =~ 'fullname=' - let fname = s:GetFullname(a:msg) - else - let fname = '' + var fname = '' + if msg =~ 'fullname=' + fname = GetFullname(msg) endif - if a:msg =~ 'addr=' - let asm_addr = s:GetAsmAddr(a:msg) - if asm_addr != '' - let s:asm_addr = asm_addr + if msg =~ 'addr=' + var asm_addr_local = GetAsmAddr(msg) + if asm_addr_local != '' + asm_addr = asm_addr_local - let curwinid = win_getid() - if win_gotoid(s:asmwin) - let lnum = search('^' . s:asm_addr) + var curwinid = win_getid() + var lnum = 0 + if win_gotoid(asmwin) + lnum = search('^' .. asm_addr) if lnum == 0 - call s:SendCommand('disassemble $pc') + SendCommand('disassemble $pc') else - call sign_unplace('TermDebug', #{id: s:asm_id}) - call sign_place(s:asm_id, 'TermDebug', 'debugPC', '%', #{lnum: lnum}) + sign_unplace('TermDebug', {'id': asm_id}) + sign_place(asm_id, 'TermDebug', 'debugPC', '%', {'lnum': lnum}) endif - call win_gotoid(curwinid) + win_gotoid(curwinid) endif endif endif - if s:running && s:stopped && bufwinnr('Termdebug-variables-listing') != -1 - call s:SendCommand('-stack-list-variables 2') + if running && stopped && bufwinnr('Termdebug-variables-listing') != -1 + SendCommand('-stack-list-variables 2') endif - if a:msg =~ '^\(\*stopped\|=thread-selected\)' && filereadable(fname) - let lnum = substitute(a:msg, '.*line="\([^"]*\)".*', '\1', '') + if msg =~ '^\(\*stopped\|=thread-selected\)' && filereadable(fname) + var lnum = substitute(msg, '.*line="\([^"]*\)".*', '\1', '') if lnum =~ '^[0-9]*$' - call s:GotoSourcewinOrCreateIt() + GotoSourcewinOrCreateIt() if expand('%:p') != fnamemodify(fname, ':p') echomsg 'different fname: "' .. expand('%:p') .. '" vs "' .. fnamemodify(fname, ':p') .. '"' augroup Termdebug - " Always open a file read-only instead of showing the ATTENTION - " prompt, since it is unlikely we want to edit the file. - " The file may be changed but not saved, warn for that. + # Always open a file read-only instead of showing the ATTENTION + # prompt, since it is unlikely we want to edit the file. + # The file may be changed but not saved, warn for that. au SwapExists * echohl WarningMsg - \ | echo 'Warning: file is being edited elsewhere' - \ | echohl None - \ | let v:swapchoice = 'o' + \ | echo 'Warning: file is being edited elsewhere' + \ | echohl None + \ | let v:swapchoice = 'o' augroup END if &modified - " TODO: find existing window - exe 'split ' . fnameescape(fname) - let s:sourcewin = win_getid() - call s:InstallWinbar(0) + # TODO: find existing window + exe 'split ' .. fnameescape(fname) + sourcewin = win_getid() + call InstallWinbar(0) else - exe 'edit ' . fnameescape(fname) + exe 'edit ' .. fnameescape(fname) endif augroup Termdebug au! SwapExists augroup END endif - exe lnum + exe ":" .. lnum normal! zv - call sign_unplace('TermDebug', #{id: s:pc_id}) - call sign_place(s:pc_id, 'TermDebug', 'debugPC', fname, - \ #{lnum: lnum, priority: 110}) + sign_unplace('TermDebug', {'id': pc_id}) + sign_place(pc_id, 'TermDebug', 'debugPC', fname, + \ {'lnum': str2nr(lnum), priority: 110}) if !exists('b:save_signcolumn') - let b:save_signcolumn = &signcolumn - call add(s:signcolumn_buflist, bufnr()) + b:save_signcolumn = &signcolumn + add(signcolumn_buflist, bufnr()) endif setlocal signcolumn=yes endif - elseif !s:stopped || fname != '' - call sign_unplace('TermDebug', #{id: s:pc_id}) + elseif !stopped || fname != '' + sign_unplace('TermDebug', {'id': pc_id}) endif - call win_gotoid(wid) -endfunc - -let s:BreakpointSigns = [] + win_gotoid(wid) +enddef -func s:CreateBreakpoint(id, subid, enabled) - let nr = printf('%d.%d', a:id, a:subid) - if index(s:BreakpointSigns, nr) == -1 - call add(s:BreakpointSigns, nr) - if a:enabled == "n" - let hiName = "debugBreakpointDisabled" +# Create breakpoint sign +def CreateBreakpoint(id: number, subid: number, enabled: string) + var nr = printf('%d.%d', id, subid) + if index(BreakpointSigns, nr) == -1 + add(BreakpointSigns, nr) + var hiName = '' + if enabled == "n" + hiName = "debugBreakpointDisabled" else - let hiName = "debugBreakpoint" + hiName = "debugBreakpoint" endif - let label = '' - if exists('g:termdebug_config') - let label = get(g:termdebug_config, 'sign', '') - endif - if label == '' - let label = printf('%02X', a:id) - if a:id > 255 - let label = 'F+' + var label = '' + if exists('g:termdebug_config') && has_key(g:termdebug_config, 'sign') + label = g:termdebug_config['sign'] + else + label = printf('%02X', id) + if id > 255 + label = 'F+' endif endif - call sign_define('debugBreakpoint' .. nr, - \ #{text: slice(label, 0, 2), - \ texthl: hiName}) + sign_define('debugBreakpoint' .. nr, + \ {'text': slice(label, 0, 2), + \ 'texthl': hiName}) endif -endfunc +enddef -func! s:SplitMsg(s) - return split(a:s, '{.\{-}}\zs') -endfunction +def SplitMsg(str: string): list<string> + return split(str, '{.\{-}}\zs') +enddef + -" Handle setting a breakpoint -" Will update the sign that shows the breakpoint -func s:HandleNewBreakpoint(msg, modifiedFlag) - if a:msg !~ 'fullname=' - " a watch or a pending breakpoint does not have a file name - if a:msg =~ 'pending=' - let nr = substitute(a:msg, '.*number=\"\([0-9.]*\)\".*', '\1', '') - let target = substitute(a:msg, '.*pending=\"\([^"]*\)\".*', '\1', '') - echomsg 'Breakpoint ' . nr . ' (' . target . ') pending.' +# Handle setting a breakpoint +# Will update the sign that shows the breakpoint +def HandleNewBreakpoint(msg: string, modifiedFlag: any) + var nr = '' + + if msg !~ 'fullname=' + # a watch or a pending breakpoint does not have a file name + if msg =~ 'pending=' + nr = substitute(msg, '.*number=\"\([0-9.]*\)\".*', '\1', '') + var target = substitute(msg, '.*pending=\"\([^"]*\)\".*', '\1', '') + echomsg 'Breakpoint ' .. nr .. ' (' .. target .. ') pending.' endif return endif - for msg in s:SplitMsg(a:msg) - let fname = s:GetFullname(msg) + + for mm in SplitMsg(msg) + var fname = GetFullname(mm) if empty(fname) continue endif - let nr = substitute(msg, '.*number="\([0-9.]*\)\".*', '\1', '') + nr = substitute(mm, '.*number="\([0-9.]*\)\".*', '\1', '') if empty(nr) return endif - " If "nr" is 123 it becomes "123.0" and subid is "0". - " If "nr" is 123.4 it becomes "123.4.0" and subid is "4"; "0" is discarded. - let [id, subid; _] = map(split(nr . '.0', '\.'), 'v:val + 0') - let enabled = substitute(msg, '.*enabled="\([yn]\)".*', '\1', '') - call s:CreateBreakpoint(id, subid, enabled) + # If "nr" is 123 it becomes "123.0" and subid is "0". + # If "nr" is 123.4 it becomes "123.4.0" and subid is "4"; "0" is discarded. + var [id, subid; _] = map(split(nr .. '.0', '\.'), 'str2nr(v:val) + 0') + # var [id, subid; _] = map(split(nr .. '.0', '\.'), 'v:val + 0') + var enabled = substitute(mm, '.*enabled="\([yn]\)".*', '\1', '') + CreateBreakpoint(id, subid, enabled) - if has_key(s:breakpoints, id) - let entries = s:breakpoints[id] + var entries = {} + var entry = {} + if has_key(breakpoints, id) + entries = breakpoints[id] else - let entries = {} - let s:breakpoints[id] = entries + breakpoints[id] = entries endif if has_key(entries, subid) - let entry = entries[subid] + entry = entries[subid] else - let entry = {} - let entries[subid] = entry + entries[subid] = entry endif - let lnum = substitute(msg, '.*line="\([^"]*\)".*', '\1', '') - let entry['fname'] = fname - let entry['lnum'] = lnum + var lnum = str2nr(substitute(mm, '.*line="\([^"]*\)".*', '\1', '')) + entry['fname'] = fname + entry['lnum'] = lnum - let bploc = printf('%s:%d', fname, lnum) - if !has_key(s:breakpoint_locations, bploc) - let s:breakpoint_locations[bploc] = [] + var bploc = printf('%s:%d', fname, lnum) + if !has_key(breakpoint_locations, bploc) + breakpoint_locations[bploc] = [] endif - let s:breakpoint_locations[bploc] += [id] + breakpoint_locations[bploc] += [id] + var posMsg = '' if bufloaded(fname) - call s:PlaceSign(id, subid, entry) - let posMsg = ' at line ' . lnum . '.' + PlaceSign(id, subid, entry) + posMsg = ' at line ' .. lnum .. '.' else - let posMsg = ' in ' . fname . ' at line ' . lnum . '.' + posMsg = ' in ' .. fname .. ' at line ' .. lnum .. '.' endif - if !a:modifiedFlag - let actionTaken = 'created' + var actionTaken = '' + if !modifiedFlag + actionTaken = 'created' elseif enabled == 'n' - let actionTaken = 'disabled' + actionTaken = 'disabled' else - let actionTaken = 'enabled' + actionTaken = 'enabled' endif - echomsg 'Breakpoint ' . nr . ' ' . actionTaken . posMsg + echom 'Breakpoint ' .. nr .. ' ' .. actionTaken .. posMsg endfor -endfunc +enddef + -func s:PlaceSign(id, subid, entry) - let nr = printf('%d.%d', a:id, a:subid) - call sign_place(s:Breakpoint2SignNumber(a:id, a:subid), 'TermDebug', - \ 'debugBreakpoint' .. nr, a:entry['fname'], - \ #{lnum: a:entry['lnum'], priority: 110}) - let a:entry['placed'] = 1 -endfunc +def PlaceSign(id: number, subid: number, entry: dict<any>) + var nr = printf('%d.%d', id, subid) + sign_place(Breakpoint2SignNumber(id, subid), 'TermDebug', + \ 'debugBreakpoint' .. nr, entry['fname'], + \ {'lnum': entry['lnum'], priority: 110}) + entry['placed'] = 1 +enddef -" Handle deleting a breakpoint -" Will remove the sign that shows the breakpoint -func s:HandleBreakpointDelete(msg) - let id = substitute(a:msg, '.*id="\([0-9]*\)\".*', '\1', '') + 0 +# Handle deleting a breakpoint +# Will remove the sign that shows the breakpoint +def HandleBreakpointDelete(msg: string) + var id = substitute(msg, '.*id="\([0-9]*\)\".*', '\1', '') if empty(id) return endif - if has_key(s:breakpoints, id) - for [subid, entry] in items(s:breakpoints[id]) + if has_key(breakpoints, id) + for [subid, entry] in items(breakpoints[id]) if has_key(entry, 'placed') - call sign_unplace('TermDebug', - \ #{id: s:Breakpoint2SignNumber(id, subid)}) - unlet entry['placed'] + sign_unplace('TermDebug', + \ {'id': Breakpoint2SignNumber(str2nr(id), str2nr(subid))}) + remove(entry, 'placed') endif endfor - unlet s:breakpoints[id] - echomsg 'Breakpoint ' . id . ' cleared.' + remove(breakpoints, id) + echomsg 'Breakpoint ' .. id .. ' cleared.' endif -endfunc +enddef -" Handle the debugged program starting to run. -" Will store the process ID in s:pid -func s:HandleProgramRun(msg) - let nr = substitute(a:msg, '.*pid="\([0-9]*\)\".*', '\1', '') + 0 +# Handle the debugged program starting to run. +# Will store the process ID in pid +def HandleProgramRun(msg: string) + var nr = str2nr(substitute(msg, '.*pid="\([0-9]*\)\".*', '\1', '')) if nr == 0 return endif - let s:pid = nr - call ch_log('Detected process ID: ' . s:pid) -endfunc + pid = nr + ch_log('Detected process ID: ' .. pid) +enddef -" Handle a BufRead autocommand event: place any signs. -func s:BufRead() - let fname = expand('<afile>:p') - for [id, entries] in items(s:breakpoints) +# Handle a BufRead autocommand event: place any signs. +def BufRead() + var fname = expand('<afile>:p') + for [id, entries] in items(breakpoints) for [subid, entry] in items(entries) if entry['fname'] == fname - call s:PlaceSign(id, subid, entry) + PlaceSign(id, subid, entry) endif endfor endfor -endfunc +enddef -" Handle a BufUnloaded autocommand event: unplace any signs. -func s:BufUnloaded() - let fname = expand('<afile>:p') - for [id, entries] in items(s:breakpoints) +# Handle a BufUnloaded autocommand event: unplace any signs. +def BufUnloaded() + var fname = expand('<afile>:p') + for [id, entries] in items(breakpoints) for [subid, entry] in items(entries) if entry['fname'] == fname - let entry['placed'] = 0 + entry['placed'] = 0 endif endfor endfor -endfunc - -call s:InitHighlight() -call s:InitAutocmd() +enddef -let &cpo = s:keepcpo -unlet s:keepcpo +InitHighlight() +InitAutocmd() -" vim: sw=2 sts=2 et +# vim: sw=2 sts=2 et