diff options
Diffstat (limited to 'crates/hir_expand/src/diagnostics.rs')
-rw-r--r-- | crates/hir_expand/src/diagnostics.rs | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/crates/hir_expand/src/diagnostics.rs b/crates/hir_expand/src/diagnostics.rs new file mode 100644 index 000000000..78ccc212c --- /dev/null +++ b/crates/hir_expand/src/diagnostics.rs | |||
@@ -0,0 +1,105 @@ | |||
1 | //! Semantic errors and warnings. | ||
2 | //! | ||
3 | //! The `Diagnostic` trait defines a trait object which can represent any | ||
4 | //! diagnostic. | ||
5 | //! | ||
6 | //! `DiagnosticSink` struct is used as an emitter for diagnostic. When creating | ||
7 | //! a `DiagnosticSink`, you supply a callback which can react to a `dyn | ||
8 | //! Diagnostic` or to any concrete diagnostic (downcasting is sued internally). | ||
9 | //! | ||
10 | //! Because diagnostics store file offsets, it's a bad idea to store them | ||
11 | //! directly in salsa. For this reason, every hir subsytem defines it's own | ||
12 | //! strongly-typed closed set of diagnostics which use hir ids internally, are | ||
13 | //! stored in salsa and do *not* implement the `Diagnostic` trait. Instead, a | ||
14 | //! subsystem provides a separate, non-query-based API which can walk all stored | ||
15 | //! values and transform them into instances of `Diagnostic`. | ||
16 | |||
17 | use std::{any::Any, fmt}; | ||
18 | |||
19 | use syntax::SyntaxNodePtr; | ||
20 | |||
21 | use crate::InFile; | ||
22 | |||
23 | #[derive(Copy, Clone, PartialEq)] | ||
24 | pub struct DiagnosticCode(pub &'static str); | ||
25 | |||
26 | impl DiagnosticCode { | ||
27 | pub fn as_str(&self) -> &str { | ||
28 | self.0 | ||
29 | } | ||
30 | } | ||
31 | |||
32 | pub trait Diagnostic: Any + Send + Sync + fmt::Debug + 'static { | ||
33 | fn code(&self) -> DiagnosticCode; | ||
34 | fn message(&self) -> String; | ||
35 | /// Used in highlighting and related purposes | ||
36 | fn display_source(&self) -> InFile<SyntaxNodePtr>; | ||
37 | fn as_any(&self) -> &(dyn Any + Send + 'static); | ||
38 | fn is_experimental(&self) -> bool { | ||
39 | false | ||
40 | } | ||
41 | } | ||
42 | |||
43 | pub struct DiagnosticSink<'a> { | ||
44 | callbacks: Vec<Box<dyn FnMut(&dyn Diagnostic) -> Result<(), ()> + 'a>>, | ||
45 | filters: Vec<Box<dyn FnMut(&dyn Diagnostic) -> bool + 'a>>, | ||
46 | default_callback: Box<dyn FnMut(&dyn Diagnostic) + 'a>, | ||
47 | } | ||
48 | |||
49 | impl<'a> DiagnosticSink<'a> { | ||
50 | pub fn push(&mut self, d: impl Diagnostic) { | ||
51 | let d: &dyn Diagnostic = &d; | ||
52 | self._push(d); | ||
53 | } | ||
54 | |||
55 | fn _push(&mut self, d: &dyn Diagnostic) { | ||
56 | for filter in &mut self.filters { | ||
57 | if !filter(d) { | ||
58 | return; | ||
59 | } | ||
60 | } | ||
61 | for cb in &mut self.callbacks { | ||
62 | match cb(d) { | ||
63 | Ok(()) => return, | ||
64 | Err(()) => (), | ||
65 | } | ||
66 | } | ||
67 | (self.default_callback)(d) | ||
68 | } | ||
69 | } | ||
70 | |||
71 | pub struct DiagnosticSinkBuilder<'a> { | ||
72 | callbacks: Vec<Box<dyn FnMut(&dyn Diagnostic) -> Result<(), ()> + 'a>>, | ||
73 | filters: Vec<Box<dyn FnMut(&dyn Diagnostic) -> bool + 'a>>, | ||
74 | } | ||
75 | |||
76 | impl<'a> DiagnosticSinkBuilder<'a> { | ||
77 | pub fn new() -> Self { | ||
78 | Self { callbacks: Vec::new(), filters: Vec::new() } | ||
79 | } | ||
80 | |||
81 | pub fn filter<F: FnMut(&dyn Diagnostic) -> bool + 'a>(mut self, cb: F) -> Self { | ||
82 | self.filters.push(Box::new(cb)); | ||
83 | self | ||
84 | } | ||
85 | |||
86 | pub fn on<D: Diagnostic, F: FnMut(&D) + 'a>(mut self, mut cb: F) -> Self { | ||
87 | let cb = move |diag: &dyn Diagnostic| match diag.as_any().downcast_ref::<D>() { | ||
88 | Some(d) => { | ||
89 | cb(d); | ||
90 | Ok(()) | ||
91 | } | ||
92 | None => Err(()), | ||
93 | }; | ||
94 | self.callbacks.push(Box::new(cb)); | ||
95 | self | ||
96 | } | ||
97 | |||
98 | pub fn build<F: FnMut(&dyn Diagnostic) + 'a>(self, default_callback: F) -> DiagnosticSink<'a> { | ||
99 | DiagnosticSink { | ||
100 | callbacks: self.callbacks, | ||
101 | filters: self.filters, | ||
102 | default_callback: Box::new(default_callback), | ||
103 | } | ||
104 | } | ||
105 | } | ||