js-makedepend

js-makedepend

A makedepend for javascript ES6, CommonJS and AMD (/ RequireJS).

For all two of you using Makefiles to build JavaScript based projects.

Installation and basic usage

(1) Install with npm

npm install -g js-makedepend

(2) Include this target in your Makefile (assuming your javascript is in src/):

depend:
	js-makedepend src/

(3) Run make depend
js-makedepend will have added the dependencies in src/ to your Makefile. See the examples below to see how that looks.

All options

Usage: js-makedepend [options] <directory-or-file>

  Options:

    -h, --help                  output usage information
    -V, --version               output the version number
    -f, --output-to <file>      Makefile to output to
                                 default: -f Makefile
                                 use -f - to output to stdout
    -x, --exclude <regex>       a regular expression for excluding modules
    -s, --delimiter <string>    starting string delimiter
    -d, --flat-define <string>  outputs a define with flat dependencies
    -a, --append                append dependencies instead of replacing them
    -M, --system <items>        list of module systems (default: amd,cjs,es6)
	-G , --dot                  visualizes dependencies in a graphiz dot

Features by example

The default: recursive

Let's say you have a cool project going with this source tree:

    src/root_one.js
    src/root_two.js
    src/one_only_one.js
    src/one_only_two.js
    src/shared.js
    src/two_only_one.js
    src/sub/depindir.js
    src/sub/dir.js

On a directory

Running js-makedepend src with no options will append all dependencies present in source files in that directory to your Makefile:

# DO NOT DELETE THIS LINE -- js-makedepend depends on it.

# amd dependencies
# cjs dependencies
src/root_one.js: \
	../../node_modules/commander/index.js \
	src/one_only_one.js \
	src/one_only_two.js \
	src/shared.js \
	src/sub/dir.js

src/root_two.js: \
	src/shared.js \
	src/two_only_one.js

src/sub/dir.js: \
	src/sub/depindir.js

src/two_only_one.js: \
	src/sub/dir.js

# es6 dependencies

On a file

You can also pass a file as an argument. js-makedepend src/root_two.js will only emit the (recursive) dependencies of src/root_two.js:

# DO NOT DELETE THIS LINE -- js-makedepend depends on it.

# amd dependencies
# cjs dependencies
src/root_two.js: \
	src/shared.js \
	src/two_only_one.js

src/two_only_one.js: \
	src/sub/dir.js

src/sub/dir.js: \
	src/sub/depindir.js

# es6 dependencies

Flattened in a DEFINE: --flat-define

Sometimes all you need is just all sources in one define. js-makedepend --system cjs --flat-define ROOT_ONE_ALL_SRC src/root_one.js will do just that:

# DO NOT DELETE THIS LINE -- js-makedepend depends on it.

# cjs dependencies
ROOT_ONE_ALL_SRC=src/root_one.js \
	../../node_modules/commander/index.js \
	src/one_only_one.js \
	src/one_only_two.js \
	src/shared.js \
	src/sub/depindir.js \
	src/sub/dir.js

(You might want to pick one module system here - otherwise you'll end up with three very similar lookin defines).

Replacing & appending: --append

You might have noted the # DO NOT DELETE THIS LINE -- js-makedepend depends on it. there. In next runs js-makedepends by default will replace everything below that line.

If you want to have the output of multiple runs of js-makedepend in your Makefile use --append e.g.

depend:
	js-makedepend --flat-define ROOT_ONE_ALL_SRC src/root_one.js
	js-makedepend --append --flat-define ROOT_TWO_ALL_SRC src/root_two.js

Excluding stuff to walk through: --exclude

In the above samples you'll notice the presence of a dependency in the node_modules tree: ../../node_modules/commander/index.js. If you don't want that, add the --exclude with a regular expression, e.g.

depend:
	js-makedepend --exclude node_modules --flat-define ALL_SRC src/

Output to something else: --output-to

If your depency tree is big, you might want to put your dependencies in a separate file, using make's include.

include jsdependencies.mk

depend:
	js-makedepend --output-to jsdependencies.mk src/

Note: running this when jsdepencies.mk doesn't exist yet will make make stop with an error. Either create it before running make (e.g. touch jsdependencies.mk) or include the include jsdepencies in your Makefile only after running the depend target for the first time.

If you pick - as a filename, js-makedepend will emit to stdout.

Selecting module systems: --system

By default js-makedepend runs through your sources thrice, once for every module system it knows. If you don't want that, specify the systems your interested in, in a comma-separated list:

	js-makedepend --system amd,es6 src/

Use your own delimiter string: --delimiter

By default js-makedepend emits a demarcation line so it can find its output on a next run:

# DO NOT DELETE THIS LINE -- js-makedepend depends on it.

If you want it to use something else, you can do that:

js-makedepend --delimiter "# Aren't you a little short for a stormtrooper?"

or even

js-makedepend --delimiter "MY_COOL_DEFINE=achoo!"

Advanced example

Include these snippets to your Makefile to

• Add dependencies to a separate depencies.mk include
• Only traverse CommonJS dependencies
• don't include any source that resides in node_modules
• besides all dependencies
  • define a ROOT_ONE_SRC with a flattened list of all files on which src/root_one.js depends
  • define a ROOT_TWO_SRC with a flattened list of all files on which src/root_two.js depends

MAKEDEPEND=node_modules/.bin/js-makedepend \
	--output-to dependencies.mk \
	--exclude node_modules \
	--system cjs
include dependencies.mk

depend:
	$(MAKEDEPEND)
	$(MAKEDEPEND) --append --flat-define ROOT_ONE_SRC src/root_one.js
	$(MAKEDEPEND) --append --flat-define ROOT_TWO_SRC src/root_wo.js

Visualizing the dependency graph

Use --dot (or -G) to save the dependencies as a graphviz dot file:

js-makedepend --dot --exclude "(node_modules)" --output-to dot-output-sample.dot src

You can use graphviz dot to transform it into something graphical:

dot -Tpng dot-output-sample.dot > dot-output-sample.png

License

MIT

Thanks

• Marijn Haverbeke and other people who colaborated on acorn - the excelent javascript parser js-makedepend uses to infer the dependencies.