Method onModify

src/Hooks.cpp:278–320

/////////////////////////////////////////////////////////////////////////// The on-modify event is triggered separately for each task added or modified Input: - line of JSON for the original task - line of JSON for the modified task, the diff being the modification Output: - emitted JSON for the input task is saved, if the exit code is zero, otherwise ignored. - all emitted non-JSON lines are co

//   depending on the status code.
//
void Hooks::onModify(Task& before, Task& after) const {
  if (!_enabled) return;

  Timer timer;

  std::vector<std::string> matchingScripts = scripts("on-modify");
  if (matchingScripts.size()) {
    // Convert vector of tasks to a vector of strings.
    std::vector<std::string> input;
    input.push_back(before.composeJSON());  // [line 0] original, never changes
    input.push_back(after.composeJSON());   // [line 1] modified

    // Call the hook scripts.
    for (auto& script : matchingScripts) {
      std::vector<std::string> output;
      int status = callHookScript(script, input, output);

      std::vector<std::string> outputJSON;
      std::vector<std::string> outputFeedback;
      separateOutput(output, outputJSON, outputFeedback);

      if (status == 0) {
        assertNTasks(outputJSON, 1, script);
        assertValidJSON(outputJSON, script);
        assertSameTask(outputJSON, before, script);

        // Propagate accepted changes forward to the next script.
        input[1] = outputJSON[0];

        for (auto& message : outputFeedback) Context::getContext().footnote(message);
      } else {
        assertFeedback(outputFeedback, script);
        for (auto& message : outputFeedback) Context::getContext().error(message);

        throw 0;  // This is how hooks silently terminate processing.
      }
    }

    after = Task(input[1]);
  }

  Context::getContext().time_hooks_us += timer.total_us();
}

////////////////////////////////////////////////////////////////////////////////
std::vector<std::string> Hooks::list() const { return _scripts; }