Proposal: Add a `hanami test` command

I propose we add hanami test as a command to hanami/hanami. We have rake now, but I think this is a good nice-to-have.

I’m willing to commit to building it, once we come to consensus on the requirements.


This allows users to run a single test file/test in an agnostic way (instead of using rspec directly, e.g.)

It also signals that testing is a first-class concern of Hanami, appropriately.

Rails has this and it’s a nice convenience that I’ve used often. For reference, their defaults for just the test command are that only non-system tests are run, which I think is a reasonable convention to follow.


I think that running hanami test within inside the folder for a slice (or app/) should only run the tests in that slice.

Question: Should running hanami test in the main folder not only run tests in app/ but also run tests in the slices as well? I think so.

Regardless, we can also have an option to specify the slice from the main folder, e.g:
hanami test --slice admin only run the tests for the admin slice, then also hanami test --app can test just the main app (unless this is the default behavior, then it wouldn’t do anything).


Looking at all the subcommands Rails has, I think we can get just implement a few key subcommands, as described below:

test                               Run all tests, except system tests
test:all                           Run all tests, including system tests
test:units                         Run tests in spec/actions, spec/models/, etc.
test:system                        Run all system tests

They also has test:db which resets the DB before testing, which seems fine and useful but not sure it’s needed for v1.


Question: Should we stick to calling it hanami test and not support calling it hanami spec at all? This would greatly simplify things, especially in documentation and for this reason, I think we should. It also leaves the spec command namespace free for users to define as they wish.

1 Like

I wrote my own binstub to do something like the slice argument

#!/usr/bin/env ruby

ENV["HANAMI_ENV"] = "test"

if ARGV in ["ciam" | "scim" | "oauth", *]
  slice_name = ENV["HANAMI_SLICES"] = ARGV.shift
  ARGV.unshift "--tag", "slice:#{slice_name}"

require 'bundler/setup'
require 'rspec/core'

Proper framework support for test running with slice filtering would be nice.

This sounds like a good initiative for me, small but convenient addition that would save developers some scripting to have that functionality.

Should running hanami test in the main folder not only run tests in app/ but also run tests in the slices as well?

Seems to be in line with the overall convention so far, where the slice is a flag to be passed to the command, so no flag means a more general approach, flag means specific slice.

As for naming - many people use “test” and “spec” interchangeably. I usually try to differentiate, as per the simple definition of specs being short of “specification” meaning they are written per functionality and are more descriptive than general tests, also having a far more “human” description.

So, given that the command is more general than specific, I too would stick to naming it hanami test

I would be open to helping out in implementation if you go forward with it and need/want some help.

1 Like