/ 
File-DataClass-v0.20.6
River stage one • 8 direct dependents • 8 total dependents
/ File::DataClass::Exception

Name

File::DataClass::Exception - Moose exception class composed from traits

Synopsis

use File::DataClass::Functions qw(throw);
use Try::Tiny;

sub some_method {
   my $self = shift;

   try   { this_will_fail }
   catch { throw $_ };
}

# OR
use File::DataClass::Exception;

sub some_method {
   my $self = shift;

   eval { this_will_fail };
   File::DataClass::Exception->throw_on_error;
}

# THEN
try   { $self->some_method() }
catch { warn $_."\n\n".$_->stacktrace."\n" };

Version

This documents version v0.20.$Rev: 0 $ of File::DataClass::Exception

Description

An exception class that supports error messages with placeholders, a "throw" in File::DataClass::Exception::TraitFor::Throwing method with automatic re-throw upon detection of self, conditional throw if an exception was caught and a simplified stacktrace

Applies exception roles to the exception base class File::DataClass::Exception::Base. See "Dependencies" for the list of roles that are applied

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

Configuration and Environment

Calls to File::DataClass::Exception-add_roles> applies the specified list of optional roles

Subroutines/Methods

BUILD

Does nothing placeholder that allows the applied roles to modify it

is_one_of_us

$bool = $class->is_one_of_us( $string_or_exception_object_ref );

Class method which detects instances of this exception class

Diagnostics

None

Dependencies

namespace::autoclean
File::DataClass::Exception::Base
File::DataClass::Exception::TraitFor::Throwing
File::DataClass::Exception::TraitFor::TracingStacks
Moose

Incompatibilities

There are no known incompatibilities in this module

Bugs and Limitations

There are no known bugs in this module. Please report problems to the address below. Patches are welcome

Acknowledgements

Larry Wall - For the Perl programming language

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

Author

Peter Flanigan, <pjfl@cpan.org>

License and Copyright

Copyright (c) 2013 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