# gitignore-to-glob

> Transforms .gitignore patterns to ones compatible with the glob package (used by Grunt & others)

Latest version **0.3.0** (published 2016-10-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install gitignore-to-glob
pnpm add gitignore-to-glob
yarn add gitignore-to-glob
bun add gitignore-to-glob
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.3.0 |
| Published | 2016-10-26 |
| First published | 2014-08-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=4.4 <5 \|\| >=6.9 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Michał Gołębiowski |
| Maintainers | m_gol |
| Keywords | gitignore, glob |

## Links

- npm: https://www.npmjs.com/package/gitignore-to-glob
- Repository: https://github.com/EE/gitignore-to-glob
- Issues: https://github.com/EE/gitignore-to-glob/issues
- npm.io page: https://npm.io/package/gitignore-to-glob

## Recent versions

- 0.3.0 (latest) — 2016-10-26
- 0.2.1 — 2016-03-09
- 0.2.0 — 2016-03-09
- 0.1.2 — 2014-08-22
- 0.1.1 — 2014-08-22
- 0.1.0 — 2014-08-22

## README

# gitignore-to-glob

> Transforms .gitignore patterns to ones compatible with the glob package (used by Grunt & others)

[![Build Status](https://travis-ci.org/EE/gitignore-to-glob.svg?branch=master)](https://travis-ci.org/EE/gitignore-to-glob)
[![Build status](https://ci.appveyor.com/api/projects/status/oi2hv39087wp6c00/branch/master?svg=true)](https://ci.appveyor.com/project/mgol/gitignore-to-glob/branch/master)
## Installation

To install the package and add it to your `package.json`, invoke:

```shell
npm install gitignore-to-glob --save-dev
```

## Rationale

`.gitignore` uses a different format than the `glob` package used, among others, by Grunt. Sometimes it's desirable
to exclude files excluded by `.gitignore` in a glob pattern so a transformation function is needed.

## Usage

Once the package has been installed, it may be used via:

```js
require('gitignore-to-glob')(pathToGitignore, dirsToCheck);
```
where `pathToGitignore` is `'.gitignore'` by default and `dirsToCheck` is an optional array of directories where we
assume all files matched by the glob pattern exist. The parameter is optional but may be passed for performance reasons.
The rationale is that `.gitignore` patterns not starting with `/` are treated as if a glob pattern started with `**/`
and that would be expensive as some directories like `node_modules` usually contain a lot of files so excluding them
all manually would be slow.


## Usage Examples

The most basic usage:
```js
require('gitignore-to-glob')();
```
This will convert files from the main `'.gitignore'`.

```js
require('gitignore-to-glob')('app/.gitignore', ['app', 'test']);
```
This will convert the `'app/.gitignore'` file but will omit patterns outside directories `app` and `test`.

## Supported Node.js versions
This project aims to support all Node.js LTS versions in the "active" phase (see [LTS README](https://github.com/nodejs/LTS/blob/master/README.md) for more details) as well as the latest stable Node.js.

## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using `npm test`.

## License
Copyright (c) 2014 Laboratorium EE. Licensed under the MIT license.

---
_Source: https://npm.io/package/gitignore-to-glob · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._