类 IRB::WorkSpace
属性
binding[R]
此工作空间的 Binding
main[R]
此上下文的顶层工作空间,也可以通过 IRB.conf[:__MAIN__]
获取
公共类方法
new(*main) 点击切换源代码
创建一个新的工作空间。
如果指定了 main,则将 self 设置为 main,否则从 TOPLEVEL_BINDING 继承 main。
# File lib/irb/workspace.rb, line 16 def initialize(*main) if main[0].kind_of?(Binding) @binding = main.shift elsif IRB.conf[:SINGLE_IRB] @binding = TOPLEVEL_BINDING else case IRB.conf[:CONTEXT_MODE] when 0 # binding in proc on TOPLEVEL_BINDING @binding = eval("proc{binding}.call", TOPLEVEL_BINDING, __FILE__, __LINE__) when 1 # binding in loaded file require "tempfile" f = Tempfile.open("irb-binding") f.print <<EOF $binding = binding EOF f.close load f.path @binding = $binding when 2 # binding in loaded file(thread use) unless defined? BINDING_QUEUE IRB.const_set(:BINDING_QUEUE, Thread::SizedQueue.new(1)) Thread.abort_on_exception = true Thread.start do eval "require \"irb/ws-for-case-2\"", TOPLEVEL_BINDING, __FILE__, __LINE__ end Thread.pass end @binding = BINDING_QUEUE.pop when 3 # binding in function on TOPLEVEL_BINDING @binding = eval("self.class.remove_method(:irb_binding) if defined?(irb_binding); private; def irb_binding; binding; end; irb_binding", TOPLEVEL_BINDING, __FILE__, __LINE__ - 3) when 4 # binding is a copy of TOPLEVEL_BINDING (default) # Note that this will typically be IRB::TOPLEVEL_BINDING # This is to avoid RubyGems' local variables (see issue #17623) @binding = TOPLEVEL_BINDING.dup end end if main.empty? @main = eval("self", @binding) else @main = main[0] end IRB.conf[:__MAIN__] = @main unless main.empty? case @main when Module @binding = eval("IRB.conf[:__MAIN__].module_eval('binding', __FILE__, __LINE__)", @binding, __FILE__, __LINE__) else begin @binding = eval("IRB.conf[:__MAIN__].instance_eval('binding', __FILE__, __LINE__)", @binding, __FILE__, __LINE__) rescue TypeError fail CantChangeBinding, @main.inspect end end end case @main when Object use_delegator = @main.frozen? else use_delegator = true end if use_delegator @main = SimpleDelegator.new(@main) IRB.conf[:__MAIN__] = @main @main.singleton_class.class_eval do private define_method(:exit) do |*a, &b| # Do nothing, will be overridden end define_method(:binding, Kernel.instance_method(:binding)) define_method(:local_variables, Kernel.instance_method(:local_variables)) end @binding = eval("IRB.conf[:__MAIN__].instance_eval('binding', __FILE__, __LINE__)", @binding, *@binding.source_location) end @binding.local_variable_set(:_, nil) end
公共实例方法
code_around_binding() 点击切换源代码
# File lib/irb/workspace.rb, line 144 def code_around_binding file, pos = @binding.source_location if defined?(::SCRIPT_LINES__[file]) && lines = ::SCRIPT_LINES__[file] code = ::SCRIPT_LINES__[file].join('') else begin code = File.read(file) rescue SystemCallError return end end lines = Color.colorize_code(code).lines pos -= 1 start_pos = [pos - 5, 0].max end_pos = [pos + 5, lines.size - 1].min line_number_fmt = Color.colorize("%#{end_pos.to_s.length}d", [:BLUE, :BOLD]) fmt = " %2s #{line_number_fmt}: %s" body = (start_pos..end_pos).map do |current_pos| sprintf(fmt, pos == current_pos ? '=>' : '', current_pos + 1, lines[current_pos]) end.join("") "\nFrom: #{file} @ line #{pos + 1} :\n\n#{body}#{Color.clear}\n" end
evaluate(context, statements, file = nil, line = nil) 点击切换源代码
评估此工作空间的上下文,并使用 Tracer 库按时间顺序输出正在执行的代码的精确行。
有关更多信息,请参见 lib/tracer.rb
。
# File lib/irb/ext/tracer.rb, line 63 def evaluate(context, statements, file = nil, line = nil) if context.use_tracer? && file != nil && line != nil Tracer.on begin __evaluate__(statements, file, line) ensure Tracer.off end else __evaluate__(statements, file || __FILE__, line || __LINE__) end end
也称为:__evaluate__
filter_backtrace(bt) 点击切换源代码
错误消息操作器警告:Rails 修补了此方法以过滤其自身的回溯。更改此方法时要谨慎。参见:github.com/rails/rails/blob/main/railties/lib/rails/commands/console/console_command.rb#L8:~:text=def,filter_backtrace
# File lib/irb/workspace.rb, line 131 def filter_backtrace(bt) return nil if bt =~ /\/irb\/.*\.rb/ return nil if bt =~ /\/irb\.rb/ return nil if bt =~ /tool\/lib\/.*\.rb|runner\.rb/ # for tests in Ruby repository case IRB.conf[:CONTEXT_MODE] when 1 return nil if bt =~ %r!/tmp/irb-binding! when 3 bt = bt.sub(/:\s*in `irb_binding'/, '') end bt end
load_commands_to_main() 点击切换源代码
# File lib/irb/workspace.rb, line 111 def load_commands_to_main main.extend ExtendCommandBundle end
local_variable_get(name) 点击切换源代码
# File lib/irb/workspace.rb, line 124 def local_variable_get(name) @binding.local_variable_get(name) end
local_variable_set(name, value) 点击切换源代码
# File lib/irb/workspace.rb, line 120 def local_variable_set(name, value) @binding.local_variable_set(name, value) end