Peter Flanigan > Unexpected > Unexpected

Download:
unexpected/Unexpected-0.38.1.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: v0.38.1   Source  

Name ^

Unexpected - Localised exception classes composed from roles

Synopsis ^

   package YourApp::Exception;

   use Moo;

   extends 'Unexpected';
   with    'Unexpected::TraitFor::ErrorLeader';

   __PACKAGE__->ignore_class( 'YourApp::IgnoreMe' );

   has '+class' => default => __PACKAGE__;

   package YourApp;

   use YourApp::Exception;
   use Try::Tiny;

   sub some_method {
      my $self = shift;

      try   { this_will_fail }
      catch { YourApp::Exception->throw $_ };
   }

   # OR

   sub some_method {
      my $self = shift;

      eval { this_will_fail };
      YourApp::Exception->throw_on_error;
   }

   # THEN
   try   { $self->some_method() }
   catch { warn $_->message };

Description ^

An exception class that supports error messages with placeholders, a throw method with automatic re-throw upon detection of self, conditional throw if an exception was caught and a simplified stack trace in addition to the error message with full stack trace

Configuration and Environment ^

Applies exception roles to the exception base class Unexpected. See "Dependencies" for the list of roles that are applied

The list of constructor methods signatures is described in build_attr_from

Error objects are overloaded to stringify to the full error message plus a leader if the optional ErrorLeader role has been applied

Subroutines/Methods ^

BUILD

Dummy subroutine which is modified by the applied roles

BUILDARGS

Differentiates different constructor method signatures

Diagnostics ^

String overload is performed in this class as opposed to the stringify error role since overloading is not supported in Moo::Role

Dependencies ^

namespace::autoclean
overload
Moo
Unexpected::TraitFor::ExceptionClasses
Unexpected::TraitFor::StringifyingError
Unexpected::TraitFor::Throwing
Unexpected::TraitFor::TracingStacks

Incompatibilities ^

There are no known incompatibilities in this module

Bugs and Limitations ^

Throwable did not let me use the stack trace filter directly, it's wrapped inside an attribute constructor. There was nothing else in Throwable that would not have been overridden

There are no known bugs in this module. Please report problems to http://rt.cpan.org/NoAuth/Bugs.html?Dist=Unexpected. Patches are welcome

Acknowledgements ^

Larry Wall - For the Perl programming language

Throwable::Error - Lifted the stack frame filter from here

John Sargent - Came up with the package name

Author ^

Peter Flanigan, <pjfl@cpan.org>

License and Copyright ^

Copyright (c) 2015 Peter Flanigan. All rights reserved

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

This program is distributed in the hope that it will be useful, but WITHOUT WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE

syntax highlighting: