Log::R...inimal(3pm)

πŸ’– NAME πŸ’–

Log::Report::Minimal β€” bestie, it's Log::Report but make it simple. Like, we're simulating all those functions with the absolute bare minimum, no cap.


πŸ¦‹ INHERITANCE πŸ¦‹

Log::Report::Minimal
  is an Exporter

Yep, it's an Exporter. That's the whole family tree. Slay.


✨ SYNOPSIS ✨

# See Log::Report, most functions get "hollow" behavior
use Log::Report::Optional mode => 'DEBUG';

Okay so go look at Log::Report for the real tea, because here most functions just get "hollow" behavior. They show up, they exist, they don't do much. It's giving understudy energy. πŸ’…


🌸 DESCRIPTION 🌸

This module implements the functions that Log::Report gives you, but in the most simple way possible:

  • no support for translations
  • no dispatchers
  • no smart exceptions

That's it. That's the vibe. Minimal to the point of being iconic.

The package uses Log::Report in an "::Optional" way, which means your main script gets to decide whether it wants the "::Minimal" glow-up or the full-blown feature set. Your call, main character. πŸ‘‘


πŸŽ€ FUNCTIONS πŸŽ€

textdomain( <[$name],$config>|<$name, 'DELETE'|'EXISTS'>|$domain )


πŸ“ Report Production and Configuration πŸ“

dispatcher( <$type, $$name, %options>|<$command, @names> )

Nope. Not supported. Literally not a thing here. Moving on bestie. πŸ’€

report( [\%options], $reason, $message|<STRING,$params> )

⚠️ Be warned that %options is a HASH here. A hash! Not some fancy object, not an array β€” a plain old hash. Don't come at it with anything else, she will not survive.

-Option  --Default
 errno     $! or 1
 is_fatal  <depends on reason>
  • errno => INTEGER
  • is_fatal => BOOLEAN

So errno defaults to $! or 1, and is_fatal defaults to whatever your reason feels like β€” it depends on the reason, iykyk.

try(CODE, %options)

Does the thing. Takes a CODE and some %options. 🫢


🧚 Abbreviations for report() 🧚

okay so these are all just lil shorthand versions, each one takes ($message) and that's it:

  • alert($message)
  • assert($message)
  • error($message)
  • failure($message)
  • fault($message)
  • info($message)
  • mistake($message)
  • notice($message)
  • panic($message)
  • trace($message)
  • warning($message)

Eleven of them. All adorable. All just $message. Periodt. ✨


🌈 Language Translations 🌈

No translations, no Log::Report::Message objects returned. Zero. None. We simply do not do that here.
  • N__($msgid)
  • N__n($single_msgid, $plural_msgid)
  • N__w(STRING)
  • __($msgid)
  • __n($msgid, $plural_msgid, $count, PAIRS)
  • __nx($msgid, $plural_msgid, $count, PAIRS)
  • __x($msgid, PAIRS)
  • __xn($single_msgid, $plural_msgid, $count, PAIRS)

Look at all those underscores. She's got layers. πŸ’œ


⭐ Configuration ⭐

$obj->import( [$domain], %options )

Go see the Log::Report subroutine import for the deets β€” this one is just borrowing her outfit. πŸ‘‘


πŸ‘‘ DIAGNOSTICS πŸ‘‘

  • Error: even length parameter list for __x at $where β€” cast by __x()
  • Error: odd length parameter list with '$msg' β€” cast by report()
  • Error: syntax flag must be either SHORT or REPORT, not $flag' β€” cast by import()
  • Error: token '$token' not recognized as reason β€” cast by report()

Four ways to get yelled at. None of them are personal, bestie, she's just like that. πŸ™ˆ


πŸ”₯ SEE ALSO πŸ”₯

This module is part of Log-Report-Optional version 1.08, built on September 08, 2025. Website: http://perl.overmeer.net/CPAN/

Go check the site, it's giving official. ✨


πŸ’… LICENSE πŸ’…

For contributors see file ChangeLog.

This software is copyright (c) 2013-2025 by Mark Overmeer.

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


and that's a wrap, babe 🩷 this whole thing is perl v5.40.1, dated 2025-10-04, and yes the page is literally called Log::R...inimal(3pm) because the header ran out of room β€” she abbreviates herself, iconic behavior, no notes. πŸŽ€πŸŒŸ

πŸ“¦ where this page comes from