# gulp-choose-file

> Gulp plugin that prompts you to choose a file to pass through the stream.

Latest version **0.1.1** (published 2016-07-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-choose-file
pnpm add gulp-choose-file
yarn add gulp-choose-file
bun add gulp-choose-file
```

## 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.1.1 |
| Published | 2016-07-14 |
| First published | 2016-07-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Aurelien Verla |
| Maintainers | pointnet |
| Keywords | ask, choose, conditional, file, fs, gulp, gulpplugin, pick, prompt, question, render, write |

## Links

- npm: https://www.npmjs.com/package/gulp-choose-file
- Repository: https://github.com/pointnet/gulp-choose-file
- Issues: https://github.com/pointnet/gulp-choose-file/issues
- npm.io page: https://npm.io/package/gulp-choose-file

## Dependencies (3)

- [through2](https://npm.io/package/through2.md) ^2.0.1
- [extend-shallow](https://npm.io/package/extend-shallow.md) ^2.0.1
- [question-cache](https://npm.io/package/question-cache.md) ^0.4.0

## Alternatives

- [unionfs](https://npm.io/package/unionfs.md) — 2.2M weekly downloads
- [path-starts-with](https://npm.io/package/path-starts-with.md) — 35.9K weekly downloads
- [redzip](https://npm.io/package/redzip.md) — 1.2K weekly downloads
- [vscode-anymatch](https://npm.io/package/vscode-anymatch.md) — 848 weekly downloads
- [@ledgerhq/coin-filecoin](https://npm.io/package/@ledgerhq/coin-filecoin.md) — 793 weekly downloads

## Recent versions

- 0.1.1 (latest) — 2016-07-14
- 0.1.0 — 2016-07-14

## README

# gulp-choose-file [![NPM version](https://img.shields.io/npm/v/gulp-choose-file.svg?style=flat)](https://www.npmjs.com/package/gulp-choose-file) [![NPM downloads](https://img.shields.io/npm/dm/gulp-choose-file.svg?style=flat)](https://npmjs.org/package/gulp-choose-file)

Gulp plugin that prompts you to choose a file to pass through the stream.

## Usage

```js
var gulp = require('gulp');
var choose = require('gulp-choose-file');

gulp.task('default', function() {
  return gulp.src('fixtures/*.*')
    .pipe(choose())
    .pipe(gulp.dest('actual'));
});
```

## options.choices

If you need to be able to automatically skip the prompt, you can pass a string with your "choice" to `options.choices`.

The following will only write `a.txt`:

```js
gulp.task('default', function() {
  return gulp.src('fixtures/*.txt')
    .pipe(choose({choices: 'a.txt'}))
    .pipe(gulp.dest('actual'));
});
```

## About

### Related projects

[gulp-choose-files](https://www.npmjs.com/package/gulp-choose-files): Gulp plugin that prompts you to choose the files to pass through the stream. | [homepage](https://github.com/generate/gulp-choose-files "Gulp plugin that prompts you to choose the files to pass through the stream.")

### Contributing

Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).

### Building docs

_(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_

To generate the readme and API documentation with [verb](https://github.com/verbose/verb):

```sh
$ npm install -g verb verb-generate-readme && verb
```

### License

Copyright © 2016, [Aurelien Verla](https://github.com/pointnet).
Released under the [MIT license](https://github.com/pointnet/gulp-choose-file/blob/master/LICENSE).

***

_This file was generated by [verb](https://github.com/verbose/verb), v0.9.0, on July 14, 2016._

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