模块 PP::PPMethods - Ruby 3.3 文档

check_inspect_key(id) 点击切换源代码

检查对象 ID id 是否在当前要进行漂亮打印的对象缓冲区中。用于在要进行漂亮打印的对象链中打破循环。

# File lib/pp.rb, line 167
def check_inspect_key(id)
  Thread.current[:__recursive_key__] &&
  Thread.current[:__recursive_key__][:inspect] &&
  Thread.current[:__recursive_key__][:inspect].include?(id)
end

comma_breakable() 点击切换源代码

一个方便的方法，与以下方法相同

text ','
breakable

# File lib/pp.rb, line 226
def comma_breakable
  text ','
  breakable
end

guard_inspect_key() { || ... } 点击切换源代码

将代码块传递给一个块，并保留之前正在打印的对象集。

# File lib/pp.rb, line 145
def guard_inspect_key
  if Thread.current[:__recursive_key__] == nil
    Thread.current[:__recursive_key__] = {}.compare_by_identity
  end

  if Thread.current[:__recursive_key__][:inspect] == nil
    Thread.current[:__recursive_key__][:inspect] = {}.compare_by_identity
  end

  save = Thread.current[:__recursive_key__][:inspect]

  begin
    Thread.current[:__recursive_key__][:inspect] = {}.compare_by_identity
    yield
  ensure
    Thread.current[:__recursive_key__][:inspect] = save
  end
end

object_address_group(obj, &block) 点击切换源代码

一个方便的方法，类似于 object_group，但也会重新格式化对象的 object_id。

# File lib/pp.rb, line 216
def object_address_group(obj, &block)
  str = Kernel.instance_method(:to_s).bind_call(obj)
  str.chomp!('>')
  group(1, str, '>', &block)
end

object_group(obj) { || ... } 点击切换源代码

一个方便的方法，与以下方法相同

group(1, '#<' + obj.class.name, '>') { ... }

# File lib/pp.rb, line 210
def object_group(obj, &block) # :yield:
  group(1, '#<' + obj.class.name, '>', &block)
end

pop_inspect_key(id) 点击切换源代码

从正在进行漂亮打印的对象集中删除一个对象。

# File lib/pp.rb, line 180
def pop_inspect_key(id)
  Thread.current[:__recursive_key__][:inspect].delete id
end

pp(obj) 点击切换源代码

使用 Object#pretty_print 或 Object#pretty_print_cycle 将 obj 添加到漂亮打印缓冲区。

当 obj 已经打印过时，使用 Object#pretty_print_cycle，即对象引用链存在循环。

# File lib/pp.rb, line 189
def pp(obj)
  # If obj is a Delegator then use the object being delegated to for cycle
  # detection
  obj = obj.__getobj__ if defined?(::Delegator) and obj.is_a?(::Delegator)

  if check_inspect_key(obj)
    group {obj.pretty_print_cycle self}
    return
  end

  begin
    push_inspect_key(obj)
    group {obj.pretty_print self}
  ensure
    pop_inspect_key(obj) unless PP.sharing_detection
  end
end

pp_hash(obj) 点击切换源代码

用于 Hash 的漂亮打印。

# File lib/pp.rb, line 285
def pp_hash(obj)
  group(1, '{', '}') {
    seplist(obj, nil, :each_pair) {|k, v|
      group {
        pp k
        text '=>'
        group(1) {
          breakable ''
          pp v
        }
      }
    }
  }
end

pp_object(obj) 点击切换源代码

用于漂亮打印任何给定 Object 的当前标准故障保护。

# File lib/pp.rb, line 269
def pp_object(obj)
  object_address_group(obj) {
    seplist(obj.pretty_print_instance_variables, lambda { text ',' }) {|v|
      breakable
      v = v.to_s if Symbol === v
      text v
      text '='
      group(1) {
        breakable ''
        pp(obj.instance_eval(v))
      }
    }
  }
end

push_inspect_key(id) 点击切换源代码

将对象 ID id 添加到正在进行漂亮打印的对象集中，以避免重复对象。

# File lib/pp.rb, line 175
def push_inspect_key(id)
  Thread.current[:__recursive_key__][:inspect][id] = true
end

seplist(list, sep=nil, iter_method=:each) { |element| ... } 点击切换源代码

添加一个分隔列表。默认情况下，列表以逗号和可断开的空格分隔。

seplist 使用 iter_method 迭代 list。它将每个对象传递给 seplist 的块。在每次传递之间调用过程 separator_proc。

如果迭代次数为零，则不会调用 separator_proc。

如果 separator_proc 为 nil 或未给出，则使用 +lambda { comma_breakable }+。如果未给出 iter_method，则使用 :each。

例如，以下 3 个代码片段具有类似的效果。

q.seplist([1,2,3]) {|v| xxx v }

q.seplist([1,2,3], lambda { q.comma_breakable }, :each) {|v| xxx v }

xxx 1
q.comma_breakable
xxx 2
q.comma_breakable
xxx 3

# File lib/pp.rb, line 255
def seplist(list, sep=nil, iter_method=:each) # :yield: element
  sep ||= lambda { comma_breakable }
  first = true
  list.__send__(iter_method) {|*v|
    if first
      first = false
    else
      sep.call
    end
    RUBY_VERSION >= "3.0" ? yield(*v, **{}) : yield(*v)
  }
end