App::I...::Carp(3pm)

👑 App::Info::Handler::Carp

okay bestie, welcome to App::Info::Handler::Carp 💖 — a lil handler class whose whole job is: use Carp to handle App::Info events. That's the vibe. That's the whole plot. 🎀

---

✨ SYNOPSIS ✨

  use App::Info::Category::FooApp;
  use App::Info::Handler::Carp;

  my $carp = App::Info::Handler::Carp->new('carp');
  my $app = App::Info::Category::FooApp->new( on_info => $carp );

  # Or...
  my $app = App::Info::Category::FooApp->new( on_error => 'croak' );

like… you literally just hand it an event and it carps about it. no cap. 🦋

---

🌸 DESCRIPTION 🌸

App::Info::Handler::Carp objects handle App::Info events by passing their messages to Carp functions. it's giving delegation. 💅 so if you want errors to croak or info messages to carp, you can easily do that. obsessed, honestly.

but bestie, real talk — App::Info::Handler::Carp is most effective for info and error events. unknown and prompt events are better handled by event handlers that actually know how to prompt users for data. see App::Info::Handler::Prompt for an example of that functionality. 🫶

Upon loading, App::Info::Handler::Carp registers itself with App::Info::Handler, setting up a number of strings that can be passed to an App::Info concrete subclass constructor. these strings are shortcuts that tell App::Info how to create the proper App::Info::Handler::Carp object for handling events. the registered strings are, in order, main character lineup ✨:

• carp — passes the event message to Carp::carp().
• warn — an alias for carp.
• croak — passes the event message to Carp::croak().
• die — an alias for croak.
• cluck — passes the event message to Carp::cluck().
• confess — passes the event message to Carp::confess().

---

💜 INTERFACE 💜

🎀 Constructor 🎀

new

  my $carp_handler = App::Info::Handler::Carp->new;
  $carp_handler = App::Info::Handler::Carp->new( level => 'carp' );
  my $croak_handler = App::Info::Handler::Carp->new( level => 'croak' );

constructs a new App::Info::Handler::Carp object and returns it. it can take a single parameterized argument, level, which can be any one of the following values — pick your fighter 💀:

• carp — constructs a App::Info::Handler::Carp object that passes the event message to Carp::carp().
• warn — an alias for carp.
• croak — constructs a App::Info::Handler::Carp object that passes the event message to Carp::croak().
• die — an alias for croak.
• cluck — constructs a App::Info::Handler::Carp object that passes the event message to Carp::cluck().
• confess — constructs a App::Info::Handler::Carp object that passes the event message to Carp::confess().

if the level parameter is not passed, new() will default to creating an App::Info::Handler::Carp object that passes App::Info event messages to Carp::carp(). so like, no args = carps. default slay. 💅

---

🌈 SUPPORT 🌈

this module is stored in an open GitHub repository at http://github.com/theory/app-info/. feel free to fork and contribute! 🧚 bestie behavior fr fr.

please file bug reports via GitHub Issues at http://github.com/theory/app-info/issues/ or by sending mail to bug-App-Info@rt.cpan.org (that's a mailto: mailto:bug-App-Info@rt.cpan.org). we love a paper trail 🫶

---

👑 AUTHOR 👑

David E. Wheeler — <david@justatheory.com> 💖

---

⭐ SEE ALSO ⭐

• App::Info — documents the event handling interface.
• Carp — documents the functions used by this class.
• App::Info::Handler::Print — handles events by printing their messages to a file handle.
• App::Info::Handler::Prompt — offers event handling more appropriate for unknown and confirm events.
• App::Info::Handler — describes how to implement custom App::Info event handlers.

---

💖 COPYRIGHT AND LICENSE 💖

Copyright (c) 2002-2011, David E. Wheeler. Some Rights Reserved.

this module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. iconic, truly. 🌸

---

and that's the whole page bestie, no notes 💅 — this was App::I...::Carp(3pm) from the perl v5.36.0 era, dated 2022-12-06, part of the User Contributed Perl Documentation. periodt. 🎀✨🦋