simplecov-console

A simple console output formatter for SimpleCov

Usage

$ gem install simplecov-console
SimpleCov.formatter = SimpleCov::Formatter::Console# or

SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new([
  SimpleCov::Formatter::HTMLFormatter,
  SimpleCov::Formatter::Console,
])

Example output:

COVERAGE:  82.34% -- 2345/2848 lines in 111 files

showing bottom (worst) 15 of 69 files
+----------+--------------------------------------------+-------+--------+---------------------------------------------+
| coverage | file                                       | lines | missed | missing                                     |
+----------+--------------------------------------------+-------+--------+---------------------------------------------+
|  22.73%  | lib/bixby/api/websocket_server.rb          | 22    | 17     | 11, 14, 17-18, 20-22, 24, 28-30, 32, 36-... |
|  30.77%  | app/models/role.rb                         | 13    | 9      | 28-34, 36-37                                |
|  32.14%  | lib/bixby/modules/metrics/rescan.rb        | 28    | 19     | 19-23, 27-31, 33-37, 39-41, 43              |
|  42.86%  | lib/archie/mail.rb                         | 14    | 8      | 6-8, 12-15, 22                              |
|  44.00%  | lib/archie/controller.rb                   | 50    | 28     | 18-21, 23, 27-30, 32, 38-40, 44-45, 48-4... |
|  44.44%  | app/models/metric_info.rb                  | 9     | 5      | 38-40, 42, 44                               |
|  46.15%  | lib/bixby/modules/notifier.rb              | 13    | 7      | 13-14, 27-28, 38-40                         |
|  46.15%  | lib/archie/otp/controller.rb               | 26    | 14     | 15-18, 21, 26-27, 31, 33-34, 36-38, 41      |
|  46.88%  | app/controllers/rest/models/hosts_contr... | 32    | 17     | 7, 19-22, 24, 28-30, 32, 36-38, 42-44, 48   |
|  47.83%  | lib/bixby/hooks.rb                         | 46    | 24     | 54, 68-70, 72-74, 84-86, 88-90, 104, 111... |
|  48.28%  | app/controllers/rest/models/checks_cont... | 29    | 15     | 5, 7-8, 10, 13, 34, 38-40, 44-45, 47, 49... |
|  48.44%  | app/controllers/application_controller.rb  | 64    | 33     | 19, 35-37, 57, 59-64, 67, 88, 92, 107, 1... |
|  50.00%  | app/views/models/repo.rb                   | 12    | 6      | 10, 12-13, 16-17, 20                        |
|  54.55%  | lib/ext/sidekiq_logging.rb                 | 11    | 5      | 9, 15-17, 19                                |
|  60.00%  | app/views/models/check_template.rb         | 10    | 4      | 10-13                                       |
+----------+--------------------------------------------+-------+--------+---------------------------------------------+
42 file(s) with 100% coverage not shown

Configuration

Disabling colorized output

Simply export NO_COLOR=1 and colors will be disabled.

NO_COLOR=1 rake test

Sorting the output

By default the coverage report is sorted by coverage % in descending order. To sort alphabetically by path, set the SORT environment variable to "path", or add the following to your test helper:

SimpleCov::Formatter::Console.sort = 'path' # sort by file path

Showing covered files

By default, fully covered files are excluded from the report. To show them, set the SHOW_COVERED environment variable to true or add the following to your test helper:

SimpleCov::Formatter::Console.show_covered = true # show all files in coverage report

Maximum rows displayed

By default, a maximum of 15 files with the worst coverage are displayed in the report. You can override this limit by setting the MAX_ROWS environment variable, or adding the following to your test helper:

SimpleCov::Formatter::Console.max_rows = # some number

Setting a value of -1 or nil will show all of the files.

Table options

In some cases, you may need to pass some options to TerminalTable.new. For example, if the filenames are truncated so much that you can't read them. In that case, you can add a line like this when setting the formatter:

SimpleCov::Formatter::Console.table_options = {:style => {:width => 200}}
SimpleCov.formatter = SimpleCov::Formatter::Console

History

0.6 (2019.11.08)

  • Added new config options: sort, show_covered, and max_rows

0.5 (2019.05.24)

  • Replaced hirb gem with terminal-table due to multiple warnings thrown (#11)
  • Support disabling colorized output via NO_COLOR env var

Contributing

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Commit and push until you are happy with your contribution.
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2019 Chetan Sarva. See LICENSE.txt for further details.