[Request] API should allow pause and unpause, not just pause-toggle

[MarcusWolschon]

Version 1.2.13 (master branch)

The API
http://docs.octoprint.org/en/master/api/job.html#issue-a-job-command
allows for a "command": "paus" described as:
"Pauses/unpauses the current print job."

Issue:
Issuing a pause command twice for any reason (timeout, response not parsed properly, script was restarted,..) resumes the print instead of keeping it paused.

In my case I'm using the pause command for a Filament monitor.
http://marcuswolschon.blogspot.de/2016/06/ultimaker-ii-filament-sensor-and-remote.html
Obviously having any chance of accidentally resuming a print instead of pausing it, is dangerous.

Proposal:
The current command is nice for user interfaces used exclusively by humans.
For automatic scripts it should offer 2 command to
pause and to resume a print regardless of state.

[GitIssueBot]

Hi @MarcusWolschon,

It looks like there is some information missing from your bug report that will be needed in order to solve the problem. Please take a look at the Contribution Guidelines which will provide you with a template to fill out here so that your bug report is ready to be investigated (I promise I'll go away then too!).

If you did not intend to report a bug, please take special note of the title format to use as described in the Contribution Guidelines.

I'm marking this one now as needing some more information. Please understand that if you do not provide that information within the next two weeks (until 2016-07-14 05:10) I'll close this ticket so it doesn't clutter the bug tracker. This is nothing personal, so please just be considerate and help the maintainers solve this problem quickly by following the guidelines linked above. Remember, the less time the devs have to spend running after information on tickets, the more time they have to actually solve problems and add awesome new features. Thank you!

Best regards,
~ Your friendly GitIssueBot

PS: I'm just an automated script, not a human being, so don't expect any replies from me :) Your ticket is read by humans too, I'm just not one of them.

[MarcusWolschon]

Relevant code:
https://github.com/foosel/OctoPrint/blob/master/src/octoprint/server/api/job.py#L40
https://github.com/foosel/OctoPrint/blob/685ce16c85eea9c4f11586ea99c9a84aca382bd4/src/octoprint/printer/standard.py#L407
https://github.com/foosel/OctoPrint/blob/692166f067329cd3d6fdc84389e0dd76184c5e0c/src/octoprint/printer/__init__.py#L239

Documentation to update:
https://github.com/foosel/OctoPrint/blob/692166f067329cd3d6fdc84389e0dd76184c5e0c/docs/features/action_commands.rst

Js code only needs to be updated if the user interface would make use of it, does it?

[foosel]

Implemented in maintenance and devel branch, will be part of next release.

Simply changing the behaviour of the pause command and introducing a resume and toggle command was not possible due to reasons of backwards compatibility (there might be third party clients depending on the toggle behaviour). Instead a new optional action parameter was added to the existing pause command which can be either pause, resume or toggle. The latter will be assumed if the action parameter is not present. API docs are adjusted accordingly.