exception-transformer

Add exceptions to be transformed in handle_exceptions block.

Battle-tested in production at Privy.

Configuration

Crash Reporter

A crash reporter should be configured during the gem setup.

ExceptionTransformer.configure do |config|
  config.reporter = proc { |e| Raven.capture_exception(e) }
end

Documentation

See API dcumentation at https://www.rubydoc.info/gems/exception_transformer.

Examples

Transform several errors to a single error

transform_exceptions FooError, BazError, to: BarError

Transform a single error based on it's message

transform_exceptions FooError, where: {
  /Invalid API key/i => BarError,
  :default => RuntimeError
}

To prevent all errors being caught via the :default branch, pass use_default: false to handle_exceptions.

Validate a response with a Proc that takes two parameters

The first parameter is the response, and the second is the calling method.

transform_exceptions validate: proc { |response, action| ... }

Inspect an error with a Proc that takes two parameters

The first parameter is the error, and the second is the calling method.

transform_exceptions with: proc { |err, action| ... }