mjml-rb 0.2.38 → 0.2.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 556f39bab241ad23362562a49530aa44547347cdadb66a72f80acdff43533814
-  data.tar.gz: f1fd9bde9c1bfde3d041ef67c4b61837e82612fc51a39feaa4fc4c88e75f7464
+  metadata.gz: c7864f17e62acc702b5da45e9ca4322bc5207d486190de2ae7bab1a19e5109be
+  data.tar.gz: 9a5587f0f059d2d422407d65ad149e0d1ba04b731409a42290d3b4aa2aa34fc3
 SHA512:
-  metadata.gz: 1061b94568afb17dd9734b397871d383890e624fcc44dd430708ce0194d370bad171a08fdba62c4e0ebb14250024b7e6003c071c8ac72d5401e9ec8b4229c28b
-  data.tar.gz: 1c7529382d699d2893ed2a99236d03cb58f9fa0792574cd45d13d64a4e7e911ca5c01fbd332ead728de4a54721cc8002293030badd99b1256b07e8da154a6124
+  metadata.gz: a910ab3a64a41505e662a31c97ad11b29a72bee403c5e98b70a2abafa7fee0e056a173e55232bde1d8a5b765a524a6acf1a99d0536c0c74a49ef67dcaa17265b
+  data.tar.gz: 0d9e9e08cfc38bcde65ba9480ca5a10365b0ecc60a20695a57cbc027dbe4a86df6d92424d46597d2ae8c46c7e25f6e4ccb6575d6d43f0d4dd157c54939afec36

data/README.md

@@ -46,6 +46,21 @@ bundle exec bin/mjml --validate example.mjml
 In a Rails app, requiring the gem registers an `ActionView` template handler for
 `.mjml` templates through a `Railtie`.
 
+By default, `.mjml` files are treated as raw MJML/XML source.
+
+If you want Slim-backed MJML templates, configure it explicitly:
+
+```ruby
+config.mjml_rb.template_language = :slim
+```
+
+Supported values are `:erb`, `:slim`, and `:haml`.
+
+With a configured `template_language`, `.mjml` templates are rendered through
+that template engine first, so partials and embedded Ruby can assemble MJML
+before the outer template is compiled to HTML. Without that setting, non-XML
+MJML source is rejected instead of being guessed.
+
 Create a view such as `app/views/user_mailer/welcome.html.mjml`:
 
 ```mjml

data/lib/mjml-rb/railtie.rb

@@ -4,9 +4,11 @@ module MjmlRb
   class Railtie < Rails::Railtie
     config.mjml_rb = ActiveSupport::OrderedOptions.new
     config.mjml_rb.compiler_options = {validation_level: "strict"}
+    config.mjml_rb.template_language = nil
 
     initializer "mjml_rb.action_view" do |app|
       MjmlRb.rails_compiler_options = app.config.mjml_rb.compiler_options.to_h
+      MjmlRb.rails_template_language = app.config.mjml_rb.template_language
 
       ActiveSupport.on_load(:action_view) do
         MjmlRb.register_action_view_template_handler!

data/lib/mjml-rb/template_handler.rb

@@ -1,16 +1,113 @@
 module MjmlRb
   class TemplateHandler
+    MJML_CAPTURE_DEPTH_IVAR = :@_mjml_rb_capture_depth
+    TEMPLATE_ENGINES = {
+      slim: {
+        require: "slim",
+        gem_name: "slim"
+      },
+      haml: {
+        require: "haml",
+        gem_name: "haml"
+      }
+    }.freeze
+
     class << self
       def call(template, source = nil)
         <<~RUBY
-          mjml_compiler_options = (::MjmlRb.rails_compiler_options || {}).dup
-          mjml_result = ::MjmlRb::Compiler.new(mjml_compiler_options).compile(#{template.source.inspect})
+          ::MjmlRb::TemplateHandler.render(self, #{template.source.inspect}, #{template.identifier.inspect}, local_assigns)
+        RUBY
+      end
+
+      def render(view_context, source, identifier, local_assigns = {})
+        if capture_mode?(view_context)
+          return mark_html_safe(render_source(view_context, source, local_assigns))
+        end
+
+        with_capture_mode(view_context) do
+          mjml_source = render_source(view_context, source, local_assigns).to_s
+          mjml_result = ::MjmlRb::Compiler.new(::MjmlRb.rails_compiler_options || {}).compile(mjml_source)
+
           if mjml_result.errors.any?
-            raise "MJML compilation failed for #{template.identifier}: \#{mjml_result.errors.map { |error| error[:formatted_message] || error[:message] }.join(', ')}"
+            raise "MJML compilation failed for #{identifier}: #{mjml_result.errors.map { |error| error[:formatted_message] || error[:message] }.join(', ')}"
           end
-          mjml_html = mjml_result.html.to_s
-          mjml_html.respond_to?(:html_safe) ? mjml_html.html_safe : mjml_html
-        RUBY
+
+          mark_html_safe(mjml_result.html.to_s)
+        end
+      end
+
+      private
+
+      def render_source(view_context, source, local_assigns)
+        language = ::MjmlRb.rails_template_language
+        if language.nil?
+          stripped_source = source.to_s.lstrip
+          return source.to_s if stripped_source.start_with?("<")
+
+          raise "MJML Rails template_language is not configured for non-XML templates. Supported values: nil, :erb, :slim, :haml"
+        end
+
+        case language
+        when :erb
+          render_erb_source(view_context, source.to_s, local_assigns)
+        when :slim, :haml
+          render_template_language_source(view_context, source.to_s, local_assigns, language)
+        else
+          raise "Unsupported MJML Rails template_language `#{language}`. Supported values: nil, :erb, :slim, :haml"
+        end
+      end
+
+      def render_erb_source(view_context, source, local_assigns)
+        require "erb"
+
+        local_assigns.each do |name, value|
+          define_local_reader(view_context, name, value)
+        end
+
+        erb = ::ERB.new(source)
+        erb.result(view_context.instance_eval { binding })
+      end
+
+      def render_template_language_source(view_context, source, local_assigns, language)
+        engine = TEMPLATE_ENGINES.fetch(language)
+        require engine[:require]
+
+        case language
+        when :slim
+          ::Slim::Template.new { source }.render(view_context, local_assigns.transform_keys(&:to_sym))
+        when :haml
+          if defined?(::Haml::Template)
+            ::Haml::Template.new { source }.render(view_context, local_assigns.transform_keys(&:to_sym))
+          else
+            raise "MJML Rails template_language is set to :haml, but this Haml version does not expose Haml::Template"
+          end
+        end
+      rescue LoadError
+        raise "MJML Rails template_language is set to :#{language}, but the `#{engine[:gem_name]}` gem is not available"
+      end
+
+      def define_local_reader(view_context, name, value)
+        singleton_class = class << view_context; self; end
+        singleton_class.send(:define_method, name) do
+          value
+        end
+      end
+
+      def capture_mode?(view_context)
+        view_context.instance_variable_get(MJML_CAPTURE_DEPTH_IVAR).to_i.positive?
+      end
+
+      def with_capture_mode(view_context)
+        depth = view_context.instance_variable_get(MJML_CAPTURE_DEPTH_IVAR).to_i
+        view_context.instance_variable_set(MJML_CAPTURE_DEPTH_IVAR, depth + 1)
+        yield
+      ensure
+        next_depth = view_context.instance_variable_get(MJML_CAPTURE_DEPTH_IVAR).to_i - 1
+        view_context.instance_variable_set(MJML_CAPTURE_DEPTH_IVAR, [next_depth, 0].max)
+      end
+
+      def mark_html_safe(value)
+        value.respond_to?(:html_safe) ? value.html_safe : value
       end
     end
   end

data/lib/mjml-rb/version.rb

@@ -1,3 +1,3 @@
 module MjmlRb
-  VERSION = "0.2.38".freeze
+  VERSION = "0.2.39".freeze
 end

data/lib/mjml-rb.rb

@@ -28,6 +28,14 @@ module MjmlRb
       @rails_compiler_options = options || {}
     end
 
+    def rails_template_language
+      @rails_template_language
+    end
+
+    def rails_template_language=(language)
+      @rails_template_language = language&.to_sym
+    end
+
     def register_action_view_template_handler!
       return unless defined?(ActionView::Template)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mjml-rb
 version: !ruby/object:Gem::Version
-  version: 0.2.38
+  version: 0.2.39
 platform: ruby
 authors:
 - Andrei Andriichuk