component_embedded_ruby 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 834b63b9cc7bf826b998ff5397391e477001e549da31d058243745db63d633e4
+  data.tar.gz: 6742bc330ce2dd5b9fdce7325759338bc966cc016955ca2156ee44e2187e1187
+SHA512:
+  metadata.gz: 24c07b6614384d476903ab99d892373625cf017b3428c6a5ba2b00a328f07b0dd614ce178235e23d4a333662379719acdef3dc5f28be74eb0d1e68f4144e4cf8
+  data.tar.gz: 181d8e02bc4746860064231b6e19cc834c1b550c0c686aca1f12703bda0894030d9e1c444c2b104edec7e364606a675b8746e789331e52789c807ec2c812a3f7

data/.github/workflows/ruby.yml

@@ -0,0 +1,20 @@
+name: Ruby
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: 2.6.x
+    - name: Build and test with Rake
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+        bundle exec rake

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+test/test_application/tmp
+test/test_application/log

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.0
+before_install: gem install bundler -v 1.17.2

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gem "rails", github: "rails/rails"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,160 @@
+GIT
+  remote: https://github.com/rails/rails
+  revision: 7e2d8434ed42d6fbf7f4743d033d50ad92ebe4da
+  specs:
+    actioncable (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailbox (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      activejob (= 6.1.0.alpha)
+      activerecord (= 6.1.0.alpha)
+      activestorage (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      mail (>= 2.7.1)
+    actionmailer (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      actionview (= 6.1.0.alpha)
+      activejob (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (6.1.0.alpha)
+      actionview (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      rack (~> 2.0, >= 2.0.9)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      activerecord (= 6.1.0.alpha)
+      activestorage (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      nokogiri (>= 1.8.5)
+    actionview (6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      globalid (>= 0.3.6)
+    activemodel (6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+    activerecord (6.1.0.alpha)
+      activemodel (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+    activestorage (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      activejob (= 6.1.0.alpha)
+      activerecord (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      marcel (~> 0.3.1)
+      mimemagic (~> 0.3.2)
+    activesupport (6.1.0.alpha)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    rails (6.1.0.alpha)
+      actioncable (= 6.1.0.alpha)
+      actionmailbox (= 6.1.0.alpha)
+      actionmailer (= 6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      actiontext (= 6.1.0.alpha)
+      actionview (= 6.1.0.alpha)
+      activejob (= 6.1.0.alpha)
+      activemodel (= 6.1.0.alpha)
+      activerecord (= 6.1.0.alpha)
+      activestorage (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      bundler (>= 1.15.0)
+      railties (= 6.1.0.alpha)
+      sprockets-rails (>= 2.0.0)
+    railties (6.1.0.alpha)
+      actionpack (= 6.1.0.alpha)
+      activesupport (= 6.1.0.alpha)
+      method_source
+      rake (>= 0.8.7)
+      thor (~> 1.0)
+
+PATH
+  remote: .
+  specs:
+    component_embedded_ruby (0.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    builder (3.2.4)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.7)
+    crass (1.0.6)
+    erubi (1.9.0)
+    globalid (0.4.2)
+      activesupport (>= 4.2.0)
+    i18n (1.8.5)
+      concurrent-ruby (~> 1.0)
+    loofah (2.7.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    mail (2.7.1)
+      mini_mime (>= 0.1.1)
+    marcel (0.3.3)
+      mimemagic (~> 0.3.2)
+    method_source (0.9.2)
+    mimemagic (0.3.5)
+    mini_mime (1.0.2)
+    mini_portile2 (2.4.0)
+    minitest (5.11.3)
+    nio4r (2.5.4)
+    nokogiri (1.10.10)
+      mini_portile2 (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rack (2.2.3)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.3.0)
+      loofah (~> 2.3)
+    rake (13.0.1)
+    sprockets (4.0.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.2)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    thor (1.0.1)
+    tzinfo (2.0.2)
+      concurrent-ruby (~> 1.0)
+    view_component (2.20.0)
+      activesupport (>= 5.0.0, < 7.0)
+    websocket-driver (0.7.3)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    zeitwerk (2.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.17)
+  component_embedded_ruby!
+  minitest (~> 5.0)
+  pry (~> 0.12.2)
+  rails!
+  rake (~> 13.0)
+  view_component (> 2.15)
+
+BUNDLED WITH
+   1.17.3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Blake Williams
+
+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,80 @@
+# Component Embedded Ruby
+
+Strict HTML templating with support for components.
+
+### Features:
+
+* Strict HTML parsing. eg: matching end tags are enforced
+* HTML attributes are either static, or dynamic. No more `class="hello <%=
+    extra_classes %>`, instead this logic should be pushed up to components.
+* Component rendering has a single dependency, a `render` method being present
+  in the rendering context.
+* Easy Rails integration by registering `crb` as a template handler.
+
+### Usage
+
+Define a template:
+
+```ruby
+<h1>
+  <Capitalization upcase={true}>hello world</Capitalization>
+</h1>
+```
+
+Define a component
+
+```ruby
+class Capitalization
+  def initialize(upcase: false)
+    @upcase = upcase
+  end
+
+  def render_in(_view_context)
+    children = yield
+
+    if @upcase
+      children.upcase
+    else
+      children
+    end
+  end
+end
+```
+
+Render it
+
+```ruby
+ComponentEmbeddedRuby.render(template_string)
+```
+
+See results
+
+
+```html
+<h1>HELLO WORLD</h1>
+```
+
+If trying to render outside of a Rails environment, ensure that the binding
+passed to the renderer has a top-level `render` method that can accept component
+instances and convert them to strings.
+
+
+e.g. the most basic example could look like this:
+
+```ruby
+def render(renderable, &block)
+  # This assumes components being rendered utilize `to_s` to render their
+  # templates
+  renderable.to_s(&block)
+end
+```
+
+For more examples, check out the `ComponentEmbeddedRuby::Renderable` tests.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/BlakeWilliams/component_embedded_ruby.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "component_embedded_ruby"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/component_embedded_ruby.gemspec

@@ -0,0 +1,42 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "component_embedded_ruby/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "component_embedded_ruby"
+  spec.version       = ComponentEmbeddedRuby::VERSION
+  spec.authors       = ["Blake Williams"]
+  spec.email         = ["blake@blakewilliams.me"]
+
+  spec.summary       = %q{HTML templates with embedded Ruby components}
+  spec.description   = %q{HTML templates with embedded Ruby components}
+  spec.homepage      = "https://github.com/blakewilliams/component_embedded_ruby"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["homepage_uri"] = spec.homepage
+    spec.metadata["source_code_uri"] = "https://github.com/blakewilliams/component_embedded_ruby"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.17"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rails", "> 6.0"
+  spec.add_development_dependency "view_component", "> 2.15"
+  spec.add_development_dependency "pry", "~> 0.12.2"
+end

data/lib/component_embedded_ruby.rb

@@ -0,0 +1,12 @@
+require "component_embedded_ruby/version"
+require "component_embedded_ruby/lexer"
+require "component_embedded_ruby/parser"
+require "component_embedded_ruby/eval"
+require "component_embedded_ruby/node"
+require "component_embedded_ruby/renderer"
+require "component_embedded_ruby/template"
+require "component_embedded_ruby/unexpected_token_error"
+
+module ComponentEmbeddedRuby
+  class Error < StandardError; end
+end

data/lib/component_embedded_ruby/eval.rb

@@ -0,0 +1,18 @@
+module ComponentEmbeddedRuby
+  class Eval
+    attr_reader :value, :output
+
+    def initialize(value, output: true)
+      @value = value
+      @output = output
+    end
+
+    def eval(binding)
+      binding.instance_eval(value)
+    end
+
+    def ==(other)
+      other.value == value
+    end
+  end
+end

data/lib/component_embedded_ruby/lexer.rb

@@ -0,0 +1,145 @@
+require "component_embedded_ruby/lexer/input_reader"
+
+module ComponentEmbeddedRuby
+  class Lexer
+    Token = Struct.new(:type, :value, :position)
+    Position = Struct.new(:line, :column)
+
+    def initialize(content)
+      @reader = InputReader.new(content)
+
+      @tokens = []
+    end
+
+    def lex
+      while !reader.eof?
+        char = reader.current_char
+
+        if char == "<"
+          add_token(:open_carrot, "<")
+          reader.next
+        elsif char == ">"
+          add_token(:close_carrot, ">")
+          reader.next
+        elsif char == "="
+          add_token(:equals, "=")
+          reader.next
+        elsif char == "\""
+          add_token(:string, read_quoted_string)
+        elsif char == "/"
+          add_token(:slash, "/")
+          reader.next
+        elsif char == "{"
+          if reader.peek == "-"
+            reader.next
+            add_token(:ruby_no_eval, read_ruby_string)
+          else
+            add_token(:ruby, read_ruby_string)
+          end
+        elsif is_letter?(char)
+          if @tokens[-1]&.type == :close_carrot
+            add_token(:string, read_body_string)
+          else
+            add_token(:identifier, read_string)
+          end
+        else
+          reader.next
+        end
+      end
+
+      @tokens
+    end
+
+    private
+
+    attr_reader :reader
+    attr_accessor :position
+
+    def add_token(type, value)
+      token = Token.new(type, value, Position.new(reader.current_line, reader.current_column))
+      @tokens << token
+    end
+
+    def read_string
+      string = ""
+
+      while is_letter?(reader.current_char) && !reader.eof?
+        string += reader.current_char
+        reader.next
+      end
+
+      string
+    end
+
+    def read_quoted_string
+      string = ""
+
+      # Get past initial "
+      reader.next
+
+      while !unescaped_quote?
+        raise "unterminated string" if reader.eof?
+        string += reader.current_char
+        reader.next
+      end
+
+      # Get past last "
+      reader.next
+
+      string
+    end
+
+    def read_body_string
+      string = ""
+
+      while reader.current_char != "<" && reader.current_char != "{"
+        raise "unterminated content" if reader.eof?
+
+        string += reader.current_char
+        reader.next
+      end
+
+      string
+    end
+
+    def read_ruby_string
+      inner_string_count = 0
+      inner_bracket_count = 0
+
+      string = ""
+
+      reader.next
+
+      previous_token = nil
+
+      loop do
+        break if inner_bracket_count == 0 && inner_string_count % 2 == 0 && reader.current_char == "}"
+        char = reader.current_char
+        string += char
+
+        # TODO handle " and ' separately
+        if inner_string_count % 2 == 0 && char == "{"
+          inner_bracket_count += 1
+        elsif inner_string_count % 2 == 0 && char == "}"
+          inner_bracket_count -= 1
+        elsif previous_token != "\\" && char == "\"" || char == "'"
+          inner_string_count -= 1
+        end
+
+        previous_token = char
+        reader.next
+      end
+
+      string
+    end
+
+    def unescaped_quote?
+      reader.current_char == "\"" && reader.peek_behind != "\\"
+    end
+
+    def is_letter?(char)
+      ascii = char.ord
+      (ascii >= 48 && ascii <= 57) || (ascii >= 65 && ascii <= 122) || ascii == 45 || ascii == 95 || ascii == 58
+    end
+  end
+end

data/lib/component_embedded_ruby/lexer/input_reader.rb

@@ -0,0 +1,46 @@
+module ComponentEmbeddedRuby
+  class Lexer
+    class InputReader
+      attr_reader :current_line, :current_column
+
+      def initialize(input)
+        @input = input.freeze
+        @position = 0
+
+        @current_line = 0
+        @current_column = 0
+      end
+
+      def eof?
+        @position == @input.length
+      end
+
+      def current_char
+        input[@position]
+      end
+
+      def peek
+        @input[@position + 1]
+      end
+
+      def peek_behind
+        @input[@position - 1]
+      end
+
+      def next
+        if current_char == "\n"
+          @current_line += 1
+          @current_column = 0
+        else
+          @current_column += 1
+        end
+
+        @position += 1
+      end
+
+      private
+
+      attr_reader :input
+    end
+  end
+end

data/lib/component_embedded_ruby/node.rb

@@ -0,0 +1,44 @@
+module ComponentEmbeddedRuby
+  class Node
+    attr_reader :tag, :attributes, :children
+
+    def initialize(tag, attributes, children)
+      @tag = tag
+      @attributes = attributes
+      @children = children
+    end
+
+    def ==(other)
+      if other
+        other.tag == tag && other.attributes == attributes && other.children == children
+      else
+        false
+      end
+    end
+
+    def component_class
+      @_component_class = Object.const_get(tag)
+    end
+
+    # If the tag starts with a capital, we assume it's a component
+    def component?
+      @_component ||= tag && !!/[[:upper:]]/.match(tag[0])
+    end
+
+    def ruby?
+      children.is_a?(Eval)
+    end
+
+    def output_ruby?
+      ruby? && children.output
+    end
+
+    def text?
+      tag.nil? && !ruby?
+    end
+
+    def html?
+      !component? && tag
+    end
+  end
+end

data/lib/component_embedded_ruby/parser.rb

@@ -0,0 +1,15 @@
+require "component_embedded_ruby/parser/base"
+require "component_embedded_ruby/parser/root_parser"
+require "component_embedded_ruby/parser/attribute_parser"
+require "component_embedded_ruby/parser/tag_parser"
+require "component_embedded_ruby/parser/token_reader"
+
+module ComponentEmbeddedRuby
+  module Parser
+    def self.parse(tokens)
+      @token_reader = TokenReader.new(tokens)
+
+      RootParser.new(@token_reader).call
+    end
+  end
+end

data/lib/component_embedded_ruby/parser/attribute_parser.rb

@@ -0,0 +1,50 @@
+module ComponentEmbeddedRuby
+  module Parser
+    # Internal: Parses an HTML tag attributes into a hash of key values
+    #
+    # This class parses HTML attributes into a hash of key values, keys are
+    # always strings but since values can be dynamic, they will either be a
+    # string or an instance of `Eval`.
+    #
+    # Given how we parse these attributes, they are intentionally either a
+    # string or Ruby, not a combination of the two.
+    #
+    # Valid attributes may look like `id="document" class={my_classes}`
+    #
+    # The following is invalid `class="mb-0 {my_classes}"`
+    #
+    class AttributeParser < Base
+      def call
+        attributes = {}
+
+        while current_token.type != :close_carrot && current_token.type != :slash
+          attributes.merge!(parse_attribute)
+        end
+
+        attributes
+      end
+
+      private
+
+      attr_reader :token_reader
+
+      def parse_attribute
+        key = expect(:identifier).value
+        expect(:equals)
+        value = parse_value
+
+        { key => value }
+      end
+
+      def parse_value
+        value_token = expect_any(:string, :ruby)
+
+        if value_token.type == :string
+          value_token.value
+        else
+          Eval.new(value_token.value)
+        end
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/parser/base.rb

@@ -0,0 +1,45 @@
+module ComponentEmbeddedRuby
+  module Parser
+    class Base
+      def initialize(token_reader)
+        @token_reader = token_reader
+      end
+
+      private
+
+      attr_reader :token_reader
+
+      def current_token
+        token_reader.current_token
+      end
+
+      def peek_token
+        token_reader.peek_token
+      end
+
+      def expect(type)
+        token = current_token
+
+        if token.type != type
+          raise UnexpectedTokenError.new(:string, current_token)
+        else
+          token_reader.next
+        end
+
+        token
+      end
+
+      def expect_any(*types)
+        token = current_token
+
+        if !types.include?(token.type)
+          raise UnexpectedTokenError.new(:string, token)
+        else
+          token_reader.next
+        end
+
+        token
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/parser/root_parser.rb

@@ -0,0 +1,51 @@
+module ComponentEmbeddedRuby
+  module Parser
+    # Internal: Used for parsing multiple adjacent tag, string, and emedded
+    # ruby into an array.
+    #
+    # This parser is used to parse top-level documents and the children of
+    # `tag` nodes, which may have any combination of adjacent tag, string, and
+    # ruby nodes.
+    #
+    class RootParser < Base
+      def call
+        results = []
+
+        while current_token
+          if current_token.type == :open_carrot
+            # If we run into a </ we are likely at the end of parsing a tag so
+            # this should return and let the `TagParser` complete parsing
+            #
+            # e.g.
+            # 1. <h1>Hello</h1> would start a `TagParser` after reading <h1
+            # 2. `TagParser` reads <h1>, sees that it has
+            #     children, and will use another instance of `RootParser` to reads its children
+            # 3. The new RootParser reads `Hello`, then runs into `</`, so it should return `["Hello"]`
+            #     and allow the `TagParser` to finish reading `</h1>`
+            if peek_token.type == :slash
+              return results
+            else
+              results << TagParser.new(token_reader).call
+            end
+          elsif current_token.type == :string || current_token.type == :identifier
+            # If we're reading a string, or some other identifier that is on
+            # its own, we can skip instantiating a new parser and parse it directly ourselves
+            results << Node.new(nil, nil, current_token.value)
+            token_reader.next
+          elsif current_token.type == :ruby || current_token.type == :ruby_no_eval
+            # If we run into Ruby code that should be evaluated inside of the
+            # template, we want to create an `Eval`. The compliation step
+            # handles `Eval` objects specially since it's making template
+            # provided ruby code compatibile with the compiled template code.
+            value = Eval.new(current_token.value, output: current_token.type == :ruby)
+
+            results << Node.new(nil, nil, value)
+            token_reader.next
+          end
+        end
+
+        results
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/parser/tag_parser.rb

@@ -0,0 +1,73 @@
+module ComponentEmbeddedRuby
+  module Parser
+    # Internal: Parses an HTML tag into a Node object
+    #
+    # This class is responsible for parsing an HTML element into a node
+    # instance. There are three variations of tags:
+    #
+    # * A self-closing tag e.g. <hr/>
+    # * A tag with no children <img src="/favicon.png"></img>
+    # * A tag with children e.g. <b>bold text!</b>
+    #
+    # A tag with children will delegate back to the `RootParser` since child
+    # elements can be any combination of adjacent tags, strings, and ruby code.
+    #
+    class TagParser < Base
+      def call
+        # Expect opening carrot, e.g. < in <h1>
+        expect(:open_carrot)
+
+        # Expects an identifier, e.g. "h1"
+        tag = expect(:identifier).value
+
+        # Expects 0 or more attributes
+        # e.g. id="hello" in <h1 id="hello">
+        attributes = AttributeParser.new(token_reader).call
+
+        # Is this a self-closing element?
+        if current_token.type == :slash
+          expect(:slash)
+          expect(:close_carrot)
+
+          Node.new(tag, attributes, [])
+        else
+          expect(:close_carrot)
+
+          children = parse_children
+
+          expect(:open_carrot)
+          expect(:slash)
+          close_tag = expect(:identifier).value
+
+          if close_tag != tag
+            raise "Mismatched tags. expected #{tag}, got #{current_token.value}"
+          end
+
+          expect(:close_carrot)
+
+          Node.new(tag, attributes, children)
+        end
+      end
+
+      private
+
+      # If the next two elements are </, we can safely asume it's meant to
+      # close the current tag and lets us avoid having to attempt parsing
+      # children.
+      def has_children?
+        return true if current_token.type != :open_carrot
+        return true if peek_token&.type != :slash
+
+        false
+      end
+
+      def parse_children
+        if has_children?
+          RootParser.new(token_reader).call
+        else
+          []
+        end
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/parser/token_reader.rb

@@ -0,0 +1,22 @@
+module ComponentEmbeddedRuby
+  module Parser
+    class TokenReader
+      def initialize(tokens)
+        @tokens = tokens
+        @position = 0
+      end
+
+      def current_token
+        @tokens[@position]
+      end
+
+      def peek_token
+        @tokens[@position + 1]
+      end
+
+      def next
+        @position += 1
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/renderer.rb

@@ -0,0 +1,85 @@
+module ComponentEmbeddedRuby
+  class Renderer
+    def initialize(nodes, output_var_name: "__crb_out", skip_return: false)
+      @nodes = Array(nodes)
+      @functions = {}
+      @output_var_name = output_var_name
+      @skip_return = skip_return
+    end
+
+    def to_ruby
+      <<~EOF
+        #{output_var_name} = '';
+
+        #{nodes.map(&method(:render)).join("\n")}
+
+        #{output_var_name if !@skip_return};
+      EOF
+    end
+
+    private
+
+    def render(node)
+      if node.component?
+        <<~EOF
+          #{children_to_ruby(node)}
+          #{output_var_name}.<< render(#{node.component_class}.new(#{attributes_for_component(node).join(",")})) { |component|
+             __c_#{node.hash.to_s.gsub("-", "_")}
+          };
+        EOF
+      elsif node.ruby?
+        if node.output_ruby?
+          "#{output_var_name}.<< (#{node.children.value}).to_s;\n"
+        else
+          "#{node.children.value};\n"
+        end
+      elsif node.text?
+        "#{output_var_name}.<< \"#{node.children}\";\n"
+      elsif node.html?
+        <<~EOF
+          #{output_var_name}.<< \"<#{node.tag}\";
+          #{attributes_for_tag(node).join("\n")};
+          #{output_var_name}.<< \">\";
+          #{node.children.map(&method(:render)).join("\n")}
+          #{output_var_name}.<< \"</#{node.tag}>\";
+        EOF
+      end
+    end
+
+    attr_reader :output_var_name
+
+    def children_to_ruby(node)
+      self.class.new(
+        node.children,
+        output_var_name: "__c_#{node.hash.to_s.gsub("-", "_")}",
+        skip_return: true
+      ).to_ruby
+    end
+
+    def attributes_for_component(node)
+      node.attributes.map do |key, value|
+        if value.is_a?(Eval)
+          " #{key}: #{value.value}"
+        else
+          " #{key}: \"#{value}\""
+        end
+      end
+    end
+
+    def attributes_for_tag(node)
+      node.attributes.map do |key, value|
+        if value.is_a?(Eval)
+          <<~EOF
+          #{output_var_name}.<< " #{key}=\\"";
+          #{output_var_name}.<< (#{value.value}).to_s;
+          #{output_var_name}.<< "\\"";
+          EOF
+        else
+          %W(#{output_var_name}.<< "key="";\n)
+        end
+      end
+    end
+
+    attr_reader :nodes
+  end
+end

data/lib/component_embedded_ruby/template.rb

@@ -0,0 +1,17 @@
+module ComponentEmbeddedRuby
+  class Template
+    def initialize(template)
+      @template = template
+    end
+
+    def to_ruby
+      tokens = Lexer.new(@template).lex
+      nodes = Parser.parse(tokens)
+      Renderer.new(nodes).to_ruby
+    end
+
+    def to_s(binding: TOPLEVEL_BINDING)
+      eval(to_ruby, binding)
+    end
+  end
+end

data/lib/component_embedded_ruby/unexpected_token_error.rb

@@ -0,0 +1,22 @@
+module ComponentEmbeddedRuby
+  class UnexpectedTokenError < StandardError
+    attr_reader :expected, :got
+
+    def initialize(expected, got)
+      @expected = expected
+      @got = got
+    end
+
+    def message
+      "Unexpected token at column #{got.position}, got #{got.value}#{expected_message}."
+    end
+
+    private
+
+    def expected_message
+      if expected != nil
+        " but expected #{expected}"
+      end
+    end
+  end
+end

data/lib/component_embedded_ruby/version.rb

@@ -0,0 +1,3 @@
+module ComponentEmbeddedRuby
+  VERSION = "0.2.0"
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: component_embedded_ruby
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Blake Williams
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-10-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: view_component
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+description: HTML templates with embedded Ruby components
+email:
+- blake@blakewilliams.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- component_embedded_ruby.gemspec
+- lib/component_embedded_ruby.rb
+- lib/component_embedded_ruby/eval.rb
+- lib/component_embedded_ruby/lexer.rb
+- lib/component_embedded_ruby/lexer/input_reader.rb
+- lib/component_embedded_ruby/node.rb
+- lib/component_embedded_ruby/parser.rb
+- lib/component_embedded_ruby/parser/attribute_parser.rb
+- lib/component_embedded_ruby/parser/base.rb
+- lib/component_embedded_ruby/parser/root_parser.rb
+- lib/component_embedded_ruby/parser/tag_parser.rb
+- lib/component_embedded_ruby/parser/token_reader.rb
+- lib/component_embedded_ruby/renderer.rb
+- lib/component_embedded_ruby/template.rb
+- lib/component_embedded_ruby/unexpected_token_error.rb
+- lib/component_embedded_ruby/version.rb
+homepage: https://github.com/blakewilliams/component_embedded_ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/blakewilliams/component_embedded_ruby
+  source_code_uri: https://github.com/blakewilliams/component_embedded_ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: HTML templates with embedded Ruby components
+test_files: []