drawght 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 776b1ea99f39fc1716543bd837504d10ca2648babb6e283c0bbf0dcc6db10b5f
-  data.tar.gz: 0aa2b64aaa564b8194266ac18d37627ae384ba3cf4e39d7ad84a3a5c342ef36c
+  metadata.gz: 9ed4619bbd991ccf58bd7e7c89407879181c656e98667b933a25cdf751a9c273
+  data.tar.gz: ae541e430afcc2ee112cd78d0549767845fbb1a8def0204de1d29e4db14baef9
 SHA512:
-  metadata.gz: 73a0b217f9ba7ecca5aaad07a182bc9756714245bd12af06a75b288b781f62bbbb6cce10013dcbcce66cc4e7a3631f62c07ed7ea9a0a50edf4525eb29dd3fd45
-  data.tar.gz: 96895069175bf3326d10e4a40f6276120043b650d77211ed00dca259c00f4ddedeaa2d28622c35a70c12e15c02a42db5e4dd1dbda936ae1d2398b3b8c092cf0b
+  metadata.gz: 704e351d12da61369698dd568740d3943ee9542ac01c3d5e52c9bad514063ea6e1d395ba503df518a91605d44fb1bb7df0b68893527fa036ea74132d6680cafa
+  data.tar.gz: e10c78a814d001c3c7baa5eec7b748c5e34256b4a1dc7206d109372ec815279ba658f2ed1017838e7e233bf62befbe847b9df1af9fa4a4bc7b74090c9651b40a

data/CHANGELOG.yaml

@@ -0,0 +1,32 @@
+- version: 1.1.0
+  date: 2025-12-22
+  summary:
+    Syntax validation and new expression.
+  changes:
+  - Syntax validation.
+  - Refined extension methods have been moved to their respective modules.
+  - Syntax for getting the length of a collection.
+
+- 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,389 @@
-# 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 (like draft/draught) 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:
+
+- `{identifier}`: converts `identifier` to its respective value. If the value
+  is a collection, then the row will be replicated and converted with the
+  respective values.
+
+- `{structure.attribute}`: converts `attribute` to its respective value inside
+  `structure`, assuming the same behavior as `{identifier}`.
+
+- `{collection:attribute}`: selects `collection`, replicates the line for each
+  item in the collection, and converts `attribute` to its respective value
+  contained in an structure within `collection`. The `collection` key can also
+  be accessed by `structure.collection`, just as `attribute` can also be
+  accessed by `structure.attribute` which will be converted following the same
+  process in case it is a collection.
+
+- `{collection#nth.attribute}`: selects the `nth` (start from 1) item from
+  `collection` and converts `attribute` to its respective value. The whole
+  process is similar to `structure.attribute`.
+
+- `{collection#$.attribute}`: selects the `nth` (start from 1) item from
+  `collection` and converts `attribute` to its respective value. The whole
+  process is similar to `structure.attribute`.
+
+### EBNF
+
+```ebnf
+identifier ::= initial_name { compound_name | space compound_name } ;
+
+initial_name ::= letter | "_" ;
+
+compound_name ::= letter | digit | "_" | "-" ;
+
+letter ::= "A"…"Z" | "a"…"z" ;
+
+digit ::= "0"…"9" ;
+
+space ::= " " ;
+
+expression ::= path [ length ] ;
+
+path ::= [ structural_path ] { sequential_path } ;
+
+structural_path ::= attribute { "." attribute } ;
+
+scoped_path ::= ":" structural_path ;
+
+attribute ::= element | item ;
+
+element ::= identifier [ index ] ;
+
+item ::= index ;
+
+index ::= "#" ( number | "$" ) ;
+
+number ::= digit { digit } ;
+
+length ::= "#&" ;
+```
+
+## 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,94 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+module Drawght
+
+module HashExtensions
+  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
+  end
+end
+
+class Compiler
+  using HashExtensions
+
+  include Parser
+  include Tracker
+
+  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 has_placeholders? line
+
+      mapping_placeholders_from line
+
+      newline = convert_structural_placeholders_from line
+
+      convert_sequential_placeholders_from newline
+    end
+
+    result.replace lines.join
+  end
+
+  def convert_structural_placeholders_from string
+    structural_placeholders.reduce string.dup do |template, expression|
+      matter = pathing dataset, *pathkeys_from(expression)
+
+      converted = [matter].flatten.map do |value|
+        template.dup.gsub! pathize(expression), 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 = pathing dataset, *pathkeys_from(attribute)
+
+      converted = matter.map do |values|
+        mappings.inject template.dup do |partial, (expression, key)|
+          value = pathing(values, *pathkeys_from(key)) || key
+          partial.dup.gsub! pathize(expression), 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,201 @@
-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})?$"
-
-  def initialize(template)
-    @template = template
+module Drawght
+  module ArrayExtensions
+    refine Array do
+      def add_unique item
+        push item unless include? item
+        self
+      end
+    end
   end
 
-  def parse(data)
-    self.parse_keys(self.parse_queries(@template, data), data)
-  end
+  module Parser
+    using ArrayExtensions
 
-  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"))
-        end
+    TOKENS = [
+      PREFIX = '{',
+      SUFFIX = '}',
+      ACCESSOR = '.',
+      INDEX = '#',
+      SCOPE = ':',
+      CONTEXT = '@',
+      LAST = '$',
+      LENGTH = '&',
+    ]
+
+    # Identifiers/name matches:
+    #
+    # - "name"
+    # - "variable name"
+    # - "variable-name"
+    # - "variable_name"
+    # - "_name_"
+    # - "name_"
+    # - "_name"
+    IDENTIFIER_MATCHES = "[A-Za-z_][A-Za-z0-9_\\-]*(?: [A-Za-z0-9_\\-]+)*"
+
+    # Index/item matches:
+    #
+    # - "#1" for first item.
+    # - "#n" for n-th item.
+    # - "#$" for last item.
+    INDEX_MATCHES = "\\#{INDEX}(?:\\d+|\\#{LAST})"
+
+    # Element matches:
+    #
+    # - "items#1" for first named item.
+    # - "items#n" for n-th named item.
+    # - "items#$" for last named item.
+    #
+    # Matches with IDENTIFIER_MATCHES and INDEX_MATCHES.
+    ELEMENT_MATCHES = "#{IDENTIFIER_MATCHES}(?:#{INDEX_MATCHES})?"
+
+    # Attribute matches.
+    ATTRIBUTE_MATCHES = "\\#{ACCESSOR}(?:#{ELEMENT_MATCHES})"
+
+    # Validation
+    #
+    # Structural matches:
+    #
+    # - "struct.attribute" for attribute value from struct.
+    # - "struct.substruct.attribute" for attribute value of the substruct from
+    #   struct.
+    # - "struct.items#1" for first item value in items of the struct.
+    # - "struct.items#1.attribute" for attribute value of the first item in
+    #   items of the struct.
+    # - "#1.attribute" for attribute value of the first item.
+    # - "#1.struct.attribute" for attribute value of the struct from the first item.
+    # - "items#1.attribute" for attribute value of the first item in items.
+    # - "items#1.struct.attribute" for attribute value of the struct of the
+    #   first item in items.
+    # - "items#1.subitems#1" for subitem value of the first item in items.
+    # - "items#1.subitems#1.attribute" for attribute value of the subitem from
+    #   first item in items.
+    #
+    # Scoped matches:
+    #
+    # ":attribute"
+    # ":collection:attribute"
+    # "collection:attribute"
+    # "collection:subcollection:attribute"
+    # "items#1:attribute"
+    # "struct.collection:attribute"
+    # "items#1.collection:attribute"
+    # "items#1.subitems#1:attribute"
+    # "items#1.subitems#1.collection:attribute"
+    # "struct.collection:noitcelloc.tcurts:attribute"
+    VALIDATION_PATTERN = Regexp.new "^(?=.*[A-Za-z_\\#{INDEX}])(?:(?:#{ELEMENT_MATCHES}|#{INDEX_MATCHES})(?:#{ATTRIBUTE_MATCHES})*)?(?:\\#{SCOPE}(?:#{ELEMENT_MATCHES})(?:#{ATTRIBUTE_MATCHES})*)*(?:\\#{INDEX}\\#{LENGTH})?$"
+
+    PLACEHOLDERS_PATTERN = Regexp.new "\\#{PREFIX}([^\\#{SUFFIX}]+)\\#{SUFFIX}"
+    STRUCTURE_TOKEN_PATTERN = Regexp.new "(\\#{ACCESSOR}|\\#{INDEX}|\\#{LENGTH}$)"
+    SCOPE_TOKEN_PATTERN = Regexp.new "(\\#{SCOPE})"
+    SCOPE_PATH_PATTERN = Regexp.new "^(.*)#{SCOPE_TOKEN_PATTERN}(.*)$"
+
+    NUMBER_PATTERN = /^\d+/
+
+    using ArrayExtensions
+
+    class SyntaxError < StandardError
+      def initialize syntax
+        super "Invalid syntax for \"#{syntax}\""
       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 pathkeys_from string
+      raise SyntaxError.new string unless syntax_valid? string
 
-  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")
-      else
-        result = result.gsub(template_key, value.to_s)
+      path = case string
+        when STRUCTURE_TOKEN_PATTERN then
+          pathkeys_for_structure string
+        when SCOPE_TOKEN_PATTERN then
+          pathkeys_for_collection string
+        else
+          [string]
       end
+
+      path.flatten
     end
-    result
-  end
 
-  private
+    def syntax_valid? string
+      string.match? VALIDATION_PATTERN
+    end
+
+    def placeholders_from string
+      return [] unless string =~ PLACEHOLDERS_PATTERN
+
+      string.scan(PLACEHOLDERS_PATTERN).flatten
+    end
+
+    def mapping_placeholders_from string
+      clear_placeholder_mappings!
+
+      placeholders_from(string).map do |placeholder|
+        if placeholder =~ SCOPE_TOKEN_PATTERN
+          placeholder.scan SCOPE_PATH_PATTERN do |pathkeys, _delimiter, attribute|
+            (sequential_placeholders[pathkeys] ||= {}).update placeholder => attribute
+          end
+        else
+          structural_placeholders.add_unique placeholder
+        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]
+        placeholder
       end
-    else
-      data.dig *nested_key.split(ATTRIBUTE)
+    end
+
+    def structural_placeholders
+      @structural_placeholders ||= []
+    end
+
+    def sequential_placeholders
+      @sequential_placeholders ||= {}
+    end
+
+    def has_placeholders? string
+      string.match? PLACEHOLDERS_PATTERN
+    end
+
+    def pathize string
+      "#{PREFIX}#{string}#{SUFFIX}"
+    end
+
+    private
+
+    def pathkeys_for_structure placeholder
+      placeholder
+        .split(STRUCTURE_TOKEN_PATTERN)
+        .reject{ |expression| [ACCESSOR, INDEX].include? expression }
+        .map do |expression|
+          value = zeroize expression
+
+          if value =~ SCOPE_TOKEN_PATTERN
+            pathkeys_for_collection expression
+          else
+            value =~ NUMBER_PATTERN ? value.to_i - 1 : expression unless value.empty?
+          end
+        end.compact
+    end
+
+    def zeroize value, token: LAST
+      value.to_s.sub token, '0'
+    end
+
+    def pathkeys_for_collection placeholder
+      placeholder.split(SCOPE_TOKEN_PATTERN).map do |expression|
+        case expression.to_s
+        when STRUCTURE_TOKEN_PATTERN then
+          pathkeys_for_structure expression
+        when SCOPE then
+          CONTEXT
+        else
+          expression
+        end
+      end
+    end
+
+    def clear_placeholder_mappings!
+      structural_placeholders.clear && sequential_placeholders.clear
     end
   end
 end

data/lib/drawght/tracker.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+module Drawght
+
+module Tracker
+  LENGTH = Parser::LENGTH
+  CONTEXT = Parser::CONTEXT
+
+  def pathing hash, *pathkeys
+    if i = pathkeys.index CONTEXT
+      prefixes, suffixes = pathkeys.slice(0..i - 1), pathkeys.slice(i + 1..-1)
+      result = pathing(hash, *prefixes).map{ |item| pathing item, *suffixes }
+      suffixes.last == LENGTH ? result.reduce(&:+) : result
+    elsif pathkeys.last == LENGTH
+      hash.dig(*pathkeys.slice(0..-2)).length
+    else
+      hash.dig *pathkeys
+    end
+  rescue => error
+    raise error, "The pathkeys \"#{pathkeys.join ' '}\" is a not valid path"
+  end
+end
+
+end # Drawght

data/lib/drawght/version.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module Drawght
+  VERSION = "1.1.0"
+  RELEASE_DATE = "2025-12-22"
+  CHANGESET = [
+    "Syntax validation.",
+    "Refined extension methods have been moved to their respective modules.",
+    "Syntax for getting the length of a collection.",
+  ]
+end

data/lib/drawght.rb

@@ -1,7 +1,17 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
 module Drawght
   require_relative "drawght/parser"
+  require_relative "drawght/tracker"
+  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.1.0
 platform: ruby
 authors:
 - Hallison Batista
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-11 00:00:00.000000000 Z
+date: 2025-12-22 00:00:00.000000000 Z
 dependencies: []
 description: |
+  Drawght v1.1.0 (2025-12-22)
+
   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:
+
+  - Syntax validation.
+  - Refined extension methods have been moved to their respective modules.
+  - Syntax for getting the length of a collection.
 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/tracker.rb
+- 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.
+summary: Drawght 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