JU
Julia Testing Defaults
Julia testing conventions using the built-in Test standard library
Details
Language / Topic
JuliaCategory
Testing
Rules
balanced
- Use `@test`, `@test_throws`, and `@test_broken` from `using Test` — group related assertions in `@testset` blocks with descriptive names.
- Use `@test_throws ErrorType expr` to assert that a specific exception type is raised — avoid bare try/catch in tests.
- Place tests in `test/runtests.jl` and include sub-test files with `include("subtest.jl")` — keep the test entry point minimal.
- Use `@testset "description" begin ... end` to group related tests and get per-group pass/fail summaries in output.
- Test both valid inputs and boundary conditions — include `@test_throws` cases for invalid argument types and out-of-range values.
- Use `@test isapprox(a, b; atol=1e-6)` for floating-point comparisons — never use `==` for `Float64` results.
- Use `Pkg.test()` locally and configure CI with `julia --project -e 'using Pkg; Pkg.test()'` for reproducible test runs.