CMake/Tests/CMakeLib/testDocumentationFormatter.cxx

/* Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
   file Copyright.txt or https://cmake.org/licensing for details.  */

#include <sstream>
#include <string>
#include <utility>

#include <cmDocumentationFormatter.h>

#include "testCommon.h"

namespace {
using TestCases =
  const std::initializer_list<std::pair<std::string, std::string>>;

bool testPrintFormattedNoIndent()
{
  const TestCases testCases = {
    { "", "" },
    { "One line no EOL text", "One line no EOL text\n" },
    { "Short text. Two sentences.", "Short text.  Two sentences.\n" },
    { "Short text\non\nmultiple\nlines\n",
      "Short text\n\non\n\nmultiple\n\nlines\n\n" },
    { "Just one a very long word: "
      "01234567890123456789012345678901234567890123456789012345"
      "678901234567890123456789",
      "Just one a very long "
      "word:\n01234567890123456789012345678901234567890123456789012345"
      "678901234567890123456789\n" },
    { " Pre-formatted paragraph with the very long word stays the same: "
      "0123456789012345678901234567890123456789012345678901234567890123456789",
      " Pre-formatted paragraph with the very long word stays the same: "
      "0123456789012345678901234567890123456789012345678901234567890123456789"
      "\n" },
    { "Extra  spaces  are     removed.   However, \n   not in    a "
      "pre-formatted\n  "
      "paragraph",
      "Extra spaces are removed.  However,\n\n   not in    a pre-formatted\n  "
      "paragraph\n" },
    { "This is the text paragraph longer than a pre-defined wrapping position "
      "of the `cmDocumentationFormatter` class. And it's gonna be wrapped "
      "over multiple lines!",
      "This is the text paragraph longer than a pre-defined wrapping position "
      "of the\n`cmDocumentationFormatter` class.  And it's gonna be wrapped "
      "over multiple\nlines!\n" }
  };

  cmDocumentationFormatter formatter;

  for (auto& test : testCases) {
    std::ostringstream out;
    formatter.PrintFormatted(out, test.first);
    ASSERT_EQUAL(out.str(), test.second);
  }

  return true;
}

bool testPrintFormattedIndent2()
{
  const TestCases testCases = {
    { "", "" },
    { "One line no EOL text", "  One line no EOL text\n" },
    { "Short text. Two sentences.", "  Short text.  Two sentences.\n" },
    { "Short text\non\nmultiple\nlines\n",
      "  Short text\n\n  on\n\n  multiple\n\n  lines\n\n" },
    { "Just one a very long word: "
      "01234567890123456789012345678901234567890123456789012345"
      "678901234567890123456789",
      "  Just one a very long "
      "word:\n  01234567890123456789012345678901234567890123456789012345"
      "678901234567890123456789\n" },
    { " Pre-formatted paragraph with the very long word stays the same: "
      "0123456789012345678901234567890123456789012345678901234567890123456789",
      "   Pre-formatted paragraph with the very long word stays the same: "
      "0123456789012345678901234567890123456789012345678901234567890123456789"
      "\n" },
    { "Extra  spaces  are     removed.   However, \n  not in    a "
      "pre-formatted\n  "
      "paragraph",
      "  Extra spaces are removed.  However,\n\n    not in    a "
      "pre-formatted\n    "
      "paragraph\n" },
    { "This is the text paragraph longer than a pre-defined wrapping position "
      "of the `cmDocumentationFormatter` class. And it's gonna be wrapped "
      "over multiple lines!",
      "  This is the text paragraph longer than a pre-defined wrapping "
      "position of\n"
      "  the `cmDocumentationFormatter` class.  And it's gonna be wrapped "
      "over\n  multiple lines!\n" }
  };

  cmDocumentationFormatter formatter;
  formatter.SetIndent(2);

  for (auto& test : testCases) {
    std::ostringstream out;
    formatter.PrintFormatted(out, test.first);
    ASSERT_EQUAL(out.str(), test.second);
  }

  return true;
}

bool testPrintFormattedIndent10()
{
  const TestCases testCases = {
    { "", "" },
    { "One line no EOL text", "          One line no EOL text\n" },
    { "This is the text paragraph longer than a pre-defined wrapping position "
      "of the `cmDocumentationFormatter` class. And it's gonna be wrapped "
      "over multiple lines!",
      "          This is the text paragraph longer than a pre-defined "
      "wrapping\n"
      "          position of the `cmDocumentationFormatter` class.  "
      "And it's gonna\n"
      "          be wrapped over multiple lines!\n" }
  };

  cmDocumentationFormatter formatter;
  formatter.SetIndent(10);

  for (auto& test : testCases) {
    std::ostringstream out;
    formatter.PrintFormatted(out, test.first);
    ASSERT_EQUAL(out.str(), test.second);
  }

  return true;
}
}

int testDocumentationFormatter(int /*unused*/, char* /*unused*/[])
{
  return runTests({ testPrintFormattedNoIndent, testPrintFormattedIndent2,
                    testPrintFormattedIndent10 },
                  false);
}