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.