redsnow 0.3.1 → 0.3.2

data/ext/snowcrash/test/performance/perf-snowcrash.cc

@@ -0,0 +1,162 @@
+//
+//  perf-snowcrash.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 10/8/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+#include <iostream>
+#include <sstream>
+#include <fstream>
+#include <cmath>
+#include "cmdline.h"
+#include "snowcrash.h"
+
+#if defined (_MSC_VER)
+#include <windows.h>
+#else
+#include <sys/time.h>
+#endif
+
+using snowcrash::SourceAnnotation;
+using snowcrash::Error;
+
+static const int TestRunCount = 1000;
+
+#if defined (_MSC_VER)
+const __int64 DELTA_EPOCH_IN_MICROSECS = 11644473600000000;
+
+struct timezone
+{
+    int tz_minuteswest;     /* minutes west of Greenwich */
+    int tz_dsttime;         /* type of DST correction */
+};
+
+int gettimeofday(struct timeval* tv, struct timezone* tz)
+{
+    FILETIME ft;
+    TIME_ZONE_INFORMATION tz_winapi;
+    __int64 tmpres = 0;
+    int rez = 0;
+
+    ZeroMemory(&ft, sizeof(ft));
+    ZeroMemory(&tz_winapi, sizeof(tz_winapi));
+
+    GetSystemTimeAsFileTime(&ft);
+
+    tmpres = ft.dwHighDateTime;
+    tmpres <<= 32;
+    tmpres |= ft.dwLowDateTime;
+
+    tmpres /= 10;
+    tmpres -= DELTA_EPOCH_IN_MICROSECS;
+
+    if (tv) {
+        tv->tv_sec = (__int32)( tmpres * 0.000001 );
+        tv->tv_usec = ( tmpres % 1000000 );
+    }
+
+    if (tz) {
+        rez = GetTimeZoneInformation(&tz_winapi);
+        tz->tz_dsttime = (rez == 2) ? true:false;
+        tz->tz_minuteswest = tz_winapi.Bias + ((rez == 2) ? tz_winapi.DaylightBias:0);
+    }
+
+    return 0;
+}
+#endif
+
+
+/**
+ *  \brief  Parse input @TestRunCount -times
+ *  \param  input   A blueprint source data.
+ *  \param  total   Total time spent parsing (s).
+ *  \param  mean    Mean time spent parsing (s).
+ *  \param  stddev  Standard deviation.
+ *  \return Result code of snowcrash::parse operation.
+ */
+static int testfunc(const std::string& input, double& total, double& mean, double& stddev)
+{
+	struct timeval stime, etime;
+	double t = 0, sum = 0, sum2 = 0;
+	int resultCode = snowcrash::Error::OK;
+
+	for (int i = 0; i < TestRunCount; ++i) {
+        snowcrash::BlueprintParserOptions options = 0;
+        snowcrash::ParseResult<snowcrash::Blueprint> blueprint;
+
+		// Do the test.
+		if (::gettimeofday(&stime, NULL)) {
+            std::cerr << "fatal: gettimeofday failed";
+			exit(EXIT_FAILURE);
+		}
+        
+        snowcrash::parse(input, options, blueprint);
+        
+		if (::gettimeofday(&etime, NULL)) {
+            std::cerr << "fatal: gettimeofday failed";
+			exit(EXIT_FAILURE);
+		}
+
+        resultCode = blueprint.report.error.code;
+        
+		// Compute the time taken and add it to the sums.
+		t = (etime.tv_sec - stime.tv_sec) + (etime.tv_usec - stime.tv_usec) / 1000000.0;
+		sum += t;
+		sum2 += t * t;
+	}
+    
+	// Compute statistics and return result
+    total = sum;
+	mean = sum / TestRunCount;
+	stddev = std::sqrt((sum2 / TestRunCount) - (mean * mean));
+	return resultCode;
+}
+
+int main(int argc, const char *argv[])
+{
+    // FIXME: Intstrumetns helper
+    //::sleep(20);
+    
+    // Setup commandline Argument Parser
+    cmdline::parser argumentParser;
+    argumentParser.set_program_name("perf-snowcrash");
+    std::stringstream ss;
+    ss << "<input file>\n\n";
+    ss << "API Blueprint Parser Performance Test Tool\n";
+
+    argumentParser.footer(ss.str());
+    argumentParser.add("help", 'h', "display this help message");
+
+    argumentParser.parse_check(argc, argv);
+    if (argumentParser.rest().size() != 1) {
+        std::cerr << "one input file expected\n";
+        exit(EXIT_FAILURE);
+    }
+    
+    // Read fixture file
+    std::ifstream inputFileStream;
+    std::string inputFileName = argumentParser.rest().front();
+    inputFileStream.open(inputFileName.c_str());
+    if (!inputFileStream.is_open()) {
+        std::cerr << "fatal: unable to open input file '" << inputFileName << "'\n";
+        exit(EXIT_FAILURE);
+    }
+    
+    std::stringstream inputStream;
+    inputStream << inputFileStream.rdbuf();
+    inputFileStream.close();
+    
+    std::cout << "running snowcrash performance test...\n";
+    
+    double mean = 0, total = 0, stddev = 0;
+    int result = testfunc(inputStream.str(), total, mean, stddev);
+    
+    std::cout << "parsing '" << inputFileName << "' " << TestRunCount << "-times (" << result << "):\n";
+    std::cout << "total: " << total << "s mean: " << mean << " +/- " << stddev << "s\n";
+    
+    // FIXME: Intstrumetns helper
+    //::sleep(20);
+}
+
+

data/ext/snowcrash/test/snowcrashtest.h

@@ -0,0 +1,88 @@
+//
+//  snowcrashtest.h
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 5/21/14.
+//  Copyright (c) 2014 Apiary Inc. All rights reserved.
+//
+
+#ifndef SNOWCRASH_SNOWCRASHTEST_H
+#define SNOWCRASH_SNOWCRASHTEST_H
+
+#include "catch.hpp"
+#include "MarkdownParser.h"
+#include "SectionParser.h"
+
+namespace snowcrashtest {
+
+    struct Symbols {
+
+        std::vector<snowcrash::ResourceModelSymbol> models;
+        std::vector<snowcrash::ResourceModelSymbolSourceMap> modelsSM;
+
+    };
+
+    template <typename T, typename PARSER>
+    struct SectionParserHelper {
+
+        static void parse(const mdp::ByteBuffer& source,
+                          snowcrash::SectionType type,
+                          const snowcrash::ParseResultRef<T>& out,
+                          const snowcrash::BlueprintParserOptions& opts = 0,
+                          const Symbols& symbols = Symbols(),
+                          snowcrash::ParseResult<snowcrash::Blueprint>* bp = NULL) {
+
+            mdp::MarkdownParser markdownParser;
+            mdp::MarkdownNode markdownAST;
+
+            snowcrash::ParseResult<snowcrash::Blueprint> blueprint;
+            snowcrash::ParseResult<snowcrash::Blueprint>* bppointer;
+
+            markdownParser.parse(source, markdownAST);
+
+            REQUIRE(!markdownAST.children().empty());
+
+            if (bp == NULL) {
+                bppointer = &blueprint;
+            } else {
+                bppointer = bp;
+            }
+
+            snowcrash::SectionParserData pd(opts, source, bppointer->node);
+
+            pd.sectionsContext.push_back(type);
+
+            pd.symbolTable.resourceModels.insert(symbols.models.begin(), symbols.models.end());
+            pd.symbolSourceMapTable.resourceModels.insert(symbols.modelsSM.begin(), symbols.modelsSM.end());
+
+            PARSER::parse(markdownAST.children().begin(),
+                          markdownAST.children(),
+                          pd,
+                          out);
+        }
+    };
+
+    struct SymbolHelper {
+
+        /** Builds a Symbols entry for testing purposes */
+        static void buildSymbol(mdp::ByteBuffer name,
+                                Symbols& symbols) {
+
+            snowcrash::ResourceModel model;
+            snowcrash::SourceMap<snowcrash::ResourceModel> modelSM;
+            mdp::BytesRangeSet sourcemap;
+
+            sourcemap.push_back(mdp::BytesRange(0, 1));
+
+            model.description = "Foo";
+            model.body = "Bar";
+            symbols.models.push_back(snowcrash::ResourceModelSymbol(name, model));
+
+            modelSM.description.sourceMap = sourcemap;
+            modelSM.body.sourceMap = sourcemap;
+            symbols.modelsSM.push_back(snowcrash::ResourceModelSymbolSourceMap(name, modelSM));
+        }
+    };
+}
+
+#endif

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

@@ -0,0 +1,491 @@
+//
+//  test-ActionParser.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 5/6/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "snowcrashtest.h"
+#include "ActionParser.h"
+
+using namespace snowcrash;
+using namespace snowcrashtest;
+
+const mdp::ByteBuffer ActionFixture = \
+"# My Method [GET]\n\n"\
+"Method Description\n\n"\
+"+ Response 200 (text/plain)\n\n"\
+"        OK.";
+
+TEST_CASE("Method block classifier", "[action]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    SectionType sectionType;
+    markdownParser.parse(ActionFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    sectionType = SectionProcessor<Action>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == ActionSectionType);
+
+    // Nameless method
+    markdownAST.children().front().text = "GET";
+    REQUIRE(!markdownAST.children().empty());
+    sectionType = SectionProcessor<Action>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == ActionSectionType);
+}
+
+TEST_CASE("Parsing action", "[action]")
+{
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(ActionFixture, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    CHECK(action.report.warnings.empty());
+
+    REQUIRE(action.node.name == "My Method");
+    REQUIRE(action.node.method == "GET");
+    REQUIRE(action.node.description == "Method Description\n\n");
+
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples.front().requests.size() == 0);
+    REQUIRE(action.node.examples.front().responses.size() == 1);
+
+    REQUIRE(action.node.examples.front().responses[0].name == "200");
+    REQUIRE(action.node.examples.front().responses[0].body == "OK.\n");
+    REQUIRE(action.node.examples.front().responses[0].headers.size() == 1);
+    REQUIRE(action.node.examples.front().responses[0].headers[0].first == "Content-Type");
+    REQUIRE(action.node.examples.front().responses[0].headers[0].second == "text/plain");
+
+    REQUIRE(action.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.name.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.name.sourceMap[0].length == 19);
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 19);
+    REQUIRE(action.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.description.sourceMap[0].location == 19);
+    REQUIRE(action.sourceMap.description.sourceMap[0].length == 20);
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].body.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].body.sourceMap[0].location == 72);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].body.sourceMap[0].length == 7);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].name.sourceMap[0].location == 41);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].name.sourceMap[0].length == 27);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].headers.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].headers.collection[0].sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].headers.collection[0].sourceMap[0].location == 41);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection[0].headers.collection[0].sourceMap[0].length == 27);
+}
+
+TEST_CASE("Parse Action description with list", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# GET\n"\
+    "Small Description\n"\
+    "+ A\n"\
+    "+ B\n"\
+    "+ Response 204\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    CHECK(action.report.warnings.empty());
+
+    REQUIRE(action.node.method == "GET");
+    REQUIRE(action.node.description == "Small Description\n\n+ A\n\n+ B\n");
+
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples.front().responses.size() == 1);
+    REQUIRE(action.node.examples.front().requests.empty());
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 6);
+    REQUIRE(action.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.description.sourceMap[0].location == 6);
+    REQUIRE(action.sourceMap.description.sourceMap[0].length == 26);
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Parse method with multiple requests and responses", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# PUT\n"\
+    "+ Request A\n"\
+    "  B\n"\
+    "  + Body\n\n"\
+    "            C\n\n"\
+    "+ Request D\n"\
+    "  E\n"\
+    "  + Body\n\n"\
+    "            F\n\n"\
+    "+ Response 200\n"\
+    "  G\n"\
+    "  + Body\n\n"\
+    "            H\n\n"\
+    "+ Response 200\n"\
+    "  I\n"\
+    "  + Body\n\n"\
+    "            J\n\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1); // warn responses with the same name
+
+    REQUIRE(action.node.name.empty());
+    REQUIRE(action.node.method == "PUT");
+    REQUIRE(action.node.description.empty());
+    REQUIRE(action.node.parameters.empty());
+
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples.front().requests.size() == 2);
+
+    REQUIRE(action.node.examples.front().requests[0].name == "A");
+    REQUIRE(action.node.examples.front().requests[0].description == "B");
+    REQUIRE(action.node.examples.front().requests[0].body == "C\n");
+    REQUIRE(action.node.examples.front().requests[0].schema.empty());
+    REQUIRE(action.node.examples.front().requests[0].parameters.empty());
+    REQUIRE(action.node.examples.front().requests[0].headers.empty());
+
+    REQUIRE(action.node.examples.front().requests[1].name == "D");
+    REQUIRE(action.node.examples.front().requests[1].description == "E");
+    REQUIRE(action.node.examples.front().requests[1].body == "F\n");
+    REQUIRE(action.node.examples.front().requests[1].schema.empty());
+    REQUIRE(action.node.examples.front().requests[1].parameters.empty());
+    REQUIRE(action.node.examples.front().requests[1].headers.empty());
+
+    REQUIRE(action.node.examples.front().responses.size() == 2);
+
+    REQUIRE(action.node.examples.front().responses[0].name == "200");
+    REQUIRE(action.node.examples.front().responses[0].description == "G");
+    REQUIRE(action.node.examples.front().responses[0].body == "H\n");
+    REQUIRE(action.node.examples.front().responses[0].schema.empty());
+    REQUIRE(action.node.examples.front().responses[0].parameters.empty());
+    REQUIRE(action.node.examples.front().responses[0].headers.empty());
+
+    REQUIRE(action.node.examples.front().responses[1].name == "200");
+    REQUIRE(action.node.examples.front().responses[1].description == "I");
+    REQUIRE(action.node.examples.front().responses[1].body == "J\n");
+    REQUIRE(action.node.examples.front().responses[1].schema.empty());
+    REQUIRE(action.node.examples.front().responses[1].parameters.empty());
+    REQUIRE(action.node.examples.front().responses[1].headers.empty());
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 6);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 2);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 2);
+}
+
+TEST_CASE("Parse method with multiple incomplete requests", "[action][blocks]")
+{
+    mdp::ByteBuffer source = \
+    "# GET /1\n"\
+    "+ Request A\n"\
+    "+ Request B\n"\
+    "  C\n"\
+    "+ Response 200\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 2); // empty asset & preformatted asset
+    REQUIRE(action.report.warnings[0].code == EmptyDefinitionWarning);
+    REQUIRE(action.report.warnings[1].code == IndentationWarning);
+
+    REQUIRE(action.node.name.empty());
+    REQUIRE(action.node.method == "GET");
+    REQUIRE(action.node.description.empty());
+    REQUIRE(action.node.parameters.empty());
+
+    REQUIRE(action.node.examples.front().requests.size() == 2);
+    REQUIRE(action.node.examples.front().requests[0].name == "A");
+    REQUIRE(action.node.examples.front().requests[0].body.empty());
+    REQUIRE(action.node.examples.front().requests[0].schema.empty());
+    REQUIRE(action.node.examples.front().requests[0].parameters.empty());
+    REQUIRE(action.node.examples.front().requests[0].headers.empty());
+
+    REQUIRE(action.node.examples.front().requests[1].name == "B");
+    REQUIRE(action.node.examples.front().requests[1].description.empty());
+    REQUIRE(action.node.examples.front().requests[1].body == "C\n\n");
+    REQUIRE(action.node.examples.front().requests[1].schema.empty());
+    REQUIRE(action.node.examples.front().requests[1].parameters.empty());
+    REQUIRE(action.node.examples.front().requests[1].headers.empty());
+
+    REQUIRE(action.node.examples.front().responses.size() == 1);
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 9);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 2);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Parse method with foreign item", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# MKCOL\n"\
+    "+ Request\n"\
+    "  + Body\n\n"\
+    "            Foo\n\n"\
+    "+ Bar\n"\
+    "+ Response 200\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1);
+    REQUIRE(action.report.warnings[0].code == IgnoringWarning);
+
+    REQUIRE(action.node.name.empty());
+    REQUIRE(action.node.method == "MKCOL");
+    REQUIRE(action.node.description.empty());
+    REQUIRE(action.node.parameters.empty());
+
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples.front().requests.size() == 1);
+    REQUIRE(action.node.examples.front().requests[0].name.empty());
+    REQUIRE(action.node.examples.front().requests[0].body == "Foo\n");
+    REQUIRE(action.node.examples.front().requests[0].schema.empty());
+    REQUIRE(action.node.examples.front().requests[0].parameters.empty());
+    REQUIRE(action.node.examples.front().requests[0].headers.empty());
+    REQUIRE(action.node.examples.front().responses.size() == 1);
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 8);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Parse method with a HR", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# PATCH /1\n\n"\
+    "A\n"\
+    "---\n"\
+    "B\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1); // no response
+
+    REQUIRE(action.node.name.empty());
+    REQUIRE(action.node.method == "PATCH");
+    REQUIRE(action.node.description == "A\n---\n\nB\n");
+    REQUIRE(action.node.examples.empty());
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 12);
+    REQUIRE(action.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.description.sourceMap[0].location == 12);
+    REQUIRE(action.sourceMap.description.sourceMap[0].length == 8);
+    REQUIRE(action.sourceMap.examples.collection.size() == 0);
+}
+
+TEST_CASE("Parse method without name", "[action]")
+{
+    mdp::ByteBuffer source = "# GET";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1); // no response
+
+    REQUIRE(action.node.name.empty());
+    REQUIRE(action.node.method == "GET");
+    REQUIRE(action.node.description.empty());
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 5);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 0);
+}
+
+TEST_CASE("Parse action with parameters", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# GET /resrouce/{id}\n"\
+    "+ Parameters\n"\
+    "    + id (required, number, `42`) ... Resource Id\n"\
+    "\n"\
+    "+ Response 204\n"\
+    "\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.empty());
+
+    REQUIRE(action.node.parameters.size() == 1);
+    REQUIRE(action.node.parameters[0].name == "id");
+    REQUIRE(action.node.parameters[0].description == "Resource Id");
+    REQUIRE(action.node.parameters[0].type == "number");
+    REQUIRE(action.node.parameters[0].defaultValue.empty());
+    REQUIRE(action.node.parameters[0].exampleValue == "42");
+    REQUIRE(action.node.parameters[0].values.empty());
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 21);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.parameters.collection.size() == 1);
+    REQUIRE(action.sourceMap.parameters.collection[0].name.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.parameters.collection[0].name.sourceMap[0].location == 40);
+    REQUIRE(action.sourceMap.parameters.collection[0].name.sourceMap[0].length == 44);
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Give a warning when 2xx CONNECT has a body", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# CONNECT /1\n"\
+    "+ Response 201\n\n"\
+    "        {}\n\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1);
+
+    REQUIRE(action.node.method == "CONNECT");
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples[0].responses.size() == 1);
+    REQUIRE(action.node.examples[0].responses[0].body == "{}\n");
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 13);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Give a warning when response to HEAD has a body", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# HEAD /1\n"\
+    "+ Response 200\n\n"\
+    "        {}\n\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1);
+    REQUIRE(action.report.warnings[0].code == EmptyDefinitionWarning);
+
+    REQUIRE(action.node.method == "HEAD");
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples[0].responses.size() == 1);
+    REQUIRE(action.node.examples[0].responses[0].body == "{}\n");
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 10);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Missing 'LINK' HTTP request method", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# LINK /1\n"\
+    "+ Response 204\n\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.empty());
+
+    REQUIRE(action.node.examples.size() == 1);
+    REQUIRE(action.node.examples[0].requests.empty());
+    REQUIRE(action.node.examples[0].responses.size() == 1);
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 10);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+}
+
+TEST_CASE("Warn when request is not followed by a response", "[action]")
+{
+    mdp::ByteBuffer source = \
+    "# GET /1\n"\
+    "+ response 200 \n"\
+    "\n"\
+    "        200\n"\
+    "\n"\
+    "+ request A\n"\
+    "\n"\
+    "        A\n";
+
+    ParseResult<Action> action;
+    SectionParserHelper<Action, ActionParser>::parse(source, ActionSectionType, action, ExportSourcemapOption);
+
+    REQUIRE(action.report.error.code == Error::OK);
+    REQUIRE(action.report.warnings.size() == 1);
+    REQUIRE(action.report.warnings[0].code == EmptyDefinitionWarning);
+
+    REQUIRE(action.node.examples.size() == 2);
+    REQUIRE(action.node.examples[0].requests.size() == 0);
+    REQUIRE(action.node.examples[0].responses.size() == 1);
+    REQUIRE(action.node.examples[1].requests.size() == 1);
+    REQUIRE(action.node.examples[1].responses.size() == 0);
+
+    REQUIRE(action.sourceMap.name.sourceMap.empty());
+    REQUIRE(action.sourceMap.method.sourceMap.size() == 1);
+    REQUIRE(action.sourceMap.method.sourceMap[0].location == 0);
+    REQUIRE(action.sourceMap.method.sourceMap[0].length == 9);
+    REQUIRE(action.sourceMap.description.sourceMap.empty());
+    REQUIRE(action.sourceMap.examples.collection.size() == 2);
+    REQUIRE(action.sourceMap.examples.collection[0].requests.collection.size() == 0);
+    REQUIRE(action.sourceMap.examples.collection[0].responses.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[1].requests.collection.size() == 1);
+    REQUIRE(action.sourceMap.examples.collection[1].responses.collection.size() == 0);
+}