byebug 4.0.5 → 5.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +72 -34
- data/CONTRIBUTING.md +26 -31
- data/README.md +3 -3
- data/lib/byebug/breakpoint.rb +2 -1
- data/lib/byebug/command.rb +27 -49
- data/lib/byebug/commands/break.rb +21 -15
- data/lib/byebug/commands/catch.rb +9 -15
- data/lib/byebug/commands/condition.rb +12 -15
- data/lib/byebug/commands/continue.rb +8 -11
- data/lib/byebug/commands/delete.rb +9 -12
- data/lib/byebug/commands/disable.rb +32 -0
- data/lib/byebug/commands/disable/breakpoints.rb +38 -0
- data/lib/byebug/commands/disable/display.rb +39 -0
- data/lib/byebug/commands/display.rb +18 -51
- data/lib/byebug/commands/down.rb +39 -0
- data/lib/byebug/commands/edit.rb +8 -14
- data/lib/byebug/commands/enable.rb +25 -0
- data/lib/byebug/commands/enable/breakpoints.rb +38 -0
- data/lib/byebug/commands/enable/display.rb +39 -0
- data/lib/byebug/commands/eval.rb +10 -192
- data/lib/byebug/commands/finish.rb +11 -12
- data/lib/byebug/commands/frame.rb +17 -182
- data/lib/byebug/commands/help.rb +18 -18
- data/lib/byebug/commands/history.rb +9 -10
- data/lib/byebug/commands/info.rb +17 -190
- data/lib/byebug/commands/info/args.rb +39 -0
- data/lib/byebug/commands/info/breakpoints.rb +59 -0
- data/lib/byebug/commands/info/catch.rb +39 -0
- data/lib/byebug/commands/info/display.rb +42 -0
- data/lib/byebug/commands/info/file.rb +81 -0
- data/lib/byebug/commands/info/line.rb +31 -0
- data/lib/byebug/commands/info/program.rb +51 -0
- data/lib/byebug/commands/interrupt.rb +5 -9
- data/lib/byebug/commands/irb.rb +5 -9
- data/lib/byebug/commands/kill.rb +6 -12
- data/lib/byebug/commands/list.rb +47 -19
- data/lib/byebug/commands/method.rb +8 -14
- data/lib/byebug/commands/next.rb +36 -0
- data/lib/byebug/commands/pp.rb +41 -0
- data/lib/byebug/commands/pry.rb +5 -9
- data/lib/byebug/commands/ps.rb +44 -0
- data/lib/byebug/commands/putl.rb +43 -0
- data/lib/byebug/commands/quit.rb +8 -12
- data/lib/byebug/commands/restart.rb +6 -12
- data/lib/byebug/commands/save.rb +30 -39
- data/lib/byebug/commands/set.rb +19 -21
- data/lib/byebug/commands/show.rb +10 -16
- data/lib/byebug/commands/source.rb +6 -12
- data/lib/byebug/commands/step.rb +36 -0
- data/lib/byebug/commands/thread.rb +13 -130
- data/lib/byebug/commands/thread/current.rb +35 -0
- data/lib/byebug/commands/thread/list.rb +41 -0
- data/lib/byebug/commands/thread/resume.rb +45 -0
- data/lib/byebug/commands/thread/stop.rb +41 -0
- data/lib/byebug/commands/thread/switch.rb +43 -0
- data/lib/byebug/commands/tracevar.rb +8 -14
- data/lib/byebug/commands/undisplay.rb +12 -15
- data/lib/byebug/commands/untracevar.rb +5 -11
- data/lib/byebug/commands/up.rb +39 -0
- data/lib/byebug/commands/var.rb +15 -94
- data/lib/byebug/commands/var/all.rb +37 -0
- data/lib/byebug/commands/var/const.rb +38 -0
- data/lib/byebug/commands/var/global.rb +33 -0
- data/lib/byebug/commands/var/instance.rb +35 -0
- data/lib/byebug/commands/var/local.rb +35 -0
- data/lib/byebug/commands/where.rb +47 -0
- data/lib/byebug/core.rb +10 -0
- data/lib/byebug/helpers/eval.rb +47 -0
- data/lib/byebug/helpers/file.rb +46 -0
- data/lib/byebug/helpers/frame.rb +76 -0
- data/lib/byebug/helpers/parse.rb +74 -0
- data/lib/byebug/helpers/string.rb +24 -0
- data/lib/byebug/helpers/thread.rb +53 -0
- data/lib/byebug/helpers/toggle.rb +56 -0
- data/lib/byebug/helpers/var.rb +45 -0
- data/lib/byebug/history.rb +2 -4
- data/lib/byebug/interface.rb +5 -3
- data/lib/byebug/interfaces/local_interface.rb +3 -1
- data/lib/byebug/interfaces/remote_interface.rb +3 -1
- data/lib/byebug/interfaces/test_interface.rb +6 -2
- data/lib/byebug/printers/plain.rb +1 -1
- data/lib/byebug/processors/command_processor.rb +9 -11
- data/lib/byebug/processors/control_command_processor.rb +1 -1
- data/lib/byebug/remote.rb +3 -0
- data/lib/byebug/runner.rb +5 -3
- data/lib/byebug/setting.rb +2 -18
- data/lib/byebug/settings/savefile.rb +21 -0
- data/lib/byebug/states/regular_state.rb +15 -6
- data/lib/byebug/subcommand_list.rb +33 -0
- data/lib/byebug/subcommands.rb +53 -0
- data/lib/byebug/version.rb +1 -1
- metadata +45 -6
- data/lib/byebug/commands/enable_disable.rb +0 -132
- data/lib/byebug/commands/stepping.rb +0 -75
- data/lib/byebug/helper.rb +0 -131
@@ -1,132 +0,0 @@
|
|
1
|
-
require 'byebug/command'
|
2
|
-
|
3
|
-
module Byebug
|
4
|
-
#
|
5
|
-
# Mixin to assist command parsing
|
6
|
-
#
|
7
|
-
module EnableDisableFunctions
|
8
|
-
def enable_disable_breakpoints(is_enable, args)
|
9
|
-
return errmsg(pr('toggle.errors.no_breakpoints')) if Breakpoint.none?
|
10
|
-
|
11
|
-
all_breakpoints = Byebug.breakpoints.sort_by(&:id)
|
12
|
-
if args.empty?
|
13
|
-
selected_breakpoints = all_breakpoints
|
14
|
-
else
|
15
|
-
selected_ids = []
|
16
|
-
args.each do |pos|
|
17
|
-
last_id = all_breakpoints.last.id
|
18
|
-
pos, err = get_int(pos, "#{is_enable} breakpoints", 1, last_id)
|
19
|
-
return errmsg(err) unless pos
|
20
|
-
|
21
|
-
selected_ids << pos
|
22
|
-
end
|
23
|
-
selected_breakpoints = all_breakpoints.select do |b|
|
24
|
-
selected_ids.include?(b.id)
|
25
|
-
end
|
26
|
-
end
|
27
|
-
|
28
|
-
selected_breakpoints.each do |b|
|
29
|
-
enabled = ('enable' == is_enable)
|
30
|
-
if enabled && !syntax_valid?(b.expr)
|
31
|
-
return errmsg(pr('toggle.errors.expression', expr: b.expr))
|
32
|
-
end
|
33
|
-
|
34
|
-
b.enabled = enabled
|
35
|
-
end
|
36
|
-
end
|
37
|
-
|
38
|
-
def enable_disable_display(is_enable, args)
|
39
|
-
return errmsg(pr('toggle.errors.no_display')) if 0 == @state.display.size
|
40
|
-
|
41
|
-
args.each do |pos|
|
42
|
-
pos, err = get_int(pos, "#{is_enable} display", 1, @state.display.size)
|
43
|
-
return errmsg(err) unless err.nil?
|
44
|
-
|
45
|
-
@state.display[pos - 1][0] = ('enable' == is_enable)
|
46
|
-
end
|
47
|
-
end
|
48
|
-
end
|
49
|
-
|
50
|
-
#
|
51
|
-
# Enabling or disabling custom display expressions or breakpoints.
|
52
|
-
#
|
53
|
-
class EnableDisableCommand < Command
|
54
|
-
include EnableDisableFunctions
|
55
|
-
|
56
|
-
Subcommands = [
|
57
|
-
['breakpoints', 2, 'Enable/disable breakpoints. Give breakpoint ' \
|
58
|
-
'numbers (separated by spaces) as arguments or no ' \
|
59
|
-
'argument at all if you want to enable/disable ' \
|
60
|
-
'every breakpoint'],
|
61
|
-
['display', 2, 'Enable/disable some expressions to be displayed when ' \
|
62
|
-
' when program stops. Arguments are the code numbers ' \
|
63
|
-
'of the expressions to resume/stop displaying. Do ' \
|
64
|
-
'"info display" to see the current list of code ' \
|
65
|
-
'numbers']
|
66
|
-
].map do |name, min, help|
|
67
|
-
Subcmd.new(name, min, help)
|
68
|
-
end
|
69
|
-
|
70
|
-
def regexp
|
71
|
-
/^\s* (dis|en)(?:able)? (?:\s+(.+))? \s*$/x
|
72
|
-
end
|
73
|
-
|
74
|
-
def execute
|
75
|
-
cmd = @match[1] == 'dis' ? 'disable' : 'enable'
|
76
|
-
|
77
|
-
return errmsg(pr('toggle.errors.syntax', toggle: cmd)) unless @match[2]
|
78
|
-
|
79
|
-
args = @match[2].split(/ +/)
|
80
|
-
param = args.shift
|
81
|
-
subcmd = Command.find(Subcommands, param)
|
82
|
-
if subcmd
|
83
|
-
send("#{cmd}_#{subcmd.name}", args)
|
84
|
-
else
|
85
|
-
send("#{cmd}_breakpoints", args.unshift(param))
|
86
|
-
end
|
87
|
-
end
|
88
|
-
|
89
|
-
def enable_breakpoints(args)
|
90
|
-
enable_disable_breakpoints('enable', args)
|
91
|
-
end
|
92
|
-
|
93
|
-
def enable_display(args)
|
94
|
-
enable_disable_display('enable', args)
|
95
|
-
end
|
96
|
-
|
97
|
-
def disable_breakpoints(args)
|
98
|
-
enable_disable_breakpoints('disable', args)
|
99
|
-
end
|
100
|
-
|
101
|
-
def disable_display(args)
|
102
|
-
enable_disable_display('disable', args)
|
103
|
-
end
|
104
|
-
|
105
|
-
class << self
|
106
|
-
def names
|
107
|
-
%w((en|dis)able)
|
108
|
-
end
|
109
|
-
|
110
|
-
def description
|
111
|
-
prettify <<-EOD
|
112
|
-
(en|dis)[able][[ (breakpoints|display)][ n1[ n2[ ...[ nn]]]]]
|
113
|
-
|
114
|
-
Enables or disables breakpoints or displays.
|
115
|
-
|
116
|
-
"enable" by itself enables all breakpoints, just like
|
117
|
-
"enable breakpoints". On the other side, "disable" or
|
118
|
-
"disable breakpoints" disable all breakpoints.
|
119
|
-
|
120
|
-
You can also specify a space separated list of breakpoint numbers to
|
121
|
-
enable or disable specific breakpoints. You can use either
|
122
|
-
"enable <id1> ... <idn>" or "enable breakpoints <id1> ... <idn>" and
|
123
|
-
the same with "disable".
|
124
|
-
|
125
|
-
If instead of "breakpoints" you specify "display", the command will
|
126
|
-
work exactly the same way, but displays will get enabled/disabled
|
127
|
-
instead of breakpoints.
|
128
|
-
EOD
|
129
|
-
end
|
130
|
-
end
|
131
|
-
end
|
132
|
-
end
|
@@ -1,75 +0,0 @@
|
|
1
|
-
require 'byebug/command'
|
2
|
-
|
3
|
-
module Byebug
|
4
|
-
#
|
5
|
-
# Implements the next functionality.
|
6
|
-
#
|
7
|
-
# Allows the user the continue execution until the next instruction in the
|
8
|
-
# current frame.
|
9
|
-
#
|
10
|
-
class NextCommand < Command
|
11
|
-
self.allow_in_post_mortem = false
|
12
|
-
|
13
|
-
def regexp
|
14
|
-
/^\s* n(?:ext)? (?:\s+(\S+))? \s*$/x
|
15
|
-
end
|
16
|
-
|
17
|
-
def execute
|
18
|
-
steps, err = parse_steps(@match[1], 'Next')
|
19
|
-
return errmsg(err) unless steps
|
20
|
-
|
21
|
-
@state.context.step_over(steps, @state.frame)
|
22
|
-
@state.proceed
|
23
|
-
end
|
24
|
-
|
25
|
-
class << self
|
26
|
-
def names
|
27
|
-
%w(next)
|
28
|
-
end
|
29
|
-
|
30
|
-
def description
|
31
|
-
prettify <<-EOD
|
32
|
-
n[ext][ nnn]
|
33
|
-
|
34
|
-
Steps over once or nnn times.
|
35
|
-
EOD
|
36
|
-
end
|
37
|
-
end
|
38
|
-
end
|
39
|
-
|
40
|
-
#
|
41
|
-
# Implements the step functionality.
|
42
|
-
#
|
43
|
-
# Allows the user the continue execution until the next instruction, possibily
|
44
|
-
# in a different frame. Use step to step into method calls or blocks.
|
45
|
-
#
|
46
|
-
class StepCommand < Command
|
47
|
-
self.allow_in_post_mortem = false
|
48
|
-
|
49
|
-
def regexp
|
50
|
-
/^\s* s(?:tep)? (?:\s+(\S+))? \s*$/x
|
51
|
-
end
|
52
|
-
|
53
|
-
def execute
|
54
|
-
steps, err = parse_steps(@match[1], 'Steps')
|
55
|
-
return errmsg(err) unless steps
|
56
|
-
|
57
|
-
@state.context.step_into(steps, @state.frame)
|
58
|
-
@state.proceed
|
59
|
-
end
|
60
|
-
|
61
|
-
class << self
|
62
|
-
def names
|
63
|
-
%w(step)
|
64
|
-
end
|
65
|
-
|
66
|
-
def description
|
67
|
-
prettify <<-EOD
|
68
|
-
s[tep][ nnn]
|
69
|
-
|
70
|
-
Steps (into methods) once or nnn times.
|
71
|
-
EOD
|
72
|
-
end
|
73
|
-
end
|
74
|
-
end
|
75
|
-
end
|
data/lib/byebug/helper.rb
DELETED
@@ -1,131 +0,0 @@
|
|
1
|
-
module Byebug
|
2
|
-
#
|
3
|
-
# Utilities for interaction with files
|
4
|
-
#
|
5
|
-
module FileFunctions
|
6
|
-
#
|
7
|
-
# Reads lines of source file +filename+ into an array
|
8
|
-
#
|
9
|
-
def get_lines(filename)
|
10
|
-
File.foreach(filename).reduce([]) { |a, e| a << e.chomp }
|
11
|
-
end
|
12
|
-
|
13
|
-
#
|
14
|
-
# Reads line number +lineno+ from file named +filename+
|
15
|
-
#
|
16
|
-
def get_line(filename, lineno)
|
17
|
-
File.open(filename) do |f|
|
18
|
-
f.gets until f.lineno == lineno - 1
|
19
|
-
f.gets
|
20
|
-
end
|
21
|
-
end
|
22
|
-
|
23
|
-
#
|
24
|
-
# Returns the number of lines in file +filename+ in a portable,
|
25
|
-
# one-line-at-a-time way.
|
26
|
-
#
|
27
|
-
def n_lines(filename)
|
28
|
-
File.foreach(filename).reduce(0) { |a, _e| a + 1 }
|
29
|
-
end
|
30
|
-
|
31
|
-
#
|
32
|
-
# Regularize file name.
|
33
|
-
#
|
34
|
-
def normalize(filename)
|
35
|
-
return filename if ['(irb)', '-e'].include?(filename)
|
36
|
-
|
37
|
-
return File.basename(filename) if Setting[:basename]
|
38
|
-
|
39
|
-
path = File.expand_path(filename)
|
40
|
-
|
41
|
-
File.exist?(path) ? File.realpath(path) : filename
|
42
|
-
end
|
43
|
-
end
|
44
|
-
|
45
|
-
#
|
46
|
-
# Utilities for interaction with files
|
47
|
-
#
|
48
|
-
module StringFunctions
|
49
|
-
#
|
50
|
-
# Converts +str+ from an_underscored-or-dasherized_string to
|
51
|
-
# ACamelizedString.
|
52
|
-
#
|
53
|
-
def camelize(str)
|
54
|
-
str.dup.split(/[_-]/).map(&:capitalize).join('')
|
55
|
-
end
|
56
|
-
|
57
|
-
#
|
58
|
-
# Improves indentation and spacing in +str+ for readability in Byebug's
|
59
|
-
# command prompt.
|
60
|
-
#
|
61
|
-
def prettify(str)
|
62
|
-
"\n" + str.gsub(/^ {8}/, '') + "\n"
|
63
|
-
end
|
64
|
-
end
|
65
|
-
|
66
|
-
#
|
67
|
-
# Utilities to assist command parsing
|
68
|
-
#
|
69
|
-
module ParseFunctions
|
70
|
-
#
|
71
|
-
# Parse 'str' of command 'cmd' as an integer between min and max. If either
|
72
|
-
# min or max is nil, that value has no bound.
|
73
|
-
#
|
74
|
-
def get_int(str, cmd, min = nil, max = nil)
|
75
|
-
if str !~ /\A[0-9]+\z/
|
76
|
-
return nil, pr('parse.errors.int.not_number', cmd: cmd, str: str)
|
77
|
-
end
|
78
|
-
|
79
|
-
int = str.to_i
|
80
|
-
if min && int < min
|
81
|
-
return min, pr('parse.errors.int.too_low', cmd: cmd, str: str, min: min)
|
82
|
-
elsif max && int > max
|
83
|
-
return max, pr('parse.errors.int.too_high',
|
84
|
-
cmd: cmd, str: str, max: max)
|
85
|
-
end
|
86
|
-
|
87
|
-
int
|
88
|
-
end
|
89
|
-
|
90
|
-
#
|
91
|
-
# Returns true if code is syntactically correct for Ruby
|
92
|
-
#
|
93
|
-
def syntax_valid?(code)
|
94
|
-
return true unless code
|
95
|
-
|
96
|
-
without_stderr do
|
97
|
-
begin
|
98
|
-
RubyVM::InstructionSequence.compile(code)
|
99
|
-
true
|
100
|
-
rescue SyntaxError
|
101
|
-
false
|
102
|
-
end
|
103
|
-
end
|
104
|
-
end
|
105
|
-
|
106
|
-
#
|
107
|
-
# Temporarily disable output to $stderr
|
108
|
-
#
|
109
|
-
def without_stderr
|
110
|
-
stderr = $stderr
|
111
|
-
$stderr.reopen(IO::NULL)
|
112
|
-
|
113
|
-
yield
|
114
|
-
ensure
|
115
|
-
$stderr.reopen(stderr)
|
116
|
-
end
|
117
|
-
|
118
|
-
#
|
119
|
-
# Returns the number of steps specified in <str> as an integer or 1 if <str>
|
120
|
-
# is empty.
|
121
|
-
#
|
122
|
-
def parse_steps(str, cmd)
|
123
|
-
return 1 unless str
|
124
|
-
|
125
|
-
steps, err = get_int(str, cmd, 1)
|
126
|
-
return nil, err unless steps
|
127
|
-
|
128
|
-
steps
|
129
|
-
end
|
130
|
-
end
|
131
|
-
end
|