oopsie-ruby

Lightweight Ruby gem that reports exceptions to an Oopsie instance.

• Zero runtime dependencies (uses Ruby stdlib)
• Rack middleware for automatic error capture
• Manual Oopsie.report(e) API
• Silent failures with optional on_error callback

Add to your Gemfile:

gem "oopsie-ruby"

Then run:

bundle install

Oopsie.configure do |config|
  config.api_key = ENV["OOPSIE_API_KEY"]
  config.endpoint = "https://your-oopsie-instance.com"

  # Optional: called when error reporting itself fails
  config.on_error = ->(e) { Rails.logger.warn("Oopsie error: #{e.message}") }
end

Create config/initializers/oopsie.rb:

Oopsie.configure do |config|
  config.api_key = Rails.application.credentials.oopsie_api_key
  config.endpoint = "https://your-oopsie-instance.com"
end

Add the middleware to automatically capture unhandled exceptions:

# config.ru
use Oopsie::Middleware

In Rails, add to config/application.rb:

config.middleware.use Oopsie::Middleware

The middleware reports the error and re-raises it, so your existing error handling is unaffected.

Report exceptions anywhere in your code:

begin
  do_something_risky
rescue => e
  Oopsie.report(e)
end

Oopsie.report never raises — if reporting fails, it silently swallows the error (or calls your on_error callback).

• Ruby >= 3.1

MIT