Add CLI

[honzajavorek]

Adding CLI to streamline the workflow with the template. Also adding extensive docs on the topic. Addressing several issues here:

• Close CLI #20
• Close Do not assume my hook handler is installed as global executable #4
• Close Do not rely on global installed dredd #3
• Close Document a process for updating this repo & propagating changes to all hook handlers #19

This is a part of the plan outlined here: apiaryio/dredd#917 (comment)

Note that the upgrade command isn't tested as the package isn't published here yet and the npm view call would just fail now. I'll test the upgrade command somehow as one of the next steps. Filed as #43

I suggest the reviewer to see the README first and learn about how the thing is supposed to work, then dive in to the changes to the code.

[artem-zakharchenko]

We can also use postinstall npm hook for copying the files, so users could upgrade the package version using a default flow (npm outdated/npm install ...), and the hook would handle additional logic.

Also account on the scenario that a user will upgrade the package as usual. I think we should ensure the package would contain expected files in any way.

[honzajavorek]

That's an interesting idea which didn't occur to me. One concern I'd have is that it would implicitly, without asking the user, copy some files over from the package to their code. I'm not sure whether it's not too invasive. I kind of like the explicit step user takes - they know what they're doing, they're doing it willingly, they can easily retry, etc.

[honzajavorek]

@artem-zakharchenko I replied to some of your comments and addressed the others in comments. Could you please re-review?

[ApiaryBot]

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀