npx: deprecate plugin

Fixes #9366
This commit is contained in:
Marc Cornellà 2020-10-21 20:01:10 +02:00 committed by GitHub
parent 80d2e4336b
commit 3b1699b595
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,21 +1,15 @@
# NPX Plugin # NPX Plugin
> npx(1) -- execute npm package binaries. ([more info](https://github.com/zkat/npx))
> npx(1) -- execute npm package binaries. ([more info](https://github.com/npm/npx))
This plugin automatically registers npx command-not-found handler if `npx` exists in your `$PATH`. This plugin automatically registers npx command-not-found handler if `npx` exists in your `$PATH`.
## Setup To use it, add `npx` to the plugins array in your zshrc file:
- Add plugin to `~/.zshrc` ```zsh
```bash
plugins=(.... npx) plugins=(.... npx)
``` ```
- Globally install npx binary (npx will be auto installed with recent versions of Node.js)
```bash
sudo npm install -g npx
```
## Note ## Note
The shell auto-fallback doesn't auto-install plain packages. In order to get it to install something, you need to add `@`: The shell auto-fallback doesn't auto-install plain packages. In order to get it to install something, you need to add `@`:
@ -29,3 +23,17 @@ Started
It does it this way so folks using the fallback don't accidentally try to install regular typoes. It does it this way so folks using the fallback don't accidentally try to install regular typoes.
## Deprecation
Since npm v7, `npx` has been moved to `npm exec`. With the move, [the `--shell-auto-fallback` argument
for `npx` has been removed](https://github.com/npm/cli/blob/v7.0.0/docs/content/cli-commands/npm-exec.md#compatibility-with-older-npx-versions):
> Shell fallback functionality is removed, as it is not advisable.
When using npm v7, you'll get this error:
> npx: the --shell-auto-fallback argument has been removed
If you get this error, just disable the plugin by removing it from the plugins array in your zshrc file.
This plugin will no longer be maintained and will be removed in the future, when the older `npx` versions
are no longer available.