use std::{    ffi::OsString,    io::Read,    path::{Path, PathBuf},}; use bstr::{BStr, BString, ByteSlice, ByteVec}; use crate::{Assignment, MatchGroup, PatternList, PatternMapping, State, StateRef}; impl<'a> From<StateRef<'a>> for State {    fn from(s: StateRef<'a>) -> Self {        match s {            StateRef::Value(v) => State::Value(v.to_str().expect("no illformed unicode").into()),            StateRef::Set => State::Set,            StateRef::Unset => State::Unset,            StateRef::Unspecified => State::Unspecified,        }    }} fn attrs_to_assignments<'a>(    attrs: impl Iterator<Item = Result<(&'a BStr, StateRef<'a>), crate::parse::Error>>,) -> Result<Vec<Assignment>, crate::parse::Error> {    attrs        .map(|res| {            res.map(|(name, state)| Assignment {                name: name.to_str().expect("no illformed unicode").into(),                state: state.into(),            })        })        .collect()} /// A marker trait to identify the type of a description.pub trait Pattern: Clone + PartialEq + Eq + std::fmt::Debug + std::hash::Hash + Ord + PartialOrd + Default {    /// The value associated with a pattern.    type Value: PartialEq + Eq + std::fmt::Debug + std::hash::Hash + Ord + PartialOrd + Clone;     /// Parse all patterns in `bytes` line by line, ignoring lines with errors, and collect them.    fn bytes_to_patterns(bytes: &[u8]) -> Vec<PatternMapping<Self::Value>>;     fn use_pattern(pattern: &git_glob::Pattern) -> bool;} /// Identify ignore patterns.#[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Default)]pub struct Ignore; impl Pattern for Ignore {    type Value = ();     fn bytes_to_patterns(bytes: &[u8]) -> Vec<PatternMapping<Self::Value>> {        crate::parse::ignore(bytes)            .map(|(pattern, line_number)| PatternMapping {                pattern,                value: (),                sequence_number: line_number,            })            .collect()    }     fn use_pattern(_pattern: &git_glob::Pattern) -> bool {        true    }} /// A value of an attribute pattern, which is either a macro definition or#[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone)]pub enum Value {    MacroAttributes(Vec<Assignment>),    Attributes(Vec<Assignment>),} /// Identify patterns with attributes.#[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Default)]pub struct Attributes; impl Pattern for Attributes {    type Value = Value;     fn bytes_to_patterns(bytes: &[u8]) -> Vec<PatternMapping<Self::Value>> {        crate::parse(bytes)            .filter_map(Result::ok)            .filter_map(|(pattern_kind, attrs, line_number)| {                let (pattern, value) = match pattern_kind {                    crate::parse::Kind::Macro(macro_name) => (                        git_glob::Pattern {                            text: macro_name,                            mode: git_glob::pattern::Mode::all(),                            first_wildcard_pos: None,                        },                        Value::MacroAttributes(attrs_to_assignments(attrs).ok()?),                    ),                    crate::parse::Kind::Pattern(p) => (                        (!p.is_negative()).then(|| p)?,                        Value::Attributes(attrs_to_assignments(attrs).ok()?),                    ),                };                PatternMapping {                    pattern,                    value,                    sequence_number: line_number,                }                .into()            })            .collect()    }     fn use_pattern(pattern: &git_glob::Pattern) -> bool {        pattern.mode != git_glob::pattern::Mode::all()    }} /// Describes a matching value within a [`MatchGroup`].#[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone)]pub struct Match<'a, T> {    pub pattern: &'a git_glob::Pattern,    /// The value associated with the pattern.    pub value: &'a T,    /// The path to the source from which the pattern was loaded, or `None` if it was specified by other means.    pub source: Option<&'a Path>,    /// The line at which the pattern was found in its `source` file, or the occurrence in which it was provided.    pub sequence_number: usize,} impl<T> MatchGroup<T>where    T: Pattern,{    /// Match `relative_path`, a path relative to the repository containing all patterns, and return the first match if available.    // TODO: better docs    pub fn pattern_matching_relative_path<'a>(        &self,        relative_path: impl Into<&'a BStr>,        is_dir: Option<bool>,        case: git_glob::pattern::Case,    ) -> Option<Match<'_, T::Value>> {        let relative_path = relative_path.into();        let basename_pos = relative_path.rfind(b"/").map(|p| p + 1);        self.patterns            .iter()            .rev()            .find_map(|pl| pl.pattern_matching_relative_path(relative_path, basename_pos, is_dir, case))    }} impl MatchGroup<Ignore> {    /// Given `git_dir`, a `.git` repository, load ignore patterns from `info/exclude` and from `excludes_file` if it    /// is provided.    /// Note that it's not considered an error if the provided `excludes_file` does not exist.    pub fn from_git_dir(        git_dir: impl AsRef<Path>,        excludes_file: Option<PathBuf>,        buf: &mut Vec<u8>,    ) -> std::io::Result<Self> {        let mut group = Self::default();         let follow_symlinks = true;        // order matters! More important ones first.        group.patterns.extend(            excludes_file                .map(|file| PatternList::<Ignore>::from_file(file, None, follow_symlinks, buf))                .transpose()?                .flatten(),        );        group.patterns.extend(PatternList::<Ignore>::from_file(            git_dir.as_ref().join("info").join("exclude"),            None,            follow_symlinks,            buf,        )?);        Ok(group)    }     /// See [PatternList::<Ignore>::from_overrides()] for details.    pub fn from_overrides(patterns: impl IntoIterator<Item = impl Into<OsString>>) -> Self {        MatchGroup {            patterns: vec![PatternList::<Ignore>::from_overrides(patterns)],        }    }     /// Add the given file at `source` if it exists, otherwise do nothing. If a `root` is provided, it's not considered a global file anymore.    /// Returns true if the file was added, or false if it didn't exist.    pub fn add_patterns_file(        &mut self,        source: impl Into<PathBuf>,        follow_symlinks: bool,        root: Option<&Path>,        buf: &mut Vec<u8>,    ) -> std::io::Result<bool> {        let previous_len = self.patterns.len();        self.patterns.extend(PatternList::<Ignore>::from_file(            source.into(),            root,            follow_symlinks,            buf,        )?);        Ok(self.patterns.len() != previous_len)    }     pub fn add_patterns_buffer(&mut self, bytes: &[u8], source: impl Into<PathBuf>, root: Option<&Path>) {        self.patterns            .push(PatternList::<Ignore>::from_bytes(bytes, source.into(), root));    }} fn read_in_full_ignore_missing(path: &Path, follow_symlinks: bool, buf: &mut Vec<u8>) -> std::io::Result<bool> {    buf.clear();    let file = if follow_symlinks {        std::fs::File::open(path)    } else {        git_features::fs::open_options_no_follow().read(true).open(path)    };    Ok(match file {        Ok(mut file) => {            file.read_to_end(buf)?;            true        }        Err(err) if err.kind() == std::io::ErrorKind::NotFound => false,        Err(err) => return Err(err),    })} impl<T> PatternList<T>where    T: Pattern,{    /// `source` is the location of the `bytes` which represent a list of patterns line by line.    pub fn from_bytes(bytes: &[u8], source: impl Into<PathBuf>, root: Option<&Path>) -> Self {        let source = source.into();        let patterns = T::bytes_to_patterns(bytes);         let base = root            .and_then(|root| source.parent().expect("file").strip_prefix(root).ok())            .and_then(|base| {                (!base.as_os_str().is_empty()).then(|| {                    let mut base: BString =                        git_path::to_unix_separators_on_windows(git_path::into_bstr(base)).into_owned();                     base.push_byte(b'/');                    base                })            });        PatternList {            patterns,            source: Some(source),            base,        }    }    pub fn from_file(        source: impl Into<PathBuf>,        root: Option<&Path>,        follow_symlinks: bool,        buf: &mut Vec<u8>,    ) -> std::io::Result<Option<Self>> {        let source = source.into();        Ok(read_in_full_ignore_missing(&source, follow_symlinks, buf)?.then(|| Self::from_bytes(buf, source, root)))    }} impl<T> PatternList<T>where    T: Pattern,{    pub fn pattern_matching_relative_path(        &self,        relative_path: &BStr,        basename_pos: Option<usize>,        is_dir: Option<bool>,        case: git_glob::pattern::Case,    ) -> Option<Match<'_, T::Value>> {        let (relative_path, basename_start_pos) =            self.strip_base_handle_recompute_basename_pos(relative_path, basename_pos)?;        self.patterns            .iter()            .rev()            .filter(|pm| T::use_pattern(&pm.pattern))            .find_map(                |PatternMapping {                     pattern,                     value,                     sequence_number,                 }| {                    pattern                        .matches_repo_relative_path(relative_path, basename_start_pos, is_dir, case)                        .then(|| Match {                            pattern,                            value,                            source: self.source.as_deref(),                            sequence_number: *sequence_number,                        })                },            )    }     pub fn pattern_idx_matching_relative_path(        &self,        relative_path: &BStr,        basename_pos: Option<usize>,        is_dir: Option<bool>,        case: git_glob::pattern::Case,    ) -> Option<usize> {        let (relative_path, basename_start_pos) =            self.strip_base_handle_recompute_basename_pos(relative_path, basename_pos)?;        self.patterns            .iter()            .enumerate()            .rev()            .filter(|(_, pm)| T::use_pattern(&pm.pattern))            .find_map(|(idx, pm)| {                pm.pattern                    .matches_repo_relative_path(relative_path, basename_start_pos, is_dir, case)                    .then(|| idx)            })    }     fn strip_base_handle_recompute_basename_pos<'a>(        &self,        relative_path: &'a BStr,        basename_pos: Option<usize>,    ) -> Option<(&'a BStr, Option<usize>)> {        match self.base.as_deref() {            Some(base) => (                relative_path.strip_prefix(base.as_slice())?.as_bstr(),                basename_pos.and_then(|pos| {                    let pos = pos - base.len();                    (pos != 0).then(|| pos)                }),            ),            None => (relative_path, basename_pos),        }        .into()    }} impl PatternList<Ignore> {    /// Parse a list of patterns, using slashes as path separators    pub fn from_overrides(patterns: impl IntoIterator<Item = impl Into<OsString>>) -> Self {        PatternList {            patterns: patterns                .into_iter()                .map(Into::into)                .enumerate()                .filter_map(|(seq_id, pattern)| {                    let pattern = git_path::try_into_bstr(PathBuf::from(pattern)).ok()?;                    git_glob::parse(pattern.as_ref()).map(|p| PatternMapping {                        pattern: p,                        value: (),                        sequence_number: seq_id,                    })                })                .collect(),            source: None,            base: None,        }    }}