Debug Tools in CLOG and CLOG Builder

[rabbibotton]

CLOG-GUI APIs
(no need to use CLOG Builder, works with non-CLOG aps using the clog-repl)

1. Break

clog-gui:clog-break (&key clog-body run (modal t))

"Stop execution, funcall RUN with CLOG-BODY if set, if run returns :continue,
the execution continues. If CLOG-BODY not set use clog-debug-instance. Then
confirm continue execution on current thread or (break)."

Use with (clog-repl :use-clog-debugger t) when not using the CLOG Builder for dev,
opens a blank page where dialogs will pop etc. for debug. Your application does not need to
be a CLOG app.

2. Probe

clog-gui:clog-probe (symbol &key clog-body
                                  (title "")
                                  (time-out 600)
                                  top left
                                  (width 400) (height 300)
                                  auto-probe
                                  (modal t))

"Pause thread of execution for time-out numnber of seconds or nil to not
block execution, display symbol's value, value is changed if OK pressed at
the moment pressed. When time-out is nil, :q quits the probe and cancel
repeats the probe with out changing value. When time-out is nil modal is
always nil. If auto-probe is set, modal and time-out is set to nil and the
probe is run again in auto-probe seconds. If not tile is set, the symbol is
used for title."

Use with (clog-repl :use-clog-debugger t) when not using the CLOG Builder for dev,
opens a blank page where dialogs will pop etc. for debug. Your application does not need to
be a CLOG app.

3. Debugger

clog-gui:with-clog-debugger ((clog-obj &key title
                                             standard-output
                                             standard-input)
                              &body body)

"BODY uses a clog-gui based debugger instead of the emacs or text console"

If there is desire to use this in non CLOG-GUI apps you would use (clog-repl :use-clog-debugger t) once the clog-repl window is open can then pass clog-user:body as clog-obj

When using CLOG-GUI for your applications you can use clog-gui-initialize use-clog-debugger and this is setup for the on-new-window thread and every CLOG event thread on that connection.

CLOG Builder APIs and Features
(works with non-CLOG apps, all debug info shows on the Builder also for CLOG-GUI APIs)

1. Probes in Builder

clog-tools:clog-builder-probe (symbol &key clog-body
                                          (title "")
                                          auto-probe)

"Display symbol's value in Probe Panel in Builder, value is changed when OK
pressed. Probe again in auto-probe seconds. If no tile is set, the symbol is
used for title."

2. The CLOG Probe Panel

You add symbols/objects (including local symbols and dynamic symbols in a given thread) using clog-builder-probe.

Once in the panel, you can refresh the probe, change the symbols value (if an actual symbol local or dynamic
was used added), remove, stop auto-probing if was set and run and of the installed Inspectors.

3. Default Inspector - print, console inspector (sbcl, ccl, ecl - their built in inspector), emacs slime inspector

4. Custom Inspectors - many in the works ;)

clog-tools:add-inspector (name func)
  "Add a custom inspector with NAME and (FUNC object title value clog-obj)"

7. Example installing the clog-modable-inspector from Konrad Hinsen

(use UltraLisp or clone both https://codeberg.org/khinsen/clog-moldable-inspector and https://codeberg.org/khinsen/html-inspector-views )

CL-USER> (ql:quickload :clog-moldable-inspector/tools)
To load "clog-moldable-inspector/tools":
clog-moldable-inspector/tools
; Loading "clog-moldable-inspector/tools"
..................................................
[package clog-moldable-inspector]....
(:CLOG-MOLDABLE-INSPECTOR/TOOLS)
CL-USER> (clog-tools:clog-builder)

[rabbibotton]

New CLOG Object Scope (launched as inspector or use the menu and type form to evaluate to an object)