How can I make Mix run only specific tests from my suite of tests?
When running mix test
all tests are executed
There are 5 ways to run only specific tests with Elixir
run a single file with mix test path_to_your_tests/your_test_file.exs
This will run all test defined in your_test_file.exs
run a specific test from a specific test file by adding a colon and the line number of that test
for example mix test path_to_your_tests/your_test_file.exs:12
will run the test at line 12 of
your_test_file.exs
define a tag to exclude on your test methods
defmodule MyTests do
@tag disabled: true
test "some test" do
#testtesttest
end
end
on the command line execute your tests like thismix test --exclude disabled
define a tag to include on your test methods
defmodule MyTests do
@tag mustexec: true
test "some test" do
#testtesttest
end
end
on the command line execute your tests like thismix test --only mustexec
Generally exclude some tagged tests by adding this to your test/test_helper.exs
fileExUnit.configure exclude: [disabled: true]
Warning:
Mix has an --include
directive. This directive is NOT the same as the --only
directive. Include is used to break the general configuration (exclusion) from the test/test_helper.exs
file described under 4).
For some reason googling for elixir mix include tests
or the like never shows up on my search results therefore I have written this entry and its answer. For more info, see the Mix documentation.