1.1.0 • Published 5 years ago

inquirer-file-selector-prompt v1.1.0

Weekly downloads
-
License
MIT
Repository
-
Last release
5 years ago

Inquirer File Selector Prompt

A plugin for Inquirer, allowing users to navigate their file directories to select files.

npm npm

Demo

Installation

npm install --save inquirer-file-selector-prompt

Usage

Register the prompt under any alias you prefer then use the prompt as you would any other inquirer prompt.

inquirer.registerPrompt('file-selector', require('inquirer-file-selector-prompt'));

inquirer.prompt({
  type: 'file-selector',
  ...
})

Options

Takes type, name, message, filter, validate, default, pageSize, path, extensions, selectionType, onlyShowMatchingExtensions properties.

The extra options that this plugin provides are:

  • path Type: string Description: Starting directory for the prompt Default: process.cwd()
  • extensions Type: Array\<string> Description: Array of valid extensions to pick from Default: [] (any extension)
  • selectionType Type: string Description: Choose whether to select a file or directory Valid options: ["file","folder","either"] Default: "file"
  • onlyShowMatchingExtensions Type: boolean Description: Select whether to hide files that do not match the specified valid extensions Default: false

Example

const inquirer = require('inquirer');
const fileSelector = require('./index.js');

inquirer.registerPrompt('file-tree-selection', fileSelector);

inquirer
	.prompt([
		{
			type: 'file-tree-selection',
			name: 'file',
			message: 'choose a file',
			extensions: ['js']
		}
	])
	.then(answers => {
		console.log(JSON.stringify(answers));
	});

License

This project is under the MIT license.