CLI Simplification

[scott113341]

• push-dir [remote] <dir>:<branch> [options...] syntax simplifying the CLI #7
• Removed all flags except --preserve-local-temp-branch Lost changes when using --allow-unclean #9
• Added --help, -h flag
• Displays --help output when used incorrectly
• Removed commit message formatting function
• Added/removed tests
• Moved tests into their own files to enable individual running

[rtsao]

Force pushing workflow
I think force pushing to the remote branch should still be a supported option (perhaps a new meaning for --force).

Simple overrides
I guess --message was undocumented, but I think it's valid option, especially in the case of a force push workflow. Supporting something like --message="hello world %H" seems useful.

Local branch preservation
--preserve-local-temp-branch is kind of an oxymoron. Maybe it's best to treat the temp branch entirely as an implementation detail. Then if the user wants to create local branch, they can specify a --local-branch-name="cool-branch-%h" option, which creates a local branch with that name (and is preserved).

Dry runs
Git push supports --dry-run, which doesn't actually push anything. Maybe we can do something similar, which would be useful in combination with --local-branch-name for debugging purposes (mainly the pull + merge behavior when not force pushing)

[rtsao]

😆 This is clever but is it worth it for DRYness? I'm not sure how often the usage docs will change in the future once we have API stability. Parsing the README at runtime seems kinda crazy.

[scott113341]

push-dir|scott-dev⚡ ⇒ node benchmark.js
showUsageFromDisk x 53,288 ops/sec ±3.82% (79 runs sampled)
showUsageFromString x 76,362,229 ops/sec ±2.10% (76 runs sampled)
Fastest is showUsageFromString

[rtsao]

fs.createReadStream('usage.txt').pipe(process.stdout)