Tests use ParallelTestRunner.jl for parallel execution. Each test file runs in its own worker process. Shared helpers are loaded automatically via init_code — test files do not need to include setup.jl themselves.

# Standard — works on all supported Julia versions
using Pkg; Pkg.test()

# Direct invocation — requires Julia 1.12+ (workspace support)
julia --project=test test/runtests.jl

# Run only a specific group (directory prefix)
julia --project=test test/runtests.jl symmetries

# Run only a specific file
julia --project=test test/runtests.jl tensors/factorizations

# Fast mode: fewer sectors, fewer scalar types, AD tests skipped
julia --project=test test/runtests.jl --fast

# Combine --fast with a group or file filter
julia --project=test test/runtests.jl --fast tensors

# Control parallelism
julia --project=test test/runtests.jl --jobs=4

Skips chainrules and mooncake groups entirely, and reduces coverage in the remaining tests:

• Sector types: tests only Z2Irrep, SU2Irrep, FermionParity ⊠ U1Irrep ⊠ SU2Irrep, and FibonacciAnyon (instead of the full sectorlist)
• Space lists: tests only (Vtr, Vℤ₂, VSU₂) (trivial, abelian, non-abelian)
• Scalar types: tests only Float64 and ComplexF64 (instead of all integer/float variants)

Defines the TestSetup module, which is loaded into every worker sandbox automatically. It exports:

• Spaces: Vtr, Vℤ₂, Vfℤ₂, Vℤ₃, VU₁, VfU₁, VCU₁, VSU₂, VfSU₂, VSU₂U₁, Vfib, VIB_diag, VIB_M
• Sector lists: sectorlist (full), fast_sectorlist (reduced)
• Utilities: randsector, smallset, hasfusiontensor, force_planar, random_fusion, randindextuple, randcircshift, _repartition, trivtuple, test_dim_isapprox, default_tol

The fast_tests::Bool constant is also available in every test file (injected alongside TestSetup via init_code in runtests.jl).

Create a .jl file anywhere under test/. It is auto-discovered by ParallelTestRunner and must be self-contained (worker processes have no shared state). TestSetup and fast_tests are already in scope — no include needed.

using Test, TestExtras
using TensorKit

@testset "My tests" begin
    # fast_tests and all TestSetup exports (Vtr, sectorlist, …) are available here
end