https://github.com/vaivaswatha/pliron
An Extensible Compiler IR Framework
https://github.com/vaivaswatha/pliron
compilers ir mlir pliron
Last synced: 3 months ago
JSON representation
An Extensible Compiler IR Framework
- Host: GitHub
- URL: https://github.com/vaivaswatha/pliron
- Owner: vaivaswatha
- License: apache-2.0
- Created: 2022-08-04T14:03:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2026-01-19T15:19:37.000Z (3 months ago)
- Last Synced: 2026-01-19T21:44:25.327Z (3 months ago)
- Topics: compilers, ir, mlir, pliron
- Language: Rust
- Homepage:
- Size: 1.07 MB
- Stars: 247
- Watchers: 7
- Forks: 22
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Programming Languages Intermediate Representation
[](https://github.com/vaivaswatha/pliron/actions/workflows/ci.yml)
`pliron` is an extensible compiler IR framework in Rust, inspired by [MLIR](https://mlir.llvm.org/docs/LangRef/).
### Build and Test
* Install the [rust toolchain](https://www.rust-lang.org/tools/install).
* `cargo build` and `cargo test` should build the compiler and run the testsuite.
* To see a simple IR constructed (by the [print_simple](tests/ir_construct.rs) test),
use the following command:
cargo test print_simple -- --show-output
It should print something like:
```mlir
builtin.module @bar
{
^block_1v1():
builtin.func @foo: builtin.function <()->(builtin.integer si64)>
{
^entry_block_2v1():
c0_op_3v1_res0 = test.constant builtin.integer <0: si64>;
test.return c0_op_3v1_res0
}
}
```
* `pliron` provides an [LLVM Dialect](pliron-llvm/README.md) and
consequently an [`llvm-opt` tool](pliron-llvm/llvm-opt/README.md)
that can parse LLVM-IR bitcode into the LLVM dialect and output
LLVM-IR bitcode.
### Using the Library
Add a dependence to the [crate](https://crates.io/crates/pliron) in your Rust project.
Note: `pliron`, is under active development. All effort is made to ensure that the code is well tested
and of production quality. Current efforts are directed at completing the LLVM dialect, which can
already [compile bzip2](https://github.com/vaivaswatha/pliron/wiki/Compiling-bzip2-through-pliron's-LLVM-dialect).
We also plan to start work on supporting a cranelift dialect / backend soon.
### Documentation
* Introduction and motivation are covered in the [introductory wiki article](https://github.com/vaivaswatha/pliron/wiki/Introduction).
* The wiki also has a [comparison](https://github.com/vaivaswatha/pliron/wiki/Comparison-with-other-compiler-frameworks) of `pliron`
with other compiler projects, touching upon some design decisions.
* Code documentation can be found on
[docs.rs](https://docs.rs/pliron/latest/pliron/).
### Some talks on `pliron`
* [pliron: An Extensible IR Framework in Rust - IICT'24](https://www.youtube.com/watch?v=LobYuwcUaZA)
* [Rust(ing) the Future of Compilers: Pliron as the MLIR Alternative (No C/C++)](https://www.youtube.com/watch?v=rRgYGBAhKQ0)
* [Pliron Rust Workshop (6 sessions)](https://www.youtube.com/watch?v=6EjMWJ2PY-o)
### Projects using `pliron`
* [Commonly used Pliron Dialects](https://github.com/vaivaswatha/pliron-common-dialects)
* [Pliron Dialect for Tensors](https://github.com/vaivaswatha/pliron-tensor)
