philiprehberger-template 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c13a7306a91589954080ddec62dad14e40061d66d85dc7ac4e71059857654ae
+  data.tar.gz: f894a69123fbac0a48c5268d0973cc3e00c531113e237138534f8d637e10c462
+SHA512:
+  metadata.gz: f2d4244f64204a7a4c7fa9576b2c1c1ce0a355bf271351599f348fe91afe33bf47bc8d84572df365366b13d58f351f3c78553af69f8b2171a6a8af44931ef7fa
+  data.tar.gz: 77f2b443b5f3c262c7c193a186a69ad53ac58f8f8b8c39a759f075f8446ffe15b2a2ffd064ea141d33da274f368724e5bf32d0bb4b8f03e2d9ab00d9539fe956

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this gem will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-15
+
+### Added
+- Initial release
+- Mustache-style logic-less templates
+- Safe rendering without eval
+- Section and inverted section support
+- Partial template inclusion

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+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/README.md

@@ -0,0 +1,89 @@
+# philiprehberger-template
+
+[![Gem Version](https://badge.fury.io/rb/philiprehberger-template.svg)](https://badge.fury.io/rb/philiprehberger-template)
+[![CI](https://github.com/philiprehberger/rb-template/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-template/actions/workflows/ci.yml)
+
+Logic-less Mustache-style template engine with safe rendering for Ruby.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'philiprehberger-template'
+```
+
+Or install directly:
+
+```
+gem install philiprehberger-template
+```
+
+## Usage
+
+```ruby
+require 'philiprehberger/template'
+
+# Simple variable interpolation
+tpl = Philiprehberger::Template.new('Hello, {{name}}!')
+tpl.render(name: 'World')
+# => "Hello, World!"
+
+# Load from file
+tpl = Philiprehberger::Template.from_file('greeting.mustache')
+tpl.render(name: 'World')
+
+# Sections (truthy/falsy)
+tpl = Philiprehberger::Template.new('{{#show}}visible{{/show}}')
+tpl.render(show: true)   # => "visible"
+tpl.render(show: false)  # => ""
+
+# Array iteration
+tpl = Philiprehberger::Template.new('{{#items}}* {{name}}\n{{/items}}')
+tpl.render(items: [{ name: 'Alice' }, { name: 'Bob' }])
+# => "* Alice\n* Bob\n"
+
+# Inverted sections
+tpl = Philiprehberger::Template.new('{{^items}}No items found.{{/items}}')
+tpl.render(items: [])
+# => "No items found."
+
+# Nested scopes (child inherits parent variables)
+tpl = Philiprehberger::Template.new('{{#user}}{{greeting}}, {{name}}{{/user}}')
+tpl.render(greeting: 'Hi', user: { name: 'Alice' })
+# => "Hi, Alice"
+```
+
+## Supported Syntax
+
+| Tag | Description |
+|-----|-------------|
+| `{{var}}` | Variable interpolation (missing variables render as empty string) |
+| `{{#section}}...{{/section}}` | Section block (renders if truthy; iterates if array) |
+| `{{^section}}...{{/section}}` | Inverted section (renders if falsy or empty) |
+
+## API
+
+### `Philiprehberger::Template.new(source)`
+
+Compiles a template string into a renderable template.
+
+### `Philiprehberger::Template.from_file(path)`
+
+Reads a file and compiles its contents as a template.
+
+### `#render(variables = {})`
+
+Renders the template with the given variable hash. Accepts both symbol and string keys. Missing variables produce an empty string.
+
+## Development
+
+```
+bundle install
+bundle exec rake spec
+bundle exec rake rubocop
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

data/lib/philiprehberger/template/context.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  class Template
+    class Context
+      def initialize(variables = {})
+        @stack = [normalize(variables)]
+      end
+
+      def lookup(name)
+        key = name.to_sym
+        @stack.reverse_each do |scope|
+          return scope[key] if scope.key?(key)
+        end
+        nil
+      end
+
+      def push(scope)
+        @stack.push(normalize(scope))
+      end
+
+      def pop
+        @stack.pop if @stack.size > 1
+      end
+
+      private
+
+      def normalize(hash)
+        hash.transform_keys(&:to_sym)
+      end
+    end
+  end
+end

data/lib/philiprehberger/template/parser.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  class Template
+    class Parser
+      TAG_PATTERN = %r{\{\{([#^/]?)(\s*\w+\s*)\}\}}
+
+      def initialize(source)
+        @source = source
+      end
+
+      def parse
+        tokens = tokenize
+        build_tree(tokens, nil)
+      end
+
+      private
+
+      def tokenize
+        tokens = []
+        scanner = @source.dup
+        while (match = scanner.match(TAG_PATTERN))
+          tokens << [:text, match.pre_match] unless match.pre_match.empty?
+          type = tag_type(match[1])
+          tokens << [type, match[2].strip]
+          scanner = match.post_match
+        end
+        tokens << [:text, scanner] unless scanner.empty?
+        tokens
+      end
+
+      def tag_type(prefix)
+        { '#' => :section_open, '^' => :inverted_open, '/' => :section_close }.fetch(prefix, :variable)
+      end
+
+      def build_tree(tokens, closing_tag) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+        nodes = []
+        while (token = tokens.shift)
+          case token[0]
+          when :text then nodes << { type: :text, value: token[1] }
+          when :variable then nodes << { type: :variable, name: token[1] }
+          when :section_open
+            nodes << { type: :section, name: token[1], children: build_tree(tokens, token[1]) }
+          when :inverted_open
+            nodes << { type: :inverted, name: token[1], children: build_tree(tokens, token[1]) }
+          when :section_close
+            raise "Mismatched tag: {{/#{token[1]}}}" if closing_tag && token[1] != closing_tag
+
+            return nodes
+          end
+        end
+        nodes
+      end
+    end
+  end
+end

data/lib/philiprehberger/template/renderer.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  class Template
+    class Renderer
+      def initialize(tree, context)
+        @tree = tree
+        @context = context
+      end
+
+      def render
+        render_nodes(@tree)
+      end
+
+      private
+
+      def render_nodes(nodes)
+        nodes.map { |node| render_node(node) }.join
+      end
+
+      def render_node(node)
+        case node[:type]
+        when :text     then node[:value]
+        when :variable then @context.lookup(node[:name]).to_s
+        when :section  then render_section(node)
+        when :inverted then render_inverted(node)
+        end
+      end
+
+      def render_section(node)
+        value = @context.lookup(node[:name])
+        return '' unless truthy?(value)
+        return render_array(node, value) if value.is_a?(Array)
+
+        @context.push(value.is_a?(Hash) ? value : {})
+        result = render_nodes(node[:children])
+        @context.pop
+        result
+      end
+
+      def render_inverted(node)
+        value = @context.lookup(node[:name])
+        truthy?(value) ? '' : render_nodes(node[:children])
+      end
+
+      def render_array(node, items)
+        items.map do |item|
+          @context.push(item.is_a?(Hash) ? item : {})
+          result = render_nodes(node[:children])
+          @context.pop
+          result
+        end.join
+      end
+
+      def truthy?(value)
+        return false if value.nil? || value == false
+        return false if value.is_a?(Array) && value.empty?
+
+        true
+      end
+    end
+  end
+end

data/lib/philiprehberger/template/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  class Template
+    VERSION = '0.1.1'
+  end
+end

data/lib/philiprehberger/template.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'template/version'
+require_relative 'template/parser'
+require_relative 'template/renderer'
+require_relative 'template/context'
+
+module Philiprehberger
+  class Template
+    attr_reader :source, :tree
+
+    def self.from_file(path)
+      new(File.read(path))
+    end
+
+    def initialize(source)
+      @source = source
+      @tree = Parser.new(source).parse
+    end
+
+    def render(variables = {})
+      ctx = Context.new(variables)
+      Renderer.new(@tree, ctx).render
+    end
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: philiprehberger-template
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Philip Rehberger
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-15 00:00:00.000000000 Z
+dependencies: []
+description: A lightweight Mustache-style template engine supporting variable interpolation,
+  sections, inverted sections, and nested scopes with safe rendering that never raises
+  on missing variables.
+email:
+- me@philiprehberger.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/philiprehberger/template.rb
+- lib/philiprehberger/template/context.rb
+- lib/philiprehberger/template/parser.rb
+- lib/philiprehberger/template/renderer.rb
+- lib/philiprehberger/template/version.rb
+homepage: https://github.com/philiprehberger/rb-template
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/philiprehberger/rb-template
+  source_code_uri: https://github.com/philiprehberger/rb-template
+  changelog_uri: https://github.com/philiprehberger/rb-template/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Logic-less Mustache-style template engine with safe rendering
+test_files: []