npm-fzf
Fuzzy search npm modules with
fzf
npm-fzf
, short-named npf
, provides fuzzy search for some most commonly used npm commands with fzf
, i.e. npm ls
, npm search
, npm run
, creating a more fulfilling develop experience with npm
.
Requirements
Must: npf
requires Node 8 for runtime or above.
Highly Recommended: fzf
is used heavily by npf
. If fzf
is not installed, npf
will default to a much less capable sibling, node-fzf
- fzf
's implementation in Node.
CLI
$ npm install -g npm-fzf
Usage
Usage: npf [options] [command]
Fuzzy search npm modules with fzf
Options:
-v, --version output the version number
-d, --details include details to each dependency, but disable the fuzzy mode
-P, --no-preview disable the default fzf preview mode
-F, --no-fuzzy disable the default fuzzy mode and resort to stdout
-h, --help output usage information
Commands:
list|ls [options] npm list with fzf
info [module] npm info with fzf
run npm run with fzf
search <module...> npm search with fzf
npf search
Usage: search [options] <module...>
npm search with fzf
Options:
-h, --help output usage information
Examples:
npf search <module...>, fuzzy search for npm modules with preview
npf search <module...> --no-preview, fuzzy search for npm modules without preview
npf search <module...> --no-fuzzy, plain search for npm modules
$ npf search express$ npf search express react
npf list
Usage: list|ls [options]
npm list with fzf
Options:
-l, --local list local dependencies, which is also the default feature
-g, --global list global modules
-t, --time show the latest global installs
-h, --help output usage information
Examples:
npf ls, a fzf list with preview of local dependencies
npf ls -t, a fzf list of latest global installs
npf ls -t --no-fuzzy, a normal list of latest global installs
npf ls -g --no-preview, a fuzzy list with no preview of global installs
npf ls -g --details, a normal, detailed list of global installs
Local dependencies
$ npf ls
Global modules
$ npf ls -g
Recent global installs
A quick refresher on what the heck it's installed/upgraded globally in the recent past
$ npf ls -t
Turn off preview mode
Preview mode uses fzf --preview
underneath and is turned on in most cases by default. You can also opt for --no-preview
to turn off the default preview mode.
$ npf ls -t --no-preview$ npf ls -g --no-preview$ npf ls -l --no-preview
Turn off fuzzy mode
Fuzzy mode is by default on. You can also opt for --no-fuzzy
to turn it off.
$ npf ls -t --no-fuzzy$ npf ls -g --no-fuzzy
Details flag
Applied to both local dependencies and global installs
$ npf ls --details
$ npf ls -g --details
npf run
Usage: run [options]
npm run with fzf
Options:
-h, --help output usage information
Examples:
npf run, execute npm scripts with fzf
npf run --no-fuzzy, execute npm scripts without fzf
$ npf run
npf info
Usage: info [options] [module]
npm info with fzf
Options:
-h, --help output usage information
Examples:
npf info [module], a fuzzy list with preview of a module's dependencies fetched from NPM registry
npf info [module] --no-preview, a fuzzy list of a module's dependencies fetched from NPM registry
npf info [module] --no-fuzzy, a list of a module's dependencies fetched from NPM registry
npf info
fetches the module's latest version by default, unless a version is specified.
It defaults to the current folder if no argument provided.
$ npf info npm-fzf
API
npf
uses npmlist
's API for getting modules' dependencies. npf
itself does not expose any API.
$ npm install @hankchanocd/npmlist
Tests
To perform unit tests and integration tests, simply run npm test
. (Need Help)
Changelog
Contribution
If you have any suggestion, leave it on Issues for discussion first. See here on how to contribute.
fzf
empowers many features that would otherwise be hard to imagine. If you haven't heard of fzf
, check out junegunn's fzf
. Check out my Dotfiles to see more use cases of fzf
.