redsnow 0.3.1 → 0.3.2

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

@@ -0,0 +1,224 @@
+//
+//  test-AssetParser.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 5/17/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "snowcrashtest.h"
+#include "AssetParser.h"
+
+using namespace snowcrash;
+using namespace snowcrashtest;
+
+const mdp::ByteBuffer BodyAssetFixture = \
+"+ Body\n"\
+"\n"\
+"        Lorem Ipsum\n";
+
+const mdp::ByteBuffer SchemaAssetFixture = \
+"+ Schema\n"\
+"\n"\
+"        Dolor Sit Amet\n";
+
+TEST_CASE("recognize explicit body signature", "[asset]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(BodyAssetFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Asset>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == BodySectionType);
+}
+
+TEST_CASE("recognize body with content on signature", "[asset]")
+{
+    mdp::ByteBuffer source = \
+    "+ Body\n"\
+    "        Lorem Ipsum\n";
+
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(source, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Asset>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == BodySectionType);
+}
+
+TEST_CASE("recognize schema signature", "[asset]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    markdownParser.parse(SchemaAssetFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+    SectionType sectionType = SectionProcessor<Asset>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == SchemaSectionType);
+}
+
+TEST_CASE("parse body asset", "[asset]")
+{
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(BodyAssetFixture, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.empty());
+    REQUIRE(asset.node == "Lorem Ipsum\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 1);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 12);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 16);
+}
+
+TEST_CASE("parse schema asset", "[asset]")
+{
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(SchemaAssetFixture, SchemaSectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.empty());
+    REQUIRE(asset.node == "Dolor Sit Amet\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 1);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 14);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 19);
+}
+
+TEST_CASE("Foreign block inside", "[asset]")
+{
+    mdp::ByteBuffer source = BodyAssetFixture;
+    source += \
+    "\n"\
+    "    Hello World!\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.size() == 1);
+    REQUIRE(asset.report.warnings[0].code == IndentationWarning);
+    REQUIRE(asset.node == "Lorem Ipsum\nHello World!\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 2);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 12);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 17);
+    REQUIRE(asset.sourceMap.sourceMap[1].location == 33);
+    REQUIRE(asset.sourceMap.sourceMap[1].length == 13);
+}
+
+TEST_CASE("Nested list block inside", "[asset]")
+{
+    mdp::ByteBuffer source = BodyAssetFixture;
+    source += \
+    "\n"\
+    "    + Hello World!\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.size() == 1);
+    REQUIRE(asset.report.warnings[0].code == IndentationWarning);
+    REQUIRE(asset.node == "Lorem Ipsum\n+ Hello World!\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 2);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 12);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 16);
+    REQUIRE(asset.sourceMap.sourceMap[1].location == 33);
+    REQUIRE(asset.sourceMap.sourceMap[1].length == 15);
+}
+
+TEST_CASE("Multiline signature", "[asset]")
+{
+    mdp::ByteBuffer source = \
+    "+ Body\n"
+    "  Multiline Signature Content\n"\
+    "\n"\
+    "        Hello World!\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.size() == 1);
+    REQUIRE(asset.report.warnings[0].code == IndentationWarning);
+    REQUIRE(asset.node == "Multiline Signature Content\nHello World!\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 3);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 2);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 5);
+    REQUIRE(asset.sourceMap.sourceMap[1].location == 9);
+    REQUIRE(asset.sourceMap.sourceMap[1].length == 29);
+    REQUIRE(asset.sourceMap.sourceMap[2].location == 42);
+    REQUIRE(asset.sourceMap.sourceMap[2].length == 17);
+}
+
+TEST_CASE("Multiple blocks", "[asset]")
+{
+    mdp::ByteBuffer source = \
+    "+ Body\n"\
+    "\n"\
+    "    Block 1\n"\
+    "\n"\
+    "        Block 2\n"\
+    "\n"\
+    "    Block 3\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.size() == 2);
+    REQUIRE(asset.report.warnings[0].code == IndentationWarning);
+    REQUIRE(asset.report.warnings[1].code == IndentationWarning);
+    REQUIRE(asset.node == "Block 1\n\nBlock 2\nBlock 3\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 3);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 12);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 9);
+    REQUIRE(asset.sourceMap.sourceMap[1].location == 25);
+    REQUIRE(asset.sourceMap.sourceMap[1].length == 13);
+    REQUIRE(asset.sourceMap.sourceMap[2].location == 42);
+    REQUIRE(asset.sourceMap.sourceMap[2].length == 8);
+}
+
+TEST_CASE("Extra spaces before signature", "[asset]")
+{
+    mdp::ByteBuffer source = \
+    "+   Body\n"\
+    "\n"\
+    "        Lorem Ipsum\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.empty());
+    REQUIRE(asset.node == "Lorem Ipsum\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 1);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 14);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 16);
+}
+
+TEST_CASE("Asset parser greediness", "[asset]")
+{
+    mdp::ByteBuffer source = BodyAssetFixture;
+    source +=\
+    "\n"\
+    "+ Another Block\n";
+
+    ParseResult<Asset> asset;
+    SectionParserHelper<Asset, AssetParser>::parse(source, BodySectionType, asset, ExportSourcemapOption);
+
+    REQUIRE(asset.report.error.code == Error::OK);
+    REQUIRE(asset.report.warnings.empty());
+    REQUIRE(asset.node == "Lorem Ipsum\n");
+
+    REQUIRE(asset.sourceMap.sourceMap.size() == 1);
+    REQUIRE(asset.sourceMap.sourceMap[0].location == 12);
+    REQUIRE(asset.sourceMap.sourceMap[0].length == 16);
+}

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

@@ -0,0 +1,32 @@
+//
+//  test-Blueprint.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 4/3/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "catch.hpp"
+#include "Blueprint.h"
+
+using namespace snowcrash;
+
+TEST_CASE("blueprint/blueprint-init", "Blueprint initializaton")
+{
+    Blueprint blueprint;
+    REQUIRE(blueprint.name.length() == 0);
+    REQUIRE(blueprint.description.length() == 0);
+    REQUIRE(blueprint.metadata.size() == 0);
+    REQUIRE(blueprint.resourceGroups.size() == 0);
+}
+
+TEST_CASE("blueprint/init", "Blueprint initializaton")
+{
+    Blueprint blueprint;
+    REQUIRE(blueprint.name.length() == 0);
+    REQUIRE(blueprint.description.length() == 0);
+    REQUIRE(blueprint.metadata.size() == 0);
+    REQUIRE(blueprint.resourceGroups.size() == 0);
+}
+
+

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

@@ -0,0 +1,462 @@
+//
+//  test-BlueprintParser.cc
+//  snowcrash
+//
+//  Created by Zdenek Nemec on 4/16/13.
+//  Copyright (c) 2013 Apiary Inc. All rights reserved.
+//
+
+#include "snowcrashtest.h"
+#include "BlueprintParser.h"
+
+using namespace snowcrash;
+using namespace snowcrashtest;
+
+mdp::ByteBuffer BlueprintFixture = \
+"meta: verse\n\n"\
+"# Snowcrash API\n\n"\
+"## Character\n"\
+"Uncle Enzo\n\n"\
+"# Group First\n"\
+"p1\n"\
+"## My Resource [/resource]\n"\
+"# Group Second\n"\
+"p2\n";
+
+TEST_CASE("Blueprint block classifier", "[blueprint]")
+{
+    mdp::MarkdownParser markdownParser;
+    mdp::MarkdownNode markdownAST;
+    SectionType sectionType;
+    markdownParser.parse(BlueprintFixture, markdownAST);
+
+    REQUIRE(!markdownAST.children().empty());
+
+    // meta: verse
+    sectionType = SectionProcessor<Blueprint>::sectionType(markdownAST.children().begin());
+    REQUIRE(sectionType == BlueprintSectionType);
+
+    // # Snowcrash API
+    sectionType = SectionProcessor<Blueprint>::sectionType(markdownAST.children().begin() + 1);
+    REQUIRE(sectionType == BlueprintSectionType);
+
+    // ## Character
+    sectionType = SectionProcessor<Blueprint>::sectionType(markdownAST.children().begin() + 2);
+    REQUIRE(sectionType == BlueprintSectionType);
+
+    // Uncle Enzo
+    sectionType = SectionProcessor<Blueprint>::sectionType(markdownAST.children().begin() + 3);
+    REQUIRE(sectionType == BlueprintSectionType);
+}
+
+TEST_CASE("Parse canonical blueprint", "[blueprint]")
+{
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(BlueprintFixture, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.metadata.size() == 1);
+    REQUIRE(blueprint.node.metadata[0].first == "meta");
+    REQUIRE(blueprint.node.metadata[0].second == "verse");
+
+    REQUIRE(blueprint.node.name == "Snowcrash API");
+    REQUIRE(blueprint.node.description == "## Character\n\nUncle Enzo\n\n");
+    REQUIRE(blueprint.node.resourceGroups.size() == 2);
+
+    REQUIRE(blueprint.node.resourceGroups[0].name == "First");
+    REQUIRE(blueprint.node.resourceGroups[0].description == "p1\n");
+    REQUIRE(blueprint.node.resourceGroups[0].resources.size() == 1);
+
+    REQUIRE(blueprint.node.resourceGroups[1].name == "Second");
+    REQUIRE(blueprint.node.resourceGroups[1].description == "p2\n");
+    REQUIRE(blueprint.node.resourceGroups[1].resources.empty());
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 13);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 17);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 30);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 25);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].length == 13);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 2);
+}
+
+TEST_CASE("Parse blueprint with multiple metadata sections", "[blueprint]")
+{
+    mdp::ByteBuffer source = "FORMAT: 1A\n\n";
+    source += BlueprintFixture;
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.metadata.size() == 2);
+    REQUIRE(blueprint.node.metadata[0].first == "FORMAT");
+    REQUIRE(blueprint.node.metadata[0].second == "1A");
+    REQUIRE(blueprint.node.metadata[1].first == "meta");
+    REQUIRE(blueprint.node.metadata[1].second == "verse");
+
+    REQUIRE(blueprint.node.name == "Snowcrash API");
+    REQUIRE(blueprint.node.description == "## Character\n\nUncle Enzo\n\n");
+    REQUIRE(blueprint.node.resourceGroups.size() == 2);
+
+    REQUIRE(blueprint.node.resourceGroups[0].name == "First");
+    REQUIRE(blueprint.node.resourceGroups[0].description == "p1\n");
+    REQUIRE(blueprint.node.resourceGroups[0].resources.size() == 1);
+
+    REQUIRE(blueprint.node.resourceGroups[1].name == "Second");
+    REQUIRE(blueprint.node.resourceGroups[1].description == "p2\n");
+    REQUIRE(blueprint.node.resourceGroups[1].resources.empty());
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 25);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 17);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 42);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 25);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 2);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].length == 12);
+    REQUIRE(blueprint.sourceMap.metadata.collection[1].sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[1].sourceMap[0].location == 12);
+    REQUIRE(blueprint.sourceMap.metadata.collection[1].sourceMap[0].length == 13);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 2);
+}
+
+TEST_CASE("Parse API with Name and abbreviated resource", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# API\n"\
+    "A\n"\
+    "# GET /resource\n"\
+    "B\n"\
+    "+ Response 200\n\n"\
+    "        {}";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.name == "API");
+    REQUIRE(blueprint.node.description == "A\n");
+    REQUIRE(blueprint.node.resourceGroups.size() == 1);
+
+    ResourceGroup group = blueprint.node.resourceGroups.front();
+    REQUIRE(group.name.empty());
+    REQUIRE(group.description.empty());
+    REQUIRE(group.resources.size() == 1);
+
+    Resource resource = group.resources.front();
+    REQUIRE(resource.uriTemplate == "/resource");
+    REQUIRE(resource.actions.size() == 1);
+    REQUIRE(resource.actions.front().examples.size() == 1);
+    REQUIRE(resource.actions.front().examples.front().responses.size() == 1);
+    REQUIRE(resource.actions.front().examples.front().responses.front().body == "{}\n");
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 6);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 6);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 2);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 1);
+}
+
+TEST_CASE("Parse nameless blueprint description", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "A\n"\
+    "# B\n";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 1);
+    REQUIRE(blueprint.report.warnings[0].code == APINameWarning);
+
+    REQUIRE(blueprint.node.name.empty());
+    REQUIRE(blueprint.node.description == "A\n\n# B\n");
+    REQUIRE(blueprint.node.resourceGroups.size() == 0);
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 6);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 0);
+}
+
+TEST_CASE("Parse nameless blueprint with a list description", "[blueprint]")
+{
+    mdp::ByteBuffer source = "+ List\n";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 1);
+    REQUIRE(blueprint.report.warnings[0].code == APINameWarning);
+
+    REQUIRE(blueprint.node.name.empty());
+    REQUIRE(blueprint.node.description == "+ List\n");
+    REQUIRE(blueprint.node.resourceGroups.size() == 0);
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 7);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 0);
+}
+
+TEST_CASE("Parse two groups with the same name", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# API\n"\
+    "# Group Name\n"\
+    "## /1\n"\
+    "### POST\n"\
+    "+ Request\n\n"\
+    "         {}\n\n"\
+    "# Group Name\n";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 2); // groups with same name & no response
+
+    REQUIRE(blueprint.node.resourceGroups.size() == 2);
+
+    REQUIRE(blueprint.node.resourceGroups[0].name == "Name");
+    REQUIRE(blueprint.node.resourceGroups[0].description.empty());
+    REQUIRE(blueprint.node.resourceGroups[0].resources.size() == 1);
+
+    REQUIRE(blueprint.node.resourceGroups[1].name == "Name");
+    REQUIRE(blueprint.node.resourceGroups[1].description.empty());
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 6);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 2);
+}
+
+TEST_CASE("Test parser options - required blueprint name", "[blueprint]")
+{
+    mdp::ByteBuffer source = "Lorem Ipsum";
+
+    ParseResult<Blueprint> blueprint;
+
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint);
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 1);
+    REQUIRE(blueprint.report.warnings[0].code == APINameWarning);
+
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, RequireBlueprintNameOption);
+    REQUIRE(blueprint.report.error.code != Error::OK);
+}
+
+TEST_CASE("Test required blueprint name on blueprint that starts with metadata", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "meta: data\n"\
+    "foo:bar\n\n"\
+    "Hello";
+
+    ParseResult<Blueprint> blueprint;
+
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, RequireBlueprintNameOption);
+    REQUIRE(blueprint.report.error.code != Error::OK);
+}
+
+TEST_CASE("Should parse nested lists in description", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# API\n"\
+    "+ List\n"\
+    "   + Nested Item\n";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.name == "API");
+    REQUIRE(blueprint.node.description == "+ List\n   + Nested Item\n");
+    REQUIRE(blueprint.node.resourceGroups.empty());
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 6);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 6);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 24);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 0);
+}
+
+TEST_CASE("Should parse paragraph without final newline", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# API\n"\
+    "Lorem Ipsum";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.name == "API");
+    REQUIRE(blueprint.node.description == "Lorem Ipsum");
+    REQUIRE(blueprint.node.resourceGroups.empty());
+}
+
+TEST_CASE("Blueprint starting with Resource Group should be parsed", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# Group Posts\n"\
+    "## /posts";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.name.empty());
+    REQUIRE(blueprint.node.description.empty());
+    REQUIRE(blueprint.node.resourceGroups.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups.front().name == "Posts");
+    REQUIRE(blueprint.node.resourceGroups.front().resources.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups.front().resources.front().uriTemplate == "/posts");
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.description.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 1);
+}
+
+TEST_CASE("Blueprint starting with Resource should be parsed", "[blueprint]")
+{
+    mdp::ByteBuffer source = "# /posts";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.empty());
+
+    REQUIRE(blueprint.node.name.empty());
+    REQUIRE(blueprint.node.description.empty());
+    REQUIRE(blueprint.node.resourceGroups.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups.front().name.empty());
+    REQUIRE(blueprint.node.resourceGroups.front().resources.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups.front().resources.front().uriTemplate == "/posts");
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.description.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 1);
+}
+
+TEST_CASE("Checking a resource with global resources for duplicates", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "# /posts\n"\
+    "# Group Posts\n"\
+    "## Posts [/posts]\n"\
+    "### Creat a post [POST]\n"\
+    "### List posts [GET]\n";
+
+    ParseResult<Blueprint> blueprint;
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption, Symbols(), &blueprint);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 3); // 2x no response & duplicate resource
+
+    REQUIRE(blueprint.node.name.empty());
+    REQUIRE(blueprint.node.description.empty());
+    REQUIRE(blueprint.node.resourceGroups.size() == 2);
+
+    REQUIRE(blueprint.node.resourceGroups[0].name.empty());
+    REQUIRE(blueprint.node.resourceGroups[0].resources.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions.empty());
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].uriTemplate == "/posts");
+
+    REQUIRE(blueprint.node.resourceGroups[1].name == "Posts");
+    REQUIRE(blueprint.node.resourceGroups[1].resources.size() == 1);
+    REQUIRE(blueprint.node.resourceGroups[1].resources[0].actions.size() == 2);
+    REQUIRE(blueprint.node.resourceGroups[1].resources[0].uriTemplate == "/posts");
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.description.sourceMap.empty());
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 0);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 2);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection[0].resources.collection.size() == 1);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection[1].resources.collection.size() == 1);
+}
+
+TEST_CASE("Parsing unexpected blocks", "[blueprint]")
+{
+    mdp::ByteBuffer source = \
+    "FORMAT: 1A\n"\
+    "\n"\
+    "# S\n"\
+    "\n"\
+    "Hello\n"\
+    "\n"\
+    "+ Response\n"\
+    "\n"\
+    "Moar text\n"\
+    "\n"\
+    "# GET /\n";
+
+    ParseResult<Blueprint> blueprint;
+
+    SectionParserHelper<Blueprint, BlueprintParser>::parse(source, BlueprintSectionType, blueprint, ExportSourcemapOption, Symbols(), &blueprint);
+
+    REQUIRE(blueprint.report.error.code == Error::OK);
+    REQUIRE(blueprint.report.warnings.size() == 1); // no response
+    REQUIRE(blueprint.report.warnings[0].code == EmptyDefinitionWarning);
+
+    REQUIRE(blueprint.node.name == "S");
+    REQUIRE(blueprint.node.description == "Hello\n\n+ Response\n\nMoar text\n\n");
+
+    REQUIRE(blueprint.node.metadata.size() == 1);
+    REQUIRE(blueprint.node.metadata[0].first == "FORMAT");
+    REQUIRE(blueprint.node.metadata[0].second == "1A");
+
+    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].uriTemplate == "/");
+    REQUIRE(blueprint.node.resourceGroups[0].resources[0].actions[0].method == "GET");
+
+    REQUIRE(blueprint.sourceMap.name.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].location == 12);
+    REQUIRE(blueprint.sourceMap.name.sourceMap[0].length == 5);
+    REQUIRE(blueprint.sourceMap.description.sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].location == 17);
+    REQUIRE(blueprint.sourceMap.description.sourceMap[0].length == 30);
+    REQUIRE(blueprint.sourceMap.metadata.collection.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap.size() == 1);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].location == 0);
+    REQUIRE(blueprint.sourceMap.metadata.collection[0].sourceMap[0].length == 12);
+    REQUIRE(blueprint.sourceMap.resourceGroups.collection.size() == 1);
+}