Class: IRB::WorkSpace (Ruby 2.2.2)
Description: Class : IRB::WorkSpace - Ruby 2.2.2

- Home
- Core 2.2.2
- Std-lib 2.2.2
- Downloads

Support for the Ruby 2.2 series has ended. See here for reference.

### Home Classes Methods

### In Files

- irb/ext/tracer.rb
- irb/workspace.rb

### Parent

Object

### Methods

- ::new
- #__evaluate__
- #evaluate
- #filter_backtrace

### Class/Module Index

Quicksearch

- IRB::Abort
- IRB::Context
- IRB::ContextExtender
- IRB::ExtendCommandBundle
- IRB::FileInputMethod
- IRB::Frame
- IRB::InputMethod
- IRB::Inspector
- IRB::Irb
- IRB::IrbLoader
- IRB::JobManager
- IRB::LoadAbort
- IRB::MethodExtender
- IRB::Notifier
- IRB::Notifier::AbstractNotifier
- IRB::Notifier::CompositeNotifier
- IRB::Notifier::LeveledNotifier
- IRB::Notifier::NoMsgNotifier
- IRB::OutputMethod
- IRB::ReadlineInputMethod
- IRB::StdioInputMethod
- IRB::StdioOutputMethod
- IRB::WorkSpace
- Object
- XMP
- XMP::StringInputMethod

No matching classes.

# IRB::WorkSpace

### Attributes

binding[R]

The Binding of this workspace

main[R]

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

### Public Class Methods

new(*main) click to toggle source

Creates a new workspace.

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

                   # File irb/workspace.rb, line 17
        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
                require "thread"

                IRB.const_set(:BINDING_QUEUE, 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(default)
              @binding = eval("def irb_binding; private; binding; end; irb_binding",
                              TOPLEVEL_BINDING,
                              __FILE__,
                              __LINE__ - 3)
            end
          end
          if main.empty?
            @main = eval("self", @binding)
          else
            @main = main[0]
            IRB.conf[:__MAIN__] = @main
            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
                IRB.fail CantChangeBinding, @main.inspect
              end
            end
          end
          eval("_=nil", @binding)
        end

### Public Instance Methods

__evaluate__(context, statements, file = nil, line = nil) click to toggle source
Alias for: evaluate
evaluate(context, statements, file = nil, line = nil) click to toggle source

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 `lib/tracer.rb` for more information.

                   # File irb/ext/tracer.rb, line 55
    def evaluate(context, statements, file = nil, line = nil)
      if context.use_tracer? && file != nil && line != nil
        Tracer.on
        begin
          __evaluate__(context, statements, file, line)
        ensure
          Tracer.off
        end
      else
        __evaluate__(context, statements, file || __FILE__, line || __LINE__)
      end
    end

Also aliased as: __evaluate__
filter_backtrace(bt) click to toggle source

error message manipulator

                   # File irb/workspace.rb, line 90
    def filter_backtrace(bt)
      case IRB.conf[:CONTEXT_MODE]
      when 0
        return nil if bt =~ /\(irb_local_binding\)/
      when 1
        if(bt =~ %r!/tmp/irb-binding! or
            bt =~ %r!irb/.*\.rb! or
            bt =~ /irb\.rb/)
          return nil
        end
      when 2
        return nil if bt =~ /irb\/.*\.rb/
        return nil if bt =~ /irb\.rb/
      when 3
        return nil if bt =~ /irb\/.*\.rb/
        return nil if bt =~ /irb\.rb/
        bt = bt.sub(/:\s*in `irb_binding'/, '')
      end
      bt
    end