Catmandu::Fix::log(3pm)

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