Logger(3pm)

πŸ“¦ version 2.1.1, in arch rolling

πŸ¦‹ Logger(3pm) πŸ¦‹

okay so bestie, this is the Lire::Logger page from LogReport's Lire Documentation β€” welcome to the group chat where the vibes are immaculate and the logging is very real. πŸ’–

✨ NAME ✨

  • Lire::Logger β€” Lire's logging interface.

🌈 SYNOPSIS 🌈

Any program, no cap:

    use Lire::Logger qw/ lr_info lr_debug lr_warn /;

    lr_info( "doing stuff " );
    lr_debug( "debugging information" );
    lr_warn( "encountered unexpected value: ", $value );
    open( CFGFILE, "my.conf" ) or lr_err( "open error: ", $! );

πŸ’œ DESCRIPTION πŸ’œ

This module contains functions that should be used by everything in the Lire framework which should need logging. Literally, if it logs in Lire, it's supposed to come through here. 🫢

All logging functions take any number of parameters that will be joined together to form the message (like print(), die(), warn() and friends). So yeah, stack those args, bestie β€” they get stitched together. ✨

🌸 lr_emerg() 🌸

This logs a message at the "emerg" level and aborts your program. This probably shouldn't be used.

🚨 The page literally says this probably shouldn't be used, bestie. That's the warning. 😭

πŸ”₯ lr_crit() πŸ”₯

This logs a message at the "crit" level and aborts your program. This should only be used when something is really broken in the Lire program or the environment. It is used a few places in Lire when assertion that should really never fail (like a DLF file with the wrong number of fields).

😭 lr_err() 😭

This logs a message at the "err" level and usually aborts your program. (It is the equivalent of a die().) The program won't abort if it's used in an eval block. Use this for error condition.

🩹 lr_warn() 🩹

This logs a message at the "warning" level. Perl's builtin warn is mapped to this function. Use this for non-fatal errors. Non-fatal, so we're not spiraling β€” just side-eyeing the problem. πŸ’…

πŸŽ€ lr_notice() πŸŽ€

This logs a message at the "notice" level. This should be used for significant informational messages that the user should see. (By default, the user will only see messages at level "notice" or higher.) So like, if it's important enough for the user's eyeballs, this is your girl. πŸ‘‘

πŸ’– lr_info() πŸ’–

This logs a message at the "info" level. Use this for general informational messages. Casual, useful, no drama. ✨

πŸ› lr_debug() πŸ›

This logs a message at the "debug" level. Use this for debugging messages. This is the "bestie, I'm in the weeds" lane. πŸ”

πŸ‘€ SEE ALSO πŸ‘€

πŸ’Œ AUTHOR πŸ’Œ

  • Francis J. Lacoste <flacoste@logreport.org>

🧾 VERSION 🧾

$Id: Logger.pm,v 1.10 2006/07/23 13:16:29 vanbaal Exp $

Copyright (C) 2001-2003 Stichting LogReport Foundation LogReport@LogReport.org

This file is part of Lire.

Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.


πŸ’– And that's the page, bestie β€” source/version Lire 2.1.1, date 2025-09-28. Go log like the main character you are. ✨

πŸ“¦ where this page comes from