|
| 1 | +use crate::core::FeatureValue::Dep; |
| 2 | +use crate::core::{Edition, FeatureMap, FeatureValue, Package}; |
| 3 | +use crate::util::interning::InternedString; |
| 4 | +use crate::{CargoResult, GlobalContext}; |
| 5 | +use annotate_snippets::{Level, Renderer, Snippet}; |
| 6 | +use cargo_util_schemas::manifest::{TomlLintLevel, TomlToolLints}; |
| 7 | +use pathdiff::diff_paths; |
| 8 | +use std::collections::{BTreeMap, HashSet}; |
| 9 | +use std::ops::Range; |
| 10 | +use std::path::Path; |
| 11 | +use toml_edit::ImDocument; |
| 12 | + |
| 13 | +pub fn get_span( |
| 14 | + document: &ImDocument<String>, |
| 15 | + path: &[&str], |
| 16 | + get_value: bool, |
| 17 | +) -> Option<Range<usize>> { |
| 18 | + let mut table = document.as_item().as_table_like().unwrap(); |
| 19 | + let mut iter = path.into_iter().peekable(); |
| 20 | + while let Some(key) = iter.next() { |
| 21 | + let (key, item) = table.get_key_value(key).unwrap(); |
| 22 | + if iter.peek().is_none() { |
| 23 | + return if get_value { |
| 24 | + item.span() |
| 25 | + } else { |
| 26 | + let leaf_decor = key.dotted_decor(); |
| 27 | + let leaf_prefix_span = leaf_decor.prefix().and_then(|p| p.span()); |
| 28 | + let leaf_suffix_span = leaf_decor.suffix().and_then(|s| s.span()); |
| 29 | + if let (Some(leaf_prefix_span), Some(leaf_suffix_span)) = |
| 30 | + (leaf_prefix_span, leaf_suffix_span) |
| 31 | + { |
| 32 | + Some(leaf_prefix_span.start..leaf_suffix_span.end) |
| 33 | + } else { |
| 34 | + key.span() |
| 35 | + } |
| 36 | + }; |
| 37 | + } |
| 38 | + if item.is_table_like() { |
| 39 | + table = item.as_table_like().unwrap(); |
| 40 | + } |
| 41 | + if item.is_array() && iter.peek().is_some() { |
| 42 | + let array = item.as_array().unwrap(); |
| 43 | + let next = iter.next().unwrap(); |
| 44 | + return array.iter().find_map(|item| { |
| 45 | + if next == &item.to_string() { |
| 46 | + item.span() |
| 47 | + } else { |
| 48 | + None |
| 49 | + } |
| 50 | + }); |
| 51 | + } |
| 52 | + } |
| 53 | + None |
| 54 | +} |
| 55 | + |
| 56 | +fn manifest_path(path: &Path, gctx: &GlobalContext) -> String { |
| 57 | + diff_paths(path, gctx.cwd()) |
| 58 | + .unwrap_or_else(|| path.to_path_buf()) |
| 59 | + .display() |
| 60 | + .to_string() |
| 61 | +} |
| 62 | + |
| 63 | +#[derive(Copy, Clone, Debug)] |
| 64 | +pub struct LintGroup { |
| 65 | + pub name: &'static str, |
| 66 | + pub default_level: LintLevel, |
| 67 | + pub desc: &'static str, |
| 68 | + pub edition_lint_opts: Option<(Edition, LintLevel)>, |
| 69 | +} |
| 70 | + |
| 71 | +const RUST_2024_COMPATIBILITY: LintGroup = LintGroup { |
| 72 | + name: "rust-2024-compatibility", |
| 73 | + default_level: LintLevel::Allow, |
| 74 | + desc: "warn about compatibility with Rust 2024", |
| 75 | + edition_lint_opts: Some((Edition::Edition2024, LintLevel::Deny)), |
| 76 | +}; |
| 77 | + |
| 78 | +#[derive(Copy, Clone, Debug)] |
| 79 | +pub struct Lint { |
| 80 | + pub name: &'static str, |
| 81 | + pub desc: &'static str, |
| 82 | + pub groups: &'static [LintGroup], |
| 83 | + pub default_level: LintLevel, |
| 84 | + pub edition_lint_opts: Option<(Edition, LintLevel)>, |
| 85 | +} |
| 86 | + |
| 87 | +impl Lint { |
| 88 | + pub fn level(&self, lints: &TomlToolLints, edition: Edition) -> LintLevel { |
| 89 | + let level = self |
| 90 | + .groups |
| 91 | + .iter() |
| 92 | + .map(|g| g.name) |
| 93 | + .chain(std::iter::once(self.name)) |
| 94 | + .filter_map(|n| lints.get(n).map(|l| (n, l))) |
| 95 | + .max_by_key(|(n, l)| (l.priority(), std::cmp::Reverse(*n))); |
| 96 | + |
| 97 | + match level { |
| 98 | + Some((_, toml_lint)) => toml_lint.level().into(), |
| 99 | + None => { |
| 100 | + if let Some((lint_edition, lint_level)) = self.edition_lint_opts { |
| 101 | + if edition >= lint_edition { |
| 102 | + lint_level |
| 103 | + } else { |
| 104 | + IMPLICIT_FEATURES.default_level |
| 105 | + } |
| 106 | + } else { |
| 107 | + IMPLICIT_FEATURES.default_level |
| 108 | + } |
| 109 | + } |
| 110 | + } |
| 111 | + } |
| 112 | +} |
| 113 | + |
| 114 | +#[derive(Copy, Clone, Debug, PartialEq)] |
| 115 | +pub enum LintLevel { |
| 116 | + Allow, |
| 117 | + Warn, |
| 118 | + Deny, |
| 119 | + Forbid, |
| 120 | +} |
| 121 | + |
| 122 | +impl LintLevel { |
| 123 | + pub fn to_diagnostic_level(self) -> Level { |
| 124 | + match self { |
| 125 | + LintLevel::Allow => Level::Note, |
| 126 | + LintLevel::Warn => Level::Warning, |
| 127 | + LintLevel::Deny => Level::Error, |
| 128 | + LintLevel::Forbid => Level::Error, |
| 129 | + } |
| 130 | + } |
| 131 | +} |
| 132 | + |
| 133 | +impl Into<LintLevel> for TomlLintLevel { |
| 134 | + fn into(self) -> LintLevel { |
| 135 | + match self { |
| 136 | + TomlLintLevel::Allow => LintLevel::Allow, |
| 137 | + TomlLintLevel::Warn => LintLevel::Warn, |
| 138 | + TomlLintLevel::Deny => LintLevel::Deny, |
| 139 | + TomlLintLevel::Forbid => LintLevel::Forbid, |
| 140 | + } |
| 141 | + } |
| 142 | +} |
| 143 | + |
| 144 | +const IMPLICIT_FEATURES: Lint = Lint { |
| 145 | + name: "implicit-features", |
| 146 | + desc: "warn about the use of unstable features", |
| 147 | + groups: &[RUST_2024_COMPATIBILITY], |
| 148 | + default_level: LintLevel::Allow, |
| 149 | + edition_lint_opts: Some((Edition::Edition2024, LintLevel::Deny)), |
| 150 | +}; |
| 151 | + |
| 152 | +pub fn check_implicit_features( |
| 153 | + pkg: &Package, |
| 154 | + path: &Path, |
| 155 | + lints: &TomlToolLints, |
| 156 | + error_count: &mut usize, |
| 157 | + gctx: &GlobalContext, |
| 158 | +) -> CargoResult<()> { |
| 159 | + let lint_level = IMPLICIT_FEATURES.level(lints, pkg.manifest().edition()); |
| 160 | + if lint_level == LintLevel::Allow { |
| 161 | + return Ok(()); |
| 162 | + } |
| 163 | + |
| 164 | + let manifest = pkg.manifest(); |
| 165 | + let features: BTreeMap<InternedString, Vec<InternedString>> = manifest |
| 166 | + .resolved_toml() |
| 167 | + .features() |
| 168 | + .map_or(BTreeMap::new(), |f| { |
| 169 | + f.iter() |
| 170 | + .map(|(k, v)| { |
| 171 | + ( |
| 172 | + InternedString::new(k), |
| 173 | + v.iter().map(InternedString::from).collect(), |
| 174 | + ) |
| 175 | + }) |
| 176 | + .collect() |
| 177 | + }); |
| 178 | + let map: FeatureMap = features |
| 179 | + .iter() |
| 180 | + .map(|(feature, list)| { |
| 181 | + let fvs: Vec<_> = list |
| 182 | + .iter() |
| 183 | + .map(|feat_value| FeatureValue::new(*feat_value)) |
| 184 | + .collect(); |
| 185 | + (*feature, fvs) |
| 186 | + }) |
| 187 | + .collect(); |
| 188 | + |
| 189 | + // Add implicit features for optional dependencies if they weren't |
| 190 | + // explicitly listed anywhere. |
| 191 | + let explicitly_listed: HashSet<_> = map |
| 192 | + .values() |
| 193 | + .flatten() |
| 194 | + .filter_map(|fv| match fv { |
| 195 | + Dep { dep_name } => Some(*dep_name), |
| 196 | + _ => None, |
| 197 | + }) |
| 198 | + .collect(); |
| 199 | + for dep in manifest.dependencies() { |
| 200 | + let dep_name_in_toml = dep.name_in_toml(); |
| 201 | + if !dep.is_optional() |
| 202 | + || features.contains_key(&dep_name_in_toml) |
| 203 | + || explicitly_listed.contains(&dep_name_in_toml) |
| 204 | + { |
| 205 | + continue; |
| 206 | + } |
| 207 | + |
| 208 | + if features.contains_key(&dep_name_in_toml) || explicitly_listed.contains(&dep_name_in_toml) |
| 209 | + { |
| 210 | + continue; |
| 211 | + } |
| 212 | + if lint_level == LintLevel::Forbid || lint_level == LintLevel::Deny { |
| 213 | + *error_count += 1; |
| 214 | + } |
| 215 | + let level = lint_level.to_diagnostic_level(); |
| 216 | + let manifest_path = manifest_path(path, gctx); |
| 217 | + let message = level.title("unused optional dependency").snippet( |
| 218 | + Snippet::source(manifest.contents()) |
| 219 | + .origin(&manifest_path) |
| 220 | + .annotation( |
| 221 | + level.span( |
| 222 | + get_span( |
| 223 | + manifest.document(), |
| 224 | + &["dependencies", &dep_name_in_toml], |
| 225 | + false, |
| 226 | + ) |
| 227 | + .unwrap(), |
| 228 | + ), |
| 229 | + ) |
| 230 | + .fold(true), |
| 231 | + ); |
| 232 | + let renderer = Renderer::styled().term_width( |
| 233 | + gctx.shell() |
| 234 | + .err_width() |
| 235 | + .diagnostic_terminal_width() |
| 236 | + .unwrap_or(annotate_snippets::renderer::DEFAULT_TERM_WIDTH), |
| 237 | + ); |
| 238 | + writeln!(gctx.shell().err(), "{}", renderer.render(message))?; |
| 239 | + } |
| 240 | + Ok(()) |
| 241 | +} |
0 commit comments