//! Parse `.gitignore` files and provide utilities to match against them.//!//! ## Examples//!//! ```//! use gix_glob::pattern::Case;//!//! let search = gix_ignore::Search::from_overrides(["target/", "!target/keep.me"], Default::default());//!//! let ignored = search//!     .pattern_matching_relative_path("target".into(), Some(true), Case::Sensitive)//!     .unwrap();//! assert_eq!(ignored.sequence_number, 1);//! assert_eq!(ignored.kind, gix_ignore::Kind::Expendable);//! assert!(!ignored.pattern.is_negative());//!//! let kept = search//!     .pattern_matching_relative_path("target/keep.me".into(), Some(false), Case::Sensitive)//!     .unwrap();//! assert_eq!(kept.sequence_number, 2);//! assert!(kept.pattern.is_negative());//! ```//!//! ## Feature Flags#![cfg_attr(    all(doc, feature = "document-features"),    doc = ::document_features::document_features!())]#![cfg_attr(all(doc, feature = "document-features"), feature(doc_cfg))]#![deny(missing_docs)]#![forbid(unsafe_code)] pub use gix_glob as glob; ///pub mod search;/// A grouping of lists of patterns while possibly keeping associated to their base path in order to find matches.////// Pattern lists with base path are queryable relative to that base, otherwise they are relative to the repository root.#[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Default)]pub struct Search {    /// A list of pattern lists, each representing a patterns from a file or specified by hand, in the order they were    /// specified in.    ///    /// When matching, this order is reversed.    pub patterns: Vec<gix_glob::search::pattern::List<search::Ignore>>,} /// The kind of *ignored* item.////// This classification is obtained when checking if a path matches an ignore pattern.#[derive(Default, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Debug)]pub enum Kind {    /// The item is ignored and will be removed to make place for tracked items that are to be checked out.    ///    /// This is the default for ignored items.    /// Another way of thinking about this class is to consider these files *trashable*, or talk about them as `ignored-and-expendable`.    #[default]    Expendable,    /// An ignored file was additionally marked as *precious* using the `$` prefix to indicate the file shall be kept.    ///    /// This means that precious files are treated like untracked files, which also must not be removed, but won't show up by default    /// as they are also ignored.    /// One can also talk about them as `ignored-and-precious`.    Precious,} ///pub mod parse; /// Parse git ignore patterns, line by line, from `bytes`.////// If `support_precious` is `true`, we will parse `$` prefixed entries as precious./// This is backward-incompatible as files that actually start with `$` like `$houdini`/// will then not be ignored anymore, instead it ignores `houdini`.pub fn parse(bytes: &[u8], support_precious: bool) -> parse::Lines<'_> {    parse::Lines::new(bytes, support_precious)}