1Catalyst::Plugin::StackUTsrearceC(o3n)tributed Perl DocuCmaetnatlaytsito:n:Plugin::StackTrace(3)
2
3
4

NAME

6       Catalyst::Plugin::StackTrace - Display a stack trace on the debug
7       screen
8

SYNOPSIS

10           use Catalyst qw/-Debug StackTrace/;
11

DESCRIPTION

13       This plugin will enhance the standard Catalyst debug screen by includ‐
14       ing a stack trace of your appliation up to the point where the error
15       occurred.  Each stack frame is displayed along with the package name,
16       line number, file name, and code context surrounding the line number.
17
18       This plugin is only active in -Debug mode.
19

CONFIGURATION

21       Configuration is optional and is specified in MyApp->config->{stack‐
22       trace}.
23
24       context
25
26       The number of context lines of code to display on either side of the
27       stack frame line.  Defaults to 3.
28
29       reverse
30
31       By default, the stack frames are shown in from "top" to "bottom" (new‐
32       est to oldest). Enabling this option reverses the stack frames so they
33       will be displayed "bottom" to "top", or from the callers perspective.
34
35       verbose
36
37       This option sets the amount of stack frames you want to see in the
38       stack trace.  It defaults to 0, meaning only frames from your applica‐
39       tion's namespace are shown.  You can use levels 1 and 2 for deeper
40       debugging.
41
42       If set to 1, the stack trace will include frames from packages outside
43       of your application's namespace, but not from most of the Catalyst
44       internals.  Packages ignored at this level include:
45
46           Catalyst
47           Catalyst::Action
48           Catalyst::Base
49           Catalyst::Dispatcher
50           Catalyst::Engine::*
51           Catalyst::Plugin::StackTrace
52           Catalyst::Plugin::Static::Simple
53           NEXT
54           main
55
56       If set to 2, the stack trace will include frames from everything except
57       this module.
58

INTERNAL METHODS

60       The following methods are extended by this plugin.
61
62       execute
63           In execute, we create a local die handler to generate the stack
64           trace.
65
66       finalize_error
67           In finalize_error, we inject the stack trace HTML into the debug
68           screen below the error message.
69
70       setup
71

SEE ALSO

73       Catalyst
74

AUTHORS

76       Andy Grundman, <andy@hybridized.org>
77
78       Matt S. Trout, <mst@shadowcatsystems.co.uk>
79

THANKS

81       The authors of CGI::Application::Plugin::DebugScreen, from which a lot
82       of code was used.
83

85       This program is free software, you can redistribute it and/or modify it
86       under the same terms as Perl itself.
87
88
89
90perl v5.8.8                       2008-02-01   Catalyst::Plugin::StackTrace(3)
Impressum