redsnow 0.3.1 → 0.3.2

data/ext/snowcrash/test/test-ParametersParser.cc

@@ -0,0 +1,355 @@
+//
+//  test-ParametersParser.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 9/1/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "snowcrashtest.h"
+#include "ParametersParser.h"
+#include "snowcrash.h"
+
+using namespace snowcrash;
+using namespace snowcrashtest;
+
+const mdp::ByteBuffer ParametersFixture = \
+"+ Parameters\n"\
+"    + id = `1234` (optional, number, `0000`)\n\n"\
+"        Lorem ipsum\n"\
+"        + Values\n"\
+"            + `1234`\n"\
+"            + `0000`\n"\
+"            + `beef`\n"\
+"    + name\n";
+
+TEST_CASE("Recognize Parameters section block", "[parameters]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(ParametersFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Parameters>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == ParametersSectionType);
+}
+
+TEST_CASE("Parse canonical parameters", "[parameters]")
+{
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(ParametersFixture,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.empty());
+
+    REQUIRE(parameters.node.size() == 2);
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].description == "Lorem ipsum\n");
+    REQUIRE(parameters.node[1].name == "name");
+    REQUIRE(parameters.node[1].description.empty());
+
+    REQUIRE(parameters.sourceMap.collection.size() == 2);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].location == 19);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].length == 40);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].location == 165);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].length == 5);
+}
+
+TEST_CASE("Parse ilegal parameter", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n"\
+    "    + i:legal\n\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source, ParametersSectionType, parameters);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.size() == 2);
+    REQUIRE(parameters.report.warnings[0].code == IgnoringWarning);
+    REQUIRE(parameters.report.warnings[1].code == FormattingWarning);
+
+    REQUIRE(parameters.node.empty());
+    REQUIRE(parameters.sourceMap.collection.empty());
+}
+
+TEST_CASE("Parse illegal parameter among legal ones", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n"\
+    "    + OK_1\n"\
+    "    + i:legal\n"\
+    "    + OK-2\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.size() == 1);
+    REQUIRE(parameters.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(parameters.node.size() == 2);
+    REQUIRE(parameters.node[0].name == "OK_1");
+    REQUIRE(parameters.node[0].description.empty());
+    REQUIRE(parameters.node[1].name == "OK-2");
+    REQUIRE(parameters.node[1].description.empty());
+
+    REQUIRE(parameters.sourceMap.collection.size() == 2);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].location == 19);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].length == 5);
+    REQUIRE(parameters.sourceMap.collection[0].description.sourceMap.empty());
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].location == 44);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].length == 5);
+    REQUIRE(parameters.sourceMap.collection[1].description.sourceMap.empty());
+}
+
+TEST_CASE("Warn about additional content in parameters section", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n"\
+    "  extra-1\n\n"\
+    "    + id\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.size() == 1);
+    REQUIRE(parameters.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(parameters.node.size() == 1);
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].description.empty());
+
+    REQUIRE(parameters.sourceMap.collection.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].location == 30);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].length == 3);
+    REQUIRE(parameters.sourceMap.collection[0].description.sourceMap.empty());
+}
+
+TEST_CASE("Warn about additional content block in parameters section", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n\n"\
+    "  extra-1\n\n"\
+    "    + id\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.size() == 1);
+    REQUIRE(parameters.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(parameters.node.size() == 1);
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].description.empty());
+
+    REQUIRE(parameters.sourceMap.collection.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].location == 31);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].length == 3);
+    REQUIRE(parameters.sourceMap.collection[0].description.sourceMap.empty());
+}
+
+TEST_CASE("Warn about multiple parameters with the same name", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n"\
+    "    + id (`42`)\n"\
+    "    + id (`43`)\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.size() == 1);
+    REQUIRE(parameters.report.warnings[0].code == RedefinitionWarning);
+
+    REQUIRE(parameters.node.size() == 2);
+
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].exampleValue == "42");
+
+    REQUIRE(parameters.node[1].name == "id");
+    REQUIRE(parameters.node[1].exampleValue == "43");
+
+    REQUIRE(parameters.sourceMap.collection.size() == 2);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].location == 19);
+    REQUIRE(parameters.sourceMap.collection[0].name.sourceMap[0].length == 10);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap.size() == 1);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].location == 35);
+    REQUIRE(parameters.sourceMap.collection[1].name.sourceMap[0].length == 10);
+}
+
+TEST_CASE("Recognize parameter when there is no description on its signature and remaining description is not a new node", "[parameters]")
+{
+    mdp::ByteBuffer source = \
+    "+ Parameters\n\n"\
+    "    + id (number) ... The ID number of the car\n"\
+    "    + state (string)\n"\
+    "        The desired state of the panoramic roof. The approximate percent open values for each state are `open` = 100%, `close` = 0%, `comfort` = 80%, and `vent` = ~15%\n"\
+    "        + Values\n"\
+    "            + `open`\n"\
+    "            + `close`\n"\
+    "            + `comfort`\n"\
+    "            + `vent`";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source,
+                                                             ParametersSectionType,
+                                                             parameters,
+                                                             ExportSourcemapOption);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.empty());
+
+    REQUIRE(parameters.node.size() == 2);
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].type == "number");
+    REQUIRE(parameters.node[0].description == "The ID number of the car");
+
+    Parameter parameter = parameters.node[1];
+    REQUIRE(parameter.name == "state");
+    REQUIRE(parameter.type == "string");
+    REQUIRE(parameter.description == "\nThe desired state of the panoramic roof. The approximate percent open values for each state are `open` = 100%, `close` = 0%, `comfort` = 80%, and `vent` = ~15%\n\n");
+    REQUIRE(parameter.values.size() == 4);
+    REQUIRE(parameter.values[0] == "open");
+    REQUIRE(parameter.values[1] == "close");
+    REQUIRE(parameter.values[2] == "comfort");
+    REQUIRE(parameter.values[3] == "vent");
+
+    REQUIRE(parameters.sourceMap.collection.size() == 2);
+}
+
+TEST_CASE("Parentheses in parameter example ", "[parameters][issue][#109]")
+{
+    // Blueprint in question:
+    //R"(
+    //# GET /{id}
+    //+ Parameters
+    //  + id (optional, oData, `substringof('homer', id)`) ... test
+    //
+    //+ response 204
+    //");
+    mdp::ByteBuffer source = \
+    "+ Parameters\n"\
+    "  + id (optional, oData, `substringof('homer', id)`) ... test\n"\
+    "\n";
+
+    ParseResult<Parameters> parameters;
+    SectionParserHelper<Parameters, ParametersParser>::parse(source, ParametersSectionType, parameters);
+
+    REQUIRE(parameters.report.error.code == Error::OK);
+    REQUIRE(parameters.report.warnings.empty());
+
+    REQUIRE(parameters.node.size() == 1);
+    REQUIRE(parameters.node[0].name == "id");
+    REQUIRE(parameters.node[0].type == "oData");
+    REQUIRE(parameters.node[0].exampleValue == "substringof('homer', id)");
+    REQUIRE(parameters.node[0].description == "test");
+}
+
+TEST_CASE("Percentage encoded characters in parameter name ", "[parameters][percentageencoding][issue][#107]")
+{
+    // Blueprint in question:
+    //R"(
+    //# GET /{id%5b%5d}
+    //+ Parameters
+    //  + id%5b%5d (optional, oData, `substringof('homer', id)`) ... test
+    //
+    //+ response 204
+    //");
+    mdp::ByteBuffer source = \
+    "# GET /{id%5b%5d}\n"\
+    "+ Parameters\n"\
+    "  + id%5b%5d (optional, oData, `substringof('homer', id)`) ... test\n"\
+    "\n"\
+    "+ response 204\n";
+
+    ParseResult<Blueprint> blueprint;
+    parse(source, 0, blueprint);
+
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.resourceGroups.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[0].resources.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].description.empty());
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].parameters.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].parameters[0].name == "id%5b%5d");
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].parameters[0].type == "oData");
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].parameters[0].exampleValue == "substringof('homer', id)");
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].parameters[0].description == "test");
+}
+
+TEST_CASE("Invalid percentage encoded characters in parameter name ", "[invalid][parameters][percentageencoding][issue][#107]")
+{
+    // Blueprint in question:
+    //R"(
+    //# GET /{id%5z}
+    //+ Parameters
+    //  + id%5z (optional, oData, `substringof('homer', id)`) ... test
+    //
+    //+ response 204
+    //");
+    mdp::ByteBuffer source = \
+    "# GET /{id%5z}\n"\
+    "+ Parameters\n"\
+    "  + id%5z (optional, oData, `substringof('homer', id)`) ... test\n"\
+    "\n"\
+    "+ response 204\n";
+
+    ParseResult<Blueprint> blueprint;
+    parse(source, 0, blueprint);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 3);
+}
+
+TEST_CASE("Incomplete percentage encoded characters in parameter name ", "[incomplete][parameters][percentageencoding][issue][#107]")
+{
+    // Blueprint in question:
+    //R"(
+    //# GET /{id%}
+    //+ Parameters
+    //  + id% (optional, oData, `substringof('homer', id)`) ... test
+    //
+    //+ response 204
+    //");
+    mdp::ByteBuffer source = \
+    "# GET /{id%}\n"\
+    "+ Parameters\n"\
+    "  + id% (optional, oData, `substringof('homer', id)`) ... test\n"\
+    "\n"\
+    "+ response 204\n";
+
+    ParseResult<Blueprint> blueprint;
+    parse(source, 0, blueprint);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 3);
+}

data/ext/snowcrash/test/test-PayloadParser.cc

@@ -0,0 +1,657 @@
+//
+//  test-PayloadParser.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 5/7/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "snowcrashtest.h"
+#include "PayloadParser.h"
+
+using namespace snowcrash;
+using namespace snowcrashtest;
+
+const mdp::ByteBuffer RequestFixture = \
+"+ Request Hello World (text/plain)\n\n"\
+"  Description\n\n"\
+"    + Headers\n\n"\
+"            X-Header: 42\n\n"\
+"    + Body\n\n"\
+"            Code\n\n"\
+"    + Schema\n\n"\
+"            Code 2\n\n";
+
+const mdp::ByteBuffer RequestBodyFixture = \
+"+ Request A\n\n"\
+"        Hello World!\n";
+
+const mdp::ByteBuffer ResponseBodyFixture = \
+"+ Response 200 (text/plain)\n\n"\
+"        Hello World!\n";
+
+const mdp::ByteBuffer SymbolFixture = \
+"+ Request\n\n"\
+"    [Symbol][]\n";
+
+const mdp::ByteBuffer EmptyBodyFixture = \
+"+ Response 200\n\n"\
+"    + Body\n\n\n\n";
+
+TEST_CASE("recognize request signature", "[payload]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(RequestFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Payload>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == RequestSectionType);
+}
+
+TEST_CASE("recognize abbreviated request signature", "[payload]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(RequestBodyFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Payload>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == RequestBodySectionType);
+}
+
+TEST_CASE("recognize abbreviated response signature", "[payload]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(ResponseBodyFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Payload>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == ResponseBodySectionType);
+}
+
+TEST_CASE("recognize empty body response signature as non-abbreviated", "[payload]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(EmptyBodyFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Payload>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == ResponseSectionType);
+}
+
+TEST_CASE("Parse request payload", "[payload]")
+{
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(RequestFixture, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    CHECK(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.name == "Hello World");
+    REQUIRE(payload.node.description == "Description\n");
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.size() == 2);
+    REQUIRE(payload.node.headers[0].first == "Content-Type");
+    REQUIRE(payload.node.headers[0].second == "text/plain");
+    REQUIRE(payload.node.headers[1].first == "X-Header");
+    REQUIRE(payload.node.headers[1].second == "42");
+    REQUIRE(payload.node.body == "Code\n");
+    REQUIRE(payload.node.schema == "Code 2\n");
+
+    REQUIRE(payload.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].length == 34);
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 38);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 12);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.size() == 2);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].length == 34);
+    REQUIRE(payload.sourceMap.headers.collection[1].sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[1].sourceMap[0].location == 74);
+    REQUIRE(payload.sourceMap.headers.collection[1].sourceMap[0].length == 17);
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 112);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 9);
+    REQUIRE(payload.sourceMap.schema.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.schema.sourceMap[0].location == 144);
+    REQUIRE(payload.sourceMap.schema.sourceMap[0].length == 11);
+}
+
+TEST_CASE("Parse abbreviated payload body", "[payload]")
+{
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(ResponseBodyFixture, ResponseBodySectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    CHECK(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.name == "200");
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.body == "Hello World!\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].length == 27);
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].length == 27);
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 33);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 17);
+}
+
+TEST_CASE("Parse abbreviated inline payload body", "[payload]")
+{
+    mdp::ByteBuffer source = RequestBodyFixture;
+    source += "  B\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestBodySectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    CHECK(payload.report.warnings.size() == 1); // preformatted code block
+
+    REQUIRE(payload.node.name == "A");
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "Hello World!\nB\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].length == 11);
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 2);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 17);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 17);
+    REQUIRE(payload.sourceMap.body.sourceMap[1].location == 36);
+    REQUIRE(payload.sourceMap.body.sourceMap[1].length == 2);
+}
+
+TEST_CASE("Parse payload description with list", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Request
+    //
+    //    + B
+    //
+    //    + Body
+    //
+    //            {}
+    //");
+
+    mdp::ByteBuffer source = \
+    "+ Request\n\n"\
+    "    + B\n\n"\
+    "    + Body\n\n"\
+    "            {}\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    CHECK(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description == "+ B\n");
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "{}\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 15);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 4);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 40);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 7);
+}
+
+TEST_CASE("Parse payload with foreign list item", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Request
+    //
+    //    + Body
+    //
+    //            {}
+    //
+    //    + Bar
+    //");
+
+    mdp::ByteBuffer source = \
+    "+ Request\n\n"\
+    "    + Body\n\n"\
+    "            {}\n\n"\
+    "    + Bar\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    CHECK(payload.report.warnings.size() == 1); // dangling block
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "{}\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 31);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 7);
+}
+
+TEST_CASE("Parse payload with dangling body", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Request
+    //    + Body
+    //
+    //            Foo
+    //
+    //    Bar
+    //");
+
+    mdp::ByteBuffer source = "+ Request\n";
+    source += "    + Body\n\n";
+    source += "            Foo\n\n";
+    source += "    Bar\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1); // dangling block
+    REQUIRE(payload.report.warnings[0].code == IndentationWarning);
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "Foo\nBar\n\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 2);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 30);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 8);
+    REQUIRE(payload.sourceMap.body.sourceMap[1].location == 43);
+    REQUIRE(payload.sourceMap.body.sourceMap[1].length == 4);
+}
+
+TEST_CASE("Parse inline payload with symbol reference", "[payload]")
+{
+    Symbols symbols;
+    SymbolHelper::buildSymbol("Symbol", symbols);
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(SymbolFixture, RequestBodySectionType, payload, ExportSourcemapOption, symbols);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 0);
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description == "Foo");
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "Bar");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 0);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 1);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 0);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 1);
+}
+
+TEST_CASE("Parse inline payload with symbol reference with extra indentation", "[payload]")
+{
+    mdp::ByteBuffer source = \
+    "+ Request\n\n"\
+    "        [Symbol][]\n";
+
+    Symbols symbols;
+    SymbolHelper::buildSymbol("Symbol", symbols);
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestBodySectionType, payload, ExportSourcemapOption, symbols);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1);
+    REQUIRE(payload.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "[Symbol][]\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 15);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 15);
+}
+
+TEST_CASE("Parse inline payload with symbol reference with foreign content", "[payload]")
+{
+    mdp::ByteBuffer source = SymbolFixture;
+    source += "\n    Foreign\n";
+
+    Symbols symbols;
+    SymbolHelper::buildSymbol("Symbol", symbols);
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestBodySectionType, payload, ExportSourcemapOption, symbols);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1); // ignoring foreign entry
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description == "Foo");
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "Bar");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 0);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 1);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 0);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 1);
+}
+
+TEST_CASE("Parse named model", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Super Model (text/plain)
+    //
+    //        Hello World!
+    //");
+
+    mdp::ByteBuffer source = "+ Super Model (text/plain)\n\n";
+    source += "        Hello World!\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, ModelBodySectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.name == "Super");
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.headers[0].first == "Content-Type");
+    REQUIRE(payload.node.headers[0].second == "text/plain");
+    REQUIRE(payload.node.body == "Hello World!\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.name.sourceMap[0].length == 26);
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].length == 26);
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 32);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 17);
+}
+
+TEST_CASE("Parse nameless model", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Model (text/plain)
+    //
+    //        Hello World!
+    //");
+
+    mdp::ByteBuffer source = "+ Model (text/plain)\n\n";
+    source += "        Hello World!\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, ModelBodySectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description.empty());
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.headers[0].first == "Content-Type");
+    REQUIRE(payload.node.headers[0].second == "text/plain");
+    REQUIRE(payload.node.body == "Hello World!\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.empty());
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.headers.collection[0].sourceMap[0].length == 20);
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 26);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 17);
+    REQUIRE(payload.sourceMap.schema.sourceMap.empty());
+}
+
+TEST_CASE("Warn on malformed payload signature", "[payload]")
+{
+    // Blueprint in question:
+    //R"(
+    //+ Request This is FUN[ (text/plain)
+    //  Description
+    //
+    //   Line 2
+    //
+    //    + Body
+    //
+    //            Hello World!
+    //");
+
+    mdp::ByteBuffer source = "+ Request This is FUN[ (text/plain)\n";
+    source += "  Description\n\n";
+    source += "   Line 2\n\n";
+    source += "    + Body\n\n";
+    source += "            Hello World!\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1);
+    REQUIRE(payload.report.warnings[0].code == FormattingWarning);
+
+    REQUIRE(payload.node.name.empty());
+    REQUIRE(payload.node.description == "Description\n\nLine 2\n");
+    REQUIRE(payload.node.parameters.empty());
+    REQUIRE(payload.node.headers.empty());
+    REQUIRE(payload.node.body == "Hello World!\n");
+    REQUIRE(payload.node.schema.empty());
+
+    REQUIRE(payload.sourceMap.name.sourceMap.empty());
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 3);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 2);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 34);
+    REQUIRE(payload.sourceMap.description.sourceMap[1].location == 38);
+    REQUIRE(payload.sourceMap.description.sourceMap[1].length == 13);
+    REQUIRE(payload.sourceMap.description.sourceMap[2].location == 54);
+    REQUIRE(payload.sourceMap.description.sourceMap[2].length == 7);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.headers.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 82);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 17);
+}
+
+TEST_CASE("Give a warning of empty message body for requests with certain headers", "[payload]")
+{
+    mdp::ByteBuffer source = \
+    "+ Request\n"\
+    "    + Headers \n"\
+    "\n"\
+    "            Content-Length: 100\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1);
+    REQUIRE(payload.report.warnings[0].code == EmptyDefinitionWarning);
+
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.headers[0].first == "Content-Length");
+    REQUIRE(payload.node.headers[0].second == "100");
+    REQUIRE(payload.node.body.empty());
+
+    REQUIRE(payload.sourceMap.body.sourceMap.empty());
+}
+
+TEST_CASE("Do not report empty message body for requests", "[payload]")
+{
+    mdp::ByteBuffer source = \
+    "+ Request\n"\
+    "    + Headers \n"\
+    "\n"\
+    "            Accept: application/json, application/javascript\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.headers[0].first == "Accept");
+    REQUIRE(payload.node.headers[0].second == "application/json, application/javascript");
+    REQUIRE(payload.node.body.empty());
+}
+
+TEST_CASE("Give a warning when 100 response has a body", "[payload]")
+{
+    mdp::ByteBuffer source = \
+    "+ Response 100\n\n"\
+    "        {}\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, ResponseBodySectionType, payload);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1);
+    REQUIRE(payload.report.warnings[0].code == EmptyDefinitionWarning);
+
+    REQUIRE(payload.node.body == "{}\n");
+}
+
+TEST_CASE("Empty body section should shouldn't be parsed as description", "[payload]")
+{
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(EmptyBodyFixture, ResponseSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.body == "");
+
+    REQUIRE(payload.sourceMap.body.sourceMap.empty());
+}
+
+TEST_CASE("Parameters section should be taken as a description node", "[payload]")
+{
+    mdp::ByteBuffer source = \
+    "+ Response 200\n\n"\
+    "    + Parameters\n\n"\
+    "        + id (string)\n\n"\
+    "    + Body\n\n"\
+    "            {}\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, ResponseSectionType, payload, ExportSourcemapOption);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.empty());
+
+    REQUIRE(payload.node.description == "+ Parameters\n\n    + id (string)\n");
+    REQUIRE(payload.node.body == "{}\n");
+
+    REQUIRE(payload.sourceMap.description.sourceMap.size() == 2);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].location == 20);
+    REQUIRE(payload.sourceMap.description.sourceMap[0].length == 14);
+    REQUIRE(payload.sourceMap.description.sourceMap[1].location == 38);
+    REQUIRE(payload.sourceMap.description.sourceMap[1].length == 18);
+    REQUIRE(payload.sourceMap.parameters.collection.empty());
+    REQUIRE(payload.sourceMap.body.sourceMap.size() == 1);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].location == 77);
+    REQUIRE(payload.sourceMap.body.sourceMap[0].length == 7);
+}
+
+TEST_CASE("Report ignoring nested request objects", "[payload][#163][#189]")
+{
+    mdp::ByteBuffer source = \
+    "+ Request\n"\
+    "    + Headers\n"\
+    "\n"\
+    "            Authorization: Basic AAAAA\n"\
+    "\n"\
+    "    + Request (application/x-www-form-urlencoded)\n"\
+    "\n"\
+    "            Hello World\n";
+
+    ParseResult<Payload> payload;
+    SectionParserHelper<Payload, PayloadParser>::parse(source, RequestSectionType, payload);
+
+    REQUIRE(payload.report.error.code == Error::OK);
+    REQUIRE(payload.report.warnings.size() == 1);
+    REQUIRE(payload.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(payload.node.headers.size() == 1);
+    REQUIRE(payload.node.body.empty());
+}