Class: Byebug::ConditionCommand

Inherits:
Command
  • Object
show all
Includes:
Helpers::ParseHelper
Defined in:
lib/byebug/commands/condition.rb

Overview

Implements conditions on breakpoints.

Adds the ability to stop on breakpoints only under certain conditions.

Instance Attribute Summary

Attributes inherited from Command

#processor

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Helpers::ParseHelper

#get_int, #parse_steps, #syntax_valid?

Methods inherited from Command

#arguments, columnize, #context, #frame, help, #initialize, match, to_s

Methods included from Helpers::StringHelper

#camelize, #deindent, #prettify

Constructor Details

This class inherits a constructor from Byebug::Command

Class Method Details

.description ⇒ Object 



19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/byebug/commands/condition.rb', line 19

def self.description
  <<-EOD
    cond[ition] <n>[ expr]

    #{short_description}

    Specify breakpoint number <n> to break only if <expr> is true. <n> is
    an integer and <expr> is an expression to be evaluated whenever
    breakpoint <n> is reached. If no expression is specified, the condition
    is removed.
  EOD
end

.regexp ⇒ Object 



15
16
17
 
# File 'lib/byebug/commands/condition.rb', line 15

def self.regexp
  /^\s* cond(?:ition)? (?:\s+(\d+)(?:\s+(.*))?)? \s*$/x
end

.short_description ⇒ Object 



32
33
34
 
# File 'lib/byebug/commands/condition.rb', line 32

def self.short_description
  'Sets conditions on breakpoints'
end

Instance Method Details

#execute ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/byebug/commands/condition.rb', line 36

def execute
  return puts(help) unless @match[1]

  breakpoints = Byebug.breakpoints.sort_by(&:id)
  return errmsg(pr('condition.errors.no_breakpoints')) if breakpoints.empty?

  pos, err = get_int(@match[1], 'Condition', 1)
  return errmsg(err) if err

  breakpoint = breakpoints.find { |b| b.id == pos }
  return errmsg(pr('break.errors.no_breakpoint')) unless breakpoint

  unless syntax_valid?(@match[2])
    return errmsg(pr('break.errors.not_changed', expr: @match[2]))
  end

  breakpoint.expr = @match[2]
end