класс PP

Родитель:: PrettyPrint
Включенные модули:: PP::PPMethods

Форматированный вывод для объектов Ruby.

Что делает `PP`

Стандартный вывод с помощью p возвращает следующее:

#<PP:0x81fedf0 @genspace=#<Proc:0x81feda0>, @group_queue=#<PrettyPrint::GroupQueue:0x81fed3c @queue=[[#<PrettyPrint::Group:0x81fed78 @breakables=[], @depth=0, @break=false>], []]>, @buffer=[], @newline="\n", @group_stack=[#<PrettyPrint::Group:0x81fed78 @breakables=[], @depth=0, @break=false>], @buffer_width=0, @indent=0, @maxwidth=79, @output_width=2, @output=#<IO:0x8114ee4>>

Форматированный вывод возвращает следующее:

#<PP:0x81fedf0
 @buffer=[],
 @buffer_width=0,
 @genspace=#<Proc:0x81feda0>,
 @group_queue=
  #<PrettyPrint::GroupQueue:0x81fed3c
   @queue=
    [[#<PrettyPrint::Group:0x81fed78 @break=false, @breakables=[], @depth=0>],
     []]>,
 @group_stack=
  [#<PrettyPrint::Group:0x81fed78 @break=false, @breakables=[], @depth=0>],
 @indent=0,
 @maxwidth=79,
 @newline="\n",
 @output=#<IO:0x8114ee4>,
 @output_width=2>

Использование

pp(obj)             #=> obj
pp obj              #=> obj
pp(obj1, obj2, ...) #=> [obj1, obj2, ...]
pp()                #=> nil

Вывод obj(s) в $> в формате с красивым выводом.

Он возвращает obj(s).

Настройка вывода

Для определения пользовательской функции форматированного вывода для ваших классов, переопределите метод #pretty_print(pp) в классе. Обратите внимание, что require 'pp' необходимо перед переопределением #pretty_print(pp).

#pretty_print принимает аргумент pp, который является экземпляром класса PP. Метод использует text, breakable, nest, group и pp для вывода объекта.

Форматированный вывод `JSON`

Для форматированного вывода JSON обратитесь к JSON#pretty_generate.

Автор

Tanaka Akira <akr@fsij.org>

Константы

VERSION

Публичные методы класса

pp(obj, out=$>, width=width_for(out)) Показать исходный код

# File lib/pp.rb, line 95
def PP.pp(obj, out=$>, width=width_for(out))
  q = PP.new(out, width)
  q.guard_inspect_key {q.pp obj}
  q.flush
  #$pp = q
  out << "\n"
end

Выводит obj в out в формате с красивым выводом шириной width столбцов.

Если out опущено, используется $>. Если width опущено, используется ширина out (см. width_for).

PP.pp возвращает out.

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

# File lib/pp.rb, line 124
def sharing_detection
  Ractor.current[:pp_sharing_detection]
end

Возвращает флаг обнаружения совместного использования в виде булевого значения. По умолчанию он равен false (nil).

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

# File lib/pp.rb, line 128
def sharing_detection=(b)
  Ractor.current[:pp_sharing_detection] = b
end

Устанавливает флаг обнаружения совместного использования на b.

singleline_pp(obj, out=$>) Показать исходный код

# File lib/pp.rb, line 107
def PP.singleline_pp(obj, out=$>)
  q = SingleLine.new(out)
  q.guard_inspect_key {q.pp obj}
  q.flush
  out
end

Выводит obj в out как PP.pp, но без отступов и перевода строки.

PP.singleline_pp возвращает out.

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

# File lib/pp.rb, line 78
def PP.width_for(out)
  begin
    require 'io/console'
    _, width = out.winsize
  rescue LoadError, NoMethodError, SystemCallError
  end
  (width || ENV['COLUMNS']&.to_i&.nonzero? || 80) - 1
end

Возвращает используемую ширину для out. Как ширина out:

Если out назначен устройству tty, используется его ширина.
В противном случае, или если значение не может быть получено, используется значение переменной среды COLUMN.
Если COLUMN не задано или равно нулю, используется 80.

И в конечном итоге возвращает значение ширины, уменьшенное на 1.

Эта отмена на 1 нужна для командной строки Windows, которая перемещает курсор на следующую строку, если достигает последнего столбца.

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