use std::sync::OnceLock; use std::{ ffi::OsStr, path::{Path, PathBuf}, }; use globset::{Glob, GlobSet, GlobSetBuilder}; use serde::{Deserialize, Serialize}; /// Returns the path to the user's home directory. pub fn home_dir() -> &'static PathBuf { static HOME_DIR: OnceLock = OnceLock::new(); HOME_DIR.get_or_init(|| dirs::home_dir().expect("failed to determine home directory")) } pub trait PathExt { fn compact(&self) -> PathBuf; fn icon_stem_or_suffix(&self) -> Option<&str>; fn extension_or_hidden_file_name(&self) -> Option<&str>; fn try_from_bytes<'a>(bytes: &'a [u8]) -> anyhow::Result where Self: From<&'a Path>, { #[cfg(unix)] { use std::os::unix::prelude::OsStrExt; Ok(Self::from(Path::new(OsStr::from_bytes(bytes)))) } #[cfg(windows)] { use anyhow::anyhow; use tendril::fmt::{Format, WTF8}; WTF8::validate(bytes) .then(|| { // Safety: bytes are valid WTF-8 sequence. Self::from(Path::new(unsafe { OsStr::from_encoded_bytes_unchecked(bytes) })) }) .ok_or_else(|| anyhow!("Invalid WTF-8 sequence: {bytes:?}")) } } } impl> PathExt for T { /// Compacts a given file path by replacing the user's home directory /// prefix with a tilde (`~`). /// /// # Returns /// /// * A `PathBuf` containing the compacted file path. If the input path /// does not have the user's home directory prefix, or if we are not on /// Linux or macOS, the original path is returned unchanged. fn compact(&self) -> PathBuf { if cfg!(target_os = "linux") || cfg!(target_os = "macos") { match self.as_ref().strip_prefix(home_dir().as_path()) { Ok(relative_path) => { let mut shortened_path = PathBuf::new(); shortened_path.push("~"); shortened_path.push(relative_path); shortened_path } Err(_) => self.as_ref().to_path_buf(), } } else { self.as_ref().to_path_buf() } } /// Returns either the suffix if available, or the file stem otherwise to determine which file icon to use fn icon_stem_or_suffix(&self) -> Option<&str> { let path = self.as_ref(); let file_name = path.file_name()?.to_str()?; if file_name.starts_with('.') { return file_name.strip_prefix('.'); } path.extension() .and_then(|e| e.to_str()) .or_else(|| path.file_stem()?.to_str()) } /// Returns a file's extension or, if the file is hidden, its name without the leading dot fn extension_or_hidden_file_name(&self) -> Option<&str> { if let Some(extension) = self.as_ref().extension() { return extension.to_str(); } self.as_ref().file_name()?.to_str()?.split('.').last() } } /// A delimiter to use in `path_query:row_number:column_number` strings parsing. pub const FILE_ROW_COLUMN_DELIMITER: char = ':'; /// A representation of a path-like string with optional row and column numbers. /// Matching values example: `te`, `test.rs:22`, `te:22:5`, etc. #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize, Hash)] pub struct PathWithPosition { pub path: PathBuf, pub row: Option, // Absent if row is absent. pub column: Option, } impl PathWithPosition { /// Returns a PathWithPosition from a path. pub fn from_path(path: PathBuf) -> Self { Self { path, row: None, column: None, } } /// Parses a string that possibly has `:row:column` suffix. /// Ignores trailing `:`s, so `test.rs:22:` is parsed as `test.rs:22`. /// If the suffix parsing fails, the whole string is parsed as a path. pub fn parse_str(s: &str) -> Self { let fallback = |fallback_str| Self { path: Path::new(fallback_str).to_path_buf(), row: None, column: None, }; let trimmed = s.trim(); let path = Path::new(trimmed); let maybe_file_name_with_row_col = path .file_name() .unwrap_or_default() .to_str() .unwrap_or_default(); if maybe_file_name_with_row_col.is_empty() { return fallback(s); } match maybe_file_name_with_row_col.split_once(FILE_ROW_COLUMN_DELIMITER) { Some((file_name, maybe_row_and_col_str)) => { let file_name = file_name.trim(); let maybe_row_and_col_str = maybe_row_and_col_str.trim(); if file_name.is_empty() { return fallback(s); } let suffix_length = maybe_row_and_col_str.len() + 1; let path_without_suffix = &trimmed[..trimmed.len() - suffix_length]; if maybe_row_and_col_str.is_empty() { fallback(path_without_suffix) } else { let (row_parse_result, maybe_col_str) = match maybe_row_and_col_str.split_once(FILE_ROW_COLUMN_DELIMITER) { Some((maybe_row_str, maybe_col_str)) => { (maybe_row_str.parse::(), maybe_col_str.trim()) } None => (maybe_row_and_col_str.parse::(), ""), }; let path = Path::new(path_without_suffix).to_path_buf(); match row_parse_result { Ok(row) => { if maybe_col_str.is_empty() { Self { path, row: Some(row), column: None, } } else { let (maybe_col_str, _) = maybe_col_str.split_once(':').unwrap_or((maybe_col_str, "")); match maybe_col_str.parse::() { Ok(col) => Self { path, row: Some(row), column: Some(col), }, Err(_) => Self { path, row: Some(row), column: None, }, } } } Err(_) => Self { path, row: None, column: None, }, } } } None => fallback(s), } } pub fn map_path( self, mapping: impl FnOnce(PathBuf) -> Result, ) -> Result { Ok(PathWithPosition { path: mapping(self.path)?, row: self.row, column: self.column, }) } pub fn to_string(&self, path_to_string: impl Fn(&PathBuf) -> String) -> String { let path_string = path_to_string(&self.path); if let Some(row) = self.row { if let Some(column) = self.column { format!("{path_string}:{row}:{column}") } else { format!("{path_string}:{row}") } } else { path_string } } } #[derive(Clone, Debug, Default)] pub struct PathMatcher { sources: Vec, glob: GlobSet, } // impl std::fmt::Display for PathMatcher { // fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { // self.sources.fmt(f) // } // } impl PartialEq for PathMatcher { fn eq(&self, other: &Self) -> bool { self.sources.eq(&other.sources) } } impl Eq for PathMatcher {} impl PathMatcher { pub fn new(globs: &[String]) -> Result { let globs = globs .into_iter() .map(|glob| Glob::new(&glob)) .collect::, _>>()?; let sources = globs.iter().map(|glob| glob.glob().to_owned()).collect(); let mut glob_builder = GlobSetBuilder::new(); for single_glob in globs { glob_builder.add(single_glob); } let glob = glob_builder.build()?; Ok(PathMatcher { glob, sources }) } pub fn sources(&self) -> &[String] { &self.sources } pub fn is_match>(&self, other: P) -> bool { let other_path = other.as_ref(); self.sources.iter().any(|source| { let as_bytes = other_path.as_os_str().as_encoded_bytes(); as_bytes.starts_with(source.as_bytes()) || as_bytes.ends_with(source.as_bytes()) }) || self.glob.is_match(other_path) || self.check_with_end_separator(other_path) } fn check_with_end_separator(&self, path: &Path) -> bool { let path_str = path.to_string_lossy(); let separator = std::path::MAIN_SEPARATOR_STR; if path_str.ends_with(separator) { self.glob.is_match(path) } else { self.glob.is_match(path_str.to_string() + separator) } } } #[cfg(test)] mod tests { use super::*; #[test] fn path_with_position_parsing_positive() { let input_and_expected = [ ( "test_file.rs", PathWithPosition { path: PathBuf::from("test_file.rs"), row: None, column: None, }, ), ( "test_file.rs:1", PathWithPosition { path: PathBuf::from("test_file.rs"), row: Some(1), column: None, }, ), ( "test_file.rs:1:2", PathWithPosition { path: PathBuf::from("test_file.rs"), row: Some(1), column: Some(2), }, ), ]; for (input, expected) in input_and_expected { let actual = PathWithPosition::parse_str(input); assert_eq!( actual, expected, "For positive case input str '{input}', got a parse mismatch" ); } } #[test] fn path_with_position_parsing_negative() { for (input, row, column) in [ ("test_file.rs:a", None, None), ("test_file.rs:a:b", None, None), ("test_file.rs::", None, None), ("test_file.rs::1", None, None), ("test_file.rs:1::", Some(1), None), ("test_file.rs::1:2", None, None), ("test_file.rs:1::2", Some(1), None), ("test_file.rs:1:2:3", Some(1), Some(2)), ] { let actual = PathWithPosition::parse_str(input); assert_eq!( actual, PathWithPosition { path: PathBuf::from("test_file.rs"), row, column, }, "For negative case input str '{input}', got a parse mismatch" ); } } // Trim off trailing `:`s for otherwise valid input. #[test] fn path_with_position_parsing_special() { #[cfg(not(target_os = "windows"))] let input_and_expected = [ ( "test_file.rs:", PathWithPosition { path: PathBuf::from("test_file.rs"), row: None, column: None, }, ), ( "test_file.rs:1:", PathWithPosition { path: PathBuf::from("test_file.rs"), row: Some(1), column: None, }, ), ( "crates/file_finder/src/file_finder.rs:1902:13:", PathWithPosition { path: PathBuf::from("crates/file_finder/src/file_finder.rs"), row: Some(1902), column: Some(13), }, ), ]; #[cfg(target_os = "windows")] let input_and_expected = [ ( "test_file.rs:", PathWithPosition { path: PathBuf::from("test_file.rs"), row: None, column: None, }, ), ( "test_file.rs:1:", PathWithPosition { path: PathBuf::from("test_file.rs"), row: Some(1), column: None, }, ), ( "\\\\?\\C:\\Users\\someone\\test_file.rs:1902:13:", PathWithPosition { path: PathBuf::from("\\\\?\\C:\\Users\\someone\\test_file.rs"), row: Some(1902), column: Some(13), }, ), ( "\\\\?\\C:\\Users\\someone\\test_file.rs:1902:13:15:", PathWithPosition { path: PathBuf::from("\\\\?\\C:\\Users\\someone\\test_file.rs"), row: Some(1902), column: Some(13), }, ), ( "\\\\?\\C:\\Users\\someone\\test_file.rs:1902:::15:", PathWithPosition { path: PathBuf::from("\\\\?\\C:\\Users\\someone\\test_file.rs"), row: Some(1902), column: None, }, ), ( "C:\\Users\\someone\\test_file.rs:1902:13:", PathWithPosition { path: PathBuf::from("C:\\Users\\someone\\test_file.rs"), row: Some(1902), column: Some(13), }, ), ( "crates/utils/paths.rs", PathWithPosition { path: PathBuf::from("crates\\utils\\paths.rs"), row: None, column: None, }, ), ( "crates/utils/paths.rs:101", PathWithPosition { path: PathBuf::from("crates\\utils\\paths.rs"), row: Some(101), column: None, }, ), ]; for (input, expected) in input_and_expected { let actual = PathWithPosition::parse_str(input); assert_eq!( actual, expected, "For special case input str '{input}', got a parse mismatch" ); } } #[test] fn test_path_compact() { let path: PathBuf = [ home_dir().to_string_lossy().to_string(), "some_file.txt".to_string(), ] .iter() .collect(); if cfg!(target_os = "linux") || cfg!(target_os = "macos") { assert_eq!(path.compact().to_str(), Some("~/some_file.txt")); } else { assert_eq!(path.compact().to_str(), path.to_str()); } } #[test] fn test_icon_stem_or_suffix() { // No dots in name let path = Path::new("/a/b/c/file_name.rs"); assert_eq!(path.icon_stem_or_suffix(), Some("rs")); // Single dot in name let path = Path::new("/a/b/c/file.name.rs"); assert_eq!(path.icon_stem_or_suffix(), Some("rs")); // No suffix let path = Path::new("/a/b/c/file"); assert_eq!(path.icon_stem_or_suffix(), Some("file")); // Multiple dots in name let path = Path::new("/a/b/c/long.file.name.rs"); assert_eq!(path.icon_stem_or_suffix(), Some("rs")); // Hidden file, no extension let path = Path::new("/a/b/c/.gitignore"); assert_eq!(path.icon_stem_or_suffix(), Some("gitignore")); // Hidden file, with extension let path = Path::new("/a/b/c/.eslintrc.js"); assert_eq!(path.icon_stem_or_suffix(), Some("eslintrc.js")); } #[test] fn test_extension_or_hidden_file_name() { // No dots in name let path = Path::new("/a/b/c/file_name.rs"); assert_eq!(path.extension_or_hidden_file_name(), Some("rs")); // Single dot in name let path = Path::new("/a/b/c/file.name.rs"); assert_eq!(path.extension_or_hidden_file_name(), Some("rs")); // Multiple dots in name let path = Path::new("/a/b/c/long.file.name.rs"); assert_eq!(path.extension_or_hidden_file_name(), Some("rs")); // Hidden file, no extension let path = Path::new("/a/b/c/.gitignore"); assert_eq!(path.extension_or_hidden_file_name(), Some("gitignore")); // Hidden file, with extension let path = Path::new("/a/b/c/.eslintrc.js"); assert_eq!(path.extension_or_hidden_file_name(), Some("js")); } #[test] fn edge_of_glob() { let path = Path::new("/work/node_modules"); let path_matcher = PathMatcher::new(&["**/node_modules/**".to_owned()]).unwrap(); assert!( path_matcher.is_match(path), "Path matcher should match {path:?}" ); } #[test] fn project_search() { let path = Path::new("/Users/someonetoignore/work/zed/zed.dev/node_modules"); let path_matcher = PathMatcher::new(&["**/node_modules/**".to_owned()]).unwrap(); assert!( path_matcher.is_match(path), "Path matcher should match {path:?}" ); } }