From c14dd55524260cdd6d399cbb8f851599c9f1796c Mon Sep 17 00:00:00 2001
From: Julian Gonggrijp <dev@juliangonggrijp.com>
Date: Mon, 19 Apr 2021 02:29:03 +0200
Subject: Mark inheritance spec as optional

---
 specs/inheritance.json  | 235 ------------------------------------------------
 specs/inheritance.yml   | 194 ---------------------------------------
 specs/~inheritance.json | 235 ++++++++++++++++++++++++++++++++++++++++++++++++
 specs/~inheritance.yml  | 194 +++++++++++++++++++++++++++++++++++++++
 4 files changed, 429 insertions(+), 429 deletions(-)
 delete mode 100644 specs/inheritance.json
 delete mode 100644 specs/inheritance.yml
 create mode 100644 specs/~inheritance.json
 create mode 100644 specs/~inheritance.yml

diff --git a/specs/inheritance.json b/specs/inheritance.json
deleted file mode 100644
index 809b693..0000000
--- a/specs/inheritance.json
+++ /dev/null
@@ -1,235 +0,0 @@
-{
-  "__ATTN__": "Do not edit this file; changes belong in the appropriate YAML file.",
-  "overview": "Parent tags are used to expand an external template into the current template,\nwith optional parameters delimited by block tags.\n\nThese tags' content MUST be a non-whitespace character sequence NOT containing\nthe current closing delimiter; each Parent tag MUST be followed by an End\nSection tag with the same content within the matching parent tag.\n\nBlock tags are used inside of parent tags to assign data onto the context\nstack prior to rendering the parent template. Outside of parent tags, block\ntags are used to indicate where value set in the parent tag should be placed.\nIf no value is set then the content in between the block tags, if any, is\nrendered.\n",
-  "tests": [
-    {
-      "name": "Default",
-      "desc": "Default content should be rendered if the block isn't overridden",
-      "data": {
-      },
-      "template": "{{$title}}Default title{{/title}}\n",
-      "expected": "Default title\n"
-    },
-    {
-      "name": "Variable",
-      "desc": "Default content renders variables",
-      "data": {
-        "bar": "baz"
-      },
-      "template": "{{$foo}}default {{bar}} content{{/foo}}\n",
-      "expected": "default baz content\n"
-    },
-    {
-      "name": "Triple Mustache",
-      "desc": "Default content renders triple mustache variables",
-      "data": {
-        "bar": "<baz>"
-      },
-      "template": "{{$foo}}default {{{bar}}} content{{/foo}}\n",
-      "expected": "default <baz> content\n"
-    },
-    {
-      "name": "Sections",
-      "desc": "Default content renders sections",
-      "data": {
-        "bar": {
-          "baz": "qux"
-        }
-      },
-      "template": "{{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}\n",
-      "expected": "default qux content\n"
-    },
-    {
-      "name": "Negative Sections",
-      "desc": "Default content renders negative sections",
-      "data": {
-        "baz": "three"
-      },
-      "template": "{{$foo}}default {{^bar}}{{baz}}{{/bar}} content{{/foo}}\n",
-      "expected": "default three content\n"
-    },
-    {
-      "name": "Mustache Injection",
-      "desc": "Mustache injection in default content",
-      "data": {
-        "bar": {
-          "baz": "{{qux}}"
-        }
-      },
-      "template": "{{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}\n",
-      "expected": "default {{qux}} content\n"
-    },
-    {
-      "name": "Inherit",
-      "desc": "Default content rendered inside included templates",
-      "data": {
-      },
-      "template": "{{<include}}{{/include}}\n",
-      "partials": {
-        "include": "{{$foo}}default content{{/foo}}"
-      },
-      "expected": "default content"
-    },
-    {
-      "name": "Overridden content",
-      "desc": "Overridden content",
-      "data": {
-      },
-      "template": "{{<super}}{{$title}}sub template title{{/title}}{{/super}}",
-      "partials": {
-        "super": "...{{$title}}Default title{{/title}}..."
-      },
-      "expected": "...sub template title..."
-    },
-    {
-      "name": "Data does not override block",
-      "desc": "Provided data does not override data passed into parent",
-      "data": {
-        "var": "var in data"
-      },
-      "template": "{{<include}}{{$var}}var in template{{/var}}{{/include}}",
-      "partials": {
-        "include": "{{$var}}var in include{{/var}}"
-      },
-      "expected": "var in template"
-    },
-    {
-      "name": "Data does not override block default",
-      "desc": "Provided data does not override default value of block",
-      "data": {
-        "var": "var in data"
-      },
-      "template": "{{<include}}{{/include}}",
-      "partials": {
-        "include": "{{$var}}var in include{{/var}}"
-      },
-      "expected": "var in include"
-    },
-    {
-      "name": "Overridden partial",
-      "desc": "Overridden partial",
-      "data": {
-      },
-      "template": "test {{<partial}}{{$stuff}}override{{/stuff}}{{/partial}}",
-      "partials": {
-        "partial": "{{$stuff}}...{{/stuff}}"
-      },
-      "expected": "test override"
-    },
-    {
-      "name": "Two overridden partials",
-      "desc": "Two overridden partials with different content",
-      "data": {
-      },
-      "template": "test {{<partial}}{{$stuff}}override1{{/stuff}}{{/partial}} {{<partial}}{{$stuff}}override2{{/stuff}}{{/partial}}\n",
-      "partials": {
-        "partial": "|{{$stuff}}...{{/stuff}}{{$default}} default{{/default}}|"
-      },
-      "expected": "test |override1 default| |override2 default|\n"
-    },
-    {
-      "name": "Override partial with newlines",
-      "desc": "Override partial with newlines",
-      "data": {
-      },
-      "template": "{{<partial}}{{$ballmer}}\npeaked\n\n:(\n{{/ballmer}}{{/partial}}",
-      "partials": {
-        "partial": "{{$ballmer}}peaking{{/ballmer}}"
-      },
-      "expected": "peaked\n\n:(\n"
-    },
-    {
-      "name": "Inherit indentation",
-      "desc": "Inherit indentation when overriding a partial",
-      "data": {
-      },
-      "template": "{{<partial}}{{$nineties}}hammer time{{/nineties}}{{/partial}}",
-      "partials": {
-        "partial": "stop:\n  {{$nineties}}collaborate and listen{{/nineties}}\n"
-      },
-      "expected": "stop:\n  hammer time\n"
-    },
-    {
-      "name": "Only one override",
-      "desc": "Override one substitution but not the other",
-      "data": {
-      },
-      "template": "{{<partial}}{{$stuff2}}override two{{/stuff2}}{{/partial}}",
-      "partials": {
-        "partial": "{{$stuff}}new default one{{/stuff}}, {{$stuff2}}new default two{{/stuff2}}"
-      },
-      "expected": "new default one, override two"
-    },
-    {
-      "name": "Super template",
-      "desc": "Super templates behave identically to partials when called with no parameters",
-      "data": {
-      },
-      "template": "{{>include}}|{{<include}}{{/include}}",
-      "partials": {
-        "include": "{{$foo}}default content{{/foo}}"
-      },
-      "expected": "default content|default content"
-    },
-    {
-      "name": "Recursion",
-      "desc": "Recursion in inherited templates",
-      "data": {
-      },
-      "template": "{{<include}}{{$foo}}override{{/foo}}{{/include}}",
-      "partials": {
-        "include": "{{$foo}}default content{{/foo}} {{$bar}}{{<include2}}{{/include2}}{{/bar}}",
-        "include2": "{{$foo}}include2 default content{{/foo}} {{<include}}{{$bar}}don't recurse{{/bar}}{{/include}}"
-      },
-      "expected": "override override override don't recurse"
-    },
-    {
-      "name": "Multi-level inheritance",
-      "desc": "Top-level substitutions take precedence in multi-level inheritance",
-      "data": {
-      },
-      "template": "{{<parent}}{{$a}}c{{/a}}{{/parent}}",
-      "partials": {
-        "parent": "{{<older}}{{$a}}p{{/a}}{{/older}}",
-        "older": "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}",
-        "grandParent": "{{$a}}g{{/a}}"
-      },
-      "expected": "c"
-    },
-    {
-      "name": "Multi-level inheritance, no sub child",
-      "desc": "Top-level substitutions take precedence in multi-level inheritance",
-      "data": {
-      },
-      "template": "{{<parent}}{{/parent}}",
-      "partials": {
-        "parent": "{{<older}}{{$a}}p{{/a}}{{/older}}",
-        "older": "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}",
-        "grandParent": "{{$a}}g{{/a}}"
-      },
-      "expected": "p"
-    },
-    {
-      "name": "Text inside super",
-      "desc": "Ignores text inside super templates, but does parse $ tags",
-      "data": {
-      },
-      "template": "{{<include}} asdfasd {{$foo}}hmm{{/foo}} asdfasdfasdf {{/include}}",
-      "partials": {
-        "include": "{{$foo}}default content{{/foo}}"
-      },
-      "expected": "hmm"
-    },
-    {
-      "name": "Text inside super",
-      "desc": "Allows text inside a super tag, but ignores it",
-      "data": {
-      },
-      "template": "{{<include}} asdfasd asdfasdfasdf {{/include}}",
-      "partials": {
-        "include": "{{$foo}}default content{{/foo}}"
-      },
-      "expected": "default content"
-    }
-  ]
-}
diff --git a/specs/inheritance.yml b/specs/inheritance.yml
deleted file mode 100644
index 8881ee5..0000000
--- a/specs/inheritance.yml
+++ /dev/null
@@ -1,194 +0,0 @@
-overview: |
-  Parent tags are used to expand an external template into the current template,
-  with optional parameters delimited by block tags.
-
-  These tags' content MUST be a non-whitespace character sequence NOT containing
-  the current closing delimiter; each Parent tag MUST be followed by an End
-  Section tag with the same content within the matching parent tag.
-
-  Block tags are used inside of parent tags to assign data onto the context
-  stack prior to rendering the parent template. Outside of parent tags, block
-  tags are used to indicate where value set in the parent tag should be placed.
-  If no value is set then the content in between the block tags, if any, is
-  rendered.
-tests:
-  - name: Default
-    desc: Default content should be rendered if the block isn't overridden
-    data: { }
-    template: |
-      {{$title}}Default title{{/title}}
-    expected: |
-      Default title
-
-  - name: Variable
-    desc: Default content renders variables
-    data: { bar: 'baz' }
-    template: |
-      {{$foo}}default {{bar}} content{{/foo}}
-    expected: |
-      default baz content
-
-  - name: Triple Mustache
-    desc: Default content renders triple mustache variables
-    data: { bar: '<baz>' }
-    template: |
-      {{$foo}}default {{{bar}}} content{{/foo}}
-    expected: |
-      default <baz> content
-
-  - name: Sections
-    desc: Default content renders sections
-    data: { bar: {baz: 'qux'} }
-    template: |
-      {{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}
-    expected: |
-      default qux content
-
-  - name: Negative Sections
-    desc: Default content renders negative sections
-    data: { baz: 'three' }
-    template: |
-      {{$foo}}default {{^bar}}{{baz}}{{/bar}} content{{/foo}}
-    expected: |
-      default three content
-
-  - name: Mustache Injection
-    desc: Mustache injection in default content
-    data: {bar: {baz: '{{qux}}'} }
-    template: |
-      {{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}
-    expected: |
-      default {{qux}} content
-
-  - name: Inherit
-    desc: Default content rendered inside included templates
-    data: { }
-    template: |
-      {{<include}}{{/include}}
-    partials:
-      include: "{{$foo}}default content{{/foo}}"
-    expected: "default content"
-
-  - name: Overridden content
-    desc: Overridden content
-    data: { }
-    template: "{{<super}}{{$title}}sub template title{{/title}}{{/super}}"
-    partials:
-      super: "...{{$title}}Default title{{/title}}..."
-    expected: "...sub template title..."
-
-  - name: Data does not override block
-    desc: Provided data does not override data passed into parent
-    data: { var: 'var in data' }
-    template: "{{<include}}{{$var}}var in template{{/var}}{{/include}}"
-    partials:
-      include: "{{$var}}var in include{{/var}}"
-    expected: "var in template"
-
-  - name: Data does not override block default
-    desc: Provided data does not override default value of block
-    data: { var: 'var in data' }
-    template: "{{<include}}{{/include}}"
-    partials:
-      include: "{{$var}}var in include{{/var}}"
-    expected: "var in include"
-
-  - name: Overridden partial
-    desc: Overridden partial
-    data: { }
-    template: "test {{<partial}}{{$stuff}}override{{/stuff}}{{/partial}}"
-    partials:
-      partial: "{{$stuff}}...{{/stuff}}"
-    expected: "test override"
-
-  - name: Two overridden partials
-    desc: Two overridden partials with different content
-    data: { }
-    template: |
-      test {{<partial}}{{$stuff}}override1{{/stuff}}{{/partial}} {{<partial}}{{$stuff}}override2{{/stuff}}{{/partial}}
-    partials:
-      partial: "|{{$stuff}}...{{/stuff}}{{$default}} default{{/default}}|"
-    expected: |
-      test |override1 default| |override2 default|
-
-  - name: Override partial with newlines
-    desc: Override partial with newlines
-    data: { }
-    template: "{{<partial}}{{$ballmer}}\npeaked\n\n:(\n{{/ballmer}}{{/partial}}"
-    partials:
-      partial: "{{$ballmer}}peaking{{/ballmer}}"
-    expected: "peaked\n\n:(\n"
-
-  - name: Inherit indentation
-    desc: Inherit indentation when overriding a partial
-    data: { }
-    template: "{{<partial}}{{$nineties}}hammer time{{/nineties}}{{/partial}}"
-    partials:
-      partial: |
-        stop:
-          {{$nineties}}collaborate and listen{{/nineties}}
-    expected: |
-      stop:
-        hammer time
-
-  - name: Only one override
-    desc: Override one substitution but not the other
-    data: { }
-    template: "{{<partial}}{{$stuff2}}override two{{/stuff2}}{{/partial}}"
-    partials:
-      partial: "{{$stuff}}new default one{{/stuff}}, {{$stuff2}}new default two{{/stuff2}}"
-    expected: "new default one, override two"
-
-  - name: Super template
-    desc: Super templates behave identically to partials when called with no parameters
-    data: { }
-    template: "{{>include}}|{{<include}}{{/include}}"
-    partials:
-      include: "{{$foo}}default content{{/foo}}"
-    expected: "default content|default content"
-
-  - name: Recursion
-    desc: Recursion in inherited templates
-    data: {}
-    template: "{{<include}}{{$foo}}override{{/foo}}{{/include}}"
-    partials:
-      include: "{{$foo}}default content{{/foo}} {{$bar}}{{<include2}}{{/include2}}{{/bar}}"
-      include2: "{{$foo}}include2 default content{{/foo}} {{<include}}{{$bar}}don't recurse{{/bar}}{{/include}}"
-    expected: "override override override don't recurse"
-
-  - name: Multi-level inheritance
-    desc: Top-level substitutions take precedence in multi-level inheritance
-    data: { }
-    template: "{{<parent}}{{$a}}c{{/a}}{{/parent}}"
-    partials:
-      parent: "{{<older}}{{$a}}p{{/a}}{{/older}}"
-      older: "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}"
-      grandParent: "{{$a}}g{{/a}}"
-    expected: c
-
-  - name: Multi-level inheritance, no sub child
-    desc: Top-level substitutions take precedence in multi-level inheritance
-    data: { }
-    template: "{{<parent}}{{/parent}}"
-    partials:
-      parent: "{{<older}}{{$a}}p{{/a}}{{/older}}"
-      older: "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}"
-      grandParent: "{{$a}}g{{/a}}"
-    expected: p
-
-  - name: Text inside super
-    desc: Ignores text inside super templates, but does parse $ tags
-    data: { }
-    template: "{{<include}} asdfasd {{$foo}}hmm{{/foo}} asdfasdfasdf {{/include}}"
-    partials:
-      include: "{{$foo}}default content{{/foo}}"
-    expected:
-      hmm
-
-  - name: Text inside super
-    desc: Allows text inside a super tag, but ignores it
-    data: {}
-    template: "{{<include}} asdfasd asdfasdfasdf {{/include}}"
-    partials:
-      include: "{{$foo}}default content{{/foo}}"
-    expected: default content
diff --git a/specs/~inheritance.json b/specs/~inheritance.json
new file mode 100644
index 0000000..809b693
--- /dev/null
+++ b/specs/~inheritance.json
@@ -0,0 +1,235 @@
+{
+  "__ATTN__": "Do not edit this file; changes belong in the appropriate YAML file.",
+  "overview": "Parent tags are used to expand an external template into the current template,\nwith optional parameters delimited by block tags.\n\nThese tags' content MUST be a non-whitespace character sequence NOT containing\nthe current closing delimiter; each Parent tag MUST be followed by an End\nSection tag with the same content within the matching parent tag.\n\nBlock tags are used inside of parent tags to assign data onto the context\nstack prior to rendering the parent template. Outside of parent tags, block\ntags are used to indicate where value set in the parent tag should be placed.\nIf no value is set then the content in between the block tags, if any, is\nrendered.\n",
+  "tests": [
+    {
+      "name": "Default",
+      "desc": "Default content should be rendered if the block isn't overridden",
+      "data": {
+      },
+      "template": "{{$title}}Default title{{/title}}\n",
+      "expected": "Default title\n"
+    },
+    {
+      "name": "Variable",
+      "desc": "Default content renders variables",
+      "data": {
+        "bar": "baz"
+      },
+      "template": "{{$foo}}default {{bar}} content{{/foo}}\n",
+      "expected": "default baz content\n"
+    },
+    {
+      "name": "Triple Mustache",
+      "desc": "Default content renders triple mustache variables",
+      "data": {
+        "bar": "<baz>"
+      },
+      "template": "{{$foo}}default {{{bar}}} content{{/foo}}\n",
+      "expected": "default <baz> content\n"
+    },
+    {
+      "name": "Sections",
+      "desc": "Default content renders sections",
+      "data": {
+        "bar": {
+          "baz": "qux"
+        }
+      },
+      "template": "{{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}\n",
+      "expected": "default qux content\n"
+    },
+    {
+      "name": "Negative Sections",
+      "desc": "Default content renders negative sections",
+      "data": {
+        "baz": "three"
+      },
+      "template": "{{$foo}}default {{^bar}}{{baz}}{{/bar}} content{{/foo}}\n",
+      "expected": "default three content\n"
+    },
+    {
+      "name": "Mustache Injection",
+      "desc": "Mustache injection in default content",
+      "data": {
+        "bar": {
+          "baz": "{{qux}}"
+        }
+      },
+      "template": "{{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}\n",
+      "expected": "default {{qux}} content\n"
+    },
+    {
+      "name": "Inherit",
+      "desc": "Default content rendered inside included templates",
+      "data": {
+      },
+      "template": "{{<include}}{{/include}}\n",
+      "partials": {
+        "include": "{{$foo}}default content{{/foo}}"
+      },
+      "expected": "default content"
+    },
+    {
+      "name": "Overridden content",
+      "desc": "Overridden content",
+      "data": {
+      },
+      "template": "{{<super}}{{$title}}sub template title{{/title}}{{/super}}",
+      "partials": {
+        "super": "...{{$title}}Default title{{/title}}..."
+      },
+      "expected": "...sub template title..."
+    },
+    {
+      "name": "Data does not override block",
+      "desc": "Provided data does not override data passed into parent",
+      "data": {
+        "var": "var in data"
+      },
+      "template": "{{<include}}{{$var}}var in template{{/var}}{{/include}}",
+      "partials": {
+        "include": "{{$var}}var in include{{/var}}"
+      },
+      "expected": "var in template"
+    },
+    {
+      "name": "Data does not override block default",
+      "desc": "Provided data does not override default value of block",
+      "data": {
+        "var": "var in data"
+      },
+      "template": "{{<include}}{{/include}}",
+      "partials": {
+        "include": "{{$var}}var in include{{/var}}"
+      },
+      "expected": "var in include"
+    },
+    {
+      "name": "Overridden partial",
+      "desc": "Overridden partial",
+      "data": {
+      },
+      "template": "test {{<partial}}{{$stuff}}override{{/stuff}}{{/partial}}",
+      "partials": {
+        "partial": "{{$stuff}}...{{/stuff}}"
+      },
+      "expected": "test override"
+    },
+    {
+      "name": "Two overridden partials",
+      "desc": "Two overridden partials with different content",
+      "data": {
+      },
+      "template": "test {{<partial}}{{$stuff}}override1{{/stuff}}{{/partial}} {{<partial}}{{$stuff}}override2{{/stuff}}{{/partial}}\n",
+      "partials": {
+        "partial": "|{{$stuff}}...{{/stuff}}{{$default}} default{{/default}}|"
+      },
+      "expected": "test |override1 default| |override2 default|\n"
+    },
+    {
+      "name": "Override partial with newlines",
+      "desc": "Override partial with newlines",
+      "data": {
+      },
+      "template": "{{<partial}}{{$ballmer}}\npeaked\n\n:(\n{{/ballmer}}{{/partial}}",
+      "partials": {
+        "partial": "{{$ballmer}}peaking{{/ballmer}}"
+      },
+      "expected": "peaked\n\n:(\n"
+    },
+    {
+      "name": "Inherit indentation",
+      "desc": "Inherit indentation when overriding a partial",
+      "data": {
+      },
+      "template": "{{<partial}}{{$nineties}}hammer time{{/nineties}}{{/partial}}",
+      "partials": {
+        "partial": "stop:\n  {{$nineties}}collaborate and listen{{/nineties}}\n"
+      },
+      "expected": "stop:\n  hammer time\n"
+    },
+    {
+      "name": "Only one override",
+      "desc": "Override one substitution but not the other",
+      "data": {
+      },
+      "template": "{{<partial}}{{$stuff2}}override two{{/stuff2}}{{/partial}}",
+      "partials": {
+        "partial": "{{$stuff}}new default one{{/stuff}}, {{$stuff2}}new default two{{/stuff2}}"
+      },
+      "expected": "new default one, override two"
+    },
+    {
+      "name": "Super template",
+      "desc": "Super templates behave identically to partials when called with no parameters",
+      "data": {
+      },
+      "template": "{{>include}}|{{<include}}{{/include}}",
+      "partials": {
+        "include": "{{$foo}}default content{{/foo}}"
+      },
+      "expected": "default content|default content"
+    },
+    {
+      "name": "Recursion",
+      "desc": "Recursion in inherited templates",
+      "data": {
+      },
+      "template": "{{<include}}{{$foo}}override{{/foo}}{{/include}}",
+      "partials": {
+        "include": "{{$foo}}default content{{/foo}} {{$bar}}{{<include2}}{{/include2}}{{/bar}}",
+        "include2": "{{$foo}}include2 default content{{/foo}} {{<include}}{{$bar}}don't recurse{{/bar}}{{/include}}"
+      },
+      "expected": "override override override don't recurse"
+    },
+    {
+      "name": "Multi-level inheritance",
+      "desc": "Top-level substitutions take precedence in multi-level inheritance",
+      "data": {
+      },
+      "template": "{{<parent}}{{$a}}c{{/a}}{{/parent}}",
+      "partials": {
+        "parent": "{{<older}}{{$a}}p{{/a}}{{/older}}",
+        "older": "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}",
+        "grandParent": "{{$a}}g{{/a}}"
+      },
+      "expected": "c"
+    },
+    {
+      "name": "Multi-level inheritance, no sub child",
+      "desc": "Top-level substitutions take precedence in multi-level inheritance",
+      "data": {
+      },
+      "template": "{{<parent}}{{/parent}}",
+      "partials": {
+        "parent": "{{<older}}{{$a}}p{{/a}}{{/older}}",
+        "older": "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}",
+        "grandParent": "{{$a}}g{{/a}}"
+      },
+      "expected": "p"
+    },
+    {
+      "name": "Text inside super",
+      "desc": "Ignores text inside super templates, but does parse $ tags",
+      "data": {
+      },
+      "template": "{{<include}} asdfasd {{$foo}}hmm{{/foo}} asdfasdfasdf {{/include}}",
+      "partials": {
+        "include": "{{$foo}}default content{{/foo}}"
+      },
+      "expected": "hmm"
+    },
+    {
+      "name": "Text inside super",
+      "desc": "Allows text inside a super tag, but ignores it",
+      "data": {
+      },
+      "template": "{{<include}} asdfasd asdfasdfasdf {{/include}}",
+      "partials": {
+        "include": "{{$foo}}default content{{/foo}}"
+      },
+      "expected": "default content"
+    }
+  ]
+}
diff --git a/specs/~inheritance.yml b/specs/~inheritance.yml
new file mode 100644
index 0000000..8881ee5
--- /dev/null
+++ b/specs/~inheritance.yml
@@ -0,0 +1,194 @@
+overview: |
+  Parent tags are used to expand an external template into the current template,
+  with optional parameters delimited by block tags.
+
+  These tags' content MUST be a non-whitespace character sequence NOT containing
+  the current closing delimiter; each Parent tag MUST be followed by an End
+  Section tag with the same content within the matching parent tag.
+
+  Block tags are used inside of parent tags to assign data onto the context
+  stack prior to rendering the parent template. Outside of parent tags, block
+  tags are used to indicate where value set in the parent tag should be placed.
+  If no value is set then the content in between the block tags, if any, is
+  rendered.
+tests:
+  - name: Default
+    desc: Default content should be rendered if the block isn't overridden
+    data: { }
+    template: |
+      {{$title}}Default title{{/title}}
+    expected: |
+      Default title
+
+  - name: Variable
+    desc: Default content renders variables
+    data: { bar: 'baz' }
+    template: |
+      {{$foo}}default {{bar}} content{{/foo}}
+    expected: |
+      default baz content
+
+  - name: Triple Mustache
+    desc: Default content renders triple mustache variables
+    data: { bar: '<baz>' }
+    template: |
+      {{$foo}}default {{{bar}}} content{{/foo}}
+    expected: |
+      default <baz> content
+
+  - name: Sections
+    desc: Default content renders sections
+    data: { bar: {baz: 'qux'} }
+    template: |
+      {{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}
+    expected: |
+      default qux content
+
+  - name: Negative Sections
+    desc: Default content renders negative sections
+    data: { baz: 'three' }
+    template: |
+      {{$foo}}default {{^bar}}{{baz}}{{/bar}} content{{/foo}}
+    expected: |
+      default three content
+
+  - name: Mustache Injection
+    desc: Mustache injection in default content
+    data: {bar: {baz: '{{qux}}'} }
+    template: |
+      {{$foo}}default {{#bar}}{{baz}}{{/bar}} content{{/foo}}
+    expected: |
+      default {{qux}} content
+
+  - name: Inherit
+    desc: Default content rendered inside included templates
+    data: { }
+    template: |
+      {{<include}}{{/include}}
+    partials:
+      include: "{{$foo}}default content{{/foo}}"
+    expected: "default content"
+
+  - name: Overridden content
+    desc: Overridden content
+    data: { }
+    template: "{{<super}}{{$title}}sub template title{{/title}}{{/super}}"
+    partials:
+      super: "...{{$title}}Default title{{/title}}..."
+    expected: "...sub template title..."
+
+  - name: Data does not override block
+    desc: Provided data does not override data passed into parent
+    data: { var: 'var in data' }
+    template: "{{<include}}{{$var}}var in template{{/var}}{{/include}}"
+    partials:
+      include: "{{$var}}var in include{{/var}}"
+    expected: "var in template"
+
+  - name: Data does not override block default
+    desc: Provided data does not override default value of block
+    data: { var: 'var in data' }
+    template: "{{<include}}{{/include}}"
+    partials:
+      include: "{{$var}}var in include{{/var}}"
+    expected: "var in include"
+
+  - name: Overridden partial
+    desc: Overridden partial
+    data: { }
+    template: "test {{<partial}}{{$stuff}}override{{/stuff}}{{/partial}}"
+    partials:
+      partial: "{{$stuff}}...{{/stuff}}"
+    expected: "test override"
+
+  - name: Two overridden partials
+    desc: Two overridden partials with different content
+    data: { }
+    template: |
+      test {{<partial}}{{$stuff}}override1{{/stuff}}{{/partial}} {{<partial}}{{$stuff}}override2{{/stuff}}{{/partial}}
+    partials:
+      partial: "|{{$stuff}}...{{/stuff}}{{$default}} default{{/default}}|"
+    expected: |
+      test |override1 default| |override2 default|
+
+  - name: Override partial with newlines
+    desc: Override partial with newlines
+    data: { }
+    template: "{{<partial}}{{$ballmer}}\npeaked\n\n:(\n{{/ballmer}}{{/partial}}"
+    partials:
+      partial: "{{$ballmer}}peaking{{/ballmer}}"
+    expected: "peaked\n\n:(\n"
+
+  - name: Inherit indentation
+    desc: Inherit indentation when overriding a partial
+    data: { }
+    template: "{{<partial}}{{$nineties}}hammer time{{/nineties}}{{/partial}}"
+    partials:
+      partial: |
+        stop:
+          {{$nineties}}collaborate and listen{{/nineties}}
+    expected: |
+      stop:
+        hammer time
+
+  - name: Only one override
+    desc: Override one substitution but not the other
+    data: { }
+    template: "{{<partial}}{{$stuff2}}override two{{/stuff2}}{{/partial}}"
+    partials:
+      partial: "{{$stuff}}new default one{{/stuff}}, {{$stuff2}}new default two{{/stuff2}}"
+    expected: "new default one, override two"
+
+  - name: Super template
+    desc: Super templates behave identically to partials when called with no parameters
+    data: { }
+    template: "{{>include}}|{{<include}}{{/include}}"
+    partials:
+      include: "{{$foo}}default content{{/foo}}"
+    expected: "default content|default content"
+
+  - name: Recursion
+    desc: Recursion in inherited templates
+    data: {}
+    template: "{{<include}}{{$foo}}override{{/foo}}{{/include}}"
+    partials:
+      include: "{{$foo}}default content{{/foo}} {{$bar}}{{<include2}}{{/include2}}{{/bar}}"
+      include2: "{{$foo}}include2 default content{{/foo}} {{<include}}{{$bar}}don't recurse{{/bar}}{{/include}}"
+    expected: "override override override don't recurse"
+
+  - name: Multi-level inheritance
+    desc: Top-level substitutions take precedence in multi-level inheritance
+    data: { }
+    template: "{{<parent}}{{$a}}c{{/a}}{{/parent}}"
+    partials:
+      parent: "{{<older}}{{$a}}p{{/a}}{{/older}}"
+      older: "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}"
+      grandParent: "{{$a}}g{{/a}}"
+    expected: c
+
+  - name: Multi-level inheritance, no sub child
+    desc: Top-level substitutions take precedence in multi-level inheritance
+    data: { }
+    template: "{{<parent}}{{/parent}}"
+    partials:
+      parent: "{{<older}}{{$a}}p{{/a}}{{/older}}"
+      older: "{{<grandParent}}{{$a}}o{{/a}}{{/grandParent}}"
+      grandParent: "{{$a}}g{{/a}}"
+    expected: p
+
+  - name: Text inside super
+    desc: Ignores text inside super templates, but does parse $ tags
+    data: { }
+    template: "{{<include}} asdfasd {{$foo}}hmm{{/foo}} asdfasdfasdf {{/include}}"
+    partials:
+      include: "{{$foo}}default content{{/foo}}"
+    expected:
+      hmm
+
+  - name: Text inside super
+    desc: Allows text inside a super tag, but ignores it
+    data: {}
+    template: "{{<include}} asdfasd asdfasdfasdf {{/include}}"
+    partials:
+      include: "{{$foo}}default content{{/foo}}"
+    expected: default content
-- 
cgit v1.2.1