0.0.3 • Published 8 years ago
git-diff-generator v0.0.3
git-diff-generator
what
generate a series of diffs, provided a list of inorder commits.
install
npm install -g git-diff-generator
usage
of course, you can see your options from the cli
$ git-diff-generator -h
Usage: git-diff-generator [options]
Options:
-h, --help output usage information
-V, --version output the version number
-c, --config [file] config // <== MOST IMPORTANT!
-o, --out [dir] output dir. defaults to cwd
-r, --repo [path] path to repo. otherwise, defaults to cwd
-v, --verbose get loud
// config.json
{
// REQUIRED
// we will `git diff --full-index commit1...commit2 > /out/path/formatted-filename.dff
// ordering: latest commits on top/first, oldest commits on bottom/last. just as out of `git log`
"commits": [
"d63bf42",
"a99bc56"
],
// OPTIONAL
// file output format accepts the following template inputs
// %ndx, index of the diff in the set of commited diffs (1 indexed)
// %commit1, earlier commit
// %commit2, later commit
"format": "%ndx-%commit1...$commit2.diff"
}
example
from this repo itself, i can perform the following:
$ git-diff-generator -c test/input/this-repo-config.json -o test/output/ -v
[git-differ] VERBOSE: SETTINGS
[git-differ] VERBOSE: out: test/output/
[git-differ] VERBOSE: repo: /Users/cdieringer/node/git-diff-generator
[git-differ] VERBOSE: format: %ndx-%commit1...%commit2.diff
[git-differ] VERBOSE: running diff: git diff --full-index a99bc56...d63bf42 > test/output/1-a99bc56...d63bf42.diff
sure enough, test/output/1-a99bc56...d63bf42.diff
is ready to go!