lit

Run tests

$ lit [tests/]

$ lit [test.py]

$ lit -v [tests/]

$ lit -a [tests/]

$ lit -j [4] [tests/]

$ lit --filter [pattern] [tests/]

lit [options] tests

lit (LLVM Integrated Tester) is a portable test execution framework designed for running compiler and tool test suites. It discovers test files in directory trees, executes them according to configurable test formats, and reports results with support for parallel execution across multiple threads. Tests are typically small scripts with embedded RUN lines that specify the commands to execute and CHECK lines that define expected output patterns.
The framework supports multiple test formats including ShTest (shell-script-style tests interpreted by lit itself), GoogleTest binaries, and custom formats defined through Python configuration files. Each test directory contains a `lit.cfg` or `lit.cfg.py` file that specifies the test format, available substitutions, and environment configuration. Although lit was built for LLVM's own test infrastructure, it is a general-purpose tool that can be used to test any command-line program.

TESTS

Test files or directories.

Verbose output.

Show all output.

Number of parallel jobs.

Run matching tests only.

Disable progress bar.

Display help information.

Primarily for LLVM projects. Requires test configuration. Python-based.

lit was developed as part of the LLVM project to provide a flexible, fast testing framework for compiler tests.

llvm-lit(1), pytest(1), make(1)