NAME MooseX::Role::Loggable - Extensive, yet simple, logging role using Log::Dispatchouli VERSION version 0.004 SYNOPSIS package My::Object; use Moose; with 'MooseX::Role::Loggable'; sub do_this { my $self = shift; $self->set_prefix('[do_this] '); $self->log_debug('starting...'); ... $self->log_debug('more stuff'); $self->clear_prefix; } DESCRIPTION This is a role to provide logging ability to whoever consumes it using Log::Dispatchouli. Once you consume this role, you have the attributes and methods documented below. This module uses Any::Moose so you can use it with Moose or Mouse. ATTRIBUTES debug A boolean for whether you're in debugging mode or not. Default: no. Read-only. logger_facility The facility the logger would use. This is useful for syslog. Default: local6. logger_ident The ident the logger would use. This is useful for syslog. Default: MooseX::Role::Loggable. Read-only. log_to_file A boolean that determines if the logger would log to a file. Default location of the file is in /tmp. Default: no. Read-only. log_to_stdout A boolean that determines if the logger would log to STDOUT. Default: no. log_to_stderr A boolean that determines if the logger would log to STDERR. Default: no. log_file The leaf name for the log file. Default: undef log_path The path for the log file. Default: undef log_pid Whether to append the PID to the log filename. Default: yes log_fail_fatal Whether failure to log is fatal. Default: yes log_muted Whether only fatals are logged. Default: no log_quiet_fatal From Log::Dispatchouli: *'stderr' or 'stdout' or an arrayref of zero, one, or both fatal log messages will not be logged to these*. Default: stderr logger A Log::Dispatchouli object. METHODS All methods here are imported from Log::Dispatchouli. You can read its documentation to understand them better. log Log a message. log_debug Log a message only if in debug mode. log_fatal Log a message and die. set_debug Set the debug flag. clear_debug Clear the debug flag. set_prefix Set a prefix for all next messages. clear_prefix Clears the prefix for all next messages. set_muted Sets the mute property, which makes only fatal messages logged. clear_muted Clears the mute property. AUTHOR Sawyer X COPYRIGHT AND LICENSE This software is copyright (c) 2011 by Sawyer X. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.