Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Output feedback text #60

Open
ghost opened this issue Dec 19, 2018 · 1 comment
Open

Output feedback text #60

ghost opened this issue Dec 19, 2018 · 1 comment

Comments

@ghost
Copy link

ghost commented Dec 19, 2018

Thank you for making/maintaining tasklib!

Per https://taskwarrior.org/docs/hooks.html (my emphasis):

Output from a hook script is a combination of a JSON-formatted task and text. Just as the JSON for a task must occupy a single line, so must a single feedback message. Feedback text is optional for a successful hook script, but required for a failing script. If provided it will be displayed by Taskwarrior according to the verbosity setting.

Here is sample output from a hypothetical spell-checking hook script:

{"description":"Buy some milk","entry":"20141118T050231Z","status":"pending","uuid":"a360fc44-315c-4366-b70c-ea7e7520b749"}
Spell checking found no errors.

The output is a single line JSON object which represents an optionally modified task, and a single line of feedback text to be displayed.

There may only be one line of JSON, and it must be for the same task that was provided as input.

However, tasklib does not seem to have a (documented) way to output feedback text.

@ghost
Copy link
Author

ghost commented Dec 19, 2018

A workaround is to do something like (e.g. for a failing hook):

print("Hook failed!")
sys.exit(1)

If this is the intended approach for handling feedback text with tasklib, then it should ideally be mentioned in the tasklib docs, and then this issue closed as fixed.

Alternatively, if another approach is intended, then that other approach should be documented/implemented.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

0 participants