CiLogger
In our CI process, we often look at logs to figure out issues with flaky tests—tests that fail sometimes but not always, especially when we can't make them fail in the same way on our own computers. The problem is, it's hard to tell which logs are about the failed tests because logs from tests that passed and failed are all mixed together.
CiLogger makes this easier by only keeping logs from tests that didn't pass, including the tricky flaky ones. This means when a flaky test won't fail the same way for us locally, we can quickly find and look at the right logs to help us understand and fix the problem.
prerequisite
- rspec or minitest
- rails(>= 6.1)
Installation
Add this line to your application's Gemfile:
gem 'ci_logger', group: :test
And then execute:
$ bundle
Or install it yourself as:
$ gem install ci_logger
Add this line to your config/environments/test.rb
config.ci_logger.enabled = ENV['CI']
You can replace ENV['CI']
with what you like.
Replace loggers besides rails logger
CiLogger replaces Rails.logger by default, but other loggers can be replaced.
your_logger = CiLogger.new(your_logger)
your_logger.debug('debug!') # This is only output when the test fails
Contributing
Contribution directions go here.
License
The gem is available as open source under the terms of the MIT License.