модуль PP::PPMethods

Общедоступные методы экземпляра

check_inspect_key(id) Показать исходный код

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

Проверяет, является ли object_id id частью текущего буфера объектов, которые нужно красиво напечатать. Используется для разрыва циклов в цепочках объектов для красивой печати.

comma_breakable() Показать исходный код

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

Удобный метод, эквивалентный следующему:

text ','
breakable

guard_inspect_key() { || ... } Показать исходный код

# File lib/pp.rb, line 107
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) Показать исходный код

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

Удобный метод, аналогичный object_group, но также переформатирует object_id объекта.

object_group(obj) { || ... } Показать исходный код

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

Удобный метод, эквивалентный следующему:

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

pop_inspect_key(id) Показать исходный код

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

Удаляет объект из набора печатаемых объектов.

pp(obj) Показать исходный код

# File lib/pp.rb, line 151
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

Добавляет obj в буфер красивой печати с использованием Object#pretty_print или Object#pretty_print_cycle.

Object#pretty_print_cycle используется, когда obj уже напечатан, т.е. цепочка ссылок на объект имеет цикл.

pp_hash(obj) Показать исходный код

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

Красивая печать для Hash

pp_object(obj) Показать исходный код

# File lib/pp.rb, line 240
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

Стандартный метод для красивой печати любого Object

push_inspect_key(id) Показать исходный код

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

Добавляет object_id id в набор печатаемых объектов, чтобы не повторять объекты.

seplist(list, sep=nil, iter_method=:each) { |element| ... } Показать исходный код

# File lib/pp.rb, line 217
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
    case v.last
    when Hash
      if Hash.ruby2_keywords_hash?(v.last)
        yield(*v, **{})
      else
        yield(*v)
      end
    else
      yield(*v)
    end
  }
end

Добавляет список, разделенный запятыми с разделителем (пробел). По умолчанию.

seplist итерирует list используя iter_method. Каждое значение передаётся блоку, заданному для 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

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.