NAME

Catmandu::Fix::log - Log::Any logger as fix

SYNOPSIS

log('test123')

log('hello world' , level:WARN)

DESCRIPTION

This fix add debugging capabilities to fixes. To use it via the command line you need to add the '-D' option to your script. E.g.

echo '{}' | catmandu convert -D to YAML --fix 'log("help!", level:WARN)'

By default all logging messages have a level:INFO and will not be displayed unless a log4perl configuration is in place (see below). Using log messages without a log4perl configuration requires a log level of 'WARN', 'ERROR' or 'FATAL'.

CONFIGURATION

To have a full control over the log messages, create a 'catmandu.yml' with a 'log4perl' section as shown below:

$ cat catmandu.yml
log4perl: |
 log4perl.category.Catmandu::Fix::log=TRACE,OUT
 log4perl.appender.OUT=Log::Log4perl::Appender::Screen
 log4perl.appender.OUT.stderr=1
 log4perl.appender.OUT.utf8=1

 log4perl.appender.OUT.layout=PatternLayout
 log4perl.appender.OUT.layout.ConversionPattern=%d [%P] - %p %l time=%r : %m%n

Using this configuration file all logging messages are written to the screen (stderr output). With this configuration in place use the catmandu command with the -D option to view the logging output:

$ echo '{}' | catmandu convert -D to YAML --fix 'log("help!")' > output.yaml 2> log.txt

The Unix redirections '>' and '2>' can be used to write the output of the catmandu command and the logging in two separate files.

SEE ALSO

Catmandu::Fix, Catmandu::Logger , Log::log4perl