bugstalker 0.4.5

BugStalker is a modern and lightweight debugger for rust applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

import time
import unittest
import pexpect
from helper import Debugger


class MultithreadTestCase(unittest.TestCase):
    def setUp(self):
        self.debugger = Debugger(path='./examples/target/debug/mt')

    def test_multithreaded_app_running(self):
        """Multithread debugee executing"""
        self.debugger.cmd(
            'run',
            'thread 1 spawn',
            'thread 2 spawn',
            'sum2: 199990000',
            'sum1: 49995000',
            'total 249985000',
        )

    def test_multithreaded_breakpoints(self):
        """Multithread debugee breakpoints"""
        # set breakpoint at program start
        self.debugger.cmd('break mt.rs:6', 'New breakpoint')
        # set breakpoints at thread 1 code
        self.debugger.cmd('break mt.rs:24', 'New breakpoint')
        # set breakpoint at thread 2 code
        self.debugger.cmd('break mt.rs:36', 'New breakpoint')
        # set breakpoint at program ends
        self.debugger.cmd('break mt.rs:14', 'New breakpoint')

        self.debugger.cmd('run', 'Hit breakpoint 1 at', '6     let jh1 = thread::spawn(sum1);')
        self.debugger.cmd(
            'continue',
            'thread 1 spawn',
            'thread 2 spawn',
            'Hit breakpoint 3 at',
            '36     let mut sum2 = 0;',
        )
        self.debugger.cmd('continue', 'Hit breakpoint 2 at', '24     let mut sum = 0;')
        self.debugger.cmd('continue', 'Hit breakpoint 4 at', '14     println!("total {}", sum1 + sum2);')
        self.debugger.cmd('continue', 'total 249985000')

    def test_multithreaded_backtrace(self):
        """Backtrace command for multithread debugee"""
        self.debugger.cmd('break mt.rs:24', 'New breakpoint')
        self.debugger.cmd('run', 'thread 1 spawn', 'Hit breakpoint 1 at', '24     let mut sum = 0;')
        self.debugger.cmd('backtrace', 'mt::sum1', 'new::thread_start')

    def test_multithreaded_trace(self):
        """Trace command for multithread debugee"""
        self.debugger.cmd('break mt.rs:36', 'New breakpoint')
        self.debugger.cmd('run', 'Hit breakpoint 1 at', '36     let mut sum2 = 0;')
        self.debugger.cmd(
            'backtrace all',
            'thread',
            'mt::main',
            'thread',
            'clock_nanosleep',
            'thread',
            'mt::sum2',
        )

    def test_multithreaded_quit(self):
        """Quit command for multithread debugee"""
        self.debugger.cmd('break mt.rs:36', 'New breakpoint')
        self.debugger.cmd('run', 'Hit breakpoint 1 at', '36     let mut sum2 = 0;')
        self.debugger.cmd('quit')
        time.sleep(2)
        self.assertFalse(self.debugger.is_alive())

    def test_thread_info(self):
        """Thread info/current command for multithread debugee"""
        self.debugger.cmd('break mt.rs:40', 'New breakpoint')
        self.debugger.cmd('run', 'Hit breakpoint 1 at')
        self.debugger.cmd('thread info', '#1 thread id', '#2 thread id', '#3 thread id')
        self.debugger.cmd('thread current', '#3 thread id')

    def test_thread_switch(self):
        """Trace switch command for multithread debugee"""
        self.debugger.cmd('break mt.rs:40', 'New breakpoint')
        self.debugger.cmd('run', 'Hit breakpoint 1 at')
        self.debugger.cmd('thread current', '#3 thread id')
        # switch to another thread
        self.debugger.cmd('thread switch 2', 'Thread #2 brought into focus')
        self.debugger.cmd('thread current', '#2 thread id')

        while True:
            try:
                self.debugger.expect_in_output('24     let mut sum = 0;', timeout=1)
            except pexpect.ExceptionPexpect:
                self.debugger.cmd('step')
            else:
                break

        self.debugger.cmd('step', '25     for i in 0..10000')
        # try to view variables from a new in-focus thread
        self.debugger.cmd('var locals', 'sum = i32(0)')

    def test_thread_switch_frame_switch(self):
        """Trace switch and frame switch command for multithread debugee"""
        self.debugger.cmd('break mt.rs:40', 'New breakpoint')
        self.debugger.cmd('run', 'Hit breakpoint 1 at')
        self.debugger.cmd('thread current', '#3 thread id')
        # switch to another thread
        self.debugger.cmd('thread switch 2', 'Thread #2 brought into focus')
        self.debugger.cmd('thread current', '#2 thread id')
        self.debugger.cmd('frame switch 2', 'switch to #2')
        self.debugger.cmd('var locals', 'sum3_jh = JoinHandle<i32> {')