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

Allow RazorProjectEngine.Process to be cancelled #11334

Open
wants to merge 24 commits into
base: main
Choose a base branch
from

Conversation

DustinCampbell
Copy link
Member

@DustinCampbell DustinCampbell commented Dec 26, 2024

We see a lot of memory churn in Razor when opening a solution. There are several contributors to this problem, but one particular issue is that the compiler continues to process files, even if the need for the resulting RazorCodeDocument as passed. Once a RazorProjectEngine.Process* method has been called, it can't be cancelled, which leads to lots of unnecessary allocations. This pull request lays the groundwork to allow the Razor compiler to be cancelled at an API level. In addition, while working on RazorProjectEngine and friends, I added caching to avoid the same queries running over project engine features over and over again.

I recommend reviewing commit-by-commit.

VS insertion PR: https://dev.azure.com/devdiv/DevDiv/_git/VS/pullrequest/600134

These two argument null checks in private protected methods are already handled elsewhere.
It turns out that nothing calls these APIs with a null file kind, so let's not annotate it that way.
There's nullability analysis all the way through that ensures that the arguments passed to this ctor can't be null.
- Don't expose CreateCodeDocumentCore with optional arguments
- Remove unneeded ArgHelper.ThrowIfNull check
Add simple helper class to cache IRazorEngineFeatures and IRazorProjectEngineFeatures by type.
This property isn't necessary. Nearly every caller can be changed to go through RazorProjectEngine.Engine.GetFeatures<T>().
Now that RazorProjectEngine.EngineFeatures is gone, this property can be safely renamed.
Avoid an unnecessary array creation/copy by passing the PooledArrayBuilder<RazorProjectItem> into RazorProjectEngine.GetImportSourceDocuments
- Add NotNull method
- Add interpolated string handlers
Because this change modifies the AssumeNotNulll extension methods to defer to Assumed.NonNull, it's necessary to update TelemetryReporter to include the ThrowHelper and Assumed classes when performing its stack walk for faults.

I suspect that these types should have already been included anyway, to improve the fault bucketing. It might be useful to add ArgHelper as well, but that's not really in scope here.
This is the same as the previous commit but results in more affected downstream code due to the changes to IRazorEngineFeature. For simplicity, each IRazorEngineFeature implementation now inherits from RazorEngineFeatureBase.
This is similar to the last commit. All IRazorProjectEngineFeature implementations now inherit from RazorProjectEngineFeatureBase.
SourceGeneratorProjectEngine inherited from RazorProjectEngine, but it really didn't need to.
@DustinCampbell DustinCampbell requested review from a team as code owners December 26, 2024 23:49
Copy link
Contributor

@davidwengier davidwengier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tooling changes ✅

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants