drawght 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 776b1ea99f39fc1716543bd837504d10ca2648babb6e283c0bbf0dcc6db10b5f
-  data.tar.gz: 0aa2b64aaa564b8194266ac18d37627ae384ba3cf4e39d7ad84a3a5c342ef36c
+  metadata.gz: 8a5dd8e8d4c11181d223311d1db2e25d8d6a9e7065289fb2ab40de86ce4fd054
+  data.tar.gz: c9698b4604f71e915915bc57ceefd595a21e36fa1969ea0d40e0f6fb907dbed9
 SHA512:
-  metadata.gz: 73a0b217f9ba7ecca5aaad07a182bc9756714245bd12af06a75b288b781f62bbbb6cce10013dcbcce66cc4e7a3631f62c07ed7ea9a0a50edf4525eb29dd3fd45
-  data.tar.gz: 96895069175bf3326d10e4a40f6276120043b650d77211ed00dca259c00f4ddedeaa2d28622c35a70c12e15c02a42db5e4dd1dbda936ae1d2398b3b8c092cf0b
+  metadata.gz: f0e6771bf26dbacaf3d3c62dbfa947e87beb639cdad189b3c068227940a1c6410a25de09a6632b450f3128d924f9a32e90ec99910dc5e1fec803abc93f016801
+  data.tar.gz: 201f2fb4ad4de65f40d79f50d97da5244d826a18718e4bec2c84ee3935247fc0f0be49e34cc98a1d7867bb418afc90650c8b3e2aa38442684ff29460265d2b53

data/CHANGELOG.yaml

@@ -0,0 +1,23 @@
+- version: 1.0.0
+  date: 2025-12-03
+  summary:
+    The compiler has finished.
+  changes:
+  - New compiler process.
+  - Refined extension methods have been added.
+  - Test coverage.
+  - Syntax revision for nested values in collections.
+
+- version: 0.2.0
+  date: 2024-08-30
+  summary:
+    Tests and tests.
+  changes:
+  - Tests have been added to test variables, objects and lists.
+
+- version: 0.1.0
+  date: 2021-07-11
+  summary:
+    Work in progress! Syntax and compiler have been coded.
+  changes:
+  - Process variables, objects and lists.

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright © 2021, Hallison Batista
+Copyright © 2021-2024, Hallison Batista
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,211 +1,348 @@
-# Drawght
-
-Drawght is a data handler for texts without logical statements. The goal is
-to use a dataset (such as the subject of a text) to draft a document
-template. It can be considered a mini template processor.
-
-Data is accessed through `{}` braces, replaced by their respective values.
-
-Considering the following data:
-
-```yaml
-title: Drawght is a very useful sketch
-author:
-  name: Hallison Batista
-  email: email@hallison.dev.br
-  networks:
-  - name: Github
-    url: //github.com/hallison
-  - name: Twitter
-    url: //twitter.com/hallison
-creation-date: 2021-06-28
-publishing date: 2021-07-01
-references:
-- name: Mustache
-  url: //mustache.github.io
-- name: Handlebars
-  url: //handlebarsjs.com
-tags:
-- Template
-- Draft
-```
-
-Note that the `creation-date` and `publishing date` fields are normally
-identified by the parser.
-
-In a template written in Markdown: 
-
-```markdown
-# {title}
-
-Drawght is a good tool for writing draft documents using datasets without
-logical statements.
-
-Written by {author.name} <{author.email}>, created in {creation-date},
-published in {publishing date} and tagged by {tags#1}.
-
-- [{author.networks:name}]({author.networks:url})
-
-Follow the news on [{author.networks#1.name}]({author.networks#1.url}).
-
-The syntax was inspired by: 
-
-- [{references:name}]({references:url})
-
-Tags:
-
-- {tags} (tagged by {author.name}).
-```
-
-The Drawght processing returns the following result:
-
-```markdown
-# Drawght is a very useful sketch
-
-Drawght is a good tool for writing draft documents using datasets without
-logical statements.
-
-Written by Hallison Batista <email@hallison.dev.br>, created in 2021-06-28,
-published in 2021-07-01 and tagged by Template.
-
-- [Dev.to](//dev.to/hallison)
-- [Github](//github.com/hallison)
-- [Twitter](//twitter.com/hallison)
-
-Follow the news on [Dev.to](//dev.to/hallison).
-
-The syntax was inspired by:
-
-- [Mustache](//mustache.github.io)
-- [Handlebars](//handlebarsjs.com)
-
-Tags:
-
-- Template (tagged by Hallison Batista).
-- Draf (tagged by Hallison Batista).
-```
-
-In a template written in HTML: 
-
-```html
-<h1>{title}</h1>
-
-<p>
-Drawght is a good tool for writing draft documents using datasets without
-logical statements.
-</p>
-
-<p>
-Written by <a href="mailto:{author.email}">{author.name}</a>, created
-published in {publishing date} and tagged by {tags#1}.
-</p>
-
-<ul>
-  <li><a href="{author.networks:url}">{author.networks:name}</a></li>
-</ul>
-
-<p>
-Follow the news on <a href="{author.networks#1.url}">author.networks#1.name</a>.
-</p>
-
-<p>
-The syntax was inspired by: 
-</p>
-
-<ul>
-  <a href="{references:url}">{references:name}</a>
-</ul>
-
-<p>
-Tags:
-</p>
-
-<ul>
-  <li>{tags} (tagged by {author.name}).</li>
-</ul>
-```
-
-The Drawght processing returns the following result:
-
-```html
-<h1>Drawght is a very useful sketch</h1>
-
-<p>
-Drawght is a good tool for writing draft documents using datasets without
-logical statements.
-</p>
-
-<p>
-Written by <a href="mailto:email@hallison.dev.br">Hallison Batista</a>,
-created published in 2021-07-01 and tagged by Template.
-</p>
-
-<ul>
-  <li><a href="//dev.to/hallison">Dev.to</a></li>
-  <li><a href="//github.com/hallison">Github</a></li>
-  <li><a href="//twitter.com/hallison">Twitter</a></li>
-</ul>
-
-<p>
-Follow the news on <a href="//dev.to/hallison">Dev.to</a>.
-</p>
-
-<p>
-The syntax was inspired by:
-</p>
-
-<ul>
-  <a href="//mustache.github.io">Mustache</a>
-  <a href="//handlebarsjs.com">Handlebars</a>
-</ul>
-
-<p>
-Tags:
-</p>
-
-<ul>
-  <li>Template (tagged by Hallison Batista).</li>
-  <li>Draf (tagged by Hallison Batista).</li>
-</ul>
-```
-
-## Syntax
-
-Drawght has a simple syntax:
-
-- `{key}`: converts `key` to its respective value. If the value is a list, then
-  the row will be replicated and converted with the respective values. 
-
-- `{object.key}`: converts `key` to its respective value inside `object`,
-  assuming the same behavior as `{key}`. 
-
-- `{list:key}`: selects `list`, replicates the line for each item in the list,
-  and converts `key` to its respective value contained in an object within
-  `list`. The `list` key can also be accessed by `object.list`, just as `key`
-  can also be accessed by `object.key` which will be converted following the
-  same process in case it is a list. 
-
-- `{list#n.key}`: selects item object `n` (from 1) from `list` and converts
-  `key` to its respective value. The whole process is similar to `object.key`. 
-
-## License (MIT)
-
-### Copyright (c) 2021, Hallison Batista
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# Drawght
+
+Drawght is a data handler for texts without logical statements. The goal is
+to use a dataset (such as the subject of a text) to draft a document
+template. It can be considered a mini template processor.
+
+Data is accessed through `{}` braces, replaced by their respective values.
+
+Considering the following data:
+
+```yaml
+title: Drawght is a very useful sketch
+author:
+  name: Hallison Batista
+  email: email@hallison.dev.br
+  networks:
+  - name: Github
+    url: //github.com/hallison
+  - name: Twitter
+    url: //twitter.com/hallison
+creation-date: 2021-06-28
+publishing date: 2021-07-01
+references:
+- name: Mustache
+  url: //mustache.github.io
+- name: Handlebars
+  url: //handlebarsjs.com
+tags:
+- Template
+- Draft
+```
+
+Note that the `creation-date` and `publishing date` fields are normally
+identified by the parser.
+
+In a template written in Markdown: 
+
+```markdown
+# {title}
+
+Drawght is a good tool for writing draft documents using datasets without
+logical statements.
+
+Written by {author.name} <{author.email}>, created in {creation-date},
+published in {publishing date} and tagged by {tags#1}.
+
+- [{author.networks:name}]({author.networks:url})
+
+Follow the news on [{author.networks#1.name}]({author.networks#1.url}).
+
+The syntax was inspired by: 
+
+- [{references:name}]({references:url})
+
+Tags:
+
+- {tags} (tagged by {author.name}).
+```
+
+The Drawght processing returns the following result:
+
+```markdown
+# Drawght is a very useful sketch
+
+Drawght is a good tool for writing draft documents using datasets without
+logical statements.
+
+Written by Hallison Batista <email@hallison.dev.br>, created in 2021-06-28,
+published in 2021-07-01 and tagged by Template.
+
+- [Dev.to](//dev.to/hallison)
+- [Github](//github.com/hallison)
+- [Twitter](//twitter.com/hallison)
+
+Follow the news on [Dev.to](//dev.to/hallison).
+
+The syntax was inspired by:
+
+- [Mustache](//mustache.github.io)
+- [Handlebars](//handlebarsjs.com)
+
+Tags:
+
+- Template (tagged by Hallison Batista).
+- Draf (tagged by Hallison Batista).
+```
+
+In a template written in HTML: 
+
+```html
+<h1>{title}</h1>
+
+<p>
+Drawght is a good tool for writing draft documents using datasets without
+logical statements.
+</p>
+
+<p>
+Written by <a href="mailto:{author.email}">{author.name}</a>, created
+published in {publishing date} and tagged by {tags#1}.
+</p>
+
+<ul>
+  <li><a href="{author.networks:url}">{author.networks:name}</a></li>
+</ul>
+
+<p>
+Follow the news on <a href="{author.networks#1.url}">author.networks#1.name</a>.
+</p>
+
+<p>
+The syntax was inspired by: 
+</p>
+
+<ul>
+  <a href="{references:url}">{references:name}</a>
+</ul>
+
+<p>
+Tags:
+</p>
+
+<ul>
+  <li>{tags} (tagged by {author.name}).</li>
+</ul>
+```
+
+The Drawght processing returns the following result:
+
+```html
+<h1>Drawght is a very useful sketch</h1>
+
+<p>
+Drawght is a good tool for writing draft documents using datasets without
+logical statements.
+</p>
+
+<p>
+Written by <a href="mailto:email@hallison.dev.br">Hallison Batista</a>,
+created published in 2021-07-01 and tagged by Template.
+</p>
+
+<ul>
+  <li><a href="//dev.to/hallison">Dev.to</a></li>
+  <li><a href="//github.com/hallison">Github</a></li>
+  <li><a href="//twitter.com/hallison">Twitter</a></li>
+</ul>
+
+<p>
+Follow the news on <a href="//dev.to/hallison">Dev.to</a>.
+</p>
+
+<p>
+The syntax was inspired by:
+</p>
+
+<ul>
+  <a href="//mustache.github.io">Mustache</a>
+  <a href="//handlebarsjs.com">Handlebars</a>
+</ul>
+
+<p>
+Tags:
+</p>
+
+<ul>
+  <li>Template (tagged by Hallison Batista).</li>
+  <li>Draf (tagged by Hallison Batista).</li>
+</ul>
+```
+
+## Install
+
+```bash
+gem install drawght
+```
+
+## Usage
+
+```ruby
+require "drawght"
+
+template = "{package.name} v{package.version}"
+result = Drawght.compile template, {
+  package: {
+    name: "Drawght",
+    version: "1.0.0",
+  }
+}
+
+puts result
+# Drawght v1.0.0
+```
+
+## Syntax
+
+Drawght has a simple syntax:
+
+- `{key}`: converts `key` to its respective value. If the value is a
+  collection, then the row will be replicated and converted with the respective
+  values. 
+
+- `{object.key}`: converts `key` to its respective value inside `object`,
+  assuming the same behavior as `{key}`. 
+
+- `{collection:key}`: selects `collection`, replicates the line for each item
+  in the collection, and converts `key` to its respective value contained in an
+  object within `collection`. The `collection` key can also be accessed by
+  `object.collection`, just as `key` can also be accessed by `object.key` which
+  will be converted following the same process in case it is a collection. 
+
+- `{collection#n.key}`: selects item object `n` (from 1) from `collection` and
+  converts `key` to its respective value. The whole process is similar to
+  `object.key`. 
+
+## How it works
+
+### Variables and attributes
+
+#### Definition
+
+```yaml
+Author:
+  Name: John Scalzi
+
+Protagonist: John Perry
+```
+
+#### Usage
+
+```
+{Protagonist}
+{Author.Name}
+```
+
+### Collections
+
+#### Definition
+
+```yaml
+Book Titles:
+- Old Man's War
+- The Ghost Brigades
+- The Last Colony
+
+# Or
+
+Books:
+- Title: Old Man's War
+- Title: The Ghost Brigades
+- Title: The Last Colony
+```
+
+#### Usage
+
+For value sequencing.
+
+```
+{Book Titles}
+{Books:Title}
+```
+
+For value straightly.
+
+```
+{Book Titles#1}
+{Book Titles#2}
+{Book Titles#3}
+
+{Books#1.Title}
+{Books#2.Title}
+{Books#3.Title}
+```
+
+### Nested collections
+
+#### Definition
+
+```yaml
+Books:
+- Title: Old Man's War
+  ISBN: 0-7653-0940-8
+
+- Title: The Ghost Brigades
+  ISBN: 0-7653-1502-5
+
+- Title: The Last Colony
+  ISBN: 0-7653-1697-8
+
+Series:
+- Name: Old Man's War
+  Books:
+  - Title: Old Man's War
+    ISBN: 0-7653-0940-8
+
+  - Title: The Ghost Brigades
+    ISBN: 0-7653-1502-5
+
+  - Title: The Last Colony
+    ISBN: 0-7653-1697-8
+
+- Name: Lock In
+  Books:
+  - Title: Lock In
+    ISBN: 978-0-7653-7586-5
+  - Title: Head On
+    ISBN: 978-0-7653-8891-9
+```
+
+#### Usage
+
+```
+{Books:Title}
+
+{Books#1.Title}
+
+{Series:Name}
+
+{Series:Books:Title}
+
+{Series#1.Name}
+
+{Series#1.Books:Title}
+
+{Series#2.Books#2.Title}
+```
+
+## License (MIT)
+
+### Copyright (c) 2021-2025, Hallison Batista
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/lib/drawght/compiler.rb

@@ -0,0 +1,73 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+module Drawght
+
+class Compiler
+  using Extensions
+
+  include Parser
+
+  attr_reader :template, :dataset, :result
+
+  def initialize template, dataset = nil
+    @template = template
+    @result = template.dup
+    @dataset = dataset.deep_stringify_keys! if dataset
+  end
+
+  def compile dataset
+    @dataset ||= dataset.deep_stringify_keys!
+    compile!
+  end
+
+  def compile!
+    convert
+    result
+  end
+
+  private
+
+  def convert
+    lines = template.lines.map do |line|
+      next line unless line.match? PLACEHOLDERS_PATTERN
+
+      mapping_placeholders_from line
+
+      newline = convert_straightly_placeholders_from line
+
+      convert_sequential_placeholders_from newline
+    end
+
+    result.replace lines.join
+  end
+
+  def convert_straightly_placeholders_from string
+    straightly_placeholders.reduce string.dup do |template, holding|
+      matter = dataset.ditch *pathkeys_from(holding)
+
+      converted = [matter].flatten.map do |value|
+        template.dup.gsub! holding.to_placeholder, value.to_s
+      end
+
+      template.replace converted.join
+    end
+  end
+
+  def convert_sequential_placeholders_from string
+    sequential_placeholders.reduce string.dup do |template, (attribute, mappings)|
+      matter = dataset.ditch *pathkeys_from(attribute)
+
+      converted = matter.map do |values|
+        mappings.inject template.dup do |partial, (holding, key)|
+          value = values.ditch(*pathkeys_from(key)) || key
+          partial.dup.gsub! holding.to_placeholder, value.to_s
+        end
+      end
+
+      template.replace converted.join
+    end
+  end
+end
+
+end

data/lib/drawght/mapper.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+module Drawght
+  module Mapper
+
+  end
+end

data/lib/drawght/parser.rb

@@ -1,68 +1,88 @@
-class Drawght::Parser
-  PREFIX, ATTRIBUTE, QUERY, ITEM, SUFFIX,  = "{", ".", ":", "#", "}"
-  KEY, LIST, INDEX = "(?<key>.*?)", "(?<list>.*?)", "(?<index>.*?)"
-  EOL = /\r?\n/
+# encoding: utf-8
+# frozen_string_literal: true
 
-  KEY_PATTERN = Regexp.new "#{PREFIX}#{KEY}#{SUFFIX}"
-  LIST_PATTERN = Regexp.new "#{PREFIX}#{LIST}#{QUERY}#{KEY}#{SUFFIX}"
-  ITEM_PATTERN = Regexp.new "#{LIST}#{ITEM}#{INDEX}([#{ATTRIBUTE}]#{KEY})?$"
+module Drawght
+  module Parser
+    using Extensions
 
-  def initialize(template)
-    @template = template
-  end
+    def pathkeys_from placeholder
+      path = case placeholder
+             when ATTRIBUTES_PATTERN then
+               path_keys_for_attribute placeholder
+             when QUERY_PATTERN then
+               path_keys_for_query placeholder
+             else
+               [placeholder]
+             end
 
-  def parse(data)
-    self.parse_keys(self.parse_queries(@template, data), data)
-  end
+      path.flatten
+    end
+
+    def placeholders_from string
+      return [] unless string =~ PLACEHOLDERS_PATTERN
+
+      string.scan(PLACEHOLDERS_PATTERN).flatten
+    end
 
-  def parse_queries(template, data)
-    template.split(EOL).map do |line|
-      result = line
-      line.scan LIST_PATTERN do |(list, key)|
-        value = value_from_key(list, data)
-        if value && (value.kind_of? Array) && key
-          partial = line.gsub("#{list}#{QUERY}", "")
-          parsed_lines = value.map { |item| parse_template(partial, item) }
-          result = result.gsub(line, parsed_lines.join("\n"))
+    def mapping_placeholders_from string
+      clear_placeholder_mappings!
+
+      placeholders_from(string).map do |placeholder|
+        if placeholder =~ QUERY_PATTERN
+          placeholder.scan %r/^(.*)#{QUERY}(.*)$/ do |pathkeys, attribute|
+            (sequential_placeholders[pathkeys] ||= {}).update placeholder => attribute
+          end
+        else
+          straightly_placeholders.add placeholder
         end
+
+        placeholder
       end
-      result
-    end.join("\n")
-  end
+    end
 
-  def parse_keys(template, data)
-    template.split(EOL).map do |line|
-      parse_template(line, data)
-    end.join("\n"); 
-  end
+    def straightly_placeholders
+      @straightly_placeholders ||= []
+    end
+
+    def sequential_placeholders
+      @sequential_placeholders ||= {}
+    end
 
-  def parse_template(template, data)
-    result = template
-    template.scan KEY_PATTERN do |(key)|
-      template_key = "#{PREFIX}#{key}#{SUFFIX}"
-      value = value_from_key(key, data) || template_key
-      if value.kind_of? Array
-        result = value.map { |item| template.gsub(template_key, item) }.join("\n")
+    def replace_placeholders template, value
+      case value
+      when Hash
+        replace_placeholder_attributes_for template, value
+      when Array
+        replace_placeholder_collections_for template, value
       else
-        result = result.gsub(template_key, value.to_s)
+        replace_placeholder_variables_from template, value
       end
     end
-    result
-  end
 
-  private
+    private
+
+    def path_keys_for_attribute placeholder
+      placeholder.split(ATTRIBUTES_PATTERN).map do |item|
+        if item.to_s =~ QUERY_PATTERN
+          path_keys_for_query item
+        else
+          item.to_s =~ /^\d/ ? item.to_i - 1 : item unless item.to_s.empty?
+        end
+      end.compact
+    end
 
-  def value_from_key(nested_key, data)
-    item = nested_key.match ITEM_PATTERN
-    if item
-      list, index, key = item.captures
-      index = index && (index.to_i)
-      value = data.dig *list.split(ATTRIBUTE)
-      if value && (value.kind_of? Array) && index
-        key ? value[index - 1][key] : value[index - 1]
+    def path_keys_for_query placeholder
+      placeholder.gsub(QUERY, "#{QUERY}&#{QUERY}").split(QUERY_PATTERN).map do |item|
+        if item.to_s =~ ATTRIBUTES_PATTERN
+          path_keys_for_attribute item
+        else
+          item
+        end
       end
-    else
-      data.dig *nested_key.split(ATTRIBUTE)
+    end
+
+    def clear_placeholder_mappings!
+      straightly_placeholders.clear && sequential_placeholders.clear
     end
   end
 end

data/lib/drawght/version.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+module Drawght
+  VERSION = "1.0.0"
+  RELEASE_DATE = "2025-12-03"
+  CHANGESET = [
+    "New compiler process.",
+    "Refined extension methods have been added.",
+    "Test coverage.",
+    "Syntax revision for nested values in collections.",
+  ]
+end

data/lib/drawght.rb

@@ -1,7 +1,78 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
 module Drawght
+  TOKENS = [
+    PREFIX = '{',
+    SUFFIX = '}',
+    ATTRIBUTE = '.',
+    ITEM = '#',
+    QUERY = ':',
+  ]
+
+  PLACEHOLDERS_PATTERN = Regexp.new "\\#{PREFIX}([^\\#{SUFFIX}]+)\\#{SUFFIX}"
+
+  ATTRIBUTES_PATTERN = Regexp.new "\\#{ATTRIBUTE}|\\#{ITEM}"
+  ATTRIBUTE_PATTERN = Regexp.new "\\#{ATTRIBUTE}"
+  ITEM_PATTERN = Regexp.new "\\#{ITEM}"
+  QUERY_PATTERN = Regexp.new "\\#{QUERY}"
+
+  PATH_PATTERN = Regexp.new "\\#{ATTRIBUTE}|\\#{ITEM}|\\#{QUERY}"
+
+  module Extensions
+    refine Hash do
+      def deep_stringify_keys!
+        transform_keys! do |key|
+          case value = fetch(key)
+          when Hash then value.deep_stringify_keys!
+          when Array then
+            value.map! do |item|
+              (item.is_a? Hash) ? item.deep_stringify_keys! : item
+            end
+          end
+
+          key.to_s
+        end
+
+        self
+      end
+
+      def ditch *pathkeys
+        if i = pathkeys.index('&')
+          list, subpath = pathkeys[0..i - 1], pathkeys[i + 1..-1]
+          dig(*list).map{ |item| item.ditch *subpath }
+        else
+          dig *pathkeys
+        end
+      rescue => error
+        error.message += "The pathkeys \"#{pathkeys.join ','}\" is a not valid path"
+        raise error
+      end
+    end
+
+    refine Array do
+      def add item
+        push item unless include? item
+        self
+      end
+    end
+
+    refine String do
+      def to_placeholder
+        "#{PREFIX}#{self}#{SUFFIX}"
+      end
+    end
+  end
+
   require_relative "drawght/parser"
+  require_relative "drawght/compiler"
+  require_relative "drawght/version"
+
+  def self.load_template(template)
+    Compiler.new template
+  end
 
-  def self.new(template)
-    Drawght::Parser.new template
+  def self.compile(template, data)
+    load_template(template).compile data
   end
 end

metadata

@@ -1,34 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: drawght
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Hallison Batista
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-11 00:00:00.000000000 Z
+date: 2025-12-03 00:00:00.000000000 Z
 dependencies: []
 description: |
+  Drawght v1.0.0 (2025-12-03)
+
   Drawght is a data handler for texts without logical statements. The goal is
   to use a dataset (such as the subject of a text) to draft a document
   template. It can be considered a mini template processor.
+
+  Latest changes:
+
+  - New compiler process.
+  - Refined extension methods have been added.
+  - Test coverage.
+  - Syntax revision for nested values in collections.
 email: email@hallison.dev.br
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.yaml
 - LICENSE
 - README.md
-- drawght.gemspec
 - lib/drawght.rb
+- lib/drawght/compiler.rb
+- lib/drawght/mapper.rb
 - lib/drawght/parser.rb
-homepage: https://github.com/drawght/drawght-ruby
+- lib/drawght/version.rb
+homepage: https://drawght.github.io
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -43,8 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Drawght parser implementation in Ruby.
 test_files: []

data/drawght.gemspec

@@ -1,30 +0,0 @@
-Gem::Specification.new do |spec|
-  spec.name      = "drawght"
-  spec.summary   = "Drawght parser implementation in Ruby."
-  spec.authors   = ["Hallison Batista"]
-  spec.email     = "email@hallison.dev.br"
-  spec.homepage  = "https://github.com/drawght/drawght-ruby"
-  spec.version   = %x(git describe --tags --abbrev=0)
-  spec.date      = %x(git log --format='%as' --max-count=1)
-  spec.licenses  = ["MIT"]
-  spec.platform  = Gem::Platform::RUBY
-
-  spec.files = %x(git ls-files).split.reject do |out|
-    ignore = out =~ /([MR]ake|Gem)file/ || out =~ /^\./
-    ignore = ignore || out =~ /example\..*/
-    ignore = ignore || out =~ %r{^doc/api} || out =~ %r{^test/.*}
-    ignore
-  end
-
-  spec.test_files = spec.files.select do |path|
-    path =~ %r{^test/.*}
-  end
-
-  spec.description = <<-end.gsub /^[ ]{4}/m, ""
-    Drawght is a data handler for texts without logical statements. The goal is
-    to use a dataset (such as the subject of a text) to draft a document
-    template. It can be considered a mini template processor.
-  end
-
-  spec.require_paths = ["lib"]
-end