Method execute

src/commands/CmdPurge.cpp:123–167

///////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////
int CmdPurge::execute(std::string&) {
  int rc = 0;
  std::vector<Task> tasks;
  bool matched_deleted = false;

  Filter filter;
  std::vector<Task> filtered;

  // Apply filter.
  filter.subset(filtered);
  if (filtered.size() == 0) {
    Context::getContext().footnote("No tasks specified.");
    return 1;
  }

  for (auto& task : filtered) {
    // Allow purging of deleted tasks only. Hence no need to deal with:
    // - unblocked tasks notifications (deleted tasks are not blocking)
    // - project changes (deleted tasks not included in progress)
    // It also has the nice property of being explicit - users need to
    // mark tasks as deleted before purging.
    if (task.getStatus() == Task::deleted) {
      // Mark that at least one deleted task matched the filter
      matched_deleted = true;

      std::string question;
      question = format("Permanently remove task {1} '{2}'?", task.identifier(true),
                        task.get("description"));

      if (permission(question, filtered.size())) handleRelations(task, tasks);
    }
  }

  // Now that any exceptions are handled, actually purge the tasks.
  for (auto& task : tasks) {
    Context::getContext().tdb2.purge(task);
  }

  if (filtered.size() > 0 and !matched_deleted)
    Context::getContext().footnote(
        "No deleted tasks specified. Maybe you forgot to delete tasks first?");

  feedback_affected(tasks.size() == 1 ? "Purged {1} task." : "Purged {1} tasks.", tasks.size());
  return rc;
}

////////////////////////////////////////////////////////////////////////////////