wok diff perl-try-tiny/description.txt @ rev 25507

plop: cleanup
author Pascal Bellard <pascal.bellard@slitaz.org>
date Sat Feb 11 10:36:59 2023 +0000 (21 months ago)
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/perl-try-tiny/description.txt	Sat Feb 11 10:36:59 2023 +0000
     1.3 @@ -0,0 +1,17 @@
     1.4 +This module provides bare bones try, catch, finally statements that are designed
     1.5 +to minimize common mistakes with eval blocks, and NOTHING else.
     1.6 +
     1.7 +This is unlike TryCatch which provides a nice syntax and avoids adding another
     1.8 +call stack layer, and supports calling return from the try block to return from
     1.9 +the parent subroutine. These extra features come at a cost of a few dependencies,
    1.10 +namely Devel::Declare and Scope::Upper which are occasionally problematic, and
    1.11 +the additional catch filtering uses Moose type constraints which may not be
    1.12 +desirable either.
    1.13 +
    1.14 +The main focus of this module is to provide simple and reliable error handling
    1.15 +for those having a hard time installing TryCatch, but who still want to write
    1.16 +correct eval blocks without 5 lines of boilerplate each time.
    1.17 +
    1.18 +It's designed to work as correctly as possible in light of the various
    1.19 +pathological edge cases and to be compatible with any style of error values
    1.20 +(simple strings, references, objects, overloaded objects, etc).