---
id: llvm-testing-tools
version: "23.0.0"
license: Apache-2.0 WITH LLVM-exception
license_treatment: unclear
maintenance: active
---

# llvm-testing-tools — LLVM Testing Tools

License: unclear · Maintenance: active · Downloads: 113.9K/mo

## What it is and what it does

llvm-testing-tools packages LLVM's FileCheck utility and split-file tool as a PyPI-installable Python package. These are low-level testing utilities commonly used in LLVM and compiler infrastructure projects to validate test output and manage test files. The package aims to let runtime builds and other projects use these tools without needing to bootstrap a full LLVM build system.

The package has no runtime dependencies, making it lightweight to install. It supports Python 3.8 and later. With 113886 monthly downloads and a position in the top 15000 packages, it appears to serve a real need in the LLVM ecosystem and related projects that depend on these testing tools.

Use it for:

- Validate compiler or interpreter test output using FileCheck pattern matching in CI/CD pipelines.
- Split and organize test files in LLVM-based projects without requiring a full LLVM build.
- Support testing infrastructure for language runtimes that depend on LLVM testing conventions.
- Automate test file management in projects that use LLVM's testing patterns but not the full toolchain.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides LLVM testing utilities like FileCheck and split-file as standalone Python tools, enabling runtime builds to access these testing features without requiring a full LLVM bootstrap build.

Yes, if you need FileCheck or split-file for testing. The package has low install friction, no dependencies, active maintenance, and serves a clear purpose in the LLVM ecosystem. The only caveat is that license treatment is marked unclear—review the Apache-2.0 WITH LLVM-exception terms for your use case before committing to it in a restricted context.

## Install

pip install llvm-testing-tools
uv add llvm-testing-tools
poetry add llvm-testing-tools

## Installing llvm-testing-tools

Before you install: Low install friction with no runtime dependencies. Active maintenance status and recent release. Requires Python 3.8 or later.

License in practice: Licensed under Apache-2.0 WITH LLVM-exception, a permissive license with LLVM-specific exception terms. License treatment is marked unclear in the metadata, so you may want to review the actual license text before use in proprietary or restricted contexts.

Quickstart:

pip install llvm-testing-tools==23.0.0

from llvm_testing_tools import FileCheck
# Use FileCheck for pattern matching in test output

Requires Python 3.8 or later.

Verify before relying:

- Whether FileCheck and split-file are exposed as importable modules or only as command-line entry points.
- What specific testing workflows or LLVM runtime builds this package is designed to support.
- Whether the package includes documentation or examples for typical usage patterns.

## Package facts

- License: Apache-2.0 WITH LLVM-exception (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 113.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

llvm testing utilities, filecheck python, split-file tool, llvm test tools, runtime testing without bootstrap, llvm testing infrastructure, filecheck command line, llvm, testing-tools, compiler-infrastructure

[View on SkillFed](https://skillfed.io/packages/llvm-testing-tools) · [View on PyPI](https://pypi.org/project/llvm-testing-tools/)