class Byebug::FinishCommand

def description
  %{
    fin[ish][ frame-number]\tExecute until selected stack frame returns.
    If no frame number is given, we run until the currently selected frame
    returns. The currently selected frame starts out the most-recent frame
    or 0 if no frame positioning (e.g "up", "down" or "frame") has been
    performed.
    If a frame number is given we run until that frame returns.
  }
end

def execute
  max_frame = @state.context.stack_size - @state.frame_pos
  if !@match[1] or @match[1].empty?
    frame_pos = @state.frame_pos
  else
    frame_pos = get_int(@match[1], "Finish", 0, max_frame-1, 0)
    return nil unless frame_pos
  end
  @state.context.step_out frame_pos
  @state.frame_pos = 0
  @state.proceed
end

def names
  %w(finish)
end

def regexp
  /^\s*fin(?:ish)? (?:\s+(.*))?$/x
end