Provides some helpers to deal with testing log subscribers by setting up notifications. Take for instance Active Record subscriber tests:

class SyncLogSubscriberTest < ActiveSupport::TestCase
  include ActiveSupport::LogSubscriber::TestHelper

  setup do
    ActiveRecord::LogSubscriber.attach_to(:active_record)
  end

  def test_basic_query_logging
    Developer.all.to_a
    wait
    assert_equal 1, @logger.logged(:debug).size
    assert_match(/Developer Load/, @logger.logged(:debug).last)
    assert_match(/SELECT \* FROM "developers"/, @logger.logged(:debug).last)
  end
end

All you need to do is to ensure that your log subscriber is added to Rails::Subscriber, as in the second line of the code above. The test helpers are responsible for setting up the queue and subscriptions, and turning colors in logs off.

The messages are available in the @logger instance, which is a logger with limited powers (it actually does not send anything to your output), and you can collect them doing @logger.logged(level), where level is the level used in logging, like info, debug, warn, and so on.

Namespace

Class

Methods

Instance Public methods

set_logger(logger)

Overwrite if you use another logger in your log subscriber.

def logger
  ActiveRecord::Base.logger = @logger
end
📝 Source code
# File activesupport/lib/active_support/log_subscriber/test_helper.rb, line 101
      def set_logger(logger)
        ActiveSupport::LogSubscriber.logger = logger
      end
🔎 See on GitHub

wait()

Wait notifications to be published.

📝 Source code
# File activesupport/lib/active_support/log_subscriber/test_helper.rb, line 92
      def wait
        @notifier.wait
      end
🔎 See on GitHub