rust-lang / rust-lang/rustc_public
Provide proper encapsulation of StableMIR APIs
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125
- Forks
- 19
- PR merge metrics
- No merged PRs in 30d
Description
The current crate structure of StableMIR is making it very hard to properly encapsulate our stable structures. All the internal details of stable items have to somehow be exposed in order to allow rustc_smir to build them.
For example, the definition of Ty exposes its internal representation:
pub struct Ty(pub usize);
There is no mechanism for us today to ensure that this usize corresponds to an index inside StableMIR. The Context trait is also exposed, even though we expect users to never invoke them directly.
The main problems I see with the lack of encapsulation are:
- Usability. It's confusing for users to know exactly what they can rely on, and what they shouldn't.
- Defining the boundaries of what is semantically versioned.
- APIs are very fragile. Users can easily make a mistake that will break a type invariant, which will result in one of the following:
a. Their code will trigger an ICE
b. The API may return inconsistent result
c. We will have to constantly check for these invariants ourselves as much as possible and returnResultfor everything we do.
We should investigate what is the best mechanism to fix this.
### Tasks
- [ ] Enable proper encapsulation (merge crates?)
- [ ] Audit the StableMIR code and change the visibility of items that shouldn't be public
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by auditing the StableMIR crate structure and the public Ty and Context APIs described in the issue. Determine whether merging crates is needed, then identify StableMIR items whose visibility can be reduced. Done means stable structures are properly encapsulated and the listed type invariants cannot be bypassed through the public API.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- compilers
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100