Capnp.Rpc.Errors

In addition to the values exposed in the API, this module also defines an instance of Haskell's Exception type class, for Cap'n Proto's Exception.

Converting arbitrary exceptions to capnproto exceptions

wrapException :: Bool -> SomeException -> Parsed Exception

wrapException debugMode e converts an arbitrary haskell exception e into an rpc exception, which can be communicated to a remote vat. If debugMode is true, the returned exception's reason field will include the text of show e.

Helpers for constructing exceptions

eMethodUnimplemented :: Parsed Exception

An exception indicating an unimplemented method.

eUnimplemented :: Text -> Parsed Exception

An unimplemented exception with a custom reason message.

eDisconnected :: Parsed Exception

An exception with type = disconnected

eFailed :: Text -> Parsed Exception

Construct an exception with a type field of failed and the given text as its reason.

throwFailed :: MonadThrow m => Text -> m a

Throw an exception with a type field of Exception'Type'failed and the argument as a reason.

Orphan instances

Exception (Parsed Exception)

Methods

toException :: Parsed Exception -> SomeException

fromException :: SomeException -> Maybe (Parsed Exception)

displayException :: Parsed Exception -> String