@oclif/plugin-autocomplete

What is @oclif/plugin-autocomplete?

@oclif/plugin-autocomplete is a plugin for the Oclif CLI framework that provides autocomplete functionality for CLI commands. It helps users by suggesting command completions, options, and arguments as they type, improving the user experience and efficiency.

What are @oclif/plugin-autocomplete's main functionalities?

Enable Autocomplete

This feature enables autocomplete for the CLI application. The code sample demonstrates how to enable autocomplete using the @oclif/plugin-autocomplete package.

const { Command } = require('@oclif/core');
const Autocomplete = require('@oclif/plugin-autocomplete').default;

class MyCommand extends Command {
  async run() {
    this.log('Enabling autocomplete...');
    await Autocomplete.enable();
  }
}

MyCommand.run();

Generate Autocomplete Script

This feature generates the autocomplete script for the CLI application. The code sample shows how to generate and log the autocomplete script using the @oclif/plugin-autocomplete package.

const { Command } = require('@oclif/core');
const Autocomplete = require('@oclif/plugin-autocomplete').default;

class MyCommand extends Command {
  async run() {
    this.log('Generating autocomplete script...');
    const script = await Autocomplete.generate();
    this.log(script);
  }
}

MyCommand.run();

Disable Autocomplete

This feature disables autocomplete for the CLI application. The code sample demonstrates how to disable autocomplete using the @oclif/plugin-autocomplete package.

const { Command } = require('@oclif/core');
const Autocomplete = require('@oclif/plugin-autocomplete').default;

class MyCommand extends Command {
  async run() {
    this.log('Disabling autocomplete...');
    await Autocomplete.disable();
  }
}

MyCommand.run();

Other packages similar to @oclif/plugin-autocomplete

commander

Commander is a popular CLI framework for Node.js that provides command parsing and option handling. While it does not natively support autocomplete, it can be extended with additional packages to provide similar functionality. Compared to @oclif/plugin-autocomplete, Commander requires more setup to achieve autocomplete features.

yargs

Yargs is another CLI framework for Node.js that helps build interactive command-line tools. It includes some built-in support for command completion, but it is not as comprehensive as @oclif/plugin-autocomplete. Yargs is more focused on argument parsing and validation.

inquirer

Inquirer is a library for creating interactive command-line interfaces. It provides prompts and questions to guide users through command execution. While it does not offer autocomplete, it can be used alongside other packages to enhance the user experience. Inquirer is more focused on user interaction rather than command completion.

README

@oclif/plugin-autocomplete

autocomplete plugin for oclif (bash & zsh)

• Usage
• Commands

Usage

See https://oclif.io/docs/plugins.html

Commands

• oclif-example autocomplete [SHELL]

oclif-example autocomplete [SHELL]

display autocomplete installation instructions

USAGE
  $ oclif-example autocomplete [SHELL]

ARGUMENTS
  SHELL  shell type

OPTIONS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

EXAMPLES
  $ oclif-example autocomplete
  $ oclif-example autocomplete bash
  $ oclif-example autocomplete zsh
  $ oclif-example autocomplete --refresh-cache

See code: src/commands/autocomplete/index.ts

Changelog

0.1.1 (2019-06-05)

Bug Fixes

• only use the first line of the command description for zsh (#10) (3446a6b)