Easy(3p)

NAME
MooseX::Log::Log4perl::Easy - A Logging Role with easy interface for Moose based on MooseX::Log::Log4perl

VERSION
This document describes MooseX::Log::Log4perl::Easy version 0.31

SYNOPSIS
 package MyApp;
 use Moose;
 use Log::Log4perl qw(:easy);

 with 'MooseX::Log::Log4perl::Easy';

 BEGIN {
        Log::Log4perl->easy_init();
 }

 sub foo {
   my ($self) = @_;
   $self->log_debug("started bar");            ### logs with default class catergory "MyApp"
   $self->log_info('bar');                     ### logs an info message
   $self->log('AlsoPossible')->fatal("croak"); ### log
 }

DESCRIPTION
The Easy logging role based on the MooseX::Log::Log4perl logging role for Moose directly adds the logmethods for all available levels to your class instance. Hence it is possible to use

  $self->log_info("blabla");

without having to access a seperate log attribute as in MooseX::Log::Log4perl;

In case your app grows and you need more of the super-cow powers of Log4perl or simply don't want the additional methodes to clutter up your class you can simply replace all code "$self->log_LEVEL" with "$self->log->LEVEL".

You can use the following regex substitution to accomplish that:

  s/log(_(trace|debug|info|warn|error|fatal))/log->$2/g

ACCESSORS

  logger
See MooseX::Log::Log4perl

  log
See MooseX::Log::Log4perl

  log_fatal ($msg)
Logs a fatal message $msg using the logger attribute. Same as calling

  $self->logger->fatal($msg)

  log_error ($msg)
Logs an error message using the logger attribute. Same as calling

  $self->logger->error($msg)

  log_warn ($msg)
Logs a warn message using the logger attribute. Same as calling

  $self->logger->warn($msg)

  log_info ($msg)
Logs an info message using the logger attribute. Same as calling

  $self->logger->info($msg)

  log_debug ($msg)
Logs a debug message using the logger attribute. Same as calling

  $self->logger->debug($msg)

  log_trace ($msg)
Logs a trace message using the logger attribute. Same as calling

  $self->logger->trace($msg)

SEE ALSO
MooseX::Log::Log4perl, Log::Log4perl, Moose

BUGS AND LIMITATIONS
Please report any bugs or feature requests to "bug-moosex-log4perl@rt.cpan.org", or through the web interface at <http://rt.cpan.org>.

Or come bother us in "#moose" on "irc.perl.org".

AUTHOR
Roland Lammel "<lammel@cpan.org>"

Inspired by suggestions by Michael Schilli "<m@perlmeister.com>"

Contributions from Tim Bunce "<TIMB@cpan.org>"

LICENCE AND COPYRIGHT
Copyright (c) 2008-2009, Roland Lammel "<lammel@cpan.org>", http://www.quikit.at. 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.