类 IRB::Inspector

一个 irb 检查器

为了创建你自己的自定义检查器，你需要了解两件事

Inspector 使用 inspect_value 或 inspect_proc 来输出返回值。

这也允许使用可选的 init+ 或 init_proc，它在检查器被激活时调用。

了解这一点，你可以创建一个基本的检查器，如下所示

irb(main):001:0> ins = IRB::Inspector.new(proc{ |v| "omg! #{v}" })
irb(main):001:0> IRB.CurrentContext.inspect_mode = ins # => omg! #<IRB::Inspector:0x007f46f7ba7d28>
irb(main):001:0> "what?" #=> omg! what?

常量

INSPECTORS

irb 可用的默认检查器，包括

:pp: 使用 Kernel#pretty_inspect
:yaml: 使用 YAML.dump
:marshal: 使用 Marshal.dump

KERNEL_INSPECT

公共类方法

def_inspector(key, arg=nil, &block) 点击切换源代码

示例

Inspector.def_inspector(key, init_p=nil){|v| v.inspect}
Inspector.def_inspector([key1,..], init_p=nil){|v| v.inspect}
Inspector.def_inspector(key, inspector)
Inspector.def_inspector([key1,...], inspector)

# File lib/irb/inspector.rb, line 58
def self.def_inspector(key, arg=nil, &block)
  if block_given?
    inspector = IRB::Inspector(block, arg)
  else
    inspector = arg
  end

  case key
  when Array
    for k in key
      def_inspector(k, inspector)
    end
  when Symbol
    INSPECTORS[key] = inspector
    INSPECTORS[key.to_s] = inspector
  when String
    INSPECTORS[key] = inspector
    INSPECTORS[key.intern] = inspector
  else
    INSPECTORS[key] = inspector
  end
end

keys_with_inspector(inspector) 点击切换源代码

确定要使用的检查器，其中 inspector 是在检查器定义期间传递的键之一。

# File lib/irb/inspector.rb, line 48
def self.keys_with_inspector(inspector)
  INSPECTORS.select{|k,v| v == inspector}.collect{|k, v| k}
end

new(inspect_proc, init_proc = nil) 点击切换源代码

创建一个新的检查器对象，在 irb 中输出返回值时使用给定的 inspect_proc。

# File lib/irb/inspector.rb, line 83
def initialize(inspect_proc, init_proc = nil)
  @init = init_proc
  @inspect = inspect_proc
end

公共实例方法

init() 点击切换源代码

Proc 在检查器被激活时调用，适合于需要依赖库。

# File lib/irb/inspector.rb, line 90
def init
  @init.call if @init
end

inspect_value(v) 点击切换源代码

Proc 在输入被评估并在 irb 中输出时调用。

# File lib/irb/inspector.rb, line 95
def inspect_value(v)
  @inspect.call(v)
rescue => e
  puts "An error occurred when inspecting the object: #{e.inspect}"

  begin
    puts "Result of Kernel#inspect: #{KERNEL_INSPECT.bind_call(v)}"
    ''
  rescue => e
    puts "An error occurred when running Kernel#inspect: #{e.inspect}"
    puts e.backtrace.join("\n")
    ''
  end
end