rustc_attr_parsing/
session_diagnostics.rs

1use std::num::IntErrorKind;
2
3use rustc_ast as ast;
4use rustc_errors::codes::*;
5use rustc_errors::{
6    Applicability, Diag, DiagArgValue, DiagCtxtHandle, Diagnostic, EmissionGuarantee, Level,
7};
8use rustc_feature::AttributeTemplate;
9use rustc_hir::AttrPath;
10use rustc_macros::{Diagnostic, LintDiagnostic, Subdiagnostic};
11use rustc_span::{Span, Symbol};
12
13use crate::fluent_generated as fluent;
14
15pub(crate) enum UnsupportedLiteralReason {
16    Generic,
17    CfgString,
18    CfgBoolean,
19}
20
21#[derive(Diagnostic)]
22#[diag(attr_parsing_expected_one_cfg_pattern, code = E0536)]
23pub(crate) struct ExpectedOneCfgPattern {
24    #[primary_span]
25    pub span: Span,
26}
27
28#[derive(Diagnostic)]
29#[diag(attr_parsing_invalid_predicate, code = E0537)]
30pub(crate) struct InvalidPredicate {
31    #[primary_span]
32    pub span: Span,
33
34    pub predicate: String,
35}
36
37/// Error code: E0541
38pub(crate) struct UnknownMetaItem<'a> {
39    pub span: Span,
40    pub item: String,
41    pub expected: &'a [&'a str],
42}
43
44// Manual implementation to be able to format `expected` items correctly.
45impl<'a, G: EmissionGuarantee> Diagnostic<'a, G> for UnknownMetaItem<'_> {
46    fn into_diag(self, dcx: DiagCtxtHandle<'a>, level: Level) -> Diag<'a, G> {
47        let expected = self.expected.iter().map(|name| format!("`{name}`")).collect::<Vec<_>>();
48        Diag::new(dcx, level, fluent::attr_parsing_unknown_meta_item)
49            .with_span(self.span)
50            .with_code(E0541)
51            .with_arg("item", self.item)
52            .with_arg("expected", expected.join(", "))
53            .with_span_label(self.span, fluent::attr_parsing_label)
54    }
55}
56
57#[derive(Diagnostic)]
58#[diag(attr_parsing_missing_since, code = E0542)]
59pub(crate) struct MissingSince {
60    #[primary_span]
61    pub span: Span,
62}
63
64#[derive(Diagnostic)]
65#[diag(attr_parsing_missing_note, code = E0543)]
66pub(crate) struct MissingNote {
67    #[primary_span]
68    pub span: Span,
69}
70
71#[derive(Diagnostic)]
72#[diag(attr_parsing_multiple_stability_levels, code = E0544)]
73pub(crate) struct MultipleStabilityLevels {
74    #[primary_span]
75    pub span: Span,
76}
77
78#[derive(Diagnostic)]
79#[diag(attr_parsing_invalid_issue_string, code = E0545)]
80pub(crate) struct InvalidIssueString {
81    #[primary_span]
82    pub span: Span,
83
84    #[subdiagnostic]
85    pub cause: Option<InvalidIssueStringCause>,
86}
87
88// The error kinds of `IntErrorKind` are duplicated here in order to allow the messages to be
89// translatable.
90#[derive(Subdiagnostic)]
91pub(crate) enum InvalidIssueStringCause {
92    #[label(attr_parsing_must_not_be_zero)]
93    MustNotBeZero {
94        #[primary_span]
95        span: Span,
96    },
97
98    #[label(attr_parsing_empty)]
99    Empty {
100        #[primary_span]
101        span: Span,
102    },
103
104    #[label(attr_parsing_invalid_digit)]
105    InvalidDigit {
106        #[primary_span]
107        span: Span,
108    },
109
110    #[label(attr_parsing_pos_overflow)]
111    PosOverflow {
112        #[primary_span]
113        span: Span,
114    },
115
116    #[label(attr_parsing_neg_overflow)]
117    NegOverflow {
118        #[primary_span]
119        span: Span,
120    },
121}
122
123impl InvalidIssueStringCause {
124    pub(crate) fn from_int_error_kind(span: Span, kind: &IntErrorKind) -> Option<Self> {
125        match kind {
126            IntErrorKind::Empty => Some(Self::Empty { span }),
127            IntErrorKind::InvalidDigit => Some(Self::InvalidDigit { span }),
128            IntErrorKind::PosOverflow => Some(Self::PosOverflow { span }),
129            IntErrorKind::NegOverflow => Some(Self::NegOverflow { span }),
130            IntErrorKind::Zero => Some(Self::MustNotBeZero { span }),
131            _ => None,
132        }
133    }
134}
135
136#[derive(Diagnostic)]
137#[diag(attr_parsing_missing_feature, code = E0546)]
138pub(crate) struct MissingFeature {
139    #[primary_span]
140    pub span: Span,
141}
142
143#[derive(Diagnostic)]
144#[diag(attr_parsing_non_ident_feature, code = E0546)]
145pub(crate) struct NonIdentFeature {
146    #[primary_span]
147    pub span: Span,
148}
149
150#[derive(Diagnostic)]
151#[diag(attr_parsing_missing_issue, code = E0547)]
152pub(crate) struct MissingIssue {
153    #[primary_span]
154    pub span: Span,
155}
156
157// FIXME: Why is this the same error code as `InvalidReprHintNoParen` and `InvalidReprHintNoValue`?
158// It is more similar to `IncorrectReprFormatGeneric`.
159#[derive(Diagnostic)]
160#[diag(attr_parsing_incorrect_repr_format_packed_one_or_zero_arg, code = E0552)]
161pub(crate) struct IncorrectReprFormatPackedOneOrZeroArg {
162    #[primary_span]
163    pub span: Span,
164}
165#[derive(Diagnostic)]
166#[diag(attr_parsing_incorrect_repr_format_packed_expect_integer, code = E0552)]
167pub(crate) struct IncorrectReprFormatPackedExpectInteger {
168    #[primary_span]
169    pub span: Span,
170}
171
172#[derive(Diagnostic)]
173#[diag(attr_parsing_invalid_repr_hint_no_paren, code = E0552)]
174pub(crate) struct InvalidReprHintNoParen {
175    #[primary_span]
176    pub span: Span,
177
178    pub name: Symbol,
179}
180
181#[derive(Diagnostic)]
182#[diag(attr_parsing_invalid_repr_hint_no_value, code = E0552)]
183pub(crate) struct InvalidReprHintNoValue {
184    #[primary_span]
185    pub span: Span,
186
187    pub name: Symbol,
188}
189
190/// Error code: E0565
191// FIXME(jdonszelmann): slowly phased out
192pub(crate) struct UnsupportedLiteral {
193    pub span: Span,
194    pub reason: UnsupportedLiteralReason,
195    pub is_bytestr: bool,
196    pub start_point_span: Span,
197}
198
199impl<'a, G: EmissionGuarantee> Diagnostic<'a, G> for UnsupportedLiteral {
200    fn into_diag(self, dcx: DiagCtxtHandle<'a>, level: Level) -> Diag<'a, G> {
201        let mut diag = Diag::new(
202            dcx,
203            level,
204            match self.reason {
205                UnsupportedLiteralReason::Generic => {
206                    fluent::attr_parsing_unsupported_literal_generic
207                }
208                UnsupportedLiteralReason::CfgString => {
209                    fluent::attr_parsing_unsupported_literal_cfg_string
210                }
211                UnsupportedLiteralReason::CfgBoolean => {
212                    fluent::attr_parsing_unsupported_literal_cfg_boolean
213                }
214            },
215        );
216        diag.span(self.span);
217        diag.code(E0565);
218        if self.is_bytestr {
219            diag.span_suggestion(
220                self.start_point_span,
221                fluent::attr_parsing_unsupported_literal_suggestion,
222                "",
223                Applicability::MaybeIncorrect,
224            );
225        }
226        diag
227    }
228}
229
230#[derive(Diagnostic)]
231#[diag(attr_parsing_invalid_repr_align_need_arg, code = E0589)]
232pub(crate) struct InvalidReprAlignNeedArg {
233    #[primary_span]
234    #[suggestion(code = "align(...)", applicability = "has-placeholders")]
235    pub span: Span,
236}
237
238#[derive(Diagnostic)]
239#[diag(attr_parsing_invalid_repr_generic, code = E0589)]
240pub(crate) struct InvalidReprGeneric<'a> {
241    #[primary_span]
242    pub span: Span,
243
244    pub repr_arg: String,
245    pub error_part: &'a str,
246}
247
248#[derive(Diagnostic)]
249#[diag(attr_parsing_incorrect_repr_format_align_one_arg, code = E0693)]
250pub(crate) struct IncorrectReprFormatAlignOneArg {
251    #[primary_span]
252    pub span: Span,
253}
254
255#[derive(Diagnostic)]
256#[diag(attr_parsing_incorrect_repr_format_expect_literal_integer, code = E0693)]
257pub(crate) struct IncorrectReprFormatExpectInteger {
258    #[primary_span]
259    pub span: Span,
260}
261
262#[derive(Diagnostic)]
263#[diag(attr_parsing_incorrect_repr_format_generic, code = E0693)]
264pub(crate) struct IncorrectReprFormatGeneric {
265    #[primary_span]
266    pub span: Span,
267
268    pub repr_arg: Symbol,
269
270    #[subdiagnostic]
271    pub cause: Option<IncorrectReprFormatGenericCause>,
272}
273
274#[derive(Subdiagnostic)]
275pub(crate) enum IncorrectReprFormatGenericCause {
276    #[suggestion(
277        attr_parsing_suggestion,
278        code = "{name}({value})",
279        applicability = "machine-applicable"
280    )]
281    Int {
282        #[primary_span]
283        span: Span,
284
285        #[skip_arg]
286        name: Symbol,
287
288        #[skip_arg]
289        value: u128,
290    },
291
292    #[suggestion(
293        attr_parsing_suggestion,
294        code = "{name}({value})",
295        applicability = "machine-applicable"
296    )]
297    Symbol {
298        #[primary_span]
299        span: Span,
300
301        #[skip_arg]
302        name: Symbol,
303
304        #[skip_arg]
305        value: Symbol,
306    },
307}
308
309impl IncorrectReprFormatGenericCause {
310    pub(crate) fn from_lit_kind(span: Span, kind: &ast::LitKind, name: Symbol) -> Option<Self> {
311        match *kind {
312            ast::LitKind::Int(value, ast::LitIntType::Unsuffixed) => {
313                Some(Self::Int { span, name, value: value.get() })
314            }
315            ast::LitKind::Str(value, _) => Some(Self::Symbol { span, name, value }),
316            _ => None,
317        }
318    }
319}
320
321#[derive(Diagnostic)]
322#[diag(attr_parsing_rustc_promotable_pairing, code = E0717)]
323pub(crate) struct RustcPromotablePairing {
324    #[primary_span]
325    pub span: Span,
326}
327
328#[derive(Diagnostic)]
329#[diag(attr_parsing_rustc_allowed_unstable_pairing, code = E0789)]
330pub(crate) struct RustcAllowedUnstablePairing {
331    #[primary_span]
332    pub span: Span,
333}
334
335#[derive(Diagnostic)]
336#[diag(attr_parsing_cfg_predicate_identifier)]
337pub(crate) struct CfgPredicateIdentifier {
338    #[primary_span]
339    pub span: Span,
340}
341
342#[derive(Diagnostic)]
343#[diag(attr_parsing_deprecated_item_suggestion)]
344pub(crate) struct DeprecatedItemSuggestion {
345    #[primary_span]
346    pub span: Span,
347
348    #[help]
349    pub is_nightly: bool,
350
351    #[note]
352    pub details: (),
353}
354
355#[derive(Diagnostic)]
356#[diag(attr_parsing_expected_single_version_literal)]
357pub(crate) struct ExpectedSingleVersionLiteral {
358    #[primary_span]
359    pub span: Span,
360}
361
362#[derive(Diagnostic)]
363#[diag(attr_parsing_expected_version_literal)]
364pub(crate) struct ExpectedVersionLiteral {
365    #[primary_span]
366    pub span: Span,
367}
368
369#[derive(Diagnostic)]
370#[diag(attr_parsing_expects_feature_list)]
371pub(crate) struct ExpectsFeatureList {
372    #[primary_span]
373    pub span: Span,
374
375    pub name: String,
376}
377
378#[derive(Diagnostic)]
379#[diag(attr_parsing_expects_features)]
380pub(crate) struct ExpectsFeatures {
381    #[primary_span]
382    pub span: Span,
383
384    pub name: String,
385}
386
387#[derive(Diagnostic)]
388#[diag(attr_parsing_invalid_since)]
389pub(crate) struct InvalidSince {
390    #[primary_span]
391    pub span: Span,
392}
393
394#[derive(Diagnostic)]
395#[diag(attr_parsing_soft_no_args)]
396pub(crate) struct SoftNoArgs {
397    #[primary_span]
398    pub span: Span,
399}
400
401#[derive(Diagnostic)]
402#[diag(attr_parsing_unknown_version_literal)]
403pub(crate) struct UnknownVersionLiteral {
404    #[primary_span]
405    pub span: Span,
406}
407
408// FIXME(jdonszelmann) duplicated from `rustc_passes`, remove once `check_attr` is integrated.
409#[derive(Diagnostic)]
410#[diag(attr_parsing_unused_multiple)]
411pub(crate) struct UnusedMultiple {
412    #[primary_span]
413    #[suggestion(code = "", applicability = "machine-applicable")]
414    pub this: Span,
415    #[note]
416    pub other: Span,
417    pub name: Symbol,
418}
419
420#[derive(LintDiagnostic)]
421#[diag(attr_parsing_unused_duplicate)]
422pub(crate) struct UnusedDuplicate {
423    #[suggestion(code = "", applicability = "machine-applicable")]
424    pub this: Span,
425    #[note]
426    pub other: Span,
427    #[warning]
428    pub warning: bool,
429}
430
431// FIXME(jdonszelmann): duplicated in rustc_lints, should be moved here completely.
432#[derive(LintDiagnostic)]
433#[diag(attr_parsing_ill_formed_attribute_input)]
434pub(crate) struct IllFormedAttributeInput {
435    pub num_suggestions: usize,
436    pub suggestions: DiagArgValue,
437}
438
439#[derive(Diagnostic)]
440#[diag(attr_parsing_ill_formed_attribute_input)]
441pub(crate) struct MustUseIllFormedAttributeInput {
442    #[primary_span]
443    pub span: Span,
444    pub num_suggestions: usize,
445    pub suggestions: DiagArgValue,
446}
447
448#[derive(Diagnostic)]
449#[diag(attr_parsing_null_on_export, code = E0648)]
450pub(crate) struct NullOnExport {
451    #[primary_span]
452    pub span: Span,
453}
454
455#[derive(Diagnostic)]
456#[diag(attr_parsing_stability_outside_std, code = E0734)]
457pub(crate) struct StabilityOutsideStd {
458    #[primary_span]
459    pub span: Span,
460}
461
462#[derive(Diagnostic)]
463#[diag(attr_parsing_empty_confusables)]
464pub(crate) struct EmptyConfusables {
465    #[primary_span]
466    pub span: Span,
467}
468
469#[derive(Diagnostic)]
470#[diag(attr_parsing_invalid_alignment_value, code = E0589)]
471pub(crate) struct InvalidAlignmentValue {
472    #[primary_span]
473    pub span: Span,
474    pub error_part: &'static str,
475}
476
477#[derive(Diagnostic)]
478#[diag(attr_parsing_repr_ident, code = E0565)]
479pub(crate) struct ReprIdent {
480    #[primary_span]
481    pub span: Span,
482}
483
484#[derive(Diagnostic)]
485#[diag(attr_parsing_unrecognized_repr_hint, code = E0552)]
486#[help]
487pub(crate) struct UnrecognizedReprHint {
488    #[primary_span]
489    pub span: Span,
490}
491
492#[derive(Diagnostic)]
493#[diag(attr_parsing_naked_functions_incompatible_attribute, code = E0736)]
494pub(crate) struct NakedFunctionIncompatibleAttribute {
495    #[primary_span]
496    #[label]
497    pub span: Span,
498    #[label(attr_parsing_naked_attribute)]
499    pub naked_span: Span,
500    pub attr: String,
501}
502
503pub(crate) enum AttributeParseErrorReason {
504    ExpectedNoArgs,
505    ExpectedStringLiteral { byte_string: Option<Span> },
506    ExpectedAtLeastOneArgument,
507    ExpectedSingleArgument,
508    ExpectedList,
509    UnexpectedLiteral,
510    ExpectedNameValue(Option<Symbol>),
511    DuplicateKey(Symbol),
512    ExpectedSpecificArgument { possibilities: Vec<&'static str>, strings: bool },
513}
514
515pub(crate) struct AttributeParseError {
516    pub(crate) span: Span,
517    pub(crate) attr_span: Span,
518    pub(crate) template: AttributeTemplate,
519    pub(crate) attribute: AttrPath,
520    pub(crate) reason: AttributeParseErrorReason,
521}
522
523impl<'a, G: EmissionGuarantee> Diagnostic<'a, G> for AttributeParseError {
524    fn into_diag(self, dcx: DiagCtxtHandle<'a>, level: Level) -> Diag<'a, G> {
525        let name = self.attribute.to_string();
526
527        let mut diag = Diag::new(dcx, level, format!("malformed `{name}` attribute input"));
528        diag.span(self.attr_span);
529        diag.code(E0539);
530        match self.reason {
531            AttributeParseErrorReason::ExpectedStringLiteral { byte_string } => {
532                if let Some(start_point_span) = byte_string {
533                    diag.span_suggestion(
534                        start_point_span,
535                        fluent::attr_parsing_unsupported_literal_suggestion,
536                        "",
537                        Applicability::MaybeIncorrect,
538                    );
539                    diag.note("expected a normal string literal, not a byte string literal");
540
541                    return diag;
542                } else {
543                    diag.span_label(self.span, "expected a string literal here");
544                }
545            }
546            AttributeParseErrorReason::ExpectedSingleArgument => {
547                diag.span_label(self.span, "expected a single argument here");
548                diag.code(E0805);
549            }
550            AttributeParseErrorReason::ExpectedAtLeastOneArgument => {
551                diag.span_label(self.span, "expected at least 1 argument here");
552            }
553            AttributeParseErrorReason::ExpectedList => {
554                diag.span_label(self.span, "expected this to be a list");
555            }
556            AttributeParseErrorReason::DuplicateKey(key) => {
557                diag.span_label(self.span, format!("found `{key}` used as a key more than once"));
558                diag.code(E0538);
559            }
560            AttributeParseErrorReason::UnexpectedLiteral => {
561                diag.span_label(self.span, format!("didn't expect a literal here"));
562                diag.code(E0565);
563            }
564            AttributeParseErrorReason::ExpectedNoArgs => {
565                diag.span_label(self.span, format!("didn't expect any arguments here"));
566                diag.code(E0565);
567            }
568            AttributeParseErrorReason::ExpectedNameValue(None) => {
569                diag.span_label(
570                    self.span,
571                    format!("expected this to be of the form `{name} = \"...\"`"),
572                );
573            }
574            AttributeParseErrorReason::ExpectedNameValue(Some(name)) => {
575                diag.span_label(
576                    self.span,
577                    format!("expected this to be of the form `{name} = \"...\"`"),
578                );
579            }
580            AttributeParseErrorReason::ExpectedSpecificArgument { possibilities, strings } => {
581                let quote = if strings { '"' } else { '`' };
582                match possibilities.as_slice() {
583                    &[] => {}
584                    &[x] => {
585                        diag.span_label(
586                            self.span,
587                            format!("the only valid argument here is {quote}{x}{quote}"),
588                        );
589                    }
590                    [first, second] => {
591                        diag.span_label(self.span, format!("valid arguments are {quote}{first}{quote} or {quote}{second}{quote}"));
592                    }
593                    [first @ .., second_to_last, last] => {
594                        let mut res = String::new();
595                        for i in first {
596                            res.push_str(&format!("{quote}{i}{quote}, "));
597                        }
598                        res.push_str(&format!(
599                            "{quote}{second_to_last}{quote} or {quote}{last}{quote}"
600                        ));
601
602                        diag.span_label(self.span, format!("valid arguments are {res}"));
603                    }
604                }
605            }
606        }
607
608        let suggestions = self.template.suggestions(false, &name);
609        diag.span_suggestions(
610            self.attr_span,
611            if suggestions.len() == 1 {
612                "must be of the form"
613            } else {
614                "try changing it to one of the following valid forms of the attribute"
615            },
616            suggestions,
617            Applicability::HasPlaceholders,
618        );
619
620        diag
621    }
622}