123456789_123456789_123456789_123456789_123456789_

Class: IRB::WorkSpace

Relationships & Source Files
Inherits: Object
Defined in: lib/irb/workspace.rb,
lib/irb/ext/tracer.rb

Class Method Summary

Instance Attribute Summary

  • #binding readonly

    The Binding of this workspace.

  • #main readonly

    The top-level workspace of this context, also available as IRB.conf[:__MAIN__].

Instance Method Summary

Constructor Details

.new(*main) ⇒ WorkSpace

Creates a new workspace.

set self to main if specified, otherwise inherit main from TOPLEVEL_BINDING.

[ GitHub ] 

  


# 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(:binding, Kernel.instance_method(:binding))
      define_method(:local_variables, Kernel.instance_method(:local_variables))
      # Define empty method to avoid delegator warning, will be overridden.
      define_method(:exit) {|*a, &b| }
      define_method(:exit!) {|*a, &b| }
    end
    @binding = eval("IRB.conf[:__MAIN__].instance_eval('binding', __FILE__, __LINE__)", @binding, *@binding.source_location)
  end

  @binding.local_variable_set(:_, nil)
end


  







Instance Attribute Details



  

    #binding   (readonly)
  



  

    

The Binding of this workspace


  



  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 106



attr_reader :binding


  








  

    #main   (readonly)
  



  

    

The top-level workspace of this context, also available as IRB.conf[:__MAIN__]


  



  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 109



attr_reader :main


  







Instance Method Details



  

    #__evaluate__(statements, file = __FILE__, line = __LINE__)  
  



  

    

Alias for #evaluate.


  



  [ GitHub ]


  

  


# File 'lib/irb/ext/tracer.rb', line 24



alias __evaluate__ evaluate


  








  

    #code_around_binding  
  

  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 146



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(statements, file = __FILE__, line = __LINE__)  
    Also known as: #__evaluate__
  



  

    

Evaluate the context of this workspace and use the Tracer library to output the exact lines of code are being executed in chronological order.



See github.com/ruby/tracer for more information.



See additional method definition at file lib/irb/workspace.rb line 118.


  



  [ GitHub ]


  

  


# File 'lib/irb/ext/tracer.rb', line 29



def evaluate(statements, file = __FILE__, line = __LINE__)
  eval(statements, @binding, file, line)
end


  








  

    #filter_backtrace(bt)  
  



  

    

error message manipulator WARN: Rails patches this method to filter its own backtrace. Be cautious when changing it. See: github.com/rails/rails/blob/main/railties/lib/rails/commands/console/console_command.rb#L8:~:text=def,filter_backtrace


  



  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 133



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_helper_methods_to_main  
  

  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 111



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


  








  

    #local_variable_get(name)  
  

  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 126



def local_variable_get(name)
  @binding.local_variable_get(name)
end


  








  

    #local_variable_set(name, value)  
  

  [ GitHub ]


  

  


# File 'lib/irb/workspace.rb', line 122



def local_variable_set(name, value)
  @binding.local_variable_set(name, value)
end