lib/Moose/Error/Default.pm

   1 package Moose::Error::Default;
   2
   3 use strict;
   4 use warnings;
   5
   6 our $VERSION   = '1.15';
   7 $VERSION = eval $VERSION;
   8 our $AUTHORITY = 'cpan:STEVAN';
   9
  10 use Carp::Heavy;
  11 use Class::MOP::MiniTrait;
  12
  13 use base 'Class::MOP::Object';
  14
  15
  16 Class::MOP::MiniTrait::apply(__PACKAGE__, 'Moose::Meta::Object::Trait');
  17
  18 sub new {
  19     my ( $self, @args ) = @_;
  20     if(exists $ENV{MOOSE_ERROR_TERSE} && $ENV{MOOSE_ERROR_TERSE}) {
  21         $self->create_error_croak( @args );
  22     }
  23     else {
  24         $self->create_error_confess( @args );
  25     }
  26 }
  27
  28 sub create_error_croak {
  29     my ( $self, @args ) = @_;
  30     $self->_create_error_carpmess( @args );
  31 }
  32
  33 sub create_error_confess {
  34     my ( $self, @args ) = @_;
  35     $self->_create_error_carpmess( @args, longmess => 1 );
  36 }
  37
  38 sub _create_error_carpmess {
  39     my ( $self, %args ) = @_;
  40
  41     my $carp_level = 3 + ( $args{depth} || 1 );
  42     local $Carp::MaxArgNums = 20; # default is 8, usually we use named args which gets messier though
  43
  44     my @args = exists $args{message} ? $args{message} : ();
  45
  46     if ( $args{longmess} || $Carp::Verbose ) {
  47         local $Carp::CarpLevel = ( $Carp::CarpLevel || 0 ) + $carp_level;
  48         return Carp::longmess(@args);
  49     } else {
  50         return Carp::ret_summary($carp_level, @args);
  51     }
  52 }
  53
  54 __PACKAGE__
  55
  56 __END__
  57
  58 =pod
  59
  60 =head1 NAME
  61
  62 Moose::Error::Default - L<Carp> based error generation for Moose.
  63
  64 =head1 DESCRIPTION
  65
  66 This class implements L<Carp> based error generation.
  67
  68 The default behavior is like L<Moose::Error::Confess>. To override this
  69 to default to L<Moose::Error::Croak>'s behaviour on a system wide basis,
  70 set the MOOSE_ERROR_TERSE environment variable to a true value.
  71
  72 =head1 METHODS
  73
  74 =over 4
  75
  76 =item new @args
  77
  78 Create a new error. Delegates to C<create_error_confess> or
  79 C<create_error_croak>.
  80
  81 =item create_error_confess @args
  82
  83 =item create_error_croak @args
  84
  85 Creates a new errors string of the specified style.
  86
  87 =back
  88
  89 =cut
  90
  91