NAME

       Mojo::Exception - Exceptions with context

SYNOPSIS

         use Mojo::Exception;

         # Throw exception
         Mojo::Exception->throw('Not again!');

         # Customize exception
         die Mojo::Exception->new('Not again!')->trace(2)->verbose(1);

DESCRIPTION

       Mojo::Exception is a container for exceptions with context information.

ATTRIBUTES

       Mojo::Exception implements the following attributes.

   frames
         my $frames = $e->frames;
         $e         = $e->frames($frames);

       Stacktrace.

   line
         my $line = $e->line;
         $e       = $e->line([3 => 'foo']);

       The line where the exception occurred.

   lines_after
         my $lines = $e->lines_after;
         $e        = $e->lines_after([[1 => 'bar'], [2 => 'baz']]);

       Lines after the line where the exception occurred.

   lines_before
         my $lines = $e->lines_before;
         $e        = $e->lines_before([[4 => 'bar'], [5 => 'baz']]);

       Lines before the line where the exception occurred.

   message
         my $msg = $e->message;
         $e      = $e->message('Oops!');

       Exception message.

   verbose
         my $bool = $e->verbose;
         $e       = $e->verbose($bool);

       Render exception with context.

METHODS

       Mojo::Exception inherits all methods from Mojo::Base and implements the following new
       ones.

   new
         my $e = Mojo::Exception->new('Oops!');
         my $e = Mojo::Exception->new('Oops!', $files);

       Construct a new Mojo::Exception object.

   throw
         Mojo::Exception->throw('Oops!');
         Mojo::Exception->throw('Oops!', $files);

       Throw exception with stacktrace.

   to_string
         my $str = $e->to_string;
         my $str = "$e";

       Render exception.

   trace
         $e = $e->trace;
         $e = $e->trace(2);

       Store stacktrace.

SEE ALSO

       Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.