NAME

Mojo::Log::Role::Format - Add sprintf logging to Mojo::Log

SYNOPSIS

use Mojo::Log;
my $log = Mojo::Log->new->with_roles('+Format')->level('debug');

# [info] cool beans
$log->logf(info => 'cool %s', 'beans');

# [warn] serializing {"data":"structures"}
$log->logf(warn => 'serializing %s', {data => 'structures'});

DESCRIPTION

Mojo::Log::Role::Format is a Mojo::Log role which allow you to log with a format like sprintf(), avoid "Use of uninitialized" warnings and will also serialize data-structures and objects.

ATTRIBUTES

logf_serialize

$cb = $log->logf_serialize;
$log = $log->logf_serialize(sub (@args) { ... });

This attribute must hold a callback that will be used to serialize the arguments passed to "logf".

The default callback uses Data::Dumper with some modifications, but these settings are currently EXPERIMENTAL and subject to change:

$Data::Dumper::Indent    = 0;
$Data::Dumper::Maxdepth  = $Data::Dumper::Maxdepth || 2;
$Data::Dumper::Pair      = ':';
$Data::Dumper::Quotekeys = 1;
$Data::Dumper::Sortkeys  = 1;
$Data::Dumper::Terse     = 1;
$Data::Dumper::Useqq     = 1;

METHODS

logf

$log = $log->logf($level => $format, @args);
$log = $log->logf($level => $message);

See "SYNOPSIS".

AUTHOR

Jan Henning Thorsen

COPYRIGHT AND LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Mojo::Log