PassiveSupport.Logging (passive_support v0.8.4)

Helper functions for logging and inspecting.

These functions serve two primary purposes and one subtle but kinda nice purpose:

To keep outputs colorized even when they're sent to Logger,
To keep IO.inspect and Kernel.inspect from truncating away data you might need if you intend, e.g., to save a function's return as fixture data for debugging purposes
Not needing to temporarily require Logger when you're debugging a module

Link to this section Summary

Functions

alert(item \\ nil, label \\ nil)

coloration_opts()

Pretty good, pretty pretty, color choices for inspected data

critical(item \\ nil, label \\ nil)

debug(item \\ nil, label \\ nil)

emergency(item \\ nil, label \\ nil)

error(item \\ nil, label \\ nil)

info(item \\ nil, label \\ nil)

inspect(item, to_log \\ false)

calls Kernel.inspect/2 on item with logger_opts/0.

inspect_opts()

Sensible defaults for see a value in its entirety through IO.inspect and Kernel.inspect

logger_opts()

Sensible option defaults for logging information to stdout

notice(item \\ nil, label \\ nil)

warn(item \\ nil, label \\ nil)

Link to this section Functions

alert(item \\ nil, label \\ nil)

coloration_opts()

Specs

coloration_opts() ::
  {:syntax_colors,
   number: :yellow,
   string: :green,
   list: :light_magenta,
   map: :light_cyan,
   atom: :light_blue,
   tuple: :"[:black_background, :white]",
   regex: :"[:cyan_background, :light_yellow]"}

Pretty good, pretty pretty, color choices for inspected data

critical(item \\ nil, label \\ nil)

debug(item \\ nil, label \\ nil)

emergency(item \\ nil, label \\ nil)

error(item \\ nil, label \\ nil)

info(item \\ nil, label \\ nil)

inspect(item, to_log \\ false)

calls Kernel.inspect/2 on item with logger_opts/0.

If you wish to overwrite some portion of the opts send to inspect, consider calling Kernel.inspect and passing Utils.logger_opts() ++ overwrites as your opts instead of calling this function.

inspect_opts()

Specs

inspect_opts() :: [
  printable_limit: :infinity,
  limit: :infinity,
  width: 170,
  pretty: true
]

Sensible defaults for see a value in its entirety through IO.inspect and Kernel.inspect

logger_opts()

Specs

logger_opts() :: [
  syntax_colors: [
    number: :yellow,
    string: :green,
    list: :light_magenta,
    map: :light_cyan,
    atom: :light_blue,
    tuple: :"[:black_background, :white]",
    regex: :"[:cyan_background, :light_yellow]"
  ],
  printable_limit: :infinity,
  limit: :infinity,
  width: 170,
  pretty: true
]

Sensible option defaults for logging information to stdout

notice(item \\ nil, label \\ nil)

warn(item \\ nil, label \\ nil)