avail/avail.anvil.debugger/AvailDebugger

AvailDebugger

AvailDebugger presents a user interface for debugging Avail fibers. It's associated with a AvailWorkbench. It can be used to explore and experiment with a running Avail program.

The layout is as follows:

┌──────────────────────┬─────────────────────────────────────┐
│                      │                                     │
│ Fibers               │ Stack                               │
│                      │                                     │
├──────┬──────┬─────┬──┴──────┬────────┬─────────┬───────────┤
│ Into │ Over │ Out │ To Line │ Resume │ Restart │ ▢ Capture │
├──────┴──────┴─────┴───────┬─┴────────┴─────────┴───────────┤
│                           │                                │
│ Code                      │  Source                        │
│                           │                                │
├────────────────┬──────────┴────────────────────────────────┤
│                │                                           │
│ Variables      │ Variable Value                            │
│                │                                           │
└────────────────┴───────────────────────────────────────────┘

To trigger the debugger:

Run the workbench
Build Availuator
Run "Command" Run [Breakpoint; Print: “(1 :: integer) + 2”;].

Author

Mark van Gulik

Richard Arriaga

Types

FiberRenderer

class FiberRenderer : DefaultListCellRenderer

Renders entries in the list of fibers.

FrameRenderer

class FrameRenderer : DefaultListCellRenderer

Renders entries in the list of frames (A_Continuations) of a fiber.

Variable

data class Variable(val name: String, val value: AvailObject)

Helper for capturing values and labels for the variables list view.

VariablesRenderer

class VariablesRenderer : DefaultListCellRenderer

Renders variables in the variables list view.

Properties

alwaysOnTop

var alwaysOnTop: Boolean

autoRequestFocus

var autoRequestFocus: Boolean

background

var background: Color

bufferStrategy

val bufferStrategy: BufferStrategy

componentOrientation

var componentOrientation: ComponentOrientation

cursor

var cursor: Cursor

debuggerModel

val debuggerModel: AvailDebuggerModel

The AvailDebuggerModel through which the fibers are controlled.

defaultCloseOperation

@set:BeanProperty(preferred = true, enumerationValues = ["WindowConstants.DO_NOTHING_ON_CLOSE", "WindowConstants.HIDE_ON_CLOSE", "WindowConstants.DISPOSE_ON_CLOSE", "WindowConstants.EXIT_ON_CLOSE"], description = "The frame's default close operation.")

var defaultCloseOperation: Int

dropTarget

var dropTarget: DropTarget

enabled

var enabled: Boolean

focusable

var focusable: Boolean

focusableWindowState

var focusableWindowState: Boolean

focusCycleRoot

var focusCycleRoot: Boolean

focusTraversalKeysEnabled

var focusTraversalKeysEnabled: Boolean

focusTraversalPolicy

var focusTraversalPolicy: FocusTraversalPolicy

focusTraversalPolicyProvider

var focusTraversalPolicyProvider: Boolean

font

var font: Font

foreground

var foreground: Color

height

val height: Int

ignoreRepaint

var ignoreRepaint: Boolean

inputContext

val inputContext: InputContext

locale

var locale: Locale

locationByPlatform

var locationByPlatform: Boolean

maximizedBounds

var maximizedBounds: Rectangle

menuBar

var menuBar: MenuBar

modalExclusionType

var modalExclusionType: Dialog.ModalExclusionType

name

var name: String

opacity

var opacity: Float

parent

val parent: Container

resizable

var resizable: Boolean

runtime

val runtime: AvailRuntime

shape

var shape: Shape

state

override var state: Int

title

var title: String

transferHandler

@set:BeanProperty(hidden = true, description = "Mechanism for transfer of data into the component")

var transferHandler: TransferHandler

type

var type: Window.Type

undecorated

var undecorated: Boolean

valid

val valid: Boolean

visible

var visible: Boolean

warningString

val warningString: String

width

val width: Int

workbench

val workbench: AvailWorkbench

The AvailWorkbench associated with this debugger.

val x: Int

val y: Int

Functions

action

open fun ~~action~~(p0: Event, p1: Any): Boolean

add

open fun add(p0: PopupMenu)

open fun add(p0: Component): Component

open fun add(p0: Component, p1: Any)

open fun add(p0: Component, p1: Int): Component

open fun add(p0: String, p1: Component): Component

open fun add(p0: Component, p1: Any, p2: Int)

addComponentListener

open fun addComponentListener(p0: ComponentListener)

addContainerListener

open fun addContainerListener(p0: ContainerListener)

addFocusListener

open fun addFocusListener(p0: FocusListener)

addHierarchyBoundsListener

open fun addHierarchyBoundsListener(p0: HierarchyBoundsListener)

addHierarchyListener

open fun addHierarchyListener(p0: HierarchyListener)

addInputMethodListener

open fun addInputMethodListener(p0: InputMethodListener)

addKeyListener

open fun addKeyListener(p0: KeyListener)

addMouseListener

open fun addMouseListener(p0: MouseListener)

addMouseMotionListener

open fun addMouseMotionListener(p0: MouseMotionListener)

addMouseWheelListener

open fun addMouseWheelListener(p0: MouseWheelListener)

addNotify

open override fun addNotify()

addPropertyChangeListener

open override fun addPropertyChangeListener(p0: PropertyChangeListener)

open override fun addPropertyChangeListener(p0: String, p1: PropertyChangeListener)

addWindowFocusListener

open fun addWindowFocusListener(p0: WindowFocusListener)

addWindowListener

open fun addWindowListener(p0: WindowListener)

addWindowStateListener

open fun addWindowStateListener(p0: WindowStateListener)

applyComponentOrientation

open override fun applyComponentOrientation(p0: ComponentOrientation)

applyResourceBundle

open fun ~~applyResourceBundle~~(p0: ResourceBundle)

open fun ~~applyResourceBundle~~(p0: String)

areFocusTraversalKeysSet

open override fun areFocusTraversalKeysSet(p0: Int): Boolean

bounds

open fun ~~bounds~~(): Rectangle

changeCodeFont

fun changeCodeFont(name: String, updatedSize: Float)

Change the font to the provided font name and size.

checkImage

open fun checkImage(p0: Image, p1: ImageObserver): Int

open fun checkImage(p0: Image, p1: Int, p2: Int, p3: ImageObserver): Int

contains

open operator fun contains(p0: Point): Boolean

open fun contains(p0: Int, p1: Int): Boolean

countComponents

open fun ~~countComponents~~(): Int

createBufferStrategy

open override fun createBufferStrategy(p0: Int)

open override fun createBufferStrategy(p0: Int, p1: BufferCapabilities)

createImage

open fun createImage(p0: ImageProducer): Image

open fun createImage(p0: Int, p1: Int): Image

createVolatileImage

open fun createVolatileImage(p0: Int, p1: Int): VolatileImage

open fun createVolatileImage(p0: Int, p1: Int, p2: ImageCapabilities): VolatileImage

deliverEvent

open override fun ~~deliverEvent~~(p0: Event)

disable

open fun ~~disable~~()

dispatchEvent

fun dispatchEvent(p0: AWTEvent)

dispose

open fun dispose()

doLayout

open override fun doLayout()

enable

open fun ~~enable~~()

open fun ~~enable~~(p0: Boolean)

enableInputMethods

open fun enableInputMethods(p0: Boolean)

findComponentAt

open fun findComponentAt(p0: Point): Component

open fun findComponentAt(p0: Int, p1: Int): Component

firePropertyChange

open fun firePropertyChange(p0: String, p1: Byte, p2: Byte)

open fun firePropertyChange(p0: String, p1: Char, p2: Char)

open fun firePropertyChange(p0: String, p1: Double, p2: Double)

open fun firePropertyChange(p0: String, p1: Float, p2: Float)

open fun firePropertyChange(p0: String, p1: Long, p2: Long)

open fun firePropertyChange(p0: String, p1: Short, p2: Short)

gatherFibers

fun gatherFibers(fibersProvider: () -> Collection<A_Fiber>)

For every existing fiber that isn't already captured by another debugger, capture that fiber with this debugger. Those fibers are not permitted to run unless this debugger says they may. Any fibers launched after this point (say, to compute a print representation or evaluate an expression) will not be captured by this debugger.

getAccessibleContext

open override fun getAccessibleContext(): AccessibleContext

getAlignmentX

open override fun getAlignmentX(): Float

getAlignmentY

open override fun getAlignmentY(): Float

getBaseline