This directory contains LLVM-style lit tests for xunused.

You need the following tools installed:

• LLVM package: Provides FileCheck and lit testing infrastructure
  • On Ubuntu/Debian: sudo apt-get install llvm
• xunused binary: Build the project first with cmake and make

The simplest way to run tests is using the check target:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --build build --target check

The check target automatically:

• Finds lit.py from your LLVM installation
• Sets up the correct PATH to include the xunused binary and LLVM tools (FileCheck, etc.)
• Runs the tests with proper configuration

If you want to run tests manually:

1. Build xunused:

   cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
   cmake --build build

2. Add xunused and LLVM tools to PATH:

   export PATH="$(pwd)/build:$PATH"
   # Also add LLVM tools directory for FileCheck
   export PATH="/usr/lib/llvm-18/bin:$PATH"

3. Set up llvm-lit (if not already available):

   # Find and use the lit.py script from your LLVM installation
   LIT_PATH=$(find /usr/lib/llvm-*/build/utils/lit/lit.py -print -quit 2>/dev/null)
   if [ -n "$LIT_PATH" ]; then
     alias llvm-lit="python3 $LIT_PATH"
   fi

4. Run the tests:

   llvm-lit -v tests

• lit.cfg.py: Configuration file for the lit test runner
• Test files (.test, .c, .cpp, .sh) in the tests/ directory
• Each test file uses LLVM-style RUN: and CHECK: directives

Tests use the LLVM FileCheck format:

• RUN: lines specify commands to execute
• CHECK: lines specify patterns to match in the output
• %t is a temporary directory for test artifacts
• split-file can be used to embed multiple input files in a single test

See basic.test for an example using split-file.