Perl module - Config::Any loader for Log4perl config files
Perl
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib/Config/Any
t
.includepath
.project
Changes
README.mkdn
dist.ini

README.mkdn

NAME

Config::Any::Log4perl - Config::Any loader for Log4perl config files

VERSION

version 0.130020

SYNOPSIS

use Config::Any;

...

my $config = Config::Any->load_files({
      files => \@files
    , use_ext => 1
    , driver_args => { Log4perl => { config_name => 'logger' }}
});

...

See Config::Any

DESCRIPTION

Loads Log4perl configuration files.

Example:

### sample.log4perl
log4perl.logger                                   = TRACE, SCREEN
log4perl.appender.SCREEN                          = Log::Log4perl::Appender::Screen
log4perl.appender.SCREEN.stderr                   = 1
log4perl.appender.SCREEN.layout                   = Log::Log4perl::Layout::PatternLayout
log4perl.appender.SCREEN.layout.ConversionPattern = %d %-5p [%5P] %m%n

METHODS

extensions

Return an array of valid extensions.

  • Return value

    ARRAY - qw( log4perl ).

load($file, $args)

Attempts to load a Log4perl config file.

  • Parameters

    $file - SCALAR - The Log4perl config file.

    $args - HASHREF - optional - Possible options:

      __config\_name__ - A key used to store configuration.
    
  • Return value

    HASHREF - Log4perl configuration.

  • Example

    With this Log4perl configuration file:

      ### sample.log4perl
      log4perl.logger                                   = TRACE, SCREEN
      log4perl.appender.SCREEN                          = Log::Log4perl::Appender::Screen
      log4perl.appender.SCREEN.stderr                   = 1
      log4perl.appender.SCREEN.layout                   = Log::Log4perl::Layout::PatternLayout
      log4perl.appender.SCREEN.layout.ConversionPattern = %d %-5p [%5P] %m%n
    

    If config_name is undefined the return value is:

      {
          'log4perl.appender.SCREEN.layout' => 'Log::Log4perl::Layout::PatternLayout',
          'log4perl.appender.SCREEN.layout.ConversionPattern' => '%d %-5p [%5P] %m%n',
          'log4perl.appender.SCREEN.stderr' => '1',
          'log4perl.logger' => 'TRACE, SCREEN',
          'log4perl.appender.SCREEN' => 'Log::Log4perl::Appender::Screen'
      }
    

    If config_name is defined like this:

      config_name => 'logger'
    

    the return value is:

      {
          'logger' => {
              'log4perl.appender.SCREEN.layout' => 'Log::Log4perl::Layout::PatternLayout',
              'log4perl.appender.SCREEN.layout.ConversionPattern' => '%d %-5p [%5P] %m%n',
              'log4perl.appender.SCREEN.stderr' => '1',
              'log4perl.appender.SCREEN' => 'Log::Log4perl::Appender::Screen',
              'log4perl.logger' => 'TRACE, SCREEN'
          }
      }
    

SEE ALSO

Log::Log4perl

AUTHOR

Loïc TROCHET losyme@cpan.org

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Loïc TROCHET.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.