Npm-scripts-tree NPM

npm-scripts-tree

npm run without argument displays 2 flat lists:

Official life-cycle scripts : start, test, postinstall…
Your custom made scripts : their name followed by their command.

npm-scripts-tree offers an alternative view.

Nested scripts.

It's pretty common to have meta scripts delegating to sub-scripts.

For instance:

"scripts": {
  "build": "npm run build:css && npm run build:js",
  "build:css": "do JS stuff",
  "build:js": "do CSS stuff"
}

npm-scripts-tree detects the relationship between these scripts and displays them in a tree fashion, recursively if needed. See detailed example below.

pre / post scripts

By starting your scripts name by pre or post you declare your own life-cycle hooks. This kind of dependency between scripts is also taken into account in the final output.

serial / parallel

npm-run-all dependencies are also supported!

Install

npm i -g npm-scripts-tree

Usage

Run npm-scripts-tree in the directory containing the package.json you want to inspect.

Life-cycle scripts are displayed in cyan
Scripts that are not sub-scripts are displayed in bold

Tip: you may want to create a shell alias like alias nst='npm-scripts-tree'.

Options

-a, --alpha List scripts alphabetically -p, --prune Remove life-cycle scripts and explicit sub-scripts (containing a :) from tree top level

Example

Fake package.json located in the test directory.

{
	"scripts": {
		"a": "npm run b && npm run c",
		"preb": "prefoo",
		"b": "foo",
		"c": "npm run d",
		"d": "bar",
		"e": "npm-run-all b d",
		"f": "npm-run-all --serial b d",
		"g": "npm-run-all --serial g:*",
		"g:a": "qux",
		"g:b": "yolo"
	}
}

Output in the terminal (without colors):

10 scripts
├─┬ a — npm run b && npm run c
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └─┬ c — npm run d
│   └── d — bar
├── preb — prefoo
├─┬ b — foo
│ └── preb — prefoo
├─┬ c — npm run d
│ └── d — bar
├── d — bar
├─┬ e — npm-run-all b d
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └── d — bar
├─┬ f — npm-run-all --serial b d
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └── d — bar
├─┬ g — npm-run-all --serial g:*
│ ├── g:a — qux
│ └── g:b — yolo
├── g:a — qux
└── g:b — yolo

After pruning:

7 scripts
├─┬ a — npm run b && npm run c
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └─┬ c — npm run d
│   └── d — bar
├─┬ b — foo
│ └── preb — prefoo
├─┬ c — npm run d
│ └── d — bar
├── d — bar
├─┬ e — npm-run-all b d
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └── d — bar
├─┬ f — npm-run-all --serial b d
│ ├─┬ b — foo
│ │ └── preb — prefoo
│ └── d — bar
└─┬ g — npm-run-all --serial g:*
  ├── g:a — qux
  └── g:b — yolo