CGI::A...gScreen(3pm)

📦
version 1.00 · 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 CGI::Application::Plugin::DebugScreen(3pm) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation — the manual name is CGI::Application::Plugin::DebugScreen(3pm) and yes the header truncates it to CGI::A...gScreen(3pm) because apparently man pages also have a character limit, tragic, but we move. 💅

✨ NAME ✨

CGI::Application::Plugin::DebugScreen — it adds Debug support to CGI::Application.

periodt, that's the whole name section, let's go 🦋

🌸 VERSION 🌸

This documentation refers to CGI::Application::Plugin::DebugScreen version 1.00. 💖

🎀 SYNOPSIS 🎀

look at how tiny this is, the way that it's literally one line:

use CGI::Application::Plugin::DebugScreen;

That is it! The fun starts when a run mode calls die. 💀✨

🦋 DESCRIPTION 🦋

So this plug-in adds stack tracing support to CGI::Application, similar in style to the Catalyst debug mode. In the event of the module calling die, a stack trace of the error is displayed. And at each level of the stack, links to the code and documentation are provided. iconic behaviour, honestly. 👑

The stack trace functionality is deactivated unless the $ENV{CGI_APP_DEBUG} environment variable is set. Which is lowkey the best part: when your code is released, this plug-in does not need to be removed. no cleanup era required, we love a plug-in that knows when to be quiet. 🙈

The links links to code and documentation are implemented using CGI::Application::Plugin::ViewCode, which will be loaded automatically if available. However — and hear me out — these links are not supported in conjunction with CGI::Application::Dispatch. 😭

(yes the original says "links links", we're keeping it, it's part of the lore 🫶)

💜 DEPENDENCIES 💜

bestie these are the situationships this module needs to function:

  • strict
  • warnings
  • CGI::Application
  • HTML::Template
  • Devel::StackTrace
  • IO::File
  • CGI::Application::Plugin::ViewCode
  • UNIVERSAL::require

💀 BUGS AND LIMITATIONS 💀

There are no known bugs in this module. ✨

Please report problems to Atsushi Kobayashi (<nekokak@cpan.org>). Patches are welcome! 🫶

🌈 SEE ALSO 🌈

go read these too, iykyk:

  • CGI::Application::Plugin::ViewCode
  • Sledge::Plugin::DebugScreen
  • CGI::Carp::DebugScreen
  • Catalyst::Plugin::StackTrace

🌸 Thanks To 🌸

shoutout to the girlies and guys, no cap, genuinely obsessed with them:

  • MATSUNO Tokuhiro (MATSUNO)
  • Koichi Taniguchi (TANIGUCHI)
  • Masahiro Nagano (KAZEBURO)
  • Tomoyuki Misonou

👑 AUTHOR 👑

Atsushi Kobayashi, <nekokak@cpan.org>

Copyright (C) 2006 by Atsushi Kobayashi (<nekokak@cpan.org>). All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

okay and that's the whole page bestie, thanks for reading, ily, go set $ENV{CGI_APP_DEBUG} and watch your stack trace slay 💅✨

this was perl v5.30.3 on 2020-09-24 — mwah, bye! 🦋💖🎀

📦 where this page comes from