類別 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