MooseX::LogDispatch(3)User Contributed Perl DocumentatioMooseX::LogDispatch(3)NAMEMooseX::LogDispatch - A Logging Role for Moose
VERSION
This document describes MooseX::LogDispatch version 1.1000
SYNOPSIS
package MyApp;
use Moose;
with MooseX::LogDispatch;
# or
# with MooseX::LogDispatch::Levels
# This is optional. Will log to screen if not provided
has log_dispatch_conf => (
is => 'ro',
lazy => 1,
default => sub {
my $self = shift;
My::Configurator->new( # <- you write this class!
file => $self->log_file,
debug => $self->debug,
);
}
);
# This is the same as the old FileBased config parameter to the role. If you
# prefer you could name the attribute 'config_filename' instead.
has log_dispatch_conf => (
is => 'ro',
lazy => 1,
default => "/path/to/my/logger.conf"
);
# Here's another variant, using a Log::Dispatch::Configurator-style
# hashref to configure things without an explicit subclass
has log_dispatch_conf => (
is => 'ro',
isa => 'HashRef',
lazy => 1,
required => 1,
default => sub {
my $self = shift;
return $self->debug ?
{
class => 'Log::Dispatch::Screen',
min_level => 'debug',
stderr => 1,
format => '[%p] %m at %F line %L%n',
}
: {
class => 'Log::Dispatch::Syslog',
min_level => 'info',
facility => 'daemon',
ident => $self->daemon_name,
format => '[%p] %m',
};
},
);
sub foo {
my ($self) = @_;
$self->logger->debug("started foo");
....
$self->logger->debug('ending foo');
}
DESCRIPTION
Log::Dispatch role for use with your Moose classes.
ACCESSORS
logger
This is the main Log::Dispatch::Config object that does all the work.
It has methods for each of the log levels, such as "debug" or "error".
log_dispatch_conf
This is an optional attribute you can give to your class. If you
define it as a hashref value, that will be interpreted in the style of
the configuration hashrefs documented in Log::Dispatch::Config
documents where they show examples of using a PLUGGABLE CONFIGURATOR
for pluggable configuration.
You can also gain greater flexibility by defining your own complete
Log::Dispatch::Configurator subclass and having your
"log_dispatch_config" attribute be an instance of this class.
If this attribute has a value of a string, it will be taken to by the
path to a config file for Log::Dispatch::Configurator::AppConfig.
By lazy-loading this attribute ("lazy => 1"), you can have the
configuration determined at runtime. This is nice if you want to
change your log format and/or destination at runtime based on things
like MooseX::Getopt / MooseX::Daemonize parameters.
If you don't provide this attribute, we'll default to sending
everything to the screen in a reasonable debugging format.
use_logger_singleton
If this attribute has a true value, and Log::Dispatch::Config has a
configured log instance, this will be used in preference to anything
set via "log_dispatch_config".
The main use for this attribute is when you want to use this module in
another library module - i.e. the consumer of this role is not the end
user. Setting this attribute to true makes it much easier for the end
user to configure logging.
Note: If you are using a class consuming this one as a role, and plan
on reinstantiating that class, its probably a good idea to set this to
1 to avoid errors.
SEE ALSO
MooseX::LogDispatch::Levels, Log::Dispatch::Configurator,
Log::Dispatch::Config, Log::Dispatch.
DEPRECATION NOTICE
The old "with Logger(...)" style has been deprecated in favour of just
using one of two roles and making the config much more flexible. As of
version 1.2000 of this module, attempting to use it will make your code
die.
BUGS AND LIMITATIONS
Please report any bugs or feature requests to
"bug-moosex-logdispatch@rt.cpan.org", or through the web interface at
<http://rt.cpan.org>.
Or come bother us in "#moose" on "irc.perl.org".
AUTHOR
Ash Berlin "<ash@cpan.org>" v1.2000 fixes by Mike Whitaker
"<penfold@cpan.org>"
Based on work by Chris Prather "<perigrin@cpan.org>"
Thanks to Brandon Black "<blblack@gmail.com>" for showing me a much
nicer way to configure things.
LICENCE AND COPYRIGHT
Some development sponsored by Takkle Inc.
Copyright (c) 2007, Ash Berlin "<ash@cpan.org>". Some rights reserved.
Copyright (c) 2007, Chris Prather "<perigrin@cpan.org>". Some rights
reserved.
This module is free software; you can redistribute it and/or modify it
under the same terms as Perl itself. See perlartistic.
perl v5.14.1 2008-10-23 MooseX::LogDispatch(3)
