Introduce Herb::Engine (#472)

Author: marcoroth

.rubocop.yml

@@ -48,16 +48,22 @@ Metrics/CyclomaticComplexity:
   Exclude:
     - lib/herb/project.rb
     - lib/herb/ast/nodes.rb
+    - lib/herb/cli.rb
+    - lib/herb/engine.rb
+    - lib/herb/engine/**/*.rb
 
 Metrics/MethodLength:
   Max: 20
   Exclude:
     - lib/herb/ast/nodes.rb
     - lib/herb/cli.rb
     - lib/herb/project.rb
+    - lib/herb/engine.rb
+    - lib/herb/engine/**/*.rb
     - templates/template.rb
     - test/fork_helper.rb
     - test/snapshot_utils.rb
+    - bin/**/*
 
 Metrics/AbcSize:
   Exclude:
@@ -66,44 +72,64 @@ Metrics/AbcSize:
     - lib/herb/cli.rb
     - lib/herb/errors.rb
     - lib/herb/project.rb
+    - lib/herb/engine.rb
+    - lib/herb/engine/**/*.rb
     - templates/template.rb
     - test/fork_helper.rb
     - test/snapshot_utils.rb
+    - bin/**/*
 
 Metrics/ClassLength:
   Exclude:
     - lib/herb/cli.rb
     - lib/herb/project.rb
     - lib/herb/visitor.rb
+    - lib/herb/engine.rb
+    - lib/herb/engine/**/*.rb
+    - bin/**/*
     - test/**/*_test.rb
 
+Metrics/ModuleLength:
+  Exclude:
+    - test/**/*.rb
+
 Metrics/BlockLength:
   Max: 30
   Exclude:
     - Rakefile
     - "*.gemspec"
     - "**/*.rake"
+    - lib/herb/cli.rb
     - lib/herb/project.rb
     - test/**/*_test.rb
+    - bin/**/*
 
 Metrics/ParameterLists:
   Exclude:
     - lib/herb/ast/nodes.rb
     - lib/herb/errors.rb
+    - lib/herb/engine/validators/security_validator.rb
 
 Metrics/PerceivedComplexity:
   Exclude:
     - lib/herb/ast/nodes.rb
     - lib/herb/cli.rb
     - lib/herb/project.rb
-    - test/snapshot_utils.rb
+    - lib/herb/engine.rb
+    - lib/herb/engine/**/*.rb
+    - test/**/*.rb
+    - bin/**/*
 
 Layout/LineLength:
   Max: 120
   Exclude:
     - test/**/*_test.rb
     - lib/herb/token.rb
     - lib/herb/ast/nodes.rb
+    - lib/herb/engine/error_formatter.rb
+    - lib/herb/engine/debug_visitor.rb
+    - lib/herb/engine/parser_error_overlay.rb
+    - lib/herb/engine/validation_error_overlay.rb
 
 Layout/EmptyLines:
   Exclude:
@@ -128,7 +154,14 @@ Layout/LeadingCommentSpace:
 Security/Eval:
   Exclude:
     - Rakefile
+    - lib/herb/cli.rb
+    - test/**/*.rb
+    - bin/erubi-render
 
 Security/MarshalLoad:
   Exclude:
     - test/fork_helper.rb
+
+Lint/UnderscorePrefixedVariableName:
+  Exclude:
+    - test/engine/secure_compiler_test.rb

Gemfile

@@ -6,6 +6,7 @@ gemspec
 
 gem "prism", github: "ruby/prism", tag: "v1.4.0"
 
+gem "actionview", "~> 8.0"
 gem "lz_string"
 gem "maxitest"
 gem "minitest-difftastic", "~> 0.2"

Gemfile.lock

@@ -22,7 +22,13 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.0.2)
+    actionview (8.0.2.1)
+      activesupport (= 8.0.2.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activesupport (8.0.2.1)
       base64
       benchmark (>= 0.3)
       bigdecimal
@@ -39,8 +45,10 @@ GEM
     base64 (0.3.0)
     benchmark (0.4.1)
     bigdecimal (3.2.2)
+    builder (3.3.0)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.3)
+    crass (1.0.6)
     csv (3.3.5)
     difftastic (0.7.0)
       pretty_please
@@ -53,6 +61,7 @@ GEM
     dispersion (0.2.0)
       prism
     drb (2.2.3)
+    erubi (1.13.1)
     ffi (1.17.2-aarch64-linux-gnu)
     ffi (1.17.2-aarch64-linux-musl)
     ffi (1.17.2-arm64-darwin)
@@ -62,28 +71,50 @@ GEM
     fileutils (1.7.3)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    io-console (0.8.0)
-    json (2.12.2)
+    io-console (0.8.1)
+    json (2.13.2)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
+    loofah (2.24.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
     lz_string (0.3.0)
     maxitest (6.0.0)
       minitest (>= 5.20.0, < 5.26.0)
     minitest (5.25.5)
     minitest-difftastic (0.2.1)
       difftastic (~> 0.6)
     mutex_m (0.3.0)
+    nokogiri (1.18.9-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.9-aarch64-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.18.9-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.9-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.9-x86_64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.9-x86_64-linux-musl)
+      racc (~> 1.4)
     parallel (1.27.0)
-    parser (3.3.8.0)
+    parser (3.3.9.0)
       ast (~> 2.4.1)
       racc
     pretty_please (0.2.0)
       dispersion (~> 0.2)
     racc (1.8.1)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
     rainbow (3.1.1)
     rake (13.3.0)
     rake-compiler (1.3.0)
@@ -94,30 +125,30 @@ GEM
       ffi (~> 1.0)
     rbs (3.9.4)
       logger
-    regexp_parser (2.10.0)
-    reline (0.6.1)
+    regexp_parser (2.11.2)
+    reline (0.6.2)
       io-console (~> 0.5)
-    rubocop (1.77.0)
+    rubocop (1.80.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.45.1, < 2.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.45.1)
+    rubocop-ast (1.46.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    sorbet (0.5.12214)
-      sorbet-static (= 0.5.12214)
-    sorbet-static (0.5.12214-aarch64-linux)
-    sorbet-static (0.5.12214-universal-darwin)
-    sorbet-static (0.5.12214-x86_64-linux)
+    sorbet (0.6.12473)
+      sorbet-static (= 0.6.12473)
+    sorbet-static (0.6.12473-aarch64-linux)
+    sorbet-static (0.6.12473-universal-darwin)
+    sorbet-static (0.6.12473-x86_64-linux)
     steep (1.10.0)
       activesupport (>= 5.1)
       concurrent-ruby (>= 1.1.10)
@@ -140,21 +171,24 @@ GEM
       unicode-display_width (>= 1.1.1, < 4)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (3.1.4)
+    unicode-display_width (3.1.5)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
     uri (1.0.3)
 
 PLATFORMS
+  aarch64-linux
   aarch64-linux-gnu
   aarch64-linux-musl
   arm64-darwin
+  universal-darwin
   x86_64-darwin
   x86_64-linux
   x86_64-linux-gnu
   x86_64-linux-musl
 
 DEPENDENCIES
+  actionview (~> 8.0)
   herb!
   lz_string
   maxitest
@@ -170,4 +204,4 @@ DEPENDENCIES
   steep (~> 1.10)
 
 BUNDLED WITH
-   2.6.3
+   2.7.1

Steepfile

@@ -7,9 +7,12 @@ target :lib do
 
   library "delegate"
   library "json"
+  library "tempfile"
+  library "pathname"
 
   ignore "lib/herb/cli.rb"
   ignore "lib/herb/libherb.rb"
   ignore "lib/herb/libherb"
   ignore "lib/herb/project.rb"
+  ignore "lib/herb/engine/error_formatter.rb"
 end