Class: IRB::Context

Inherits:
Object show all
Defined in:
lib/irb/context.rb,
lib/irb/ext/change-ws.rb,
lib/irb/ext/use-loader.rb,
lib/irb/ext/workspaces.rb,
lib/irb/ext/eval_history.rb

Overview

:nodoc:

Constant Summary collapse

KERNEL_PUBLIC_METHOD =
::Kernel.instance_method(:public_method)
KERNEL_METHOD =
::Kernel.instance_method(:method)
ASSIGN_OPERATORS_REGEXP =
Regexp.union(%w[= += -= *= /= %= **= &= |= &&= ||= ^= <<= >>=])
NOPRINTING_IVARS =

:nodoc:

["@last_value"]
NO_INSPECTING_IVARS =

:nodoc:

["@irb", "@io"]
IDNAME_IVARS =

:nodoc:

["@prompt_mode"]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(irb, workspace = nil, input_method = nil) ⇒ Context

Creates a new IRB context.

The optional input_method argument:

nil

uses stdin or Reline or Readline

String

uses a File

other

uses this as InputMethod


27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
# File 'lib/irb/context.rb', line 27

def initialize(irb, workspace = nil, input_method = nil)
  @irb = irb
  @workspace_stack = []
  if workspace
    @workspace_stack << workspace
  else
    @workspace_stack << WorkSpace.new
  end
  @thread = Thread.current

  # copy of default configuration
  @ap_name = IRB.conf[:AP_NAME]
  @rc = IRB.conf[:RC]
  @load_modules = IRB.conf[:LOAD_MODULES]

  if IRB.conf.has_key?(:USE_SINGLELINE)
    @use_singleline = IRB.conf[:USE_SINGLELINE]
  elsif IRB.conf.has_key?(:USE_READLINE) # backward compatibility
    @use_singleline = IRB.conf[:USE_READLINE]
  else
    @use_singleline = nil
  end
  if IRB.conf.has_key?(:USE_MULTILINE)
    @use_multiline = IRB.conf[:USE_MULTILINE]
  elsif IRB.conf.has_key?(:USE_RELINE) # backward compatibility
    warn <<~MSG.strip
      USE_RELINE is deprecated, please use USE_MULTILINE instead.
    MSG
    @use_multiline = IRB.conf[:USE_RELINE]
  elsif IRB.conf.has_key?(:USE_REIDLINE)
    warn <<~MSG.strip
      USE_REIDLINE is deprecated, please use USE_MULTILINE instead.
    MSG
    @use_multiline = IRB.conf[:USE_REIDLINE]
  else
    @use_multiline = nil
  end
  @use_autocomplete = IRB.conf[:USE_AUTOCOMPLETE]
  @verbose = IRB.conf[:VERBOSE]
  @io = nil

  self.inspect_mode = IRB.conf[:INSPECT_MODE]
  self.use_tracer = IRB.conf[:USE_TRACER]
  self.use_loader = IRB.conf[:USE_LOADER] if IRB.conf[:USE_LOADER]
  self.eval_history = IRB.conf[:EVAL_HISTORY] if IRB.conf[:EVAL_HISTORY]

  @ignore_sigint = IRB.conf[:IGNORE_SIGINT]
  @ignore_eof = IRB.conf[:IGNORE_EOF]

  @back_trace_limit = IRB.conf[:BACK_TRACE_LIMIT]

  self.prompt_mode = IRB.conf[:PROMPT_MODE]

  @irb_name = IRB.conf[:IRB_NAME]

  unless IRB.conf[:SINGLE_IRB] or !defined?(IRB::JobManager)
    @irb_name = @irb_name + "#" + IRB.JobManager.n_jobs.to_s
  end

  self.irb_path = "(" + @irb_name + ")"

  case input_method
  when nil
    @io = nil
    case use_multiline?
    when nil
      if term_interactive? && IRB.conf[:PROMPT_MODE] != :INF_RUBY && !use_singleline?
        # Both of multiline mode and singleline mode aren't specified.
        @io = RelineInputMethod.new(build_completor)
      else
        @io = nil
      end
    when false
      @io = nil
    when true
      @io = RelineInputMethod.new(build_completor)
    end
    unless @io
      case use_singleline?
      when nil
        if (defined?(ReadlineInputMethod) && term_interactive? &&
            IRB.conf[:PROMPT_MODE] != :INF_RUBY)
          @io = ReadlineInputMethod.new
        else
          @io = nil
        end
      when false
        @io = nil
      when true
        if defined?(ReadlineInputMethod)
          @io = ReadlineInputMethod.new
        else
          @io = nil
        end
      else
        @io = nil
      end
    end
    @io = StdioInputMethod.new unless @io

  when '-'
    @io = FileInputMethod.new($stdin)
    @irb_name = '-'
    self.irb_path = '-'
  when String
    @io = FileInputMethod.new(input_method)
    @irb_name = File.basename(input_method)
    self.irb_path = input_method
  else
    @io = input_method
  end
  @extra_doc_dirs = IRB.conf[:EXTRA_DOC_DIRS]

  @echo = IRB.conf[:ECHO]
  if @echo.nil?
    @echo = true
  end

  @echo_on_assignment = IRB.conf[:ECHO_ON_ASSIGNMENT]
  if @echo_on_assignment.nil?
    @echo_on_assignment = :truncate
  end

  @newline_before_multiline_output = IRB.conf[:NEWLINE_BEFORE_MULTILINE_OUTPUT]
  if @newline_before_multiline_output.nil?
    @newline_before_multiline_output = true
  end

  @command_aliases = IRB.conf[:COMMAND_ALIASES].dup
end

Instance Attribute Details

#ap_nameObject

A copy of the default IRB.conf[:AP_NAME]


223
224
225
# File 'lib/irb/context.rb', line 223

def ap_name
  @ap_name
end

#auto_indent_modeObject

Can be either the default IRB.conf[:AUTO_INDENT], or the mode set by #prompt_mode=

To disable auto-indentation in irb:

IRB.conf[:AUTO_INDENT] = false

or

irb_context.auto_indent_mode = false

or

IRB.CurrentContext.auto_indent_mode = false

See IRB@Configuration for more information.


313
314
315
# File 'lib/irb/context.rb', line 313

def auto_indent_mode
  @auto_indent_mode
end

#back_trace_limitObject

The limit of backtrace lines displayed as top n and tail n.

The default value is 16.

Can also be set using the --back-trace-limit command line option.


404
405
406
# File 'lib/irb/context.rb', line 404

def back_trace_limit
  @back_trace_limit
end

#command_aliasesObject

User-defined IRB command aliases


407
408
409
# File 'lib/irb/context.rb', line 407

def command_aliases
  @command_aliases
end

#echoObject Also known as: echo?

Whether to echo the return value to output or not.

Uses IRB.conf[:ECHO] if available, or defaults to true.

puts "hello"
# hello
#=> nil
IRB.CurrentContext.echo = false
puts "omg"
# omg

344
345
346
# File 'lib/irb/context.rb', line 344

def echo
  @echo
end

#echo_on_assignmentObject Also known as: echo_on_assignment?

Whether to echo for assignment expressions.

If set to false, the value of assignment will not be shown.

If set to true, the value of assignment will be shown.

If set to :truncate, the value of assignment will be shown and truncated.

It defaults to :truncate.

a = "omg"
#=> omg

a = "omg" * 10
#=> omgomgomgomgomgomgomg...

IRB.CurrentContext.echo_on_assignment = false
a = "omg"

IRB.CurrentContext.echo_on_assignment = true
a = "omg" * 10
#=> omgomgomgomgomgomgomgomgomgomg

To set the behaviour of showing on assignment in irb:

IRB.conf[:ECHO_ON_ASSIGNMENT] = :truncate or true or false

or

irb_context.echo_on_assignment = :truncate or true or false

or

IRB.CurrentContext.echo_on_assignment = :truncate or true or false

379
380
381
# File 'lib/irb/context.rb', line 379

def echo_on_assignment
  @echo_on_assignment
end

#eval_historyObject

The command result history limit. This method is not available until #eval_history= was called with non-nil value (directly or via setting IRB.conf[:EVAL_HISTORY] in .irbrc).


31
32
33
# File 'lib/irb/ext/eval_history.rb', line 31

def eval_history
  @eval_history
end

#extra_doc_dirsObject

Specify the installation locations of the ri file to be displayed in the document dialog.


333
334
335
# File 'lib/irb/context.rb', line 333

def extra_doc_dirs
  @extra_doc_dirs
end

#ignore_eofObject Also known as: ignore_eof?

Whether ^D (control-d) will be ignored or not.

If set to false, ^D will quit irb.


330
331
332
# File 'lib/irb/context.rb', line 330

def ignore_eof
  @ignore_eof
end

#ignore_sigintObject Also known as: ignore_sigint?

Whether ^C (control-c) will be ignored or not.

If set to false, ^C will quit irb.

If set to true,

  • during input: cancel input then return to top level.

  • during execute: abandon current execution.


326
327
328
# File 'lib/irb/context.rb', line 326

def ignore_sigint
  @ignore_sigint
end

#inspect_methodObject (readonly)

Inspector for the current context


268
269
270
# File 'lib/irb/context.rb', line 268

def inspect_method
  @inspect_method
end

#inspect_modeObject

A copy of the default IRB.conf[:INSPECT_MODE]


266
267
268
# File 'lib/irb/context.rb', line 266

def inspect_mode
  @inspect_mode
end

#ioObject

The current input method.

Can be either StdioInputMethod, ReadlineInputMethod, RelineInputMethod, FileInputMethod or other specified when the context is created. See ::new for more # information on input_method.


218
219
220
# File 'lib/irb/context.rb', line 218

def io
  @io
end

#irbObject

Current irb session.


221
222
223
# File 'lib/irb/context.rb', line 221

def irb
  @irb
end

#irb_nameObject

Can be either name from IRB.conf[:IRB_NAME], or the number of the current job set by JobManager, such as irb#2


230
231
232
# File 'lib/irb/context.rb', line 230

def irb_name
  @irb_name
end

#irb_pathObject

Can be one of the following:

  • the #irb_name surrounded by parenthesis

  • the input_method passed to Context.new

  • the file path of the current IRB context in a binding.irb session


236
237
238
# File 'lib/irb/context.rb', line 236

def irb_path
  @irb_path
end

#last_valueObject (readonly)

The return value of the last statement evaluated.


458
459
460
# File 'lib/irb/context.rb', line 458

def last_value
  @last_value
end

#load_modulesObject

A copy of the default IRB.conf[:LOAD_MODULES]


227
228
229
# File 'lib/irb/context.rb', line 227

def load_modules
  @load_modules
end

#newline_before_multiline_outputObject Also known as: newline_before_multiline_output?

Whether a newline is put before multiline output.

Uses IRB.conf[:NEWLINE_BEFORE_MULTILINE_OUTPUT] if available, or defaults to true.

"abc\ndef"
#=>
abc
def
IRB.CurrentContext.newline_before_multiline_output = false
"abc\ndef"
#=> abc
def

393
394
395
# File 'lib/irb/context.rb', line 393

def newline_before_multiline_output
  @newline_before_multiline_output
end

#prompt_cObject

IRB prompt for continuated statement. (e.g. immediately after an if)

See Custom Prompts for more information.


283
284
285
# File 'lib/irb/context.rb', line 283

def prompt_c
  @prompt_c
end

#prompt_iObject

Standard IRB prompt.

See Custom Prompts for more information.


275
276
277
# File 'lib/irb/context.rb', line 275

def prompt_i
  @prompt_i
end

#prompt_modeObject

A copy of the default IRB.conf[:PROMPT_MODE]


271
272
273
# File 'lib/irb/context.rb', line 271

def prompt_mode
  @prompt_mode
end

#prompt_sObject

IRB prompt for continuated strings.

See Custom Prompts for more information.


279
280
281
# File 'lib/irb/context.rb', line 279

def prompt_s
  @prompt_s
end

#rcObject Also known as: rc?

A copy of the default IRB.conf[:RC]


225
226
227
# File 'lib/irb/context.rb', line 225

def rc
  @rc
end

#return_formatObject

The format of the return statement, set by #prompt_mode= using the :RETURN of the mode passed to set the current #prompt_mode.


316
317
318
# File 'lib/irb/context.rb', line 316

def return_format
  @return_format
end

#threadObject (readonly)

The current thread in this context.


212
213
214
# File 'lib/irb/context.rb', line 212

def thread
  @thread
end

#use_autocompleteObject (readonly) Also known as: use_autocomplete?

Whether colorization is enabled or not.

A copy of the default IRB.conf[:USE_AUTOCOMPLETE]


264
265
266
# File 'lib/irb/context.rb', line 264

def use_autocomplete
  @use_autocomplete
end

#use_multilineObject (readonly) Also known as: use_multiline?, use_reline, use_reline?

Whether multiline editor mode is enabled or not.

A copy of the default IRB.conf[:USE_MULTILINE]


256
257
258
# File 'lib/irb/context.rb', line 256

def use_multiline
  @use_multiline
end

#use_singlelineObject (readonly) Also known as: use_singleline?, use_readline, use_readline?

Whether singleline editor mode is enabled or not.

A copy of the default IRB.conf[:USE_SINGLELINE]


260
261
262
# File 'lib/irb/context.rb', line 260

def use_singleline
  @use_singleline
end

#verboseObject

Whether verbose messages are displayed or not.

A copy of the default IRB.conf[:VERBOSE]


397
398
399
# File 'lib/irb/context.rb', line 397

def verbose
  @verbose
end

#with_debuggerObject

Returns the value of attribute with_debugger.


409
410
411
# File 'lib/irb/context.rb', line 409

def with_debugger
  @with_debugger
end

#workspace_homeObject (readonly)

The toplevel workspace, see #home_workspace


210
211
212
# File 'lib/irb/context.rb', line 210

def workspace_home
  @workspace_home
end

Instance Method Details

#__inspect__Object


673
# File 'lib/irb/context.rb', line 673

alias __inspect__ inspect

#_set_last_valueObject

Sets the return value from the last statement evaluated in this context to #last_value. See #set_last_value


14
15
16
17
# File 'lib/irb/ext/eval_history.rb', line 14

def set_last_value(value)
  @last_value = value
  workspace.local_variable_set :_, value
end

#change_workspace(*_main) ⇒ Object

Changes the current workspace to given object or binding.

If the optional argument is omitted, the workspace will be #home_workspace which is inherited from TOPLEVEL_BINDING or the main object, IRB.conf[:MAIN_CONTEXT] when irb was initialized.

See IRB::WorkSpace.new for more information.


26
27
28
29
30
31
32
33
34
35
# File 'lib/irb/ext/change-ws.rb', line 26

def change_workspace(*_main)
  if _main.empty?
    replace_workspace(home_workspace)
    return main
  end

  workspace = WorkSpace.new(_main[0])
  replace_workspace(workspace)
  workspace.load_helper_methods_to_main
end

#colorize_input(input, complete:) ⇒ Object


645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
# File 'lib/irb/context.rb', line 645

def colorize_input(input, complete:)
  if IRB.conf[:USE_COLORIZE] && IRB::Color.colorable?
    lvars = local_variables || []
    parsed_input = parse_input(input, false)
    if parsed_input.is_a?(Statement::Command)
      name, sep, arg = input.split(/(\s+)/, 2)
      arg = IRB::Color.colorize_code(arg, complete: complete, local_variables: lvars)
      "#{IRB::Color.colorize(name, [:BOLD])}\e[m#{sep}#{arg}"
    else
      IRB::Color.colorize_code(input, complete: complete, local_variables: lvars)
    end
  else
    Reline::Unicode.escape_for_print(input)
  end
end

#evaluate(statement, line_no) ⇒ Object

:nodoc:


550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
# File 'lib/irb/context.rb', line 550

def evaluate(statement, line_no) # :nodoc:
  @line_no = line_no

  case statement
  when Statement::EmptyInput
    return
  when Statement::Expression
    result = evaluate_expression(statement.code, line_no)
    set_last_value(result)
  when Statement::Command
    statement.command_class.execute(self, statement.arg)
  when Statement::IncorrectAlias
    warn statement.message
  end

  nil
end

#evaluate_expression(code, line_no) ⇒ Object

:nodoc:


572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
# File 'lib/irb/context.rb', line 572

def evaluate_expression(code, line_no) # :nodoc:
  result = nil
  if IRB.conf[:MEASURE] && IRB.conf[:MEASURE_CALLBACKS].empty?
    IRB.set_measure_callback
  end

  if IRB.conf[:MEASURE] && !IRB.conf[:MEASURE_CALLBACKS].empty?
    last_proc = proc do
      result = workspace.evaluate(code, @eval_path, line_no)
    end
    IRB.conf[:MEASURE_CALLBACKS].inject(last_proc) do |chain, item|
      _name, callback, arg = item
      proc do
        callback.(self, code, line_no, arg) do
          chain.call
        end
      end
    end.call
  else
    result = workspace.evaluate(code, @eval_path, line_no)
  end
  result
end

#file_input?Boolean

Whether #io uses a File for the input_method passed when creating the current context, see ::new

Returns:

  • (Boolean)

492
493
494
# File 'lib/irb/context.rb', line 492

def file_input?
  @io.class == FileInputMethod
end

#from_binding?Boolean

Returns:

  • (Boolean)

568
569
570
# File 'lib/irb/context.rb', line 568

def from_binding?
  @irb.from_binding
end

#history_fileObject

A copy of the default IRB.conf[:HISTORY_FILE]


184
185
186
# File 'lib/irb/context.rb', line 184

def history_file
  IRB.conf[:HISTORY_FILE]
end

#history_file=(hist) ⇒ Object

Set IRB.conf[:HISTORY_FILE] to the given hist.


189
190
191
# File 'lib/irb/context.rb', line 189

def history_file=(hist)
  IRB.conf[:HISTORY_FILE] = hist
end

#home_workspaceObject

Inherited from TOPLEVEL_BINDING.


11
12
13
14
15
16
17
# File 'lib/irb/ext/change-ws.rb', line 11

def home_workspace
  if defined? @home_workspace
    @home_workspace
  else
    @home_workspace = workspace
  end
end

#inspectObject Also known as: to_s

:nodoc:


674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
# File 'lib/irb/context.rb', line 674

def inspect # :nodoc:
  array = []
  for ivar in instance_variables.sort{|e1, e2| e1 <=> e2}
    ivar = ivar.to_s
    name = ivar.sub(/^@(.*)$/, '\1')
    val = instance_eval(ivar)
    case ivar
    when *NOPRINTING_IVARS
      array.push format("conf.%s=%s", name, "...")
    when *NO_INSPECTING_IVARS
      array.push format("conf.%s=%s", name, val.to_s)
    when *IDNAME_IVARS
      array.push format("conf.%s=:%s", name, val.id2name)
    else
      array.push format("conf.%s=%s", name, val.inspect)
    end
  end
  array.join("\n")
end

#inspect?Boolean

Whether #inspect_mode is set or not, see #inspect_mode= for more detail.

Returns:

  • (Boolean)

486
487
488
# File 'lib/irb/context.rb', line 486

def inspect?
  @inspect_mode.nil? or @inspect_mode
end

#inspect_last_value(output = +'')) ⇒ Object

:nodoc:


661
662
663
# File 'lib/irb/context.rb', line 661

def inspect_last_value(output = +'') # :nodoc:
  @inspect_method.inspect_value(@last_value, output)
end

#inspector_support_stream_output?Boolean

Returns:

  • (Boolean)

665
666
667
# File 'lib/irb/context.rb', line 665

def inspector_support_stream_output?
  @inspect_method.support_stream_output?
end

#local_variablesObject

:nodoc:


696
697
698
# File 'lib/irb/context.rb', line 696

def local_variables # :nodoc:
  workspace.binding.local_variables
end

#mainObject

The top-level workspace, see WorkSpace#main


205
206
207
# File 'lib/irb/context.rb', line 205

def main
  workspace.main
end

#parse_input(code, is_assignment_expression) ⇒ Object


596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
# File 'lib/irb/context.rb', line 596

def parse_input(code, is_assignment_expression)
  command_name, arg = code.strip.split(/\s+/, 2)
  arg ||= ''

  # command can only be 1 line
  if code.lines.size != 1 ||
    # command name is required
    command_name.nil? ||
    # local variable have precedence over command
    local_variables.include?(command_name.to_sym) ||
    # assignment expression is not a command
    (is_assignment_expression ||
    (arg.start_with?(ASSIGN_OPERATORS_REGEXP) && !arg.start_with?(/==|=~/)))
    return Statement::Expression.new(code, is_assignment_expression)
  end

  command = command_name.to_sym

  # Check command aliases
  if aliased_name = command_aliases[command]
    if command_class = Command.load_command(aliased_name)
      command = aliased_name
    elsif HelperMethod.helper_methods[aliased_name]
      message = <<~MESSAGE
        Using command alias `#{command}` for helper method `#{aliased_name}` is not supported.
        Please check the value of `IRB.conf[:COMMAND_ALIASES]`.
      MESSAGE
      return Statement::IncorrectAlias.new(message)
    else
      message = <<~MESSAGE
        You're trying to use command alias `#{command}` for command `#{aliased_name}`, but `#{aliased_name}` does not exist.
        Please check the value of `IRB.conf[:COMMAND_ALIASES]`.
      MESSAGE
      return Statement::IncorrectAlias.new(message)
    end
  else
    command_class = Command.load_command(command)
  end

  # Check visibility
  public_method = !!KERNEL_PUBLIC_METHOD.bind_call(main, command) rescue false
  private_method = !public_method && !!KERNEL_METHOD.bind_call(main, command) rescue false
  if command_class && Command.execute_as_command?(command, public_method: public_method, private_method: private_method)
    Statement::Command.new(code, command_class, arg)
  else
    Statement::Expression.new(code, is_assignment_expression)
  end
end

#pop_workspaceObject

Removes the last element from the current #workspaces stack and returns it, or nil if the current workspace stack is empty.

Also, see #push_workspace.


32
33
34
# File 'lib/irb/ext/workspaces.rb', line 32

def pop_workspace
  @workspace_stack.pop if @workspace_stack.size > 1
end

#prompt_nObject

TODO: Remove this when developing v2.0


286
287
288
289
# File 'lib/irb/context.rb', line 286

def prompt_n
  warn "IRB::Context#prompt_n is deprecated and will be removed in the next major release."
  ""
end

#prompt_n=(_) ⇒ Object

TODO: Remove this when developing v2.0


292
293
294
295
# File 'lib/irb/context.rb', line 292

def prompt_n=(_)
  warn "IRB::Context#prompt_n= is deprecated and will be removed in the next major release."
  ""
end

#prompting?Boolean

Whether #verbose? is true, and input_method is either StdioInputMethod or RelineInputMethod or ReadlineInputMethod, see #io for more information.

Returns:

  • (Boolean)

453
454
455
# File 'lib/irb/context.rb', line 453

def prompting?
  verbose? || @io.prompting?
end

#push_workspace(*_main) ⇒ Object

Creates a new workspace with the given object or binding, and appends it onto the current #workspaces stack.

See IRB::Context#change_workspace and IRB::WorkSpace.new for more information.


14
15
16
17
18
19
20
21
22
23
24
25
26
# File 'lib/irb/ext/workspaces.rb', line 14

def push_workspace(*_main)
  if _main.empty?
    if @workspace_stack.size > 1
      # swap the top two workspaces
      previous_workspace, current_workspace = @workspace_stack.pop(2)
      @workspace_stack.push current_workspace, previous_workspace
    end
  else
    new_workspace = WorkSpace.new(workspace.binding, _main[0])
    @workspace_stack.push new_workspace
    new_workspace.load_helper_methods_to_main
  end
end

#replace_workspace(workspace) ⇒ Object

Replace the current workspace with the given workspace.


199
200
201
202
# File 'lib/irb/context.rb', line 199

def replace_workspace(workspace)
  @workspace_stack.pop
  @workspace_stack.push(workspace)
end

#safe_method_call_on_main(method_name) ⇒ Object


700
701
702
703
# File 'lib/irb/context.rb', line 700

def safe_method_call_on_main(method_name)
  main_object = main
  Object === main_object ? main_object.__send__(method_name) : Object.instance_method(method_name).bind_call(main_object)
end

#save_historyObject


179
180
181
# File 'lib/irb/context.rb', line 179

def save_history
  IRB.conf[:SAVE_HISTORY]
end

#save_history=(val) ⇒ Object


175
176
177
# File 'lib/irb/context.rb', line 175

def save_history=(val)
  IRB.conf[:SAVE_HISTORY] = val
end

#set_last_value(value) ⇒ Object

Sets the return value from the last statement evaluated in this context to #last_value.


462
463
464
465
# File 'lib/irb/context.rb', line 462

def set_last_value(value)
  @last_value = value
  workspace.local_variable_set :_, value
end

#use_loaderObject Also known as: use_loader?

Returns whether irb‘s own file reader method is used by load/require or not.

This mode is globally affected (irb-wide).


37
38
39
# File 'lib/irb/ext/use-loader.rb', line 37

def use_loader
  IRB.conf[:USE_LOADER]
end

#use_loader=(opt) ⇒ Object

Sets IRB.conf[:USE_LOADER]

See #use_loader for more information.


47
48
49
50
51
# File 'lib/irb/ext/use-loader.rb', line 47

def use_loader=(val)
  self.class.remove_method(__method__)
  require_relative "ext/use-loader"
  __send__(__method__, val)
end

#use_tracer=(val) ⇒ Object


158
159
160
161
# File 'lib/irb/context.rb', line 158

def use_tracer=(val)
  require_relative "ext/tracer" if val
  IRB.conf[:USE_TRACER] = val
end

#verbose?Boolean

Returns whether messages are displayed or not.

Returns:

  • (Boolean)

434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
# File 'lib/irb/context.rb', line 434

def verbose?
  if @verbose.nil?
    if @io.kind_of?(RelineInputMethod)
      false
    elsif defined?(ReadlineInputMethod) && @io.kind_of?(ReadlineInputMethod)
      false
    elsif !STDIN.tty? or @io.kind_of?(FileInputMethod)
      true
    else
      false
    end
  else
    @verbose
  end
end

#workspaceObject

Workspace in the current context.


194
195
196
# File 'lib/irb/context.rb', line 194

def workspace
  @workspace_stack.last
end