enolib 0.5.0

data/lib/enolib/messages/de.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+#  GENERATED ON 2019-04-10T13:57:55 - DO NOT EDIT MANUALLY
+
+module Enolib
+  module Messages
+    module De
+      CONTENT_HEADER = 'Inhalt'
+      EXPECTED_EMPTY = 'Ein leeres Element wurde erwartet.'
+      EXPECTED_FIELD = 'Ein Feld wurde erwartet.'
+      EXPECTED_FIELDS = 'Nur Felder wurden erwartet.'
+      EXPECTED_FIELDSET = 'Ein Fieldset wurde erwartet.'
+      EXPECTED_FIELDSET_ENTRY = 'Ein Fieldset Eintrag wurde erwartet.'
+      EXPECTED_FIELDSETS = 'Nur Fieldsets wurden erwartet.'
+      EXPECTED_LIST = 'Eine Liste wurde erwartet.'
+      EXPECTED_LIST_ITEM = 'Ein Listen Eintrag wurde erwartet.'
+      EXPECTED_LISTS = 'Nur Listen wurden erwartet.'
+      EXPECTED_SECTION = 'Eine Sektion wurde erwartet.'
+      EXPECTED_SECTIONS = 'Nur Sektionen wurden erwartet.'
+      EXPECTED_SINGLE_ELEMENT = 'Nur ein einzelnes Element wurde erwartet.'
+      EXPECTED_SINGLE_EMPTY = 'Nur ein einzelnes leeres Element wurde erwartet.'
+      EXPECTED_SINGLE_FIELD = 'Nur ein einzelnes Feld wurde erwartet.'
+      EXPECTED_SINGLE_FIELDSET = 'Nur ein einzelnes Fieldset wurde erwartet.'
+      EXPECTED_SINGLE_FIELDSET_ENTRY = 'Nur ein einzelner Fieldset Eintrag wurde erwartet.'
+      EXPECTED_SINGLE_LIST = 'Nur eine einzelne Liste wurde erwartet.'
+      EXPECTED_SINGLE_SECTION = 'Nur eine einzelne Sektion wurde erwartet.'
+      GUTTER_HEADER = 'Zeile'
+      MISSING_COMMENT = 'Ein erforderlicher Kommentar zu diesem Feld fehlt.'
+      MISSING_ELEMENT = 'Ein einzelnes Element ist erforderlich - es kann einen beliebigen Schlüssel haben.'
+      MISSING_EMPTY = 'Ein einzelnes leeres Element ist erforderlich - es kann einen beliebigen Schlüssel haben.'
+      MISSING_FIELD = 'Ein einzelnes Feld ist erforderlich - es kann einen beliebigen Schlüssel haben.'
+      MISSING_FIELDSET = 'Ein einzelnes Fieldset ist erforderlich - es kann einen beliebigen Schlüssel haben.'
+      MISSING_FIELDSET_ENTRY = 'Ein einzelner Fieldset Eintrag ist erforderlich - er kann einen beliebigen Schlüssel haben.'
+      MISSING_LIST = 'Eine einzelne Liste ist erforderlich - sie kann einen beliebigen Schlüssel haben.'
+      MISSING_SECTION = 'Eine einzelne Sektion ist erforderlich - sie kann einen beliebigen Schlüssel haben.'
+      UNEXPECTED_ELEMENT = 'Dieses Element wurde nicht erwartet, prüfe ob es am richtigen Platz ist und dass der Schlüssel keine Tippfehler enthält.'
+      def self.comment_error(message) "Es gibt ein Problem mit dem Kommentar dieses Elements: #{message}" end
+      def self.cyclic_dependency(line, key) "In Zeile #{line} wird '#{key}' in sich selbst kopiert." end
+      def self.expected_empty_with_key(key) "Ein leeres Element mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_field_with_key(key) "Ein Feld mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_fields_with_key(key) "Nur Felder mit dem Schlüssel '#{key}' wurden erwartet." end
+      def self.expected_fieldset_with_key(key) "Ein Fieldset mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_fieldsets_with_key(key) "Nur Fieldsets mit dem Schlüssel '#{key}' wurden erwartet." end
+      def self.expected_list_with_key(key) "Eine Liste mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_lists_with_key(key) "Nur Listen mit dem Schlüssel '#{key}' wurden erwartet." end
+      def self.expected_section_with_key(key) "Eine Sektion mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_sections_with_key(key) "Nur Sektionen mit dem Schlüssel '#{key}' wurden erwartet." end
+      def self.expected_single_element_with_key(key) "Nur ein einzelnes Element mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_empty_with_key(key) "Nur ein einzelnes leeres Element mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_field_with_key(key) "Nur ein einzelnes Feld mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_fieldset_entry_with_key(key) "Nur ein einzelner Fieldset Eintrag mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_fieldset_with_key(key) "Nur ein einzelnes Fieldset mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_list_with_key(key) "Nur eine einzelne Liste mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.expected_single_section_with_key(key) "Nur eine einzelne Sektion mit dem Schlüssel '#{key}' wurde erwartet." end
+      def self.invalid_line(line) "Zeile #{line} folgt keinem spezifierten Muster." end
+      def self.key_error(message) "Es gibt ein Problem mit dem Schlüssel dieses Elements: #{message}" end
+      def self.missing_element_for_continuation(line) "Zeile #{line} enthält eine Zeilenfortsetzung ohne dass davor ein fortsetzbares Element begonnen wurde." end
+      def self.missing_element_with_key(key) "Das Element '#{key}' fehlt - falls es angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_empty_with_key(key) "Das leere Element '#{key}' fehlt - falls es angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_field_value(key) "Das Feld '#{key}' muss einen Wert enthalten." end
+      def self.missing_field_with_key(key) "Das Feld '#{key}' fehlt - falls es angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_fieldset_entry_value(key) "Der Fieldset Eintrag '#{key}' muss einen Wert enthalten." end
+      def self.missing_fieldset_entry_with_key(key) "Der Fieldset Eintrag '#{key}' fehlt - falls er angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_fieldset_for_fieldset_entry(line) "Zeile #{line} enthält einen Fieldset Eintrag ohne dass davor ein Fieldset begonnen wurde." end
+      def self.missing_fieldset_with_key(key) "Das Fieldset '#{key}' fehlt - falls es angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_list_for_list_item(line) "Zeile #{line} enthält einen Listeneintrag ohne dass davor ein eine Liste begonnen wurde." end
+      def self.missing_list_item_value(key) "Die Liste '#{key}' darf keine leeren Einträge enthalten." end
+      def self.missing_list_with_key(key) "Die Liste '#{key}' fehlt - falls sie angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.missing_section_with_key(key) "Die Sektion '#{key}' fehlt - falls sie angegeben wurde eventuell nach Tippfehlern Ausschau halten und auch die Gross/Kleinschreibung beachten." end
+      def self.non_section_element_not_found(line, key) "In Zeile #{line} soll das Nicht-Sektions Element '#{key}' kopiert werden, es wurde aber nicht gefunden." end
+      def self.section_hierarchy_layer_skip(line) "Zeile #{line} beginnt eine Sektion die mehr als eine Ebene tiefer liegt als die aktuelle." end
+      def self.section_not_found(line, key) "In Zeile #{line} soll die Sektion '#{key}' kopiert werden, sie wurde aber nicht gefunden." end
+      def self.two_or_more_templates_found(key) "Es gibt mindestens zwei Elemente mit dem Schlüssel '#{key}' die hier zum kopieren in Frage kommen, es ist nicht klar welches kopiert werden soll." end
+      def self.unterminated_escaped_key(line) "In Zeile #{line} wird der Schlüssel eines Elements escaped, jedoch wird diese Escape Sequenz bis zum Ende der Zeile nicht mehr beendet." end
+      def self.unterminated_multiline_field(key, line) "Das Mehrzeilenfeld '#{key}' dass in Zeile #{line} beginnt wird bis zum Ende des Dokuments nicht mehr beendet." end
+      def self.value_error(message) "Es gibt ein Problem mit dem Wert dieses Elements: #{message}" end
+    end
+  end
+end

data/lib/enolib/messages/en.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+#  GENERATED ON 2019-04-10T13:57:55 - DO NOT EDIT MANUALLY
+
+module Enolib
+  module Messages
+    module En
+      CONTENT_HEADER = 'Content'
+      EXPECTED_EMPTY = 'An empty element was expected.'
+      EXPECTED_FIELD = 'A field was expected.'
+      EXPECTED_FIELDS = 'Only fields were expected.'
+      EXPECTED_FIELDSET = 'A fieldset was expected.'
+      EXPECTED_FIELDSET_ENTRY = 'A fieldset entry was expected.'
+      EXPECTED_FIELDSETS = 'Only fieldsets were expected.'
+      EXPECTED_LIST = 'A list was expected.'
+      EXPECTED_LIST_ITEM = 'A list item was expected.'
+      EXPECTED_LISTS = 'Only lists were expected.'
+      EXPECTED_SECTION = 'A section was expected.'
+      EXPECTED_SECTIONS = 'Only sections were expected.'
+      EXPECTED_SINGLE_ELEMENT = 'Only a single element was expected.'
+      EXPECTED_SINGLE_EMPTY = 'Only a single empty element was expected.'
+      EXPECTED_SINGLE_FIELD = 'Only a single field was expected.'
+      EXPECTED_SINGLE_FIELDSET = 'Only a single fieldset was expected.'
+      EXPECTED_SINGLE_FIELDSET_ENTRY = 'Only a single fieldset entry was expected.'
+      EXPECTED_SINGLE_LIST = 'Only a single list was expected.'
+      EXPECTED_SINGLE_SECTION = 'Only a single section was expected.'
+      GUTTER_HEADER = 'Line'
+      MISSING_COMMENT = 'A required comment for this element is missing.'
+      MISSING_ELEMENT = 'A single element is required - it can have any key.'
+      MISSING_EMPTY = 'A single empty element is required - it can have any key.'
+      MISSING_FIELD = 'A single field is required - it can have any key.'
+      MISSING_FIELDSET = 'A single fieldset is required - it can have any key.'
+      MISSING_FIELDSET_ENTRY = 'A single fieldset entry is required - it can have any key.'
+      MISSING_LIST = 'A single list is required - it can have any key.'
+      MISSING_SECTION = 'A single section is required - it can have any key.'
+      UNEXPECTED_ELEMENT = 'This element was not expected, make sure it is at the right place in the document and that its key is not mis-typed.'
+      def self.comment_error(message) "There is a problem with the comment of this element: #{message}" end
+      def self.cyclic_dependency(line, key) "In line #{line} '#{key}' is copied into itself." end
+      def self.expected_empty_with_key(key) "An empty element with the key '#{key}' was expected." end
+      def self.expected_field_with_key(key) "A field with the key '#{key}' was expected." end
+      def self.expected_fields_with_key(key) "Only fields with the key '#{key}' were expected." end
+      def self.expected_fieldset_with_key(key) "A fieldset with the key '#{key}' was expected." end
+      def self.expected_fieldsets_with_key(key) "Only fieldsets with the key '#{key}' were expected." end
+      def self.expected_list_with_key(key) "A list with the key '#{key}' was expected." end
+      def self.expected_lists_with_key(key) "Only lists with the key '#{key}' were expected." end
+      def self.expected_section_with_key(key) "A section with the key '#{key}' was expected." end
+      def self.expected_sections_with_key(key) "Only sections with the key '#{key}' were expected." end
+      def self.expected_single_element_with_key(key) "Only a single element with the key '#{key}' was expected." end
+      def self.expected_single_empty_with_key(key) "Only a single empty element with the key '#{key}' was expected." end
+      def self.expected_single_field_with_key(key) "Only a single field with the key '#{key}' was expected." end
+      def self.expected_single_fieldset_entry_with_key(key) "Only a single fieldset entry with the key '#{key}' was expected." end
+      def self.expected_single_fieldset_with_key(key) "Only a single fieldset with the key '#{key}' was expected." end
+      def self.expected_single_list_with_key(key) "Only a single list with the key '#{key}' was expected." end
+      def self.expected_single_section_with_key(key) "Only a single section with the key '#{key}' was expected." end
+      def self.invalid_line(line) "Line #{line} does not follow any specified pattern." end
+      def self.key_error(message) "There is a problem with the key of this element: #{message}" end
+      def self.missing_element_for_continuation(line) "Line #{line} contains a line continuation without a continuable element being specified before." end
+      def self.missing_element_with_key(key) "The element '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_empty_with_key(key) "The empty element '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_field_value(key) "The field '#{key}' must contain a value." end
+      def self.missing_field_with_key(key) "The field '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_fieldset_entry_value(key) "The fieldset entry '#{key}' must contain a value." end
+      def self.missing_fieldset_entry_with_key(key) "The fieldset entry '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_fieldset_for_fieldset_entry(line) "Line #{line} contains a fieldset entry without a fieldset being specified before." end
+      def self.missing_fieldset_with_key(key) "The fieldset '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_list_for_list_item(line) "Line #{line} contains a list item without a list being specified before." end
+      def self.missing_list_item_value(key) "The list '#{key}' may not contain empty items." end
+      def self.missing_list_with_key(key) "The list '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.missing_section_with_key(key) "The section '#{key}' is missing - in case it has been specified look for typos and also check for correct capitalization." end
+      def self.non_section_element_not_found(line, key) "In line #{line} the non-section element '#{key}' should be copied, but it was not found." end
+      def self.section_hierarchy_layer_skip(line) "Line #{line} starts a section that is more than one level deeper than the current one." end
+      def self.section_not_found(line, key) "In line #{line} the section '#{key}' should be copied, but it was not found." end
+      def self.two_or_more_templates_found(key) "There are at least two elements with the key '#{key}' that qualify for being copied here, it is not clear which to copy." end
+      def self.unterminated_escaped_key(line) "In line #{line} the key of an element is escaped, but the escape sequence is not terminated until the end of the line." end
+      def self.unterminated_multiline_field(key, line) "The multiline field '#{key}' starting in line #{line} is not terminated until the end of the document." end
+      def self.value_error(message) "There is a problem with the value of this element: #{message}" end
+    end
+  end
+end

data/lib/enolib/messages/es.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+#  GENERATED ON 2019-04-10T13:57:55 - DO NOT EDIT MANUALLY
+
+module Enolib
+  module Messages
+    module Es
+      CONTENT_HEADER = 'Contenido'
+      EXPECTED_EMPTY = 'Se esperaba un elemento vacío.'
+      EXPECTED_FIELD = 'Se esperaba una casilla.'
+      EXPECTED_FIELDS = 'Solo se esperaban casillas.'
+      EXPECTED_FIELDSET = 'Se esperaba una collecíon de casillas.'
+      EXPECTED_FIELDSET_ENTRY = 'Se esperaba una casilla de collecíon.'
+      EXPECTED_FIELDSETS = 'Solo se esperaban colleciones de casillas.'
+      EXPECTED_LIST = 'Se esperaba una lista.'
+      EXPECTED_LIST_ITEM = 'Se esperaba una entrada de lista.'
+      EXPECTED_LISTS = 'Solo se esperaban listas.'
+      EXPECTED_SECTION = 'Se esperaba una sección.'
+      EXPECTED_SECTIONS = 'Solo se esperaban secciones.'
+      EXPECTED_SINGLE_ELEMENT = 'Solo se esperaba un único elemento.'
+      EXPECTED_SINGLE_EMPTY = 'Solo se esperaba un único elemento vacío.'
+      EXPECTED_SINGLE_FIELD = 'Solo se esperaba una sola casilla.'
+      EXPECTED_SINGLE_FIELDSET = 'Solo se esperaba una sola collecíon de casillas.'
+      EXPECTED_SINGLE_FIELDSET_ENTRY = 'Solo se esperaba una sola casilla de collecíon.'
+      EXPECTED_SINGLE_LIST = 'Solo se esperaba una sola lista.'
+      EXPECTED_SINGLE_SECTION = 'Solo se esperaba una sola sección.'
+      GUTTER_HEADER = 'Línea'
+      MISSING_COMMENT = 'Falta un comentario necesario para este elemento.'
+      MISSING_ELEMENT = 'Se requiere un único elemento - puede tener cualquier clave.'
+      MISSING_EMPTY = 'Se requiere un único elemento vacío - puede tener cualquier clave.'
+      MISSING_FIELD = 'Se requiere una sola casilla - puede tener cualquier clave.'
+      MISSING_FIELDSET = 'Se requiere una sola collecíon de casillas - puede tener cualquier clave.'
+      MISSING_FIELDSET_ENTRY = 'Se requiere una sola casilla de collecíon - puede tener cualquier clave.'
+      MISSING_LIST = 'Se requiere una sola lista - puede tener cualquier clave.'
+      MISSING_SECTION = 'Se requiere una sola sección - puede tener cualquier clave.'
+      UNEXPECTED_ELEMENT = 'Este elemento no se esperaba, averigua si es en el sitio correcto y que no contiene un error tipográfico la clave.'
+      def self.comment_error(message) "Hay un problema con el comentario de este elemento: #{message}" end
+      def self.cyclic_dependency(line, key) "En la línea #{line} '#{key}' se copia en sí mismo." end
+      def self.expected_empty_with_key(key) "Se esperaba un elemento vacío con la clave '#{key}'." end
+      def self.expected_field_with_key(key) "Se esperaba una casilla con la clave '#{key}'." end
+      def self.expected_fields_with_key(key) "Solo se esperaban casillas con la clave '#{key}'." end
+      def self.expected_fieldset_with_key(key) "Se esperaba una collecíon de casillas con la clave '#{key}'." end
+      def self.expected_fieldsets_with_key(key) "Solo se esperaban colleciones de casillas con la clave '#{key}'." end
+      def self.expected_list_with_key(key) "Se esperaba una lista con la clave '#{key}'." end
+      def self.expected_lists_with_key(key) "Solo se esperaban listas con la clave '#{key}'." end
+      def self.expected_section_with_key(key) "Se esperaba una sección con la clave '#{key}'." end
+      def self.expected_sections_with_key(key) "Solo se esperaban secciones con la clave '#{key}'." end
+      def self.expected_single_element_with_key(key) "Solo se esperaba un único elemento con la clave '#{key}'." end
+      def self.expected_single_empty_with_key(key) "Solo se esperaba un único elemento vacío con la clave '#{key}'." end
+      def self.expected_single_field_with_key(key) "Solo se esperaba una sola casilla con la clave '#{key}'." end
+      def self.expected_single_fieldset_entry_with_key(key) "Solo se esperaba una sola casilla de collecíon con la clave '#{key}'." end
+      def self.expected_single_fieldset_with_key(key) "Solo se esperaba una sola collecíon de casillas con la clave '#{key}'." end
+      def self.expected_single_list_with_key(key) "Solo se esperaba una sola lista con la clave '#{key}'." end
+      def self.expected_single_section_with_key(key) "Solo se esperaba una sola sección con la clave '#{key}'." end
+      def self.invalid_line(line) "Línea #{line} no sigue un patrón especificado." end
+      def self.key_error(message) "Hay un problema con la clave de este elemento: #{message}" end
+      def self.missing_element_for_continuation(line) "Línea #{line} contiene una continuacíon de línea sin un elemento que se puede continuar empezado antes." end
+      def self.missing_element_with_key(key) "Falta el elemento '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_empty_with_key(key) "Falta el elemento vacío '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_field_value(key) "La casilla '#{key}' debe contener un valor." end
+      def self.missing_field_with_key(key) "Falta la casilla '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_fieldset_entry_value(key) "La casilla de collecíon '#{key}' debe contener un valor." end
+      def self.missing_fieldset_entry_with_key(key) "Falta la casilla de collecíon '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_fieldset_for_fieldset_entry(line) "Línea #{line} contiene una casilla de collecíon sin una collecíon de casillas empezada antes." end
+      def self.missing_fieldset_with_key(key) "Falta la collecíon de casillas '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_list_for_list_item(line) "Línea #{line} contiene una entrada de lista sin una lista empezada antes." end
+      def self.missing_list_item_value(key) "La lista '#{key}' no debe contener entradas vacías." end
+      def self.missing_list_with_key(key) "Falta la lista '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.missing_section_with_key(key) "Falta la sección '#{key}' - si se proporcionó, mira por errores ortográficos y también distingue entre mayúsculas y minúsculas." end
+      def self.non_section_element_not_found(line, key) "En la línea #{line} debe ser copiado el elemento no sección '#{key}', pero no se encontró." end
+      def self.section_hierarchy_layer_skip(line) "Línea #{line} inicia una sección que es más de un nivel más bajo el actual." end
+      def self.section_not_found(line, key) "En la línea #{line} debe ser copiado la sección '#{key}', pero no se encontró." end
+      def self.two_or_more_templates_found(key) "Hay como mínimo dos elementos con la clave '#{key}' que se clasifiquen para estar copiado, no está claro cual debe ser copiado." end
+      def self.unterminated_escaped_key(line) "En la línea #{line}, la clave de un elemento se escapa, pero esta secuencia de escape no termina hasta el final de la línea." end
+      def self.unterminated_multiline_field(key, line) "La casilla de múltiples líneas '#{key}' que comienza en la línea #{line} no termina hasta el final del documento." end
+      def self.value_error(message) "Hay un problema con el valor de este elemento: #{message}" end
+    end
+  end
+end

data/lib/enolib/parse.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Enolib
+  def self.parse(input, **options)
+    context = Context.new(input, **options)
+
+    Section.new(context, context.document)
+  end
+end

data/lib/enolib/parser.rb

@@ -0,0 +1,708 @@
+# frozen_string_literal: true
+
+module Enolib
+  class Parser
+    def initialize(context)
+      @context = context
+      @depth = 0
+      @index = 0
+      @line = 0
+      @unresolved_non_section_elements = nil
+      @unresolved_sections = nil
+    end
+
+    def run
+      if @context.input.empty?
+        @context.line_count = 1
+        return
+      end
+
+      comments = nil
+      last_continuable_element = nil
+      last_non_section_element = nil
+      last_section = @context.document
+
+      while @index < @context.input.length
+        match = Grammar::REGEX.match(@context.input, @index)
+
+        unless match && match.begin(0) == @index
+          instruction = tokenize_error_context
+          raise Errors::Parsing.invalid_line(@context, instruction)
+        end
+
+        instruction = {
+          index: @index,
+          line: @line,
+          ranges: {
+            line: match.offset(0)
+          }
+        }
+
+        multiline_field = false
+
+        if match[Grammar::EMPTY_LINE_INDEX]
+
+          instruction[:type] = :empty_line
+
+          if comments
+            @context.meta.concat(comments)
+            comments = nil
+          end
+
+        elsif match[Grammar::ELEMENT_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          instruction[:key] = match[Grammar::KEY_UNESCAPED_INDEX]
+
+          if instruction[:key]
+            instruction[:ranges][:element_operator] = match.offset(Grammar::ELEMENT_OPERATOR_INDEX)
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_UNESCAPED_INDEX)
+          else
+            instruction[:key] = match[Grammar::KEY_ESCAPED_INDEX]
+            instruction[:ranges][:element_operator] = match.offset(Grammar::ELEMENT_OPERATOR_INDEX)
+            instruction[:ranges][:escape_begin_operator] = match.offset(Grammar::KEY_ESCAPE_BEGIN_OPERATOR_INDEX)
+            instruction[:ranges][:escape_end_operator] = match.offset(Grammar::KEY_ESCAPE_END_OPERATOR_INDEX)
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_ESCAPED_INDEX)
+          end
+
+          value = match[Grammar::FIELD_VALUE_INDEX]
+
+          if value
+            instruction[:ranges][:value] = match.offset(Grammar::FIELD_VALUE_INDEX)
+            instruction[:type] = :field
+            instruction[:value] = value
+          else
+            instruction[:type] = :empty_element
+          end
+
+          instruction[:parent] = last_section
+          last_section[:elements].push(instruction)
+          last_continuable_element = instruction
+          last_non_section_element = instruction
+
+        elsif match[Grammar::LIST_ITEM_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          instruction[:ranges][:item_operator] = match.offset(Grammar::LIST_ITEM_OPERATOR_INDEX)
+          instruction[:type] = :list_item
+
+          value = match[Grammar::LIST_ITEM_VALUE_INDEX]
+
+          if value
+            instruction[:ranges][:value] = match.offset(Grammar::LIST_ITEM_VALUE_INDEX)
+            instruction[:value] = value
+          end
+
+          if !last_non_section_element
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_list_for_list_item(@context, instruction)
+          elsif last_non_section_element[:type] == :list
+            last_non_section_element[:items].push(instruction)
+          elsif last_non_section_element[:type] == :empty_element
+            last_non_section_element[:items] = [instruction]
+            last_non_section_element[:type] = :list
+          else
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_list_for_list_item(@context, instruction)
+          end
+
+          instruction[:parent] = last_non_section_element
+          last_continuable_element = instruction
+
+        elsif match[Grammar::FIELDSET_ENTRY_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          instruction[:type] = :fieldset_entry
+
+          instruction[:key] = match[Grammar::KEY_UNESCAPED_INDEX]
+
+          if instruction[:key]
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_UNESCAPED_INDEX)
+            instruction[:ranges][:entry_operator] = match.offset(Grammar::FIELDSET_ENTRY_OPERATOR_INDEX)
+          else
+            instruction[:key] = match[Grammar::KEY_ESCAPED_INDEX]
+            instruction[:ranges][:entry_operator] = match.offset(Grammar::FIELDSET_ENTRY_OPERATOR_INDEX)
+            instruction[:ranges][:escape_begin_operator] = match.offset(Grammar::KEY_ESCAPE_BEGIN_OPERATOR_INDEX)
+            instruction[:ranges][:escape_end_operator] = match.offset(Grammar::KEY_ESCAPE_END_OPERATOR_INDEX)
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_ESCAPED_INDEX)
+          end
+
+          value = match[Grammar::FIELDSET_ENTRY_VALUE_INDEX]
+
+          if value
+            instruction[:ranges][:value] = match.offset(Grammar::FIELDSET_ENTRY_VALUE_INDEX)
+            instruction[:value] = value
+          end
+
+          if !last_non_section_element
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_fieldset_for_fieldset_entry(@context, instruction)
+          elsif last_non_section_element[:type] == :fieldset
+            last_non_section_element[:entries].push(instruction)
+          elsif last_non_section_element[:type] == :empty_element
+            last_non_section_element[:entries] = [instruction]
+            last_non_section_element[:type] = :fieldset
+          else
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_fieldset_for_fieldset_entry(@context, instruction)
+          end
+
+          instruction[:parent] = last_non_section_element
+          last_continuable_element = instruction
+
+        elsif match[Grammar::SPACED_LINE_CONTINUATION_OPERATOR_INDEX]
+
+          if !last_continuable_element
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_element_for_continuation(@context, instruction)
+          end
+
+          instruction[:spaced] = true
+          instruction[:ranges][:spaced_line_continuation_operator] = match.offset(Grammar::SPACED_LINE_CONTINUATION_OPERATOR_INDEX)
+          instruction[:type] = :continuation
+
+          value = match[Grammar::SPACED_LINE_CONTINUATION_VALUE_INDEX]
+
+          if value
+            instruction[:ranges][:value] = match.offset(Grammar::SPACED_LINE_CONTINUATION_VALUE_INDEX)
+            instruction[:value] = value
+          end
+
+          if last_continuable_element.has_key?(:continuations)
+            last_continuable_element[:continuations].push(instruction)
+          else
+            if last_continuable_element[:type] == :empty_element
+              last_continuable_element[:type] = :field
+            end
+
+            last_continuable_element[:continuations] = [instruction]
+          end
+
+          if comments
+            @context.meta.concat(comments)
+            comments = nil
+          end
+
+        elsif match[Grammar::DIRECT_LINE_CONTINUATION_OPERATOR_INDEX]
+
+          if !last_continuable_element
+            instruction = tokenize_error_context
+            raise Errors::Parsing.missing_element_for_continuation(@context, instruction)
+          end
+
+          instruction[:ranges][:direct_line_continuation_operator] = match.offset(Grammar::DIRECT_LINE_CONTINUATION_OPERATOR_INDEX)
+          instruction[:type] = :continuation
+
+          value = match[Grammar::DIRECT_LINE_CONTINUATION_VALUE_INDEX]
+
+          if value
+            instruction[:ranges][:value] = match.offset(Grammar::DIRECT_LINE_CONTINUATION_VALUE_INDEX)
+            instruction[:value] = value
+          end
+
+          if last_continuable_element.has_key?(:continuations)
+            last_continuable_element[:continuations].push(instruction)
+          else
+            if last_continuable_element[:type] == :empty_element
+              last_continuable_element[:type] = :field
+            end
+
+            last_continuable_element[:continuations] = [instruction]
+          end
+
+          if comments
+            @context.meta.concat(comments)
+            comments = nil
+          end
+
+        elsif match[Grammar::SECTION_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          instruction[:elements] = []
+          instruction[:ranges][:section_operator] = match.offset(Grammar::SECTION_OPERATOR_INDEX)
+          instruction[:type] = :section
+
+          new_depth = instruction[:ranges][:section_operator][1] - instruction[:ranges][:section_operator][0]
+
+          if new_depth == @depth + 1
+            instruction[:parent] = last_section
+            @depth = new_depth
+          elsif new_depth == @depth
+            instruction[:parent] = last_section[:parent]
+          elsif new_depth < @depth
+            while new_depth < @depth
+              last_section = last_section[:parent]
+              @depth -= 1
+            end
+
+            instruction[:parent] = last_section[:parent]
+          else
+            instruction = tokenize_error_context
+            raise Errors::Parsing.section_hierarchy_layer_skip(@context, instruction, last_section)
+          end
+
+          instruction[:parent][:elements].push(instruction)
+          last_section = instruction
+
+          instruction[:key] = match[Grammar::SECTION_KEY_UNESCAPED_INDEX]
+
+          if instruction[:key]
+            instruction[:ranges][:key] = match.offset(Grammar::SECTION_KEY_UNESCAPED_INDEX)
+          else
+            instruction[:key] = match[Grammar::SECTION_KEY_ESCAPED_INDEX]
+            instruction[:ranges][:escape_begin_operator] = match.offset(Grammar::SECTION_KEY_ESCAPE_BEGIN_OPERATOR_INDEX)
+            instruction[:ranges][:escape_end_operator] = match.offset(Grammar::SECTION_KEY_ESCAPE_END_OPERATOR_INDEX)
+            instruction[:ranges][:key] = match.offset(Grammar::SECTION_KEY_ESCAPED_INDEX)
+          end
+
+          template = match[Grammar::SECTION_TEMPLATE_INDEX]
+
+          if template
+            instruction[:ranges][:template] = match.offset(Grammar::SECTION_TEMPLATE_INDEX)
+            instruction[:template] = template
+
+            parent = instruction[:parent]
+            while parent[:type] != :document
+              parent[:deep_resolve] = true
+              parent = parent[:parent]
+            end
+
+            copy_operator_offset = match.offset(Grammar::SECTION_COPY_OPERATOR_INDEX)
+
+            if copy_operator_offset[1] - copy_operator_offset[0] == 2
+              instruction[:deep_copy] = true
+              instruction[:ranges][:deep_copy_operator] = copy_operator_offset
+            else
+              instruction[:ranges][:copy_operator] = copy_operator_offset
+            end
+
+            @unresolved_sections = {} unless @unresolved_sections
+
+            if @unresolved_sections.has_key?(template)
+              @unresolved_sections[template][:targets].push(instruction)
+            else
+              @unresolved_sections[template] = { targets: [instruction] }
+            end
+
+            instruction[:copy] = @unresolved_sections[template]
+          end
+
+          last_continuable_element = nil
+          last_non_section_element = nil
+
+        elsif match[Grammar::MULTILINE_FIELD_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          operator = match[Grammar::MULTILINE_FIELD_OPERATOR_INDEX]
+          key = match[Grammar::MULTILINE_FIELD_KEY_INDEX]
+
+          instruction[:key] = key
+          instruction[:parent] = last_section
+          instruction[:ranges][:multiline_field_operator] = match.offset(Grammar::MULTILINE_FIELD_OPERATOR_INDEX)
+          instruction[:ranges][:key] = match.offset(Grammar::MULTILINE_FIELD_KEY_INDEX)
+          instruction[:type] = :multiline_field_begin
+
+          @index = match.end(0)
+
+          last_section[:elements].push(instruction)
+          last_continuable_element = nil
+          last_non_section_element = instruction
+
+          terminator_regex = /\n[^\S\n]*(#{operator})(?!-)[^\S\n]*(#{Regexp.escape(key)})[^\S\n]*(?=\n|$)/
+          terminator_match = terminator_regex.match(@context.input, @index)
+
+          @index += 1  # move past current char (\n) into next line
+          @line += 1
+
+          unless terminator_match
+            tokenize_error_context
+            raise Errors::Parsing.unterminated_multiline_field(@context, instruction)
+          end
+
+          end_of_multiline_field_index = terminator_match.begin(0)
+
+          if end_of_multiline_field_index != @index - 1
+            instruction[:lines] = []
+
+            loop do
+              end_of_line_index = @context.input.index("\n", @index)
+
+              if !end_of_line_index || end_of_line_index >= end_of_multiline_field_index
+                last_non_section_element[:lines].push(
+                  line: @line,
+                  ranges: {
+                    line: [@index, end_of_multiline_field_index],
+                    value: [@index, end_of_multiline_field_index]
+                  },
+                  type: :multiline_field_value
+                )
+
+                @index = end_of_multiline_field_index + 1
+                @line += 1
+
+                break
+              else
+                last_non_section_element[:lines].push(
+                  line: @line,
+                  ranges: {
+                    line: [@index, end_of_line_index],
+                    value: [@index, end_of_line_index]
+                  },
+                  type: :multiline_field_value
+                )
+
+                @index = end_of_line_index + 1
+                @line += 1
+              end
+            end
+          end
+
+          instruction = {
+            length: terminator_match.end(0),
+            line: @line,
+            ranges: {
+              key:  terminator_match.offset(2),
+              line: [@index, terminator_match.end(0)],
+              multiline_field_operator: terminator_match.offset(1),
+            },
+            type: :multiline_field_end
+          }
+
+          last_non_section_element[:end] = instruction
+          last_non_section_element = nil
+
+          @index = terminator_match.end(0) + 1
+          @line += 1
+
+          multiline_field = true
+
+        elsif match[Grammar::COMMENT_OPERATOR_INDEX]
+
+          if comments
+            comments.push(instruction)
+          else
+            comments = [instruction]
+          end
+
+          instruction[:ranges][:comment_operator] = match.offset(Grammar::COMMENT_OPERATOR_INDEX)
+          instruction[:type] = :comment
+
+          comment = match[Grammar::COMMENT_VALUE_INDEX]
+
+          if comment
+            instruction[:comment] = comment
+            instruction[:ranges][:comment] = match.offset(Grammar::COMMENT_VALUE_INDEX)
+          end
+
+        elsif match[Grammar::COPY_OPERATOR_INDEX]
+
+          if comments
+            instruction[:comments] = comments
+            comments = nil
+          end
+
+          template = match[Grammar::TEMPLATE_INDEX]
+
+          instruction[:ranges][:copy_operator] = match.offset(Grammar::COPY_OPERATOR_INDEX)
+          instruction[:ranges][:template] = match.offset(Grammar::TEMPLATE_INDEX)
+          instruction[:template] = template
+          instruction[:type] = :empty_element
+
+          instruction[:key] = match[Grammar::KEY_UNESCAPED_INDEX]
+
+          if instruction[:key]
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_UNESCAPED_INDEX)
+          else
+            instruction[:key] = match[Grammar::KEY_ESCAPED_INDEX]
+            instruction[:ranges][:escape_begin_operator] = match.offset(Grammar::KEY_ESCAPE_BEGIN_OPERATOR_INDEX)
+            instruction[:ranges][:escape_end_operator] = match.offset(Grammar::KEY_ESCAPE_END_OPERATOR_INDEX)
+            instruction[:ranges][:key] = match.offset(Grammar::KEY_ESCAPED_INDEX)
+          end
+
+          instruction[:parent] = last_section
+          last_section[:elements].push(instruction)
+          last_continuable_element = nil
+          last_non_section_element = instruction
+
+          @unresolved_non_section_elements = {} unless @unresolved_non_section_elements
+
+          if @unresolved_non_section_elements.has_key?(template)
+            @unresolved_non_section_elements[template][:targets].push(instruction)
+          else
+            @unresolved_non_section_elements[template] = { targets: [instruction] }
+          end
+
+          instruction[:copy] = @unresolved_non_section_elements[template]
+        end
+
+        unless multiline_field
+          @index = match.end(0) + 1
+          @line += 1
+        end
+      end
+
+      if @context.input[-1] == "\n"
+        @context.line_count = @line + 1
+      else
+        @context.line_count = @line
+      end
+
+      @context.meta.concat(comments) if comments
+
+      resolve if @unresolved_non_section_elements || @unresolved_sections
+    end
+
+    private
+
+    def consolidate_non_section_elements(element, template)
+      if template.has_key?(:comments) && !element.has_key?(:comments)
+        element[:comments] = template[:comments]
+      end
+
+      case element[:type]
+      when :empty_element
+        case template[:type]
+        when :multiline_field_begin
+          element[:type] = :field
+          mirror(element, template)
+        when :field
+          element[:type] = :field
+          mirror(element, template)
+        when :fieldset
+          element[:type] = :fieldset
+          mirror(element, template)
+        when :list
+          element[:type] = :list
+          mirror(element, template)
+        end
+      when :fieldset
+        case template[:type]
+        when :fieldset
+          element[:extend] = template
+        when :field, :list, :multiline_field_begin
+          raise Errors::Parsing.missing_fieldset_for_fieldset_entry(@context, element[:entries].first)
+        end
+      when :list
+        case template[:type]
+        when :list
+          element[:extend] = template
+        when :field, :fieldset, :multiline_field_begin
+          raise Errors::Parsing.missing_list_for_list_item(@context, element[:items].first)
+        end
+      end
+    end
+
+    def consolidate_sections(section, template, deep_merge)
+      if template.has_key?(:comments) && !section.has_key?(:comments)
+        section[:comments] = template[:comments]
+      end
+
+      if section[:elements].empty?
+        mirror(section, template)
+      else
+        # TODO: Handle possibility of two templates (one hardcoded in the document, one implicitly derived through deep merging)
+        #       Possibly also elswhere (e.g. up there in the mirror branch?)
+        section[:extend] = template
+
+        return unless deep_merge
+
+        merge_map = {}
+
+        section[:elements].each do |section_element|
+          if section_element[:type] != :section || merge_map.has_key?(section_element[:key])
+            merge_map[section_element[:key]] = false # non-mergable (no section or multiple instructions with same key)
+          else
+            merge_map[section_element[:key]] = { section: section_element }
+          end
+        end
+
+        template[:elements].each do |section_element|
+          if merge_map.has_key?(section_element[:key])
+            merger = merge_map[section_element[:key]]
+
+            next unless merger
+
+            if section_element[:type] != :section || merger.has_key?(:template)
+              merge_map[section_element[:key]] = false # non-mergable (no section or multiple template instructions with same key)
+            else
+              merger[:template] = section_element
+            end
+          end
+        end
+
+        merge_map.each_value do |merger|
+          if merger && merger.has_key?(:template)
+            consolidate_sections(merger[:section], merger[:template], true)
+          end
+        end
+      end
+    end
+
+    def mirror(element, template)
+      if template.has_key?(:mirror)
+        element[:mirror] = template[:mirror]
+      else
+        element[:mirror] = template
+      end
+    end
+
+    def index(section)
+      section[:elements].each do |element|
+        if element[:type] == :section
+          index(element)
+
+          if @unresolved_sections &&
+             @unresolved_sections.has_key?(element[:key]) &&
+             element[:key] != element[:template]
+            copy_data = @unresolved_sections[element[:key]]
+
+            if copy_data.has_key?(:template)
+              raise Errors::Parsing.two_or_more_templates_found(@context, copy_data[:targets].first, copy_data[:template], element)
+            end
+
+            copy_data[:template] = element
+          end
+        elsif @unresolved_non_section_elements &&
+              @unresolved_non_section_elements.has_key?(element[:key]) &&
+              element[:key] != element[:template]
+          copy_data = @unresolved_non_section_elements[element[:key]]
+
+          if copy_data.has_key?(:template)
+            raise Errors::Parsing.two_or_more_templates_found(@context, copy_data[:targets].first, copy_data[:template], element)
+          end
+
+          copy_data[:template] = element
+        end
+      end
+    end
+
+    def resolve
+      index(@context.document)
+
+      if @unresolved_non_section_elements
+        @unresolved_non_section_elements.each_value do |copy|
+          unless copy.has_key?(:template)
+            raise Errors::Parsing.non_section_element_not_found(@context, copy[:targets].first)
+          end
+
+          copy[:targets].each do |target|
+            resolve_non_section_element(target) if target.has_key?(:copy)
+          end
+        end
+      end
+
+      if @unresolved_sections
+        @unresolved_sections.each_value do |copy|
+          unless copy.has_key?(:template)
+            raise Errors::Parsing.section_not_found(@context, copy[:targets].first)
+          end
+
+          copy[:targets].each do |target|
+            resolve_section(target) if target.has_key?(:copy)
+          end
+        end
+      end
+    end
+
+    def resolve_non_section_element(element, previous_elements = [])
+      if previous_elements.include?(element)
+        raise Errors::Parsing.cyclic_dependency(@context, element, previous_elements)
+      end
+
+      template = element[:copy][:template]
+
+      if template.has_key?(:copy)
+        resolve_non_section_element(template, [*previous_elements, element])
+      end
+
+      consolidate_non_section_elements(element, template)
+
+      element.delete(:copy)
+    end
+
+    def resolve_section(section, previous_sections = [])
+      if previous_sections.include?(section)
+        raise Errors::Parsing.cyclic_dependency(@context, section, previous_sections)
+      end
+
+      if section.has_key?(:deep_resolve)
+        section[:elements].each do |section_element|
+          if section_element[:type] == :section &&
+             (section_element.has_key?(:copy) || section_element.has_key?(:deep_resolve))
+            resolve_section(section_element, [*previous_sections, section])
+          end
+        end
+      end
+
+      if section.has_key?(:copy)
+        template = section[:copy][:template]
+
+        if template.has_key?(:copy) || template.has_key?(:deep_resolve)
+          resolve_section(template, [*previous_sections, section])
+        end
+
+        consolidate_sections(section, template, section.has_key?(:deep_copy))
+
+        section.delete(:copy)
+      end
+    end
+
+    def tokenize_error_context
+      first_instruction = nil
+
+      loop do
+        end_of_line_index = @context.input.index("\n", @index)
+
+        if end_of_line_index
+          instruction = {
+            line: @line,
+            ranges: { line: [@index, end_of_line_index] }
+          }
+
+          @context.meta.push(instruction)
+
+          if first_instruction
+            instruction[:type] = :unparsed
+          else
+            first_instruction = instruction
+          end
+
+          @index = end_of_line_index + 1
+          @line += 1
+        else
+          instruction = {
+            line: @line,
+            ranges: { line: [@index, @context.input.length]}
+          }
+
+          instruction[:type] = :unparsed if first_instruction
+
+          @context.line_count = @line + 1
+          @context.meta.push(instruction)
+
+          return first_instruction || instruction
+        end
+      end
+    end
+  end
+end