https://github.com/fabiospampinato/fast-ignore
A fast parser and processor for .gitignore files.
https://github.com/fabiospampinato/fast-ignore
dotignore fast gitignore ignore
Last synced: 4 months ago
JSON representation
A fast parser and processor for .gitignore files.
- Host: GitHub
- URL: https://github.com/fabiospampinato/fast-ignore
- Owner: fabiospampinato
- License: mit
- Created: 2023-12-09T01:12:09.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-03-29T00:07:41.000Z (over 1 year ago)
- Last Synced: 2024-11-06T11:52:36.751Z (about 1 year ago)
- Topics: dotignore, fast, gitignore, ignore
- Language: JavaScript
- Homepage:
- Size: 14.6 KB
- Stars: 52
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# Fast Ignore
A fast parser and processor for `.gitignore` files.
Note: terminal slashes on globs are ignored for now.
## Install
```sh
npm install --save fast-ignore
```
## Usage
```ts
import fastIgnore from 'fast-ignore';
// Let's create the content of a .gitignore file
const gitignore = `
# Some always-ignore files
*~
*.err
*.log
._*
.cache
.fseventsd
.DocumentRevisions*
.DS_Store
.TemporaryItems
.Trashes
Thumbs.db
# Some project-specific ignores
dist
node_modules
`;
// Let's create our ignore function
const ignore = fastIgnore ( gitignore );
// Now we can check if a relative path should be ignored
ignore ( 'foo/bar.js' ); // false
ignore ( 'node_modules/foo/bar.js' ); // true
ignore ( 'dist/foo/bar.js' ); // true
// We can also work with multiple ignore files at once, which is faster than handling them individually
// This goes roughly as fast as just concatenating the files together, but with the semantics of separate files
// The difference is that an ignore file that comes later won't be able to un-ignore something that was ignored by a previous one
// As a result please note that writing `fastIgnore ([ 'dist', '!dist' ])` may work differently than you expected
const prettierignore = `
**/test
**/__test__
# The following globs are effectively useless
# because they can't un-ignore something that was ignored by any previous ignore files
!dist
!node_modules
`;
const comboIgnore = fastIgnore ([ gitignore, prettierignore ]);
comboIgnore ( 'foo/bar.js' ); // false
comboIgnore ( 'node_modules/foo/bar.js' ); // true
comboIgnore ( 'dist/foo/bar.js' ); // true
comboIgnore ( 'test/foo/bar.js' ); // true
```
## License
MIT © Fabio Spampinato