require "bugsnag/on_error_callbacks" 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 ## # Disable the given middleware. This removes them from the list of # middleware and ensures they cannot be added again # # See also {#remove} def disable(*middlewares) @mutex.synchronize do @disabled_middleware += middlewares @middlewares.delete_if {|m| @disabled_middleware.include?(m) } end end ## # Remove the given middleware from the list of middleware # # This is like {#disable} but allows the middleware to be added again def remove(*middlewares) @mutex.synchronize do @middlewares.delete_if {|m| middlewares.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 # # @return [Array] def middleware_procs # Split the middleware into separate lists of callables (e.g. Proc, Lambda, Method) and Classes callables, classes = @middlewares.partition {|middleware| middleware.respond_to?(:call) } # Wrap the classes in a proc that, when called, news up the middleware and # passes the next middleware in the queue middleware_instances = classes.map do |middleware| proc {|next_middleware| middleware.new(next_middleware) } end # Wrap the list of callables in a proc that, when called, wraps them in an # 'OnErrorCallbacks' instance that also has a reference to the next middleware wrapped_callables = proc {|next_middleware| OnErrorCallbacks.new(next_middleware, callables) } # Return the combined middleware and wrapped callables middleware_instances.push(wrapped_callables) end end end