Support Graceful Restarts

[scien]

isaacs/npm#1999

npm restart currently runs prestop, stop, poststop, restart, prestart, start, poststart. According to the docs, and the original intention of the feature, a restart script should be able to be provided so the application can choose to restart their service gracefully (see isaacs/npm#184) instead of issueing a full stop/start.

Note: npm restart will run the stop and start scripts if no restart script is provided.

A full stop/start should only happen if a restart script is not provided.

[ralt]

Looks like the commit log should be "Don't run restart if it doesn't exist", shouldn't it? I'm confused between your description and the code in the commit.

[domenic]

No, the commit message makes sense. LGTM, @isaacs?

[luk-]

LGTM

[eliasgs]

Why isn't this merged?

[luk-]

I think we can probably merge this if someone wants to update the docs for it as well. If not, I can tomorrow or sometime this week.

[timoxley]

@scien want to add "npm restart will run the stop and start scripts if no restart script is provided." to the docs?

#4430

[eliasgs]

The docs says:
This runs a package's "restart" script, if one was provided. Otherwise it runs package's "stop" script, if one was provided, and then the "start" script.
It seems to sufficiently describe the functionality, if this pull request gets merged?

I think this should just be merged already:)

[domenic]

This needs a test before it can be merged.

[othiym23]

This has been waiting for a test without getting one for over a year. Closing as abandoned. Thanks for taking the time to put it together, @scien, and sorry we let it languish for so long without providing feedback. If you want to take another stab at this, a new version, with tests, would be welcome.