Spec formatter similar to Ruby minitest-reporters
0.2.0 Latest release released


SpecReporter is a spec output formatter for Crystal, similar to Ruby minitest-reporters' SpecReporter.

SpecReporter Demo Video


Specreporter-spec looks and works similar to Ruby's "SpecReporter" module from the minitest-reporters gem.

The changes/improvements compared to the default Crystal formatter include:

  • Nicer and more informative output
  • Info on elapsed time for each test
  • Short and informative backtrace summaries
  • Info on total number of assertions ran
  • Configurable field widths
  • Configurable terminal width
  • Configurable elapsed time precision
  • Ability to enable/disable sections from default formatter


Add this to your application's shard.yml:

    github: docelic/specreporter-spec

Simply add the following content to your spec/spec_helper.cr:

require "spec"

require "specreporter-spec"
  #indent_string: "    ",        # Indent string. Default "  "
  #width: (ENV["COLUMNS"]? || 80).to_i-2, # Terminal width. Default 78
  ## ^-- You may need to run "eval `resize`" in term to get COLUMNS variable
  #elapsed_width: 8,     # Number of decimals for "elapsed" time. Default 3
  #status_width: 10,     # Width of the status field. Default 5
  #trim_exceptions: false,     # Hide callstack from exceptions? Default true
  #skip_errors_report: false,  # Skip default backtraces. Default true
  #skip_slowest_report: false, # Skip default "slowest" report. Default true
  #skip_failed_report: false,  # Skip default failed reports summary. Default true

Configure the options to your liking.

And run tests in the usual way (crystal s[pec]).



The formatter certainly works, but the implementation must be improved before it could be added to Crystal as built-in formatter.

Code improvements and further feature ideas welcome! Thanks!

Other / Unrelated Formatters

Other / unrelated spec formatters for Crystal in existence:

  • Rainbow - formats the standard formatter dots in rainbow colors.
  github: docelic/specreporter-spec
  version: ~> 0.2.0
License Apache-2.0
Crystal 0.26.1


Dependencies 0

Development Dependencies 0

Dependents 1

Last synced .
search fire star recently