Catman...x::log(3pm)

✨ NAME ✨

Catmandu::Fix::log — it's a Log::Any logger, but make it a fix 💅

---

🎀 SYNOPSIS 🎀

log('test123')

log('hello world' , level:WARN)

---

💖 DESCRIPTION 💖

okay so bestie, this fix is literally here to add debugging capabilities to your fixes. it's giving "console.log but make it catmandu" 🦋

to use it from the command line you need to add the -D option to your script. like, for example:

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

by default, all logging messages have a level of level:INFO and will NOT be displayed unless a log4perl configuration is in place (scroll down, it's below 👇). so if you're out here using log messages with no log4perl configuration at all, you need a log level of 'WARN', 'ERROR' or 'FATAL'. those are the only ones that will show up, no cap. 💀

---

🌸 CONFIGURATION 🌸

if you want full control over your log messages, create a catmandu.yml with a log4perl section, exactly like this:

$ 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

with this configuration file in place, all your logging messages get written to the screen (that's stderr output, bestie 👑). and once you've got this config living in your project, run the catmandu command with the -D option to actually see the logging output:

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

the Unix redirections '>' and '2>' are your besties here — use them to write the output of the catmandu command and the logging into two separate files. iconic, honestly. 🌈

---

🦋 SEE ALSO 🦋

• Catmandu::Fix
• Catmandu::Logger
• Log::log4perl

---

perl v5.40.1 · 2026-01-24 — that's the version and date this page was born, and it's the end of the manpage, so byeee 🫶 stay logged, stay iconic, periodt 💖✨