enclosed-exceptions

Catching all exceptions from within an enclosed computation

https://github.com/jcristovao/enclosed-exceptions

LTS Haskell 22.43:1.0.3
Stackage Nightly 2024-11-24:1.0.3
Latest on Hackage:1.0.3

See all snapshots enclosed-exceptions appears in

MIT licensed by Michael Snoyman, João Cristóvão
Maintained by [email protected], [email protected]
This version can be pinned in stack with:enclosed-exceptions-1.0.3@sha256:6d4e9b5156721ccfa62d3cdcbf13d8571773031050ec714cb55b841f0c183f6a,1911

Module documentation for 1.0.3

Used by 1 package in lts-22.43(full list with versions):
shelly

enclosed-exceptions

The purpose of this module is to allow you to capture all exceptions originating from within the enclosed computation, while still reacting to asynchronous exceptions aimed at the calling thread.

This way, you can be sure that the function that calls, for example, catchAny, will still respond to ThreadKilled or Timeout events raised by another thread (with throwTo), while capturing all exceptions, synchronous or asynchronous, resulting from the execution of the enclosed computation.

One particular use case is to allow the safe execution of code from various libraries (which you do not control), capturing any faults that might occur, while remaining responsive to higher level events and control actions.

This library was originally developed by Michael Snoyman for the ClassyPrelude library, and was latter spun-off into a separate independent package.

For a more detailed explanation of the motivation behind this functions, see:

Catching all exceptions

and

the discussion in haskell-cafe

Changes

ChangeLog for enclosed-exceptions

1.0.3

  • Skip some tests on GHC 8.4 #12

1.0.2.1

  • Support for GHC 7.4 and earlier

1.0.2

  • Use MVar in tryAny, drop async dependency #9

1.0.1

  • Added tryDeep and catchDeep