Skip to content

Commit c0d2ccc

Browse files
veera-sivarajanveera-sivarajan
committed
Implement a Method to Seal DiagInner's Suggestions
1 parent ec867f0 commit c0d2ccc

File tree

13 files changed

+102
-53
lines changed

13 files changed

+102
-53
lines changed

‎compiler/rustc_codegen_ssa/src/back/write.rs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ use rustc_errors::emitter::Emitter;
1616
use rustc_errors::translation::Translate;
1717
use rustc_errors::{
1818
Diag, DiagArgMap, DiagCtxt, DiagMessage, ErrCode, FatalError, FluentBundle, Level, MultiSpan,
19-
Style,
19+
Style, Suggestions,
2020
};
2121
use rustc_fs_util::link_or_copy;
2222
use rustc_hir::def_id::{CrateNum, LOCAL_CRATE};
@@ -1903,7 +1903,7 @@ impl Emitter for SharedEmitter {
19031903
// Check that we aren't missing anything interesting when converting to
19041904
// the cut-down local `DiagInner`.
19051905
assert_eq!(diag.span, MultiSpan::new());
1906-
assert_eq!(diag.suggestions, Ok(vec![]));
1906+
assert_eq!(diag.suggestions, Suggestions::Enabled(vec![]));
19071907
assert_eq!(diag.sort_span, rustc_span::DUMMY_SP);
19081908
assert_eq!(diag.is_lint, None);
19091909
// No sensible check for `diag.emitted_at`.

‎compiler/rustc_errors/src/annotate_snippet_emitter_writer.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ impl Emitter for AnnotateSnippetEmitter {
4848
fn emit_diagnostic(&mut self, mut diag: DiagInner) {
4949
let fluent_args = to_fluent_args(diag.args.iter());
5050

51-
let mut suggestions = diag.suggestions.unwrap_or(vec![]);
51+
let mut suggestions = diag.suggestions.unwrap_tag();
5252
self.primary_span_formatted(&mut diag.span, &mut suggestions, &fluent_args);
5353

5454
self.fix_multispans_in_extern_macros_and_render_macro_backtrace(

‎compiler/rustc_errors/src/diagnostic.rs

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,9 @@ use crate::snippet::Style;
1919
use crate::{
2020
CodeSuggestion, DiagCtxtHandle, DiagMessage, ErrCode, ErrorGuaranteed, ExplicitBug, Level,
2121
MultiSpan, StashKey, SubdiagMessage, Substitution, SubstitutionPart, SuggestionStyle,
22+
Suggestions,
2223
};
2324

24-
/// Error type for `DiagInner`'s `suggestions` field, indicating that
25-
/// `.disable_suggestions()` was called on the `DiagInner`.
26-
#[derive(Clone, Debug, PartialEq, Eq, Hash, Encodable, Decodable)]
27-
pub struct SuggestionsDisabled;
28-
2925
/// Simplified version of `FluentArg` that can implement `Encodable` and `Decodable`. Collection of
3026
/// `DiagArg` are converted to `FluentArgs` (consuming the collection) at the start of diagnostic
3127
/// emission.
@@ -296,7 +292,7 @@ pub struct DiagInner {
296292
pub code: Option<ErrCode>,
297293
pub span: MultiSpan,
298294
pub children: Vec<Subdiag>,
299-
pub suggestions: Result<Vec<CodeSuggestion>, SuggestionsDisabled>,
295+
pub suggestions: Suggestions,
300296
pub args: DiagArgMap,
301297

302298
/// This is not used for highlighting or rendering any error message. Rather, it can be used
@@ -325,7 +321,7 @@ impl DiagInner {
325321
code: None,
326322
span: MultiSpan::new(),
327323
children: vec![],
328-
suggestions: Ok(vec![]),
324+
suggestions: Suggestions::Enabled(vec![]),
329325
args: Default::default(),
330326
sort_span: DUMMY_SP,
331327
is_lint: None,
@@ -429,7 +425,7 @@ impl DiagInner {
429425
&Option<ErrCode>,
430426
&MultiSpan,
431427
&[Subdiag],
432-
&Result<Vec<CodeSuggestion>, SuggestionsDisabled>,
428+
&Suggestions,
433429
Vec<(&DiagArgName, &DiagArgValue)>,
434430
&Option<IsLint>,
435431
) {
@@ -843,16 +839,32 @@ impl<'a, G: EmissionGuarantee> Diag<'a, G> {
843839
self
844840
}
845841

846-
/// Disallow attaching suggestions this diagnostic.
842+
/// Disallow attaching suggestions to this diagnostic.
847843
/// Any suggestions attached e.g. with the `span_suggestion_*` methods
848844
/// (before and after the call to `disable_suggestions`) will be ignored.
849845
#[rustc_lint_diagnostics]
850846
pub fn disable_suggestions(&mut self) -> &mut Self {
851-
self.suggestions = Err(SuggestionsDisabled);
847+
self.suggestions = Suggestions::Disabled;
852848
self
853849
}
854850

855-
/// Helper for pushing to `self.suggestions`, if available (not disable).
851+
/// Prevent new suggestions from being added to this diagnostic.
852+
///
853+
/// Suggestions added before the call to `.seal_suggestions()` will be preserved
854+
/// and new suggestions will be ignored.
855+
#[rustc_lint_diagnostics]
856+
pub fn seal_suggestions(&mut self) -> &mut Self {
857+
if let Suggestions::Enabled(suggestions) = &mut self.suggestions {
858+
let suggestions_slice = std::mem::take(suggestions).into_boxed_slice();
859+
self.suggestions = Suggestions::Sealed(suggestions_slice);
860+
}
861+
self
862+
}
863+
864+
/// Helper for pushing to `self.suggestions`.
865+
///
866+
/// A new suggestion is added if suggestions are enabled for this diagnostic.
867+
/// Otherwise, they are ignored.
856868
#[rustc_lint_diagnostics]
857869
fn push_suggestion(&mut self, suggestion: CodeSuggestion) {
858870
for subst in &suggestion.substitutions {
@@ -866,7 +878,7 @@ impl<'a, G: EmissionGuarantee> Diag<'a, G> {
866878
}
867879
}
868880

869-
if let Ok(suggestions) = &mut self.suggestions {
881+
if let Suggestions::Enabled(suggestions) = &mut self.suggestions {
870882
suggestions.push(suggestion);
871883
}
872884
}

‎compiler/rustc_errors/src/emitter.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -498,7 +498,7 @@ impl Emitter for HumanEmitter {
498498
fn emit_diagnostic(&mut self, mut diag: DiagInner) {
499499
let fluent_args = to_fluent_args(diag.args.iter());
500500

501-
let mut suggestions = diag.suggestions.unwrap_or(vec![]);
501+
let mut suggestions = diag.suggestions.unwrap_tag();
502502
self.primary_span_formatted(&mut diag.span, &mut suggestions, &fluent_args);
503503

504504
self.fix_multispans_in_extern_macros_and_render_macro_backtrace(

‎compiler/rustc_errors/src/json.rs

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,8 @@ use crate::emitter::{
3333
use crate::registry::Registry;
3434
use crate::translation::{to_fluent_args, Translate};
3535
use crate::{
36-
CodeSuggestion, FluentBundle, LazyFallbackBundle, MultiSpan, SpanLabel, Subdiag, TerminalUrl,
36+
CodeSuggestion, FluentBundle, LazyFallbackBundle, MultiSpan, SpanLabel, Subdiag, Suggestions,
37+
TerminalUrl,
3738
};
3839

3940
#[cfg(test)]
@@ -292,7 +293,7 @@ impl Diagnostic {
292293
/// Converts from `rustc_errors::DiagInner` to `Diagnostic`.
293294
fn from_errors_diagnostic(diag: crate::DiagInner, je: &JsonEmitter) -> Diagnostic {
294295
let args = to_fluent_args(diag.args.iter());
295-
let sugg = diag.suggestions.iter().flatten().map(|sugg| {
296+
let sugg_to_diag = |sugg: &CodeSuggestion| {
296297
let translated_message =
297298
je.translate_message(&sugg.msg, &args).map_err(Report::new).unwrap();
298299
Diagnostic {
@@ -303,7 +304,12 @@ impl Diagnostic {
303304
children: vec![],
304305
rendered: None,
305306
}
306-
});
307+
};
308+
let sugg = match &diag.suggestions {
309+
Suggestions::Enabled(suggestions) => suggestions.iter().map(sugg_to_diag),
310+
Suggestions::Sealed(suggestions) => suggestions.iter().map(sugg_to_diag),
311+
Suggestions::Disabled => [].iter().map(sugg_to_diag),
312+
};
307313

308314
// generate regular command line output and store it in the json
309315

‎compiler/rustc_errors/src/lib.rs

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,41 @@ impl SuggestionStyle {
126126
}
127127
}
128128

129+
/// Represents the help messages seen on a diagnostic.
130+
#[derive(Clone, Debug, PartialEq, Hash, Encodable, Decodable)]
131+
pub enum Suggestions {
132+
/// Indicates that new suggestions can be added or removed from this diagnostic.
133+
///
134+
/// `DiagInner`'s new_* methods initialize the `suggestions` field with
135+
/// this variant. Also, this is the default variant for `Suggestions`.
136+
Enabled(Vec<CodeSuggestion>),
137+
/// Indicates that suggestions cannot be added or removed from this diagnostic.
138+
///
139+
/// Gets toggled when `.seal_suggestions()` is called on the `DiagInner`.
140+
Sealed(Box<[CodeSuggestion]>),
141+
/// Indicates that no suggestion is available for this diagnostic.
142+
///
143+
/// Gets toggled when `.disable_suggestions()` is called on the `DiagInner`.
144+
Disabled,
145+
}
146+
147+
impl Suggestions {
148+
/// Returns the underlying list of suggestions.
149+
pub fn unwrap_tag(self) -> Vec<CodeSuggestion> {
150+
match self {
151+
Suggestions::Enabled(suggestions) => suggestions,
152+
Suggestions::Sealed(suggestions) => suggestions.into_vec(),
153+
Suggestions::Disabled => Vec::new(),
154+
}
155+
}
156+
}
157+
158+
impl Default for Suggestions {
159+
fn default() -> Self {
160+
Self::Enabled(vec![])
161+
}
162+
}
163+
129164
#[derive(Clone, Debug, PartialEq, Hash, Encodable, Decodable)]
130165
pub struct CodeSuggestion {
131166
/// Each substitute can have multiple variants due to multiple

‎compiler/rustc_hir_analysis/src/collect/type_of.rs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
use core::ops::ControlFlow;
22

3-
use rustc_errors::{Applicability, StashKey};
3+
use rustc_errors::{Applicability, StashKey, Suggestions};
44
use rustc_hir as hir;
55
use rustc_hir::def_id::{DefId, LocalDefId};
66
use rustc_hir::HirId;
@@ -670,7 +670,7 @@ fn infer_placeholder_type<'tcx>(
670670

671671
// The parser provided a sub-optimal `HasPlaceholders` suggestion for the type.
672672
// We are typeck and have the real type, so remove that and suggest the actual type.
673-
if let Ok(suggestions) = &mut err.suggestions {
673+
if let Suggestions::Enabled(suggestions) = &mut err.suggestions {
674674
suggestions.clear();
675675
}
676676

‎compiler/rustc_parse/src/parser/diagnostics.rs

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ use rustc_ast_pretty::pprust;
1616
use rustc_data_structures::fx::FxHashSet;
1717
use rustc_errors::{
1818
pluralize, Applicability, Diag, DiagCtxtHandle, ErrorGuaranteed, FatalError, PErr, PResult,
19-
Subdiagnostic,
19+
Subdiagnostic, Suggestions,
2020
};
2121
use rustc_session::errors::ExprParenthesesNeeded;
2222
use rustc_span::edit_distance::find_best_match_for_name;
@@ -775,7 +775,7 @@ impl<'a> Parser<'a> {
775775
}
776776

777777
// Check for misspelled keywords if there are no suggestions added to the diagnostic.
778-
if err.suggestions.as_ref().is_ok_and(|code_suggestions| code_suggestions.is_empty()) {
778+
if matches!(&err.suggestions, Suggestions::Enabled(list) if list.is_empty()) {
779779
self.check_for_misspelled_kw(&mut err, &expected);
780780
}
781781
Err(err)
@@ -803,6 +803,9 @@ impl<'a> Parser<'a> {
803803
&& let Some(misspelled_kw) = find_similar_kw(curr_ident, &expected_keywords)
804804
{
805805
err.subdiagnostic(misspelled_kw);
806+
// We don't want other suggestions to be added as they are most likely meaningless
807+
// when there is a misspelled keyword.
808+
err.seal_suggestions();
806809
} else if let Some((prev_ident, _)) = self.prev_token.ident()
807810
&& !prev_ident.is_used_keyword()
808811
{
@@ -818,6 +821,9 @@ impl<'a> Parser<'a> {
818821
// positives like suggesting keyword `for` for `extern crate foo {}`.
819822
if let Some(misspelled_kw) = find_similar_kw(prev_ident, &all_keywords) {
820823
err.subdiagnostic(misspelled_kw);
824+
// We don't want other suggestions to be added as they are most likely meaningless
825+
// when there is a misspelled keyword.
826+
err.seal_suggestions();
821827
}
822828
}
823829
}

‎compiler/rustc_resolve/src/late.rs

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ use rustc_ast::visit::{visit_opt, walk_list, AssocCtxt, BoundKind, FnCtxt, FnKin
1717
use rustc_ast::*;
1818
use rustc_data_structures::fx::{FxHashMap, FxHashSet, FxIndexMap};
1919
use rustc_errors::codes::*;
20-
use rustc_errors::{Applicability, DiagArgValue, IntoDiagArg, StashKey};
20+
use rustc_errors::{Applicability, DiagArgValue, IntoDiagArg, StashKey, Suggestions};
2121
use rustc_hir::def::Namespace::{self, *};
2222
use rustc_hir::def::{self, CtorKind, DefKind, LifetimeRes, NonMacroAttrKind, PartialRes, PerNS};
2323
use rustc_hir::def_id::{DefId, LocalDefId, CRATE_DEF_ID, LOCAL_CRATE};
@@ -4051,17 +4051,23 @@ impl<'a: 'ast, 'b, 'ast, 'tcx> LateResolutionVisitor<'a, 'b, 'ast, 'tcx> {
40514051
err.sort_span = parent_err.sort_span;
40524052
err.is_lint = parent_err.is_lint.clone();
40534053

4054-
// merge the parent's suggestions with the typo suggestions
4055-
fn append_result<T, E>(res1: &mut Result<Vec<T>, E>, res2: Result<Vec<T>, E>) {
4056-
match res1 {
4057-
Ok(vec1) => match res2 {
4058-
Ok(mut vec2) => vec1.append(&mut vec2),
4059-
Err(e) => *res1 = Err(e),
4060-
},
4061-
Err(_) => (),
4062-
};
4054+
// merge the parent_err's suggestions with the typo (err's) suggestions
4055+
match &mut err.suggestions {
4056+
Suggestions::Enabled(typo_suggestions) => match &mut parent_err.suggestions {
4057+
Suggestions::Enabled(parent_suggestions) => {
4058+
// If both suggestions are enabled, append parent_err's suggestions to err's suggestions.
4059+
typo_suggestions.append(parent_suggestions)
4060+
}
4061+
Suggestions::Sealed(_) | Suggestions::Disabled => {
4062+
// If the parent's suggestions are either sealed or disabled, it signifies that
4063+
// new suggestions cannot be added or removed from the diagnostic. Therefore,
4064+
// we assign both types of suggestions to err's suggestions and discard the
4065+
// existing suggestions in err.
4066+
err.suggestions = std::mem::take(&mut parent_err.suggestions);
4067+
}
4068+
},
4069+
Suggestions::Sealed(_) | Suggestions::Disabled => (),
40634070
}
4064-
append_result(&mut err.suggestions, parent_err.suggestions.clone());
40654071

40664072
parent_err.cancel();
40674073

‎compiler/rustc_trait_selection/src/error_reporting/traits/fulfillment_errors.rs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ use rustc_data_structures::unord::UnordSet;
66
use rustc_errors::codes::*;
77
use rustc_errors::{
88
pluralize, struct_span_code_err, Applicability, Diag, ErrorGuaranteed, MultiSpan, StashKey,
9-
StringPart,
9+
StringPart, Suggestions,
1010
};
1111
use rustc_hir::def::Namespace;
1212
use rustc_hir::def_id::{DefId, LocalDefId, LOCAL_CRATE};
@@ -2136,8 +2136,8 @@ impl<'a, 'tcx> TypeErrCtxt<'a, 'tcx> {
21362136
if let Some(span) = err.span.primary_span()
21372137
&& let Some(mut diag) =
21382138
self.dcx().steal_non_err(span, StashKey::AssociatedTypeSuggestion)
2139-
&& let Ok(ref mut s1) = err.suggestions
2140-
&& let Ok(ref mut s2) = diag.suggestions
2139+
&& let Suggestions::Enabled(ref mut s1) = err.suggestions
2140+
&& let Suggestions::Enabled(ref mut s2) = diag.suggestions
21412141
{
21422142
s1.append(s2);
21432143
diag.cancel()

‎tests/ui/parser/issues/issue-70549-resolve-after-recovered-self-ctor.stderr

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,6 @@ help: there is a keyword `mut` with a similar name
1414
|
1515
LL | fn foo(&mut Self) {}
1616
| ~~~
17-
help: declare the type after the parameter binding
18-
|
19-
LL | fn foo(<identifier>: <type>) {}
20-
| ~~~~~~~~~~~~~~~~~~~~
2117

2218
error: unexpected lifetime `'static` in pattern
2319
--> $DIR/issue-70549-resolve-after-recovered-self-ctor.rs:8:13
@@ -47,10 +43,6 @@ help: there is a keyword `mut` with a similar name
4743
|
4844
LL | fn bar(&'static mut Self) {}
4945
| ~~~
50-
help: declare the type after the parameter binding
51-
|
52-
LL | fn bar(<identifier>: <type>) {}
53-
| ~~~~~~~~~~~~~~~~~~~~
5446

5547
error: expected one of `:`, `@`, or `|`, found keyword `Self`
5648
--> $DIR/issue-70549-resolve-after-recovered-self-ctor.rs:14:17

‎tests/ui/parser/misspelled-keywords/impl-trait.stderr

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,6 @@ help: there is a keyword `impl` with a similar name
88
|
99
LL | fn code<T: impl Debug>() -> u8 {}
1010
| ~~~~
11-
help: you might have meant to end the type parameters here
12-
|
13-
LL | fn code<T: impll> Debug>() -> u8 {}
14-
| +
1511

1612
error: aborting due to 1 previous error
1713

‎tests/ui/parser/misspelled-keywords/ref.stderr

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,6 @@ help: there is a keyword `ref` with a similar name
88
|
99
LL | Some(ref list) => println!("{list:?}"),
1010
| ~~~
11-
help: missing `,`
12-
|
13-
LL | Some(refe, list) => println!("{list:?}"),
14-
| +
1511

1612
error[E0023]: this pattern has 2 fields, but the corresponding tuple variant has 1 field
1713
--> $DIR/ref.rs:4:14

0 commit comments

Comments
 (0)