Class: IRB::ReadlineInputMethod

Inherits:
StdioInputMethod show all
Includes:
HistorySavingAbility
Defined in:
lib/irb/input-method.rb

Constant Summary

Constants inherited from InputMethod

InputMethod::BASIC_WORD_BREAK_CHARACTERS

Instance Attribute Summary

Attributes inherited from InputMethod

#prompt

Class Method Summary collapse

Instance Method Summary collapse

Methods included from HistorySavingAbility

#load_history, #reset_history_counter, #save_history, #support_history_saving?

Methods inherited from StdioInputMethod

#encoding, #line, #readable_after_eof?

Methods inherited from InputMethod

#readable_after_eof?, #support_history_saving?, #winsize

Constructor Details

#initializeReadlineInputMethod

Creates a new input method object using Readline



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
# File 'lib/irb/input-method.rb', line 194

def initialize
  self.class.initialize_readline
  if Readline.respond_to?(:encoding_system_needs)
    IRB.__send__(:set_encoding, Readline.encoding_system_needs.name, override: false)
  end

  super

  @eof = false
  @completor = RegexpCompletor.new

  if Readline.respond_to?("basic_word_break_characters=")
    Readline.basic_word_break_characters = BASIC_WORD_BREAK_CHARACTERS
  end
  Readline.completion_append_character = nil
  Readline.completion_proc = ->(target) {
    bind = IRB.conf[:MAIN_CONTEXT].workspace.binding
    @completor.completion_candidates('', target, '', bind: bind)
  }
end

Class Method Details

.initialize_readlineObject



178
179
180
181
182
183
184
185
186
187
188
# File 'lib/irb/input-method.rb', line 178

def initialize_readline
  return if defined?(self::Readline)

  begin
    require 'readline'
    const_set(:Readline, ::Readline)
  rescue LoadError
    const_set(:Readline, ::Reline)
  end
  const_set(:HISTORY, self::Readline::HISTORY)
end

Instance Method Details

#completion_infoObject



215
216
217
# File 'lib/irb/input-method.rb', line 215

def completion_info
  'RegexpCompletor'
end

#eof?Boolean

Whether the end of this input method has been reached, returns true if there is no more data to read.

See IO#eof? for more information.

Returns:

  • (Boolean)


238
239
240
# File 'lib/irb/input-method.rb', line 238

def eof?
  @eof
end

#getsObject

Reads the next line from this input method.

See IO#gets for more information.



222
223
224
225
226
227
228
229
230
231
232
# File 'lib/irb/input-method.rb', line 222

def gets
  Readline.input = @stdin
  Readline.output = @stdout
  if l = Readline.readline(@prompt, false)
    Readline::HISTORY.push(l) if !l.empty? && l != Readline::HISTORY.to_a.last
    @line[@line_no += 1] = l + "\n"
  else
    @eof = true
    l
  end
end

#inspectObject

For debug message



247
248
249
250
251
252
253
# File 'lib/irb/input-method.rb', line 247

def inspect
  readline_impl = Readline == ::Reline ? 'Reline' : 'ext/readline'
  str = "ReadlineInputMethod with #{readline_impl} #{Readline::VERSION}"
  inputrc_path = File.expand_path(ENV['INPUTRC'] || '~/.inputrc')
  str += " and #{inputrc_path}" if File.exist?(inputrc_path)
  str
end

#prompting?Boolean

Returns:

  • (Boolean)


242
243
244
# File 'lib/irb/input-method.rb', line 242

def prompting?
  true
end