class Byebug::FinishCommand

def description
  %{fin[ish][ n_frames]\tExecute until frame returns.
    If no number is given, we run until the current frame returns. If a
    number of frames `n_frames` is given, then we run until `n_frames`
    return from the current position.}
end

def execute
  max_frames = Context.stack_size - @state.frame_pos
  n_frames = get_int(@match[1], 'finish', 0, max_frames - 1, 1)
  return nil unless n_frames
  force = n_frames == 0 ? true : false
  @state.context.step_out(@state.frame_pos + n_frames, force)
  @state.frame_pos = 0
  @state.proceed
end

def names
  %w(finish)
end

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