module Bugsnag class MiddlewareStack ## # Creates the middleware stack. def initialize @middlewares = [] @disabled_middleware = [] @mutex = Mutex.new end ## # Defines a new middleware to use in the middleware call sequence. # # Will return early if given middleware is disabled or already included. def use(new_middleware) @mutex.synchronize do return if @disabled_middleware.include?(new_middleware) return if @middlewares.include?(new_middleware) @middlewares << new_middleware end end ## # Inserts a new middleware to use after a given middleware already added. # # Will return early if given middleware is disabled or already added. # New middleware will be inserted last if the existing middleware is not already included. def insert_after(after, new_middleware) @mutex.synchronize do return if @disabled_middleware.include?(new_middleware) return if @middlewares.include?(new_middleware) if after.is_a? Array index = @middlewares.rindex {|el| after.include?(el)} else index = @middlewares.rindex(after) end if index.nil? @middlewares << new_middleware else @middlewares.insert index + 1, new_middleware end end end ## # Inserts a new middleware to use before a given middleware already added. # # Will return early if given middleware is disabled or already added. # New middleware will be inserted last if the existing middleware is not already included. def insert_before(before, new_middleware) @mutex.synchronize do return if @disabled_middleware.include?(new_middleware) return if @middlewares.include?(new_middleware) if before.is_a? Array index = @middlewares.index {|el| before.include?(el)} else index = @middlewares.index(before) end @middlewares.insert index || @middlewares.length, new_middleware end end def disable(*middlewares) @mutex.synchronize do @disabled_middleware += middlewares @middlewares.delete_if {|m| @disabled_middleware.include?(m)} end end ## # Allows the user to proxy methods for more complex functionality. def method_missing(method, *args, &block) @middlewares.send(method, *args, &block) end ## # Runs the middleware stack. def run(report) # The final lambda is the termination of the middleware stack. It calls deliver on the notification lambda_has_run = false notify_lambda = lambda do |notif| lambda_has_run = true yield if block_given? end begin # We reverse them, so we can call "call" on the first middleware middleware_procs.reverse.inject(notify_lambda) { |n,e| e.call(n) }.call(report) rescue StandardError => e # KLUDGE: Since we don't re-raise middleware exceptions, this breaks rspec raise if e.class.to_s == "RSpec::Expectations::ExpectationNotMetError" # We dont notify, as we dont want to loop forever in the case of really broken middleware, we will # still send this notify Bugsnag.configuration.warn "Bugsnag middleware error: #{e}" Bugsnag.configuration.warn "Middleware error stacktrace: #{e.backtrace.inspect}" end # Ensure that the deliver has been performed, and no middleware has botched it notify_lambda.call(report) unless lambda_has_run end private # Generates a list of middleware procs that are ready to be run # Pass each one a reference to the next in the queue def middleware_procs @middlewares.map{|middleware| proc { |next_middleware| middleware.new(next_middleware) } } end end end