node-merge-trees
Symlink or copy multiple trees of files on top of each other, resulting in a single merged tree.
Optimized for repeated (incremental) merging.
Installation
npm install --save merge-trees
Usage
-
new MergeTrees(inputPaths, outputPath, options)
:
-
inputPaths
: An array of paths to the input directories
-
outputPath
: The path to the output directory. Must exist and be empty.
-
options
: A hash of options
-
mergeTrees.merge()
: Merge the input directories into the output directory.
Can be called repeatedly for efficient incremental merging.
Options
-
overwrite
: By default, node-merge-trees throws an error when a file
exists in multiple nodes. If you pass { overwrite: true }
, the output
will contain the version of the file as it exists in the last input
directory that contains it.
-
annotation
: A note to help with logging.
Example
var MergeTrees = require('merge-trees');
var mergeTrees = new MergeTrees(
['public', 'scripts'],
'output-dir',
{ overwrite: true });
mergeTrees.merge()
mergeTrees.merge()
Say the directory structure is as follows:
.
├─ public
│ ├─ index.html
│ └─ images
│ └─ logo.png
├─ scripts
│ └─ app.js
├─ output-dir
…
Running mergeTrees.merge()
will generate this folder:
.
├─ …
└─ output-dir
├─ app.js
├─ index.html
└─ images
└─ logo.png
The parent folders, public
and scripts
in this case, are not included in the output. The output tree contains only the files within each folder, all mixed together.
Contributing
Clone this repo and run the tests like so:
npm install
npm test
Issues and pull requests are welcome. If you change code, be sure to re-run
npm test
. Oftentimes it's useful to add or update tests as well.