@oclif/plugin-update

What is @oclif/plugin-update?

@oclif/plugin-update is a plugin for the Oclif CLI framework that provides functionality for updating CLI applications. It allows developers to easily integrate update commands into their CLI tools, ensuring that users can always have the latest version of the tool.

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

Check for Updates

This feature allows the CLI tool to check for updates. The `UpdateCommand` class from `@oclif/plugin-update` is extended to create a custom update command that can be run to check for updates.

const { Command } = require('@oclif/core');
const { UpdateCommand } = require('@oclif/plugin-update');

class MyUpdateCommand extends UpdateCommand {
  async run() {
    await super.run();
    this.log('Checked for updates!');
  }
}

module.exports = MyUpdateCommand;

Run Update

This feature allows the CLI tool to perform an update. The `UpdateCommand` class is used to run the update process, ensuring that the CLI tool is updated to the latest version.

const { Command } = require('@oclif/core');
const { UpdateCommand } = require('@oclif/plugin-update');

class MyUpdateCommand extends UpdateCommand {
  async run() {
    await super.run();
    this.log('CLI tool updated to the latest version!');
  }
}

module.exports = MyUpdateCommand;

Other packages similar to @oclif/plugin-update

update-notifier

The `update-notifier` package checks for updates of a CLI tool and notifies the user if a new version is available. Unlike `@oclif/plugin-update`, it does not perform the update itself but rather informs the user to update manually.

npm-check-updates

`npm-check-updates` is a package that allows you to find and update outdated npm dependencies. While it is not specifically for CLI tools, it provides similar functionality in terms of checking for and updating dependencies.

yarn-upgrade-all

`yarn-upgrade-all` is a package that upgrades all dependencies for a project using Yarn. It is similar to `@oclif/plugin-update` in that it automates the update process, but it is focused on project dependencies rather than CLI tools.

README

@oclif/plugin-update

• Usage
• Commands

Usage

$ npm install -g @oclif/plugin-update
$ oclif-example COMMAND
running command...
$ oclif-example (-v|--version|version)
@oclif/plugin-update/1.1.17 linux-x64 node-v8.11.1
$ oclif-example --help [COMMAND]
USAGE
  $ oclif-example COMMAND
...

Commands

• oclif-example update [CHANNEL]

oclif-example update [CHANNEL]

update the oclif-example CLI

USAGE
  $ oclif-example update [CHANNEL]

See code: src/commands/update.ts

Changelog

1.1.17 (2018-04-21)

Bug Fixes

• only show waiting message once (5c75700)