NAME

Try::Lite - easy exception catcher with auto rethrow

SYNOPSIS

use Try::Lite;
try {
    YourExceptionClass->throw;
} (
    'YourExceptionClass' => sub {
        say ref($@); # show 'YourExceptionClass'
    }
);

You can catch base exception class:

package YourExceptionClass {
    use parent 'BaseExceptionClass';
}

try {
    YourExceptionClass->throw;
} (
    'BaseExceptionClass' => sub {
        say ref($@); # show 'YourExceptionClass'
    }
);

You can catch any exception:

try {
    die "oops\n";
} (
    '*' => sub {
        say $@; # show "oops\n";
    }
);

If there is no matched catch clause, Try::Lite rethrow the exception automatically:

eval {
    try {
        die "oops\n";
    } (
        'YourExceptionClass' => sub {}
    );
};
say $@; # show "oops\n"

You can receives the try block return value and catechs subs return value:

my $ret = try {
    'foo'
} ( '*' => sub {} );
say $ret; # show 'foo'

my $ret = try {
    die 'foo'
} ( '*' => sub { 'bar' } );
say $ret; # show 'bar'

You can catch any exceptions:

sub run (&) {
  my $code = shift;

  try { $code->() } (
    'FileException'    => sub { say 'file exception' },
    'NetworkException' => sub { say 'network exception' }
  );
}

run { FileException->throw };    # show 'file exception'
run { NetworkException->throw }; # show 'network exception'
run { die 'oops' };              # Died

DESCRIPTION

Try::Lite is easy exception catch with Exception classes. Exception other than the all specified conditions are It run rethrow.

THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.

EXPORT

try $code_ref, %catche_rules

AUTHOR

Kazuhiro Osawa <yappo {@} shibuya {dot} pl>

SEE ALSO

try function base is Try::Tiny

LICENSE

Copyright (C) Kazuhiro Osawa

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