Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make AST->HIR lowering incremental #452

Closed
1 of 3 tasks
cjgillot opened this issue Aug 1, 2021 · 3 comments
Closed
1 of 3 tasks

Make AST->HIR lowering incremental #452

cjgillot opened this issue Aug 1, 2021 · 3 comments
Labels
major-change A proposal to make a major change to rustc major-change-accepted A major change proposal that was accepted T-compiler Add this label so rfcbot knows to poll the compiler team

Comments

@cjgillot
Copy link

cjgillot commented Aug 1, 2021

Proposal

AST->HIR lowering is currently done ahead of the construction of the incremental compilation engine. This issue proposes to make lowering incremental by introducing a query lower_to_hir(def: LocalDefId) -> Option<&hir::OwnerInfo<'_>> which lowers the AST item corresponding to definition def into the corresponding HIR and some associated information.

The objective is to eventually skip lowering some parts of the AST, and to allow progress towards making resolution and expansion incremental.

The proposed design is as follows:

  • remove global analyses from the current lowering pass, and pull them back to resolution stage;
  • attach lowering information to definitions instead of having multiple maps inside hir::Crate, effectively making hir::Crate an IndexVec<LocalDefId, Option<OwnerInfo<'_>>>;
  • extract the required resolution outputs from the resolver and keep them immutable;
  • allow to create new definitions from inside the query system (*);
  • index the AST by LocalDefId, using an IndexVec<LocalDefId, AstOwner> where AstOwner is an enum holding OwningRef<Lrc<Crate>, ItemLike> for different ItemLike;
  • perform HIR indexing per-owner;
  • make lowering incremental.

One of the most subtle changes is (*), which allows to create new definitions from inside queries. It is made safe using an eval-always query which forces re-execution of its caller, and effectively enforces the side-effects creating the definition. The first time definitions are iterated over (for instance for metadata output), a read-lock to the definitions is leaked, which seals the list of definitions.

Draft branch is accessible at rust-lang/rust@master...cjgillot:lower-incr

Mentors or Reviewers

Process

The main points of the Major Change Process are as follows:

  • File an issue describing the proposal.
  • A compiler team member or contributor who is knowledgeable in the area can second by writing @rustbot second.
    • Finding a "second" suffices for internal changes. If however, you are proposing a new public-facing feature, such as a -C flag, then full team check-off is required.
    • Compiler team members can initiate a check-off via @rfcbot fcp merge on either the MCP or the PR.
  • Once an MCP is seconded, the Final Comment Period begins. If no objections are raised after 10 days, the MCP is considered approved.

You can read more about Major Change Proposals on forge.

Comments

This issue is not meant to be used for technical discussion. There is a Zulip stream for that. Use this issue to leave procedural comments, such as volunteering to review, indicating that you second the proposal (or third, etc), or raising a concern that you would like to be addressed.

@cjgillot cjgillot added major-change A proposal to make a major change to rustc T-compiler Add this label so rfcbot knows to poll the compiler team labels Aug 1, 2021
@rustbot
Copy link
Collaborator

rustbot commented Aug 1, 2021

This issue is not meant to be used for technical discussion. There is a Zulip stream for that. Use this issue to leave procedural comments, such as volunteering to review, indicating that you second the proposal (or third, etc), or raising a concern that you would like to be addressed.

cc @rust-lang/compiler @rust-lang/compiler-contributors

@rustbot rustbot added the to-announce Announce this issue on triage meeting label Aug 1, 2021
@apiraino apiraino removed the to-announce Announce this issue on triage meeting label Aug 5, 2021
@pnkfelix
Copy link
Member

@rustbot second

@rustbot rustbot added the final-comment-period The FCP has started, most (if not all) team members are in agreement label Aug 17, 2021
@apiraino
Copy link
Contributor

apiraino commented Sep 1, 2021

@rustbot label -final-comment-period +major-change-accepted

@apiraino apiraino closed this as completed Sep 1, 2021
@rustbot rustbot added major-change-accepted A major change proposal that was accepted to-announce Announce this issue on triage meeting and removed final-comment-period The FCP has started, most (if not all) team members are in agreement labels Sep 1, 2021
@apiraino apiraino removed the to-announce Announce this issue on triage meeting label Sep 2, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
major-change A proposal to make a major change to rustc major-change-accepted A major change proposal that was accepted T-compiler Add this label so rfcbot knows to poll the compiler team
Projects
None yet
Development

No branches or pull requests

4 participants