Method datasetsList

app/src/API/Handlers/ProjectHandler.cpp:3307–3348

* @brief List all datasets across all groups */

 * @brief List all datasets across all groups
 */
API::CommandResponse API::Handlers::ProjectHandler::datasetsList(const QString& id,
                                                                 const QJsonObject& params)
{
  Q_UNUSED(params)

  const auto& groups = DataModel::ProjectModel::instance().groups();

  QJsonArray datasets_array;
  int total_datasets = 0;

  for (const auto& group : groups) {
    for (const auto& dataset : group.datasets) {
      datasets_array.append(buildDatasetObject(dataset, group));
      ++total_datasets;
    }
  }

  QString summary;
  if (total_datasets == 0) {
    summary = QStringLiteral("No datasets configured.");
  } else {
    summary = QStringLiteral("%1 datasets across %2 group%3.")
                .arg(total_datasets)
                .arg(groups.size())
                .arg(groups.size() == 1 ? QString() : QStringLiteral("s"));
  }

  QJsonObject result;
  result[QStringLiteral("_summary")]     = summary;
  result[QStringLiteral("datasets")]     = datasets_array;
  result[QStringLiteral("datasetCount")] = total_datasets;
  if (total_datasets >= 10)
    result[QStringLiteral("_hint")] =
      QStringLiteral("Bulk edits across %1 datasets: use project.batch (rename/retitle/reindex/"
                     "update many at once) or project.dataset.addMany (create N similar). "
                     "Looping single project.dataset.update calls costs N round-trips and N "
                     "autosave-debounce restarts. See meta.describeCommand{name:"
                     "\"project.batch\"} for the {ops:[{command,params},...]} shape.")
        .arg(total_datasets);

  return CommandResponse::makeSuccess(id, result);
}

/**
 * @brief Find a dataset by its uniqueId across all groups.