153 releases

new 0.0.202 Feb 19, 2024
0.0.199 Jan 29, 2024
0.0.190 Dec 18, 2023
0.0.187 Nov 27, 2023
0.0.26 Nov 30, 2020
Download history 3171/week @ 2023-10-30 2422/week @ 2023-11-06 2652/week @ 2023-11-13 2438/week @ 2023-11-20 2985/week @ 2023-11-27 2677/week @ 2023-12-04 2538/week @ 2023-12-11 2147/week @ 2023-12-18 1461/week @ 2023-12-25 1837/week @ 2024-01-01 2630/week @ 2024-01-08 2441/week @ 2024-01-15 2219/week @ 2024-01-22 2176/week @ 2024-01-29 2152/week @ 2024-02-05 1973/week @ 2024-02-12

8,791 downloads per month
Used in 19 crates (13 directly)

MIT/Apache

475KB
11K SLoC

HIR (previously known as descriptors) provides a high-level object oriented access to Rust code.

The principal difference between HIR and syntax trees is that HIR is bound to a particular crate instance. That is, it has cfg flags and features applied. So, the relation between syntax and HIR is many-to-one.

HIR is the public API of the all of the compiler logic above syntax trees. It is written in "OO" style. Each type is self contained (as in, it knows its parents and full context). It should be "clean code".

hir_* crates are the implementation of the compiler logic. They are written in "ECS" style, with relatively little abstractions. Many types are not self-contained, and explicitly use local indexes, arenas, etc.

hir is what insulates the "we don't know how to actually write an incremental compiler" from the ide with completions, hovers, etc. It is a (soft, internal) boundary: https://www.tedinski.com/2018/02/06/system-boundaries.html.

Dependencies

~12–22MB
~314K SLoC