gitignore.rs

This is an implementation of .gitignore parsing and matching in Rust. Use this library if you want to check whether a given path would be excluded by a .gitignore file.

It currently builds on both nighly and stable versions of Rust.

Usage

The crate is called gitignore and you can it is available via crates.io:

[dependencies]
gitignore = "x.y.z"

You can also use the Git version directory simply by depending on it via Cargo:

[dependencies.gitignore]
git = "https://github.com/nathankleyn/gitignore.rs.git"

There are some useful bundled binaries which you can view to see how you might apply this library.

Examples

A simple example is as follows:

// Create a file
let file = gitignore::file::File::new(&path_to_gitignore).unwrap();

// This returns a bool as to whether the file matches a rule in the .gitignore file.
file.is_excluded(&path).unwrap();