futurism 1.0.0 → 1.2.0.pre2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 414f6857d0112042c7745a9198e9e9c05d2886d3649f955d53d4ed09fed1dddc
-  data.tar.gz: cd55e6f01214c0379e2a5b2d0505c76486cc388114daa3888439e608a0a74335
+  metadata.gz: 00f16be3e103b54e5c6bbd9efaea16b7196d0e4a561bde8b61051989b1e74e59
+  data.tar.gz: 67c9a17bb4a80fcc12f830bf8ce39174086e336b93d041f822308a20359381dc
 SHA512:
-  metadata.gz: 14de66605b2c41ef1cc6aca2c42507a856dfd67cbb1dc23de029b77bfb5c24b5b6a5a2ecf65b95cef5622c45dfef6ecccd05059daeaf25615a12356015b5b614
-  data.tar.gz: a63476d5c42a5db0ae0220f71b4c5a4792aaf529c0741df322a239c8be458b8433c94bd461574833c1b102e1b8f444038adb1c7f66a3a16d6b73025672fa8022
+  metadata.gz: ff6e67f624ad9ccd114800b457c4f7e48fa6232f87aa970f7f1513b59bd4ea3daedf05806e2582af057588d1cd19075e87ab81f8f4ffde23544f64b6e8ae2a5c
+  data.tar.gz: 1bafaacb876d3d50d020692a555946112a74bdb10b0cabac0e67b3b57f561b7935ba25024c0792102ec9f89addfa54fde03daf10101364cb27b51f687817956f

data/README.md

@@ -22,6 +22,7 @@ Lazy-load Rails partials via CableReady
   - [HTML Options](#html-options)
   - [Eager Loading](#eager-loading)
   - [Broadcast Partials Individually](#broadcast-partials-individually)
+  - [Contextual Placeholder Arguments](#contextual-placeholder-arguments)
 - [Events](#events)
 - [Installation](#installation)
   - [Manual Installation](#manual-installation)
@@ -187,6 +188,28 @@ For collections, however, you can opt into individual broadcasts by specifying `
 <% end %>
 ```
 
+## Contextual Placeholder Arguments
+
+For individual models or arbitrary collections, you can pass `record` and `index` to the placeholder block as arguments:
+
+```erb
+<%= futurize @post, extends: :div do |post| %>
+  <div><%= post.title %></div>
+<% end %>
+```
+
+```erb
+<%= futurize @posts, extends: :tr do |post, index| %>
+  <td><%= index + 1 %></td><td><%= post.title %></td>
+<% end %>
+```
+
+```erb
+<%= futurize partial: "users/user", collection: users, extends: "tr" do |user, index| %>
+  <td><%= index + 1 %></td><td><%= user.name %></td>
+<% end >
+```
+
 ## Events
 
 Once your futurize element has been rendered, the `futurize:appeared` custom event will be called.
@@ -309,8 +332,10 @@ yarn install --force
 ### Release
 
 1. Update the version numbers in `javascript/package.json` and `lib/futurism/version.rb`
-2. `rake release`
-3. `cd javascript && npm publish --access public`
+2. `git commit -m "Bump version to x.x.x"`
+3. Run `bundle exec rake build`
+4. Run `bundle exec rake release`
+5. `cd javascript && npm publish --access public`
 
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/futurism/helpers.rb

@@ -9,31 +9,32 @@ module Futurism
         end
       end
 
-      if block_given?
-        placeholder = capture(&block)
-      else
-        options[:eager] = true
-      end
+      options[:eager] = true unless block_given?
 
       if records_or_string.is_a?(ActiveRecord::Base) || records_or_string.is_a?(ActiveRecord::Relation)
-        futurize_active_record(records_or_string, extends: extends, placeholder: placeholder, **options)
+        futurize_active_record(records_or_string, extends: extends, **options, &block)
       elsif records_or_string.is_a?(String)
         html_options = options.delete(:html_options)
-        futurize_with_options(extends: extends, placeholder: placeholder, partial: records_or_string, locals: options, html_options: html_options)
+        futurize_with_options(extends: extends, partial: records_or_string, locals: options, html_options: html_options, &block)
       else
-        futurize_with_options(extends: extends, placeholder: placeholder, **options)
+        futurize_with_options(extends: extends, **options, &block)
       end
     end
 
-    def futurize_with_options(extends:, placeholder:, **options)
+    def futurize_with_options(extends:, **options, &block)
       collection = options.delete(:collection)
       if collection.nil?
+        placeholder = capture(&block) if block_given?
+
         WrappingFuturismElement.new(extends: extends, placeholder: placeholder, options: options).render
       else
         collection_class_name = collection.try(:klass).try(:name) || collection.first.class.to_s
         as = options.delete(:as) || collection_class_name.underscore
         broadcast_each = options.delete(:broadcast_each) || false
+
         collection.each_with_index.map { |record, index|
+          placeholder = capture(record, index, &block) if block_given?
+
           WrappingFuturismElement.new(extends: extends, placeholder: placeholder, options: options.deep_merge(
             broadcast_each: broadcast_each,
             locals: {as.to_sym => record, "#{as}_counter".to_sym => index}
@@ -42,8 +43,10 @@ module Futurism
       end
     end
 
-    def futurize_active_record(records, extends:, placeholder:, **options)
-      Array(records).map { |record|
+    def futurize_active_record(records, extends:, **options, &block)
+      Array(records).map.with_index { |record, index|
+        placeholder = capture(record, index, &block) if block_given?
+
         WrappingFuturismElement.new(extends: extends, options: options.merge(model: record), placeholder: placeholder).render
       }.join.html_safe
     end

data/lib/futurism/helpers.rb~

@@ -9,27 +9,27 @@ module Futurism
         end
       end
 
-      if block_given?
-        placeholder = capture(&block)
-      else
-        options[:eager] = true
-      end
+      options[:eager] = true unless block_given?
 
       if records_or_string.is_a?(ActiveRecord::Base) || records_or_string.is_a?(ActiveRecord::Relation)
-        futurize_active_record(records_or_string, extends: extends, placeholder: placeholder, **options)
+        futurize_active_record(records_or_string, extends: extends, **options, &block)
       elsif records_or_string.is_a?(String)
         html_options = options.delete(:html_options)
-        futurize_with_options(extends: extends, placeholder: placeholder, partial: records_or_string, locals: options, html_options: html_options)
+        futurize_with_options(extends: extends, partial: records_or_string, locals: options, html_options: html_options, &block)
       else
-        futurize_with_options(extends: extends, placeholder: placeholder, **options)
+        futurize_with_options(extends: extends, **options, &block)
       end
     end
 
-    def futurize_with_options(extends:, placeholder:, **options)
+    def futurize_with_options(extends:, **options, &block)
       collection = options.delete(:collection)
       if collection.nil?
+        placeholder = capture(&block) if block_given?
+
         WrappingFuturismElement.new(extends: extends, placeholder: placeholder, options: options).render
       else
+        placeholder = capture(record, index, &block) if block_given?
+
         collection_class_name = collection.try(:klass).try(:name) || collection.first.class.to_s
         as = options.delete(:as) || collection_class_name.underscore
         broadcast_each = options.delete(:broadcast_each) || false
@@ -42,8 +42,10 @@ module Futurism
       end
     end
 
-    def futurize_active_record(records, extends:, placeholder:, **options)
-      Array(records).map { |record|
+    def futurize_active_record(records, extends:, **options, &block)
+      Array(records).map.with_index { |record, index|
+        placeholder = capture(record, index, &block) if block_given?
+
         WrappingFuturismElement.new(extends: extends, options: options.merge(model: record), placeholder: placeholder).render
       }.join.html_safe
     end
@@ -53,12 +55,13 @@ module Futurism
       include ActionView::Helpers
       include Futurism::MessageVerifier
 
-      attr_reader :extends, :placeholder, :html_options, :data_attributes, :model, :options, :eager, :controller
+      attr_reader :extends, :placeholder, :html_options, :data_attributes, :model, :options, :eager, :broadcast_each, :controller
 
       def initialize(extends:, placeholder:, options:)
         @extends = extends
         @placeholder = placeholder
         @eager = options.delete(:eager)
+        @broadcast_each = options.delete(:broadcast_each)
         @controller = options.delete(:controller)
         @html_options = options.delete(:html_options) || {}
         @data_attributes = html_options.fetch(:data, {}).except(:sgid, :signed_params)
@@ -71,6 +74,7 @@ module Futurism
           signed_params: signed_params,
           sgid: model && model.to_sgid.to_s,
           eager: eager.presence,
+          broadcast_each: broadcast_each.presence,
           signed_controller: signed_controller
         })
       end

data/lib/futurism/version.rb

@@ -1,3 +1,3 @@
 module Futurism
-  VERSION = "1.0.0"
+  VERSION = "1.2.0.pre2"
 end

data/lib/futurism/version.rb~

@@ -1,3 +1,3 @@
 module Futurism
-  VERSION = "0.8.0"
+  VERSION = "1.2.0.pre1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: futurism
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0.pre2
 platform: ruby
 authors:
 - Julian Rubisch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-25 00:00:00.000000000 Z
+date: 2021-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -126,16 +126,16 @@ dependencies:
   name: cable_ready
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '4'
+        version: 5.0.0.pre4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '4'
+        version: 5.0.0.pre4
 description: Uses custom html elements with attached IntersectionObserver to automatically
   lazy load partials via websockets
 email:
@@ -150,7 +150,6 @@ files:
 - config/routes.rb
 - lib/futurism.rb
 - lib/futurism.rb~
-- lib/futurism/#helpers.rb#
 - lib/futurism/channel.rb
 - lib/futurism/channel.rb~
 - lib/futurism/engine.rb
@@ -183,9 +182,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.1.4
 signing_key:

data/lib/futurism/#helpers.rb#

@@ -1,105 +0,0 @@
-module Futurism
-  module Helpers
-    def futurize(records_or_string = nil, extends:, **options, &block)
-      if Rails.env.test? && Futurism.skip_in_test
-        if records_or_string.nil?
-          return render(**options)
-        else
-          return render(records_or_string, **options)
-        end
-      end
-
-      placeholder = capture(&block)
-
-      if records_or_string.is_a?(ActiveRecord::Base) || records_or_string.is_a?(ActiveRecord::Relation)
-        futurize_active_record(records_or_string, extends: extends, placeholder: placeholder, **options)
-      elsif records_or_string.is_a?(String)
-        html_options = options.delete(:html_options)
-        futurize_with_options(extends: extends, placeholder: placeholder, partial: records_or_string, locals: options, html_options: html_options)
-      else
-        futurize_with_options(extends: extends, placeholder: placeholder, **options)
-      end
-    end
-
-    def futurize_with_options(extends:, placeholder:, **options)
-      collection = options.delete(:collection)
-      if collection.nil?
-        WrappingFuturismElement.new(extends: extends, placeholder: placeholder, options: options).render
-      else
-        collection_class_name = collection.try(:klass).try(:name) || collection.first.class.to_s
-        as = options.delete(:as) || collection_class_name.underscore
-        collection.each_with_index.map { |record, index|
-          WrappingFuturismElement.new(extends: extends, placeholder: placeholder, options: options.deep_merge(locals: {as.to_sym => record, "#{as}_counter".to_sym => index})).render
-        }.join.html_safe
-      end
-    end
-
-    def futurize_active_record(records, extends:, placeholder:, **options)
-      Array(records).map { |record|
-        WrappingFuturismElement.new(extends: extends, options: options.merge(model: record), placeholder: placeholder).render
-      }.join.html_safe
-    end
-
-    # wraps functionality for rendering a futurism element
-    class WrappingFuturismElement
-      include ActionView::Helpers
-      include Futurism::MessageVerifier
-
-      attr_reader :extends, :placeholder, :html_options, :data_attributes, :model, :options, :eager, :controller
-
-      def initialize(extends:, placeholder:, options:)
-        @extends = extends
-        @placeholder = placeholder
-        @eager = options.delete(:eager)
-        @controller = options.delete(:controller)
-        @html_options = options.delete(:html_options) || {}
-        @data_attributes = html_options.fetch(:data, {}).except(:sgid, :signed_params)
-        @model = options.delete(:model)
-        @options = data_attributes.any? ? options.merge(data: data_attributes) : options
-      end
-
-      def dataset
-        data_attributes.merge({
-          signed_params: signed_params,
-          sgid: model && model.to_sgid.to_s,
-          eager: eager.presence,
-          signed_controller: signed_controller
-        })
-      end
-
-      def render
-        case extends
-        when :li
-          content_tag :li, placeholder, html_options.deep_merge({data: dataset, is: "futurism-li"})
-        when :tr
-          content_tag :tr, placeholder, html_options.deep_merge({data: dataset, is: "futurism-table-row"})
-        else
-          content_tag :"futurism-element", placeholder, html_options.deep_merge({data: dataset})
-        end
-      end
-
-      def transformed_options
-        require_relative "shims/deep_transform_values" unless options.respond_to? :deep_transform_values
-
-        options.deep_transform_values do |value|
-          next(value) unless value.respond_to?(:to_global_id)
-          next(value) if value.is_a?(ActiveRecord::Base) && value.new_record?
-
-          value.to_global_id.to_s
-        end
-      end
-
-      private
-
-      def signed_params
-        message_verifier.generate(transformed_options)
-      end
-
-      def signed_controller
-        return unless controller.present?
-
-        message_verifier.generate(controller.to_s)
-      end
-    end
-  end
-end