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).