# eric6.Debugger.DebuggerInterfaceNone

Module implementing a dummy debugger interface for the debug server.

### Global Attributes

ClientDefaultCapabilities
ClientTypeAssociations

### Classes

DebuggerInterfaceNone | Class implementing a dummy debugger interface for the debug server.

### Functions

createDebuggerInterfaceNone | Module function to create a debugger interface instance.
getRegistryData | Module function to get characterizing data for the debugger interface.

## DebuggerInterfaceNone

Class implementing a dummy debugger interface for the debug server.

### Derived from

QObject

### Class Attributes

None

### Class Methods

None

### Methods

DebuggerInterfaceNone | Constructor
flush | Public slot to flush the queue.
getClientCapabilities | Public method to retrieve the debug clients capabilities.
isConnected | Public method to test, if a debug client has connected.
newConnection | Public slot to handle a new connection.
remoteBreakpoint | Public method to set or clear a breakpoint.
remoteBreakpointEnable | Public method to enable or disable a breakpoint.
remoteBreakpointIgnore | Public method to ignore a breakpoint the next couple of occurrences.
remoteCapabilities | Public slot to get the debug clients capabilities.
remoteClientSetFilter | Public method to set a variables filter list.
remoteClientVariable | Public method to request the variables of the debugged program.
remoteClientVariables | Public method to request the variables of the debugged program.
remoteCompletion | Public slot to get the a list of possible commandline completions from the remote client.
remoteContinue | Public method to continue the debugged program.
remoteCoverage | Public method to load a new program to collect coverage data.
remoteEnvironment | Public method to set the environment for a program to debug, run, ...
remoteEval | Public method to evaluate arg in the current context of the debugged program.
remoteLoad | Public method to load a new program to debug.
remoteMoveIP | Public method to move the instruction pointer to a different line.
remoteProfile | Public method to load a new program to collect profiling data.
remoteRawInput | Public method to send the raw input to the debugged program.
remoteRun | Public method to load a new program to run.
remoteSetThread | Public method to request to set the given thread as current thread.
remoteStatement | Public method to execute a Python statement.
remoteStep | Public method to single step the debugged program.
remoteStepOut | Public method to step out the debugged program.
remoteStepOver | Public method to step over the debugged program.
remoteStepQuit | Public method to stop the debugged program.
remoteThreadList | Public method to request the list of threads from the client.
remoteUTPrepare | Public method to prepare a new unittest run.
remoteUTRun | Public method to start a unittest run.
remoteUTStop | public method to stop a unittest run.
remoteWatchpoint | Public method to set or clear a watch expression.
remoteWatchpointEnable | Public method to enable or disable a watch expression.
remoteWatchpointIgnore | Public method to ignore a watch expression the next couple of occurrences.
setCallTraceEnabled | Public method to set the call trace state.
shutdown | Public method to cleanly shut down.
startRemote | Public method to start a remote Python interpreter.
startRemoteForProject | Public method to start a remote Python interpreter for a project.

### Static Methods

None

#### DebuggerInterfaceNone (Constructor)

DebuggerInterfaceNone(debugServer, passive)

Constructor

debugServer
  reference to the debug server (DebugServer)
passive
  flag indicating passive connection mode (boolean)

#### DebuggerInterfaceNone.flush

flush()

Public slot to flush the queue.

#### DebuggerInterfaceNone.getClientCapabilities

getClientCapabilities()

Public method to retrieve the debug clients capabilities.

Returns:
  debug client capabilities (integer)

#### DebuggerInterfaceNone.isConnected

isConnected()

Public method to test, if a debug client has connected.

Returns:
  flag indicating the connection status (boolean)

#### DebuggerInterfaceNone.newConnection

newConnection(sock)

Public slot to handle a new connection.

sock
  reference to the socket object (QTcpSocket)

Returns:
  flag indicating success (boolean)

#### DebuggerInterfaceNone.remoteBreakpoint

remoteBreakpoint(fn, line, setBreakpoint, cond=None, temp=False)

Public method to set or clear a breakpoint.

fn
  filename the breakpoint belongs to (string)
line
  linenumber of the breakpoint (int)
setBreakpoint
  flag indicating setting or resetting a breakpoint (boolean)
cond
  condition of the breakpoint (string)
temp
  flag indicating a temporary breakpoint (boolean)

#### DebuggerInterfaceNone.remoteBreakpointEnable

remoteBreakpointEnable(fn, line, enable)

Public method to enable or disable a breakpoint.

fn
  filename the breakpoint belongs to (string)
line
  linenumber of the breakpoint (int)
enable
  flag indicating enabling or disabling a breakpoint (boolean)

#### DebuggerInterfaceNone.remoteBreakpointIgnore

remoteBreakpointIgnore(fn, line, count)

Public method to ignore a breakpoint the next couple of occurrences.

fn
  filename the breakpoint belongs to (string)
line
  linenumber of the breakpoint (int)
count
  number of occurrences to ignore (int)

#### DebuggerInterfaceNone.remoteCapabilities

remoteCapabilities()

Public slot to get the debug clients capabilities.

#### DebuggerInterfaceNone.remoteClientSetFilter

remoteClientSetFilter(scope, filterStr)

Public method to set a variables filter list.

scope
  the scope of the variables (0 = local, 1 = global)
filterStr
  regexp string for variable names to filter out (string)

#### DebuggerInterfaceNone.remoteClientVariable

remoteClientVariable(scope, filterList, var, framenr=0, maxSize=0)

Public method to request the variables of the debugged program.

scope (int)
  the scope of the variables (0 = local, 1 = global)
filterList (list of int)
  list of variable types to filter out
var (list of str)
  list encoded name of variable to retrieve
framenr (int)
  framenumber of the variables to retrieve (int)
maxSize (int)
  maximum size the formatted value of a variable will be shown. If it is bigger than that, a 'too big' indication will be given (@@TOO_BIG_TO_SHOW@@).

#### DebuggerInterfaceNone.remoteClientVariables

remoteClientVariables(scope, filterList, framenr=0, maxSize=0)

Public method to request the variables of the debugged program.

scope (int)
  the scope of the variables (0 = local, 1 = global)
filterList (list of int)
  list of variable types to filter out
framenr (int)
  framenumber of the variables to retrieve
maxSize (int)
  maximum size the formatted value of a variable will be shown. If it is bigger than that, a 'too big' indication will be given (@@TOO_BIG_TO_SHOW@@).

#### DebuggerInterfaceNone.remoteCompletion

remoteCompletion(text)

Public slot to get the a list of possible commandline completions from the remote client.

text
  the text to be completed (string)

#### DebuggerInterfaceNone.remoteContinue

remoteContinue(special=False)

Public method to continue the debugged program.

special
  flag indicating a special continue operation

#### DebuggerInterfaceNone.remoteCoverage

remoteCoverage(fn, argv, wd, erase=False)

Public method to load a new program to collect coverage data.

fn
  the filename to run (string)
argv
  the commandline arguments to pass to the program (string)
wd
  the working directory for the program (string)
erase=
  flag indicating that coverage info should be cleared first (boolean)

#### DebuggerInterfaceNone.remoteEnvironment

remoteEnvironment(env)

Public method to set the environment for a program to debug, run, ...

env
  environment settings (dictionary)

#### DebuggerInterfaceNone.remoteEval

remoteEval(arg)

Public method to evaluate arg in the current context of the debugged program.

arg
  the arguments to evaluate (string)

#### DebuggerInterfaceNone.remoteLoad

remoteLoad(fn, argv, wd, traceInterpreter=False, autoContinue=True, autoFork=False, forkChild=False)

Public method to load a new program to debug.

fn
  the filename to debug (string)
argv
  the commandline arguments to pass to the program (string)
wd
  the working directory for the program (string)
traceInterpreter=
  flag indicating if the interpreter library should be traced as well (boolean)
autoContinue=
  flag indicating, that the debugger should not stop at the first executable line (boolean)
autoFork=
  flag indicating the automatic fork mode (boolean)
forkChild=
  flag indicating to debug the child after forking (boolean)

#### DebuggerInterfaceNone.remoteMoveIP

remoteMoveIP(line)

Public method to move the instruction pointer to a different line.

line
  the new line, where execution should be continued

#### DebuggerInterfaceNone.remoteProfile

remoteProfile(fn, argv, wd, erase=False)

Public method to load a new program to collect profiling data.

fn
  the filename to run (string)
argv
  the commandline arguments to pass to the program (string)
wd
  the working directory for the program (string)
erase=
  flag indicating that timing info should be cleared first (boolean)

#### DebuggerInterfaceNone.remoteRawInput

remoteRawInput(s)

Public method to send the raw input to the debugged program.

s
  the raw input (string)

#### DebuggerInterfaceNone.remoteRun

remoteRun(fn, argv, wd, autoFork=False, forkChild=False)

Public method to load a new program to run.

fn
  the filename to run (string)
argv
  the commandline arguments to pass to the program (string)
wd
  the working directory for the program (string)
autoFork=
  flag indicating the automatic fork mode (boolean)
forkChild=
  flag indicating to debug the child after forking (boolean)

#### DebuggerInterfaceNone.remoteSetThread

remoteSetThread(tid)

Public method to request to set the given thread as current thread.

tid
  id of the thread (integer)

#### DebuggerInterfaceNone.remoteStatement

remoteStatement(stmt)

Public method to execute a Python statement.

stmt
  the Python statement to execute (string). It should not have a trailing newline.

#### DebuggerInterfaceNone.remoteStep

remoteStep()

Public method to single step the debugged program.

#### DebuggerInterfaceNone.remoteStepOut

remoteStepOut()

Public method to step out the debugged program.

#### DebuggerInterfaceNone.remoteStepOver

remoteStepOver()

Public method to step over the debugged program.

#### DebuggerInterfaceNone.remoteStepQuit

remoteStepQuit()

Public method to stop the debugged program.

#### DebuggerInterfaceNone.remoteThreadList

remoteThreadList()

Public method to request the list of threads from the client.

#### DebuggerInterfaceNone.remoteUTPrepare

remoteUTPrepare(fn, tn, tfn, failed, cov, covname, coverase)

Public method to prepare a new unittest run.

fn
  the filename to load (string)
tn
  the testname to load (string)
tfn
  the test function name to load tests from (string)
failed
  list of failed test, if only failed test should be run (list of strings)
cov
  flag indicating collection of coverage data is requested (boolean)
covname
  filename to be used to assemble the coverage caches filename (string)
coverase
  flag indicating erasure of coverage data is requested (boolean)

#### DebuggerInterfaceNone.remoteUTRun

remoteUTRun()

Public method to start a unittest run.

#### DebuggerInterfaceNone.remoteUTStop

remoteUTStop()

public method to stop a unittest run.

#### DebuggerInterfaceNone.remoteWatchpoint

remoteWatchpoint(cond, setWatch, temp=False)

Public method to set or clear a watch expression.

cond
  expression of the watch expression (string)
setWatch
  flag indicating setting or resetting a watch expression (boolean)
temp
  flag indicating a temporary watch expression (boolean)

#### DebuggerInterfaceNone.remoteWatchpointEnable

remoteWatchpointEnable(cond, enable)

Public method to enable or disable a watch expression.

cond
  expression of the watch expression (string)
enable
  flag indicating enabling or disabling a watch expression (boolean)

#### DebuggerInterfaceNone.remoteWatchpointIgnore

remoteWatchpointIgnore(cond, count)

Public method to ignore a watch expression the next couple of occurrences.

cond
  expression of the watch expression (string)
count
  number of occurrences to ignore (int)

#### DebuggerInterfaceNone.setCallTraceEnabled

setCallTraceEnabled(on)

Public method to set the call trace state.

on
  flag indicating to enable the call trace function (boolean)

#### DebuggerInterfaceNone.shutdown

shutdown()

Public method to cleanly shut down.

It closes our socket and shuts down the debug client. (Needed on Win OS)

#### DebuggerInterfaceNone.startRemote

startRemote(port, runInConsole, interpreter)

Public method to start a remote Python interpreter.

port
  port number the debug server is listening on (integer)
runInConsole
  flag indicating to start the debugger in a console window (boolean)
interpreter
  interpreter to be used to execute the remote side (string)

Returns:
  client process object (QProcess), a flag to indicate a network connection (boolean) and the name of the interpreter in case of a local execution (string)

#### DebuggerInterfaceNone.startRemoteForProject

startRemoteForProject(port, runInConsole, interpreter)

Public method to start a remote Python interpreter for a project.

port
  port number the debug server is listening on (integer)
runInConsole
  flag indicating to start the debugger in a console window (boolean)
interpreter
  interpreter to be used to execute the remote side (string)

Returns:
  client process object (QProcess), a flag to indicate a network connection (boolean) and the name of the interpreter in case of a local execution (string)

Up

## createDebuggerInterfaceNone

createDebuggerInterfaceNone(debugServer, passive)

Module function to create a debugger interface instance.

debugServer (DebugServer)
  reference to the debug server
passive (bool)
  flag indicating passive connection mode

Returns:
  instantiated debugger interface

Return Type:
  DebuggerInterfaceNone

Up

## getRegistryData

getRegistryData()

Module function to get characterizing data for the debugger interface.

Returns:
  list of tuples containing the client type, the client capabilities, the client file type associations and a reference to the creation function

Return Type:
  list of tuple of (str, int, list of str, function)

Up