roda 3.91.0 → 3.92.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e89aa3dd4e7c27d33d8b989c87a661a42e28c771aa8c96109279cc8131a4c5f5
-  data.tar.gz: e54282de7adf4827dcda2e29c82bbec6d8d76bbbefe29185d3d35b92f3390a50
+  metadata.gz: 63e0c8b5dc16e1652a1bbe309c046b681c8f11a90a31c2b2bd8368baa1b85f43
+  data.tar.gz: b81857ea9bc5ac7667f19fb730982d7b1259e95e1ff1b049d0c619fddf08a1be
 SHA512:
-  metadata.gz: a403baf3ca83c6e636c59c1a598319aa41254ad8bffb6e18ba0f81eebf1260674c30f3954b471da60be605d397496d0c2bb96ff286d5e094ea17a4745dc67f82
-  data.tar.gz: 2caeb451da13d935c1e14e7009304a16e256942926237704cd80baf32f9fa9d534b58830d8d4092cefec4940cc40fe90e01b33152183d43877900d479135e710
+  metadata.gz: ca7712b09048602d91378cdb22ecf30e2d03cf43a215ad52d6aa697151abd88fe4873f4e162b617782f89b434f733d0230f7a3b8bacf252880450dc65308e4ac
+  data.tar.gz: 625b03ba51df7bc895b69e09a739584ae5ff6c15f7701e98a5e55fec301ed0e97353f503565811ae335534c1e6e0634916246fae99493851e472148c5c666789

data/lib/roda/plugins/assets.rb

@@ -60,7 +60,7 @@ class Roda
     #   <%= assets(:css, media: 'print') %>
     #
     # The assets method will respect the application's +:add_script_name+ option,
-    # if it set it will automatically prefix the path with the +SCRIPT_NAME+ for
+    # if it is set it will automatically prefix the path with the +SCRIPT_NAME+ for
     # the request.
     #
     # == Asset Paths

data/lib/roda/plugins/each_part.rb

@@ -0,0 +1,87 @@
+# frozen-string-literal: true
+
+#
+class Roda
+  module RodaPlugins
+    # The each_part plugin adds an each_part method, which is a
+    # render_each-like method that treats all keywords as locals.
+    #
+    #   # Can replace this:
+    #   render_each(enum, :template, locals: {foo: 'bar'})
+    #
+    #   # With this:
+    #   each_part(enum, :template, foo: 'bar')
+    #
+    # On Ruby 2.7+, the part method takes a keyword splat, so you
+    # must pass keywords and not a positional hash for the locals.
+    #
+    # If you are using the :assume_fixed_locals render plugin option,
+    # template caching is enabled, you are using Ruby 3+, and you
+    # are freezing your Roda application, in addition to providing a
+    # simpler API, this also provides a performance improvement.
+    module EachPart
+      def self.load_dependencies(app)
+        app.plugin :render_each
+      end
+
+      module ClassMethods
+        # When freezing, optimize the part method if assuming fixed locals
+        # and caching templates.
+        def freeze
+          if render_opts[:assume_fixed_locals] && !render_opts[:check_template_mtime]
+            include AssumeFixedLocalsInstanceMethods
+          end
+
+          super
+        end
+      end
+
+      module InstanceMethods
+        if RUBY_VERSION >= '2.7'
+          class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+            def each_part(enum, template, **locals, &block)
+              render_each(enum, template, :locals=>locals, &block)
+            end
+          RUBY
+        # :nocov:
+        else
+          def each_part(enum, template, locals=OPTS, &block)
+            render_each(enum, template, :locals=>locals, &block)
+          end
+        end
+        # :nocov:
+      end
+
+      module AssumeFixedLocalsInstanceMethods
+        # :nocov:
+        if RUBY_VERSION >= '3.0'
+        # :nocov:
+          class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+            def each_part(enum, template, **locals, &block)
+              if optimized_method = _cached_render_each_template_method(template)
+                optimized_method = optimized_method[0]
+                as = render_each_default_local(template)
+                if defined?(yield)
+                  enum.each do |v|
+                    locals[as] = v
+                    yield send(optimized_method, **locals)
+                  end
+                  nil
+                else
+                  enum.map do |v|
+                    locals[as] = v
+                    send(optimized_method, **locals)
+                  end.join
+                end
+              else
+                render_each(enum, template, :locals=>locals, &block)
+              end
+            end
+          RUBY
+        end
+      end
+    end
+
+    register_plugin(:each_part, EachPart)
+  end
+end

data/lib/roda/plugins/mailer.rb

@@ -103,7 +103,7 @@ class Roda
     # 
     #  Mailer.sendmail('/welcome/1', 'foo@example.com')
     #
-    #  r.mail 'welcome' do |user_id, mail_from| 
+    #  r.mail 'welcome', Integer do |user_id, mail_from| 
     #    from mail_from
     #    to User[user_id].email
     #    # ...

data/lib/roda/plugins/render_each.rb

@@ -91,12 +91,16 @@ class Roda
 
           if as
             opts = opts.dup
-            if locals = opts[:locals]
-              locals = opts[:locals] = Hash[locals]
+            if locals
+              opts[:locals] = locals
             else
-              locals = opts[:locals] = {}
+              locals = opts[:locals] = if locals = opts[:locals]
+                Hash[locals]
+              else
+                {}
+              end
+              locals[as] = nil
             end
-            locals[as] = nil
 
             if (opts.keys - ALLOWED_KEYS).empty? && (optimized_template = _optimized_render_method_for_locals(template, locals))
               return _optimized_render_each(enum, optimized_template, as, locals, &block)
@@ -134,7 +138,8 @@ class Roda
             case template
             when String, Symbol
               if (method_cache = render_opts[:template_method_cache])
-                _cached_template_method_lookup(method_cache, [:_render_locals, template, [template.to_sym]])
+                key = render_opts[:assume_fixed_locals] ? template : [:_render_locals, template, [template.to_sym]]
+                _cached_template_method_lookup(method_cache, key)
               end
             else
               false

data/lib/roda/version.rb

@@ -4,7 +4,7 @@ class Roda
   RodaMajorVersion = 3
 
   # The minor version of Roda, updated for new feature releases of Roda.
-  RodaMinorVersion = 91
+  RodaMinorVersion = 92
 
   # The patch version of Roda, updated only for bug fixes from the last
   # feature release.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: roda
 version: !ruby/object:Gem::Version
-  version: 3.91.0
+  version: 3.92.0
 platform: ruby
 authors:
 - Jeremy Evans
 bindir: bin
 cert_chain: []
-date: 2025-04-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -200,6 +200,7 @@ files:
 - lib/roda/plugins/direct_call.rb
 - lib/roda/plugins/disallow_file_uploads.rb
 - lib/roda/plugins/drop_body.rb
+- lib/roda/plugins/each_part.rb
 - lib/roda/plugins/early_hints.rb
 - lib/roda/plugins/empty_root.rb
 - lib/roda/plugins/environments.rb
@@ -326,7 +327,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Routing tree web toolkit
 test_files: []