Class: IRB::Context

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

Overview

:nodoc:

Constant Summary collapse

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



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
# File 'lib/irb/context.rb', line 28

def initialize(irb, workspace = nil, input_method = nil)
  @irb = irb
  if workspace
    @workspace = workspace
  else
    @workspace = 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
    @use_multiline = IRB.conf[:USE_RELINE]
  elsif IRB.conf.has_key?(:USE_REIDLINE)
    warn "      USE_REIDLINE is deprecated, please use USE_RELINE instead.\n    MSG\n    @use_multiline = IRB.conf[:USE_RELINE]\n  else\n    @use_multiline = nil\n  end\n  @use_autocomplete = IRB.conf[:USE_AUTOCOMPLETE]\n  @verbose = IRB.conf[:VERBOSE]\n  @io = nil\n\n  self.inspect_mode = IRB.conf[:INSPECT_MODE]\n  self.use_tracer = IRB.conf[:USE_TRACER] if IRB.conf[:USE_TRACER]\n  self.use_loader = IRB.conf[:USE_LOADER] if IRB.conf[:USE_LOADER]\n  self.eval_history = IRB.conf[:EVAL_HISTORY] if IRB.conf[:EVAL_HISTORY]\n\n  @ignore_sigint = IRB.conf[:IGNORE_SIGINT]\n  @ignore_eof = IRB.conf[:IGNORE_EOF]\n\n  @back_trace_limit = IRB.conf[:BACK_TRACE_LIMIT]\n\n  self.prompt_mode = IRB.conf[:PROMPT_MODE]\n\n  if IRB.conf[:SINGLE_IRB] or !defined?(IRB::JobManager)\n    @irb_name = IRB.conf[:IRB_NAME]\n  else\n    @irb_name = IRB.conf[:IRB_NAME]+\"#\"+IRB.JobManager.n_jobs.to_s\n  end\n  @irb_path = \"(\" + @irb_name + \")\"\n\n  case input_method\n  when nil\n    @io = nil\n    case use_multiline?\n    when nil\n      if STDIN.tty? && IRB.conf[:PROMPT_MODE] != :INF_RUBY && !use_singleline?\n        # Both of multiline mode and singleline mode aren't specified.\n        @io = RelineInputMethod.new\n      else\n        @io = nil\n      end\n    when false\n      @io = nil\n    when true\n      @io = RelineInputMethod.new\n    end\n    unless @io\n      case use_singleline?\n      when nil\n        if (defined?(ReadlineInputMethod) && STDIN.tty? &&\n            IRB.conf[:PROMPT_MODE] != :INF_RUBY)\n          @io = ReadlineInputMethod.new\n        else\n          @io = nil\n        end\n      when false\n        @io = nil\n      when true\n        if defined?(ReadlineInputMethod)\n          @io = ReadlineInputMethod.new\n        else\n          @io = nil\n        end\n      else\n        @io = nil\n      end\n    end\n    @io = StdioInputMethod.new unless @io\n\n  when '-'\n    @io = FileInputMethod.new($stdin)\n    @irb_name = '-'\n    @irb_path = '-'\n  when String\n    @io = FileInputMethod.new(input_method)\n    @irb_name = File.basename(input_method)\n    @irb_path = input_method\n  else\n    @io = input_method\n  end\n  self.save_history = IRB.conf[:SAVE_HISTORY] if IRB.conf[:SAVE_HISTORY]\n\n  @extra_doc_dirs = IRB.conf[:EXTRA_DOC_DIRS]\n\n  @echo = IRB.conf[:ECHO]\n  if @echo.nil?\n    @echo = true\n  end\n\n  @echo_on_assignment = IRB.conf[:ECHO_ON_ASSIGNMENT]\n  if @echo_on_assignment.nil?\n    @echo_on_assignment = :truncate\n  end\n\n  @newline_before_multiline_output = IRB.conf[:NEWLINE_BEFORE_MULTILINE_OUTPUT]\n  if @newline_before_multiline_output.nil?\n    @newline_before_multiline_output = true\n  end\nend\n".strip

Instance Attribute Details

#ap_nameObject

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



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

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.



234
235
236
# File 'lib/irb/context.rb', line 234

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.

See IRB@Command+line+options for more command line options.



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

def back_trace_limit
  @back_trace_limit
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


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

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


300
301
302
# File 'lib/irb/context.rb', line 300

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).



37
38
39
# File 'lib/irb/ext/history.rb', line 37

def eval_history
  @eval_history
end

#extra_doc_dirsObject

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



254
255
256
# File 'lib/irb/context.rb', line 254

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.



251
252
253
# File 'lib/irb/context.rb', line 251

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.



247
248
249
# File 'lib/irb/context.rb', line 247

def ignore_sigint
  @ignore_sigint
end

#inspect_modeObject

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



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

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.



170
171
172
# File 'lib/irb/context.rb', line 170

def io
  @io
end

#irbObject

Current irb session.



173
174
175
# File 'lib/irb/context.rb', line 173

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



182
183
184
# File 'lib/irb/context.rb', line 182

def irb_name
  @irb_name
end

#irb_pathObject

Can be either the #irb_name surrounded by parenthesis, or the input_method passed to Context.new



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

def irb_path
  @irb_path
end

#last_valueObject (readonly)

The return value of the last statement evaluated.



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

def last_value
  @last_value
end

#load_modulesObject

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



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

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


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

def newline_before_multiline_output
  @newline_before_multiline_output
end

#prompt_cObject

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

See IRB@Customizing+the+IRB+Prompt for more information.



215
216
217
# File 'lib/irb/context.rb', line 215

def prompt_c
  @prompt_c
end

#prompt_iObject

Standard IRB prompt.

See IRB@Customizing+the+IRB+Prompt for more information.



207
208
209
# File 'lib/irb/context.rb', line 207

def prompt_i
  @prompt_i
end

#prompt_modeObject

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



203
204
205
# File 'lib/irb/context.rb', line 203

def prompt_mode
  @prompt_mode
end

#prompt_nObject

See IRB@Customizing+the+IRB+Prompt for more information.



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

def prompt_n
  @prompt_n
end

#prompt_sObject

IRB prompt for continuated strings.

See IRB@Customizing+the+IRB+Prompt for more information.



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

def prompt_s
  @prompt_s
end

#rcObject Also known as: rc?

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



177
178
179
# File 'lib/irb/context.rb', line 177

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.



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

def return_format
  @return_format
end

#threadObject (readonly)

The current thread in this context.



164
165
166
# File 'lib/irb/context.rb', line 164

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]



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

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]



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

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]



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

def use_singleline
  @use_singleline
end

#use_tracerObject Also known as: use_tracer?

Whether Tracer is used when evaluating statements in this context.

See lib/tracer.rb for more information.



43
44
45
# File 'lib/irb/ext/tracer.rb', line 43

def use_tracer
  @use_tracer
end

#verboseObject

Whether verbose messages are displayed or not.

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



318
319
320
# File 'lib/irb/context.rb', line 318

def verbose
  @verbose
end

#workspaceObject

WorkSpace in the current context.



162
163
164
# File 'lib/irb/context.rb', line 162

def workspace
  @workspace
end

#workspace_homeObject (readonly)

The toplevel workspace, see #home_workspace



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

def workspace_home
  @workspace_home
end

Instance Method Details

#__exit__Object



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

alias __exit__ exit

#__inspect__Object



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

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



20
21
22
23
# File 'lib/irb/ext/history.rb', line 20

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.



32
33
34
35
36
37
38
39
40
41
42
43
# File 'lib/irb/ext/change-ws.rb', line 32

def change_workspace(*_main)
  if _main.empty?
    @workspace = home_workspace
    return main
  end

  @workspace = WorkSpace.new(_main[0])

  if !(class<<main;ancestors;end).include?(ExtendCommandBundle)
    main.extend ExtendCommandBundle
  end
end

#evaluate(line, line_no, exception: nil) ⇒ Object

:nodoc:



473
474
475
476
477
478
479
480
481
# File 'lib/irb/context.rb', line 473

def evaluate(line, line_no, exception: nil) # :nodoc:
  @line_no = line_no
  if exception
    line_no -= 1
    line = "begin ::Kernel.raise _; rescue _.class\n#{line}\n""end"
    @workspace.local_variable_set(:_, exception)
  end
  set_last_value(@workspace.evaluate(self, line, irb_path, line_no))
end

#exit(ret = 0) ⇒ Object

Exits the current session, see IRB.irb_exit



489
490
491
492
493
# File 'lib/irb/context.rb', line 489

def exit(ret = 0)
  IRB.irb_exit(@irb, ret)
rescue UncaughtThrowError
  super
end

#file_input?Boolean

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

Returns:

  • (Boolean)


413
414
415
# File 'lib/irb/context.rb', line 413

def file_input?
  @io.class == FileInputMethod
end

#history_fileObject

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



48
49
50
# File 'lib/irb/ext/save-history.rb', line 48

def history_file
  IRB.conf[:HISTORY_FILE]
end

#history_file=(hist) ⇒ Object

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



53
54
55
# File 'lib/irb/ext/save-history.rb', line 53

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

#home_workspaceObject

Inherited from TOPLEVEL_BINDING.



17
18
19
20
21
22
23
# File 'lib/irb/ext/change-ws.rb', line 17

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

#init_save_historyObject

:nodoc:



17
18
19
20
21
# File 'lib/irb/ext/save-history.rb', line 17

def init_save_history# :nodoc:
  unless (class<<@io;self;end).include?(HistorySavingAbility)
    @io.extend(HistorySavingAbility)
  end
end

#inspectObject Also known as: to_s

:nodoc:



500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
# File 'lib/irb/context.rb', line 500

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)


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

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

#inspect_last_valueObject

:nodoc:



483
484
485
# File 'lib/irb/context.rb', line 483

def inspect_last_value # :nodoc:
  @inspect_method.inspect_value(@last_value)
end

#irb_levelObject

Size of the current WorkSpace stack



17
18
19
# File 'lib/irb/ext/workspaces.rb', line 17

def irb_level
  workspace_stack.size
end

#mainObject

The top-level workspace, see WorkSpace#main



155
156
157
# File 'lib/irb/context.rb', line 155

def main
  @workspace.main
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.



58
59
60
61
62
63
64
# File 'lib/irb/ext/workspaces.rb', line 58

def pop_workspace
  if workspaces.empty?
    print "workspace stack empty\n"
    return
  end
  @workspace = workspaces.pop
end

#prompting?Boolean

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

Returns:

  • (Boolean)


371
372
373
374
375
# File 'lib/irb/context.rb', line 371

def prompting?
  verbose? || (STDIN.tty? && @io.kind_of?(StdioInputMethod) ||
               @io.kind_of?(RelineInputMethod) ||
               (defined?(ReadlineInputMethod) && @io.kind_of?(ReadlineInputMethod)))
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.



35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# File 'lib/irb/ext/workspaces.rb', line 35

def push_workspace(*_main)
  if _main.empty?
    if workspaces.empty?
      print "No other workspace\n"
      return nil
    end
    ws = workspaces.pop
    workspaces.push @workspace
    @workspace = ws
    return workspaces
  end

  workspaces.push @workspace
  @workspace = WorkSpace.new(@workspace.binding, _main[0])
  if !(class<<main;ancestors;end).include?(ExtendCommandBundle)
    main.extend ExtendCommandBundle
  end
end

#save_historyObject

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



24
25
26
# File 'lib/irb/ext/save-history.rb', line 24

def save_history
  IRB.conf[:SAVE_HISTORY]
end

#save_history=(val) ⇒ Object

Sets IRB.conf[:SAVE_HISTORY] to the given val and calls #init_save_history with this context.

Will store the number of val entries of history in the #history_file

Add the following to your .irbrc to change the number of history entries stored to 1000:

IRB.conf[:SAVE_HISTORY] = 1000


38
39
40
41
42
43
44
45
# File 'lib/irb/ext/save-history.rb', line 38

def save_history=(val)
  IRB.conf[:SAVE_HISTORY] = val
  if val
    main_context = IRB.conf[:MAIN_CONTEXT]
    main_context = self unless main_context
    main_context.init_save_history
  end
end

#set_last_value(value) ⇒ Object

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



382
383
384
385
# File 'lib/irb/context.rb', line 382

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).



43
44
45
# File 'lib/irb/ext/use-loader.rb', line 43

def use_loader
  IRB.conf[:USE_LOADER]
end

#use_loader=(opt) ⇒ Object

Sets IRB.conf[:USE_LOADER]

See #use_loader for more information.



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# File 'lib/irb/ext/use-loader.rb', line 53

def use_loader=(opt)

  if IRB.conf[:USE_LOADER] != opt
    IRB.conf[:USE_LOADER] = opt
    if opt
      if !$".include?("irb/cmd/load")
      end
      (class<<@workspace.main;self;end).instance_eval {
        alias_method :load, :irb_load
        alias_method :require, :irb_require
      }
    else
      (class<<@workspace.main;self;end).instance_eval {
        alias_method :load, :__original__load__IRB_use_loader__
        alias_method :require, :__original__require__IRB_use_loader__
      }
    end
  end
  print "Switch to load/require#{unless use_loader; ' non';end} trace mode.\n" if verbose?
  opt
end

#verbose?Boolean

Returns whether messages are displayed or not.

Returns:

  • (Boolean)


352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
# File 'lib/irb/context.rb', line 352

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

#workspacesObject

WorkSpaces in the current stack



22
23
24
25
26
27
28
# File 'lib/irb/ext/workspaces.rb', line 22

def workspaces
  if defined? @workspaces
    @workspaces
  else
    @workspaces = []
  end
end