mjml-rails 4.14.1 → 4.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae000b23a07869a790fcda678ef39a4647ff5dfa561a012d562d8193c5c5d125
-  data.tar.gz: 9bb383f3a70b2a71518ee8684aec8a3eb0a7b153714372da01b79901fd9cbfcb
+  metadata.gz: 7a768bdc7c72cb474b41346d9f48685d46ac7eb477850f417eac944abcfe3289
+  data.tar.gz: ceca1bd32af0d391c92a5ff0a00a80751e34b069571fe57567fc3b1cfee656ff
 SHA512:
-  metadata.gz: 7851d43cf196343c277f8653f67007d3ce92e5ef20761f2b078d74acc8982fb47629829cd89eded4e4a18a6dd72e41bf7ab89e4bb6ddc45172ec67410f6eceee
-  data.tar.gz: 71fc235d2d2f282c7c7e21e91a6e0bdd850bd8fe8bcd80054ae16a8148624b589586ba26039dd735735d5c60b6a1ffd1e5f6a535e9f2c76f42f5aa4653d0a41b
+  metadata.gz: a2a6098dadd2d9004b7043903b61056da28d2d061bebb391c7ed9ab537f24879dac30b46d08388c41871a74c7a7e4e703d1b206e08f0980aeaeb006e3674ed7c
+  data.tar.gz: f626fc4c6141133b42cba395e137f557ed3259198a40ab7b445a8ec5b3521cbb74a5a499df5d3e0a176f5f3a8c10e5f933e37fa000d45957784c1d9869b4a778

data/README.md

@@ -68,6 +68,14 @@ Run the following command to install it:
 bundle install
 ```
 
+After installation, you can generate the MJML initializer file:
+
+```console
+rails generate mjml:install
+```
+
+This will create `config/initializers/mjml.rb` with default configuration options.
+
 Add the MJML parser to your project with your favourite package manager:
 
 ```console
@@ -124,7 +132,7 @@ MJML-Rails has the following settings with defaults:
 
    ERB can be used inside MJML templates by default. Possible values are all template languages that you have installed, e.g. `:haml` or `:slim`.
 
-   **Note:** If you’re using Haml/Slim layouts, please don’t put `<mjml>` in comments in your partial. Read more at [#34](https://github.com/sighmon/mjml-rails/issues/34).
+   **Note:** If you're using Haml/Slim layouts, please don't put `<mjml>` in comments in your partial. Read more at [#34](https://github.com/sighmon/mjml-rails/issues/34).
 
 - `raise_render_exception: true`
 
@@ -155,6 +163,9 @@ MJML-Rails has the following settings with defaults:
 - `use_mrml: false`
   Enabling this will allow you to use Rust implementation of MJML via the `mrml` gem. It comes with prebuilt binaries instead of having to install MJML along with Node. When enabled the options `mjml_binary_version_supported`, `mjml_binary`, `minify`, `beautify` and `validation_level` are ignored.
 
+- `cache_mjml: false`
+  By default, MJML-Rails does not cache compiled templates. Setting this to `true` will cache compiled templates in `tmp/mjml_cache` to improve performance for frequently used templates.
+
 - `fonts`
   By default, MJML-Rails uses MJML default fonts, but enables you to override it.
   Example : `config.fonts = { Raleway: 'https://fonts.googleapis.com/css?family=Raleway }`
@@ -185,6 +196,9 @@ Mjml.setup do |config|
 
   # Use default system fonts instead of google fonts
   config.fonts = {}
+
+  # Uncomment this to enable template caching
+  # config.cache_mjml = true
 end
 ```
 

data/lib/generators/mjml/install/install_generator.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module Mjml
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+      desc 'Creates MJML initializer for your application'
+
+      def copy_initializer
+        template 'mjml.rb', 'config/initializers/mjml.rb'
+      end
+    end
+  end
+end

data/lib/generators/mjml/install/templates/mjml.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# MJML configuration
+Mjml.setup do |config|
+  # Use :erb as a template language
+  config.template_language = :erb
+
+  # Raise exceptions for template errors
+  config.raise_render_exception = true
+
+  # Beautify the output HTML
+  config.beautify = true
+
+  # Minify the output HTML
+  config.minify = false
+
+  # Validation level for MJML templates
+  # Possible values: 'strict', 'soft'
+  config.validation_level = 'strict'
+
+  # Use MRML instead of MJML (requires mrml gem)
+  config.use_mrml = false
+
+  # Cache compiled templates for better performance
+  config.cache_mjml = false
+
+  # Custom fonts configuration
+  # Example: config.fonts = { Raleway: 'https://fonts.googleapis.com/css?family=Raleway' }
+  config.fonts = nil
+
+  # Uncomment this to enable template caching
+  # config.cache_mjml = true
+end

data/lib/mjml/cache.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Mjml
+  class Cache
+    attr_reader :template_path
+
+    def initialize(template_path)
+      @template_path = template_path
+    end
+
+    # @yield [] -> String
+    # @return [String]
+    def cache(&block)
+      return yield if !Mjml.cache_mjml && block
+
+      cached_path = cached_file_path
+      if File.exist?(cached_path)
+        File.read(cached_path)
+      else
+        html_content = yield if block
+        File.write(cached_path, html_content)
+        html_content
+      end
+    end
+
+    private
+
+    def cached_file_path
+      File.join(cache_directory, "#{fingerprint}.html")
+    end
+
+    def fingerprint
+      full_path = File.join(Dir.pwd, 'app', 'views', "#{template_path}.mjml")
+      raise "Template file not found: #{full_path}" unless File.exist?(full_path)
+
+      Digest::SHA256.hexdigest(File.read(full_path))
+    end
+
+    def cache_directory
+      dir = File.join(Dir.pwd, 'tmp', 'mjml_cache')
+      FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+      dir
+    end
+  end
+end

data/lib/mjml/handler.rb

@@ -17,6 +17,7 @@ module Mjml
       compiled_source = compile_source(source, template)
 
       parser_class = Mjml.use_mrml ? 'MrmlParser' : 'Parser'
+      template_path = template.virtual_path
       # Per MJML v4 syntax documentation[0] valid/render'able document MUST start with <mjml> root tag
       # If we get here and template source doesn't start with one it means
       # that we are rendering partial named according to legacy naming convention (partials ending with '.mjml')
@@ -25,7 +26,7 @@ module Mjml
       #
       # [0] - https://github.com/mjmlio/mjml/blob/master/doc/components_1.md#mjml
       if /<mjml.*?>/i.match?(compiled_source)
-        "Mjml::#{parser_class}.new(begin;#{compiled_source};end).render.html_safe"
+        "Mjml::#{parser_class}.new('#{template_path}', begin;#{compiled_source};end).render.html_safe"
       else
         compiled_source
       end

data/lib/mjml/parser.rb

@@ -1,36 +1,46 @@
 # frozen_string_literal: true
 
+require 'digest'
+require_relative 'cache'
+
 module Mjml
   class Parser
     class ParseError < StandardError; end
 
-    attr_reader :input
+    attr_reader :template_path, :input
 
     # Create new parser
     #
-    # @param input [String] The string to transform in html
-    def initialize(input)
+    # @param template_path [String] The path to the .mjml file
+    # @param input [String] The content of the .mjml file
+    def initialize(template_path, input)
       raise Mjml.mjml_binary_error_string unless Mjml.valid_mjml_binary
 
-      @input = input
+      @template_path = template_path
+      @input         = input
+      @with_cache    = Cache.new(template_path)
     end
 
-    # Render mjml template
+    # rubocop:disable Metrics/MethodLength
+    # Render MJML template
     #
     # @return [String]
     def render
-      in_tmp_file = Tempfile.open(['in', '.mjml']) do |file|
-        file.write(input)
-        file # return tempfile from block so #unlink works later
-      end
-      run(in_tmp_file.path)
-    rescue StandardError
-      raise if Mjml.raise_render_exception
+      @with_cache.cache do
+        in_tmp_file = Tempfile.open(['in', '.mjml']) do |file|
+          file.write(input)
+          file # return tempfile from block so #unlink works later
+        end
+        run(in_tmp_file.path)
+      rescue StandardError
+        raise if Mjml.raise_render_exception
 
-      ''
-    ensure
-      in_tmp_file&.unlink
+        ''
+      ensure
+        in_tmp_file&.unlink
+      end
     end
+    # rubocop:enable Metrics/MethodLength
 
     # Exec mjml command
     #

data/lib/mjml/version.rb

@@ -2,5 +2,5 @@
 
 module Mjml
   # Version number no longer matches MJML.io version
-  VERSION = '4.14.1'
+  VERSION = '4.15.0'
 end

data/lib/mjml.rb

@@ -19,7 +19,8 @@ module Mjml
     :raise_render_exception,
     :template_language,
     :validation_level,
-    :use_mrml
+    :use_mrml,
+    :cache_mjml
 
   mattr_writer :valid_mjml_binary
 
@@ -33,6 +34,7 @@ module Mjml
   self.validation_level = 'strict'
   self.use_mrml = false
   self.fonts = nil
+  self.cache_mjml = false
 
   def self.check_version(bin)
     stdout, _, status = run_mjml('--version', mjml_bin: bin)

data/test/parser_test.rb

@@ -4,7 +4,7 @@ require 'test_helper'
 
 describe Mjml::Parser do
   let(:input) { mock('input') }
-  let(:parser) { Mjml::Parser.new(input) }
+  let(:parser) { Mjml::Parser.new('test_template', input) }
 
   describe '#render' do
     describe 'when exception is raised' do
@@ -42,7 +42,7 @@ describe Mjml::Parser do
         expect(Mjml.beautify).must_equal(true)
         expect(Mjml.minify).must_equal(false)
         expect(Mjml.validation_level).must_equal('strict')
-        expect(Mjml.fonts).must_equal(nil)
+        assert_nil(Mjml.fonts)
       end
 
       it 'uses setup config' do

metadata

@@ -1,12 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: mjml-rails
 version: !ruby/object:Gem::Version
-  version: 4.14.1
+  version: 4.15.0
 platform: ruby
 authors:
 - Simon Loffler
 - Steven Pickles
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -36,7 +35,7 @@ cert_chain:
   Qqk2dn/fFE9vdcl9OaOw2Zizne/1VFL/jkzXLqnLgbKD/q129mVCBgw2CKYnQfMN
   4RwBjPyqnMxWnSq6Ycn7HdFEkgyf2cAxFfH5QtDsjEuca+/LAJMeAQ==
   -----END CERTIFICATE-----
-date: 2025-02-20 00:00:00.000000000 Z
+date: 2025-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -158,11 +157,14 @@ extra_rdoc_files: []
 files:
 - MIT-LICENSE
 - README.md
+- lib/generators/mjml/install/install_generator.rb
+- lib/generators/mjml/install/templates/mjml.rb
 - lib/generators/mjml/mailer/mailer_generator.rb
 - lib/generators/mjml/mailer/templates/layout.html.mjml
 - lib/generators/mjml/mailer/templates/view.html.erb
 - lib/mjml-rails.rb
 - lib/mjml.rb
+- lib/mjml/cache.rb
 - lib/mjml/handler.rb
 - lib/mjml/mrml_parser.rb
 - lib/mjml/parser.rb
@@ -192,8 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: MJML + ERb templates
 test_files: