e2e-to-bazel
Converts end-to-end (e2e) test targets or paths to `bazel run` commands for `heir-opt`. Use when you need to convert an e2e test target (where flags are defined in the BUILD file) to a shell command whose flags can be modified for further analysis and debugging.
- License 许可
- Apache-2.0
- 所属仓库
- google/heir
- 最近更新
- 2026-11-15
- Stars
- ★ 948
- Forks
- 185
01 前言 Front Matter
- name
- e2e-to-bazel
- description
- Converts end-to-end (e2e) test targets or paths to `bazel run` commands for `heir-opt`. Use when you need to convert an e2e test target (where flags are defined in the BUILD file) to a shell command whose flags can be modified for further analysis and debugging.
03 SKILL.md 正文
E2E To Bazel
Overview
This skill guides the agent in using the e2e_to_bazel tool to convert e2e test
targets or paths to executable commands.
Usage
Converting a Test Target or Path
To convert an e2e test target, directory, or source file to a bazel run
command, use the following command recipes:
bazel run //third_party/heir/scripts:e2e_to_bazel -- {target_or_path}
Replace {target_or_path} with the test target (e.g.,
//tests/Examples/lattigo/ckks/mnist:mnist_test), directory, or source file
path.
Gotchas
- Blaze Query Dependency: The tool relies on
bazel queryto extract attributes. This requires a workingblazeenvironment and may be slow for the first run. - Workspace State: It requires that the workspace is in a state where
bazel querycan evaluate the targets. - Source file mapping: If a source file is provided, it searches for
heir_opttargets that depend on it.
Copy this checklist and track progress:
- [ ] Step 1: Identify the e2e test target, directory, or file to convert.
- [ ] Step 2: Run the `e2e_to_bazel` tool on it.
- [ ] Step 3: Inspect the generated command or run it.
- [ ] Step 4: Verify execution results.
<!-- mdformat global-off -->
04 同仓库更多 Skills
reproduce-failure
Describes a decision tree of steps and skills to utilize when, starting from a test failure or the failure of `bazel run` command using heir-opt, you would like to produce a reproducing input IR that fails on a particular compiler pass.
lit-to-bazel
Converts MLIR lit test files to `bazel run` commands. Use when you need to convert a failing MLIR lit test target (containing RUN lines) to a shell command whose flags can be modified for further analysis and debugging.
dump-intermediate-ir
Augments a `bazel run` CLI command for `heir-opt` with additional flags that dump the IR before each compiler pass, allowing the agent to inspect intermediate IR during compilation, identify a particular pass at which the pipeline fails, or extract the corresponding IR input to a particular pass for further debugging.