Method execute

src/commands/CmdColumns.cpp:56–112

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

////////////////////////////////////////////////////////////////////////////////
int CmdColumns::execute(std::string& output) {
  // Obtain the arguments from the description.  That way, things like '--'
  // have already been handled.
  auto words = Context::getContext().cli2.getWords();
  if (words.size() > 1) throw std::string("You can only specify one search string.");

  // Include all columns in the table.
  std::vector<std::string> names;
  for (const auto& col : Context::getContext().columns) names.push_back(col.first);

  std::sort(names.begin(), names.end());

  // Render a list of column names, formats and examples.
  Table formats;
  formats.width(Context::getContext().getWidth());
  formats.add("Columns");
  formats.add("Type");
  formats.add("Modifiable");
  formats.add("Supported Formats");
  formats.add("Example");
  setHeaderUnderline(formats);

  for (const auto& name : names) {
    if (words.size() == 0 || find(name, words[0], false) != std::string::npos) {
      auto styles = Context::getContext().columns[name]->styles();
      auto examples = Context::getContext().columns[name]->examples();

      for (unsigned int i = 0; i < styles.size(); ++i) {
        auto row = formats.addRow();
        formats.set(row, 0, i == 0 ? name : "");
        formats.set(row, 1, i == 0 ? Context::getContext().columns[name]->type() : "");
        formats.set(row, 2,
                    i == 0 ? (Context::getContext().columns[name]->modifiable() ? "Modifiable"
                                                                                : "Read Only")
                           : "");
        formats.set(row, 3, styles[i] + (i == 0 ? "*" : ""));
        formats.set(row, 4, i < examples.size() ? examples[i] : "");
      }
    }
  }

  auto row = formats.addRow();
  formats.set(row, 0, "<uda>");
  formats.set(row, 1, "<type>");
  formats.set(row, 2, "Modifiable");
  formats.set(row, 3, "default*");

  row = formats.addRow();
  formats.set(row, 0, "");
  formats.set(row, 3, "indicator");

  output = optionalBlankLine() + formats.render() + '\n' +
           "* Means default format, and therefore optional.  For example, 'due' and "
           "'due.formatted' are equivalent.\n";

  return 0;
}