Inspect.Opts

Определяет опции, используемые протоколом Inspect.

Доступны следующие поля:

:base - печатает целые числа как :binary, :octal, :decimal, или :hex, по умолчанию :decimal. При инспектировании двоичных данных любой :base кроме :decimal подразумевает binaries: :as_binaries.
:binaries - при :as_binaries все двоичные данные будут напечатаны в битовой записи.

При :as_strings все двоичные данные будут напечатаны как строки, непечатаемые байты будут экранированы. При использовании значения по умолчанию :infer, двоичные данные будут напечатаны как строки, если они печатаемы, иначе в битовой записи. Смотрите String.printable?/1, чтобы узнать, когда строка печатаема.
:charlists - при :as_charlists все списки будут напечатаны как списки символов, непечатаемые элементы будут экранированы.

При :as_lists все списки будут напечатаны как списки. При значении по умолчанию :infer, список будет напечатан как список символов, если он печатаем, иначе как список. Смотрите List.ascii_printable?/1, чтобы узнать, когда список символов печатаем.
:custom_options (с версии v1.9.0) - список ключевых слов, хранящий пользовательские опции. Полезно при реализации протокола Inspect для вложенных структур, чтобы передавать пользовательские опции.
:inspect_fun (с версии v1.9.0) - функция для построения документов алгебры. По умолчанию Inspect.Opts.default_inspect_fun/0.
:limit - ограничивает количество элементов, которые инспектируются для кортежей, битовых строк, карт, списков и любых других коллекций элементов, за исключением печатаемых строк и печатаемых списков символов, которые используют опцию :printable_limit. Если вы не хотите ограничивать количество элементов конкретным числом, используйте :infinity. Принимает положительное целое число или :infinity. По умолчанию 50.
:pretty - если установлено в true, включает красивую печать. По умолчанию false.
:printable_limit - ограничивает количество символов, которые инспектируются в печатаемых строках и печатаемых списках символов. Вы можете использовать String.printable?/1 и List.ascii_printable?/1, чтобы проверить, является ли заданная строка или список символов печатаемым. Если вы не хотите ограничивать количество символов конкретным числом, используйте :infinity. Принимает положительное целое число или :infinity. По умолчанию 4096.
:safe - если установлено в false, ошибки при инспектировании структур будут генерироваться как ошибки вместо обертывания в исключение Inspect.Error. Это полезно при отладке ошибок и сбоев для пользовательских реализаций инспекции.
:structs - если установлено в false, структуры не форматируются протоколом инспекции, а вместо этого печатаются как карты. По умолчанию true.
:syntax_colors - при установке в список ключевых слов цветов, вывод цветной. Ключи — типы, значения — цвета для каждого типа (например, [number: :red, atom: :blue]). Типы могут включать :atom, :binary, :boolean, :list, :map, :number, :regex, :string, и :tuple. Пользовательские типы данных могут предоставлять свои собственные опции. Цвета могут быть любыми IO.ANSI.ansidata/0, принятыми IO.ANSI.format/1.
:width - количество символов на строке, используемое, когда красивое форматирование true или при печати в устройства ввода-вывода. Установите в 0 для принудительного печати каждого элемента на отдельной строке. Если вы не хотите ограничивать количество элементов конкретным числом, используйте :infinity. По умолчанию 80.

Краткое описание

Функции

default_inspect_fun(): Возвращает функцию инспекции по умолчанию.
default_inspect_fun(fun): Устанавливает функцию инспекции по умолчанию.
new(opts): Создаёт структуру Inspect.Opts.

Типы

color_key()Источник

@type color_key() :: atom()

t()Источник

@type t() :: %Inspect.Opts{
  base: :decimal | :binary | :hex | :octal,
  binaries: :infer | :as_binaries | :as_strings,
  char_lists: :infer | :as_lists | :as_char_lists,
  charlists: :infer | :as_lists | :as_charlists,
  custom_options: keyword(),
  inspect_fun: (any(), t() -> Inspect.Algebra.t()),
  limit: non_neg_integer() | :infinity,
  pretty: boolean(),
  printable_limit: non_neg_integer() | :infinity,
  safe: boolean(),
  structs: boolean(),
  syntax_colors: [{color_key(), IO.ANSI.ansidata()}],
  width: non_neg_integer() | :infinity
}

Функции

default_inspect_fun()Источник

@spec default_inspect_fun() :: (term(), t() -> Inspect.Algebra.t())

Возвращает функцию инспекции по умолчанию.

default_inspect_fun(fun)Источник

@spec default_inspect_fun((term(), t() -> Inspect.Algebra.t())) :: :ok

Устанавливает функцию инспекции по умолчанию.

Устанавливайте эту опцию с осторожностью, так как она изменит способ инспектирования всех значений в системе. Основное использование этой функциональности — предоставление точки входа для фильтрации инспектируемых значений, чтобы сущности соответствовали правилам и законодательству по безопасности и конфиденциальности данных.

Категорически не рекомендуется библиотекам устанавливать свою собственную функцию, так как это должно контролироваться приложениями. Библиотеки должны вместо этого определять собственные структуры с пользовательскими реализациями инспекции. Если библиотеке нужно изменить функцию инспекции по умолчанию, то лучше всего попросить пользователей вашей библиотеки явно вызвать default_inspect_fun/1 с вашей функцией по выбору.

По умолчанию Inspect.inspect/2.

Примеры

previous_fun = Inspect.Opts.default_inspect_fun()

Inspect.Opts.default_inspect_fun(fn
  %{address: _} = map, opts ->
    previous_fun.(%{map | address: "[REDACTED]"}, opts)

  value, opts ->
    previous_fun.(value, opts)
end)

new(opts)Источник

@spec new(keyword()) :: t()

Создаёт структуру Inspect.Opts.

Настройки Inspect.Opts

Краткое описание

Типы

Функции

Типы

color_key()Источник

t()Источник

Функции

default_inspect_fun()Источник

default_inspect_fun(fun)Источник

Примеры

new(opts)Источник

Inspect.Opts