futurism 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 490e77869b91685fe4335badd8006842871eaba8df9cab7998038c531f11e607
-  data.tar.gz: 9bc29e824f7a1e8298942842d543e19eef1e2cf6e22d1b058109675b2d38ad15
+  metadata.gz: ba66b2cb1a12fb863e2e0fc34798411d7f95947a197496150e1a499582fc4e28
+  data.tar.gz: 3f7f290ef2b0b79f9c9e5100e7eaed2520dcb8e481e391bd537649d0023d379b
 SHA512:
-  metadata.gz: 55449d0339a7731cb8725459aca47b66ac8039600c4e8e24a5dbf3f7c9986466f949fc91042f1882dbc2332a61009f3cabbd3c76dda98d1a07bd7a4c9abdb111
-  data.tar.gz: 315e1274d56647b26bd0a703759160f93fa75e8d302bf5cc6304835e74fabc727e68395cba3554bf7a2fa5174acfb11c481fdbe536df0af34870560a1aa54b54
+  metadata.gz: e772253cf0ed802d14c6836c0fb7285f7011f79f516fa88cc85e13191b7de0f29ebbc0edbd5c7996f4f858ec4efe4890613605587a2cbd6c17c4ecbad05b4985
+  data.tar.gz: cf4db9dd38a545a7fe43381dc22597a4c5e77a4023698b19017740fa996e6aa0433e1927c115a1187bb9028ad26e2b36aa3ecd9f66fb19000380a6b6467efffb

data/README.md

@@ -1,12 +1,15 @@
 # Futurism
 [![Twitter follow](https://img.shields.io/twitter/follow/julian_rubisch?style=social)](https://twitter.com/julian_rubisch)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-10-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 Lazy-load Rails partials via CableReady
 
 :rotating_light: *Futurism is still in pre-1.0 state. As much as I hope to keep the API backwards-compatible, I cannot guarantee it* :rotating_light:
 
+<img src="https://user-images.githubusercontent.com/4352208/88374198-9e6f3500-cd99-11ea-804b-0216ed320eff.jpg" alt="birmingham-museums-trust-GrvC6MI-z4w-unsplash" width="50%" align="center"/>
+<span>Photo by <a href="https://unsplash.com/@birminghammuseumstrust?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">Birmingham Museums Trust</a> on <a href="https://unsplash.com/s/photos/futurism?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">Unsplash</a></span>
+
 ## Facts
 - only one dependency: CableReady
 - bundle size (without CableReady) is around [~1.04kB](https://bundlephobia.com/result?p=@minthesize/futurism@0.1.3)
@@ -77,7 +80,7 @@ That way you get maximal flexibility when just specifying a single resource.
 Call `futurize` with a `partial` keyword:
 
 ```erb
-<%= futurize partial: "items/card", locals: {card: @card}, extends: :div %>
+<%= futurize partial: "items/card", locals: {card: @card}, extends: :div do %>
   <div class="spinner"></div>
 <% end %>
 ```
@@ -85,9 +88,42 @@ Call `futurize` with a `partial` keyword:
 You can also use the shorthand syntax:
 
 ```erb
-<%= futurize "items/card", card: @card, extends: :div %>
+<%= futurize "items/card", card: @card, extends: :div do %>
+  <div class="spinner"></div>
+<% end %>
+```
+
+#### Collections
+
+Collection rendering is also possible:
+
+```erb
+<%= futurize partial: "items/card", collection: @cards, extends: :div do %>
   <div class="spinner"></div>
 <% end %>
+```
+
+### HTML Options
+
+You can pass a hash of attribute/value pairs which will be mixed into the HTML markup for the placeholder element. This is important for layouts that require elements to have dimensionality. For example, many scripts calculate size based on element height and width. This option ensures that your elements have integrity, even if they are gone before you see them.
+
+```erb
+<%= futurize @posts, extends: :tr, html_options: {style: "width: 50px; height: 50px;"} do %>
+  <td class="placeholder"></td>
+<% end %>
+```
+
+This will output the following:
+
+```html
+<tr style="width: 50px; height: 50px;">
+  <td class="placeholder"></td>
+</tr>
+```
+
+## Events
+
+Once your futurize element has been rendered, the `futurize:appeared` custom event will be called.
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -119,7 +155,7 @@ $ bin/yarn add @minthesize/futurism
 In your `app/javascript/channels/index.js`, add the following
 
 ```js
-import * as Futurism
+import * as Futurism from '@minthesize/futurism''
 
 import consumer from './consumer'
 
@@ -146,7 +182,13 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://ParamagicDev.github.io/portfolio"><img src="https://avatars2.githubusercontent.com/u/26425882?v=4" width="100px;" alt=""/><br /><sub><b>Konnor Rogers</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=ParamagicDev" title="Code">💻</a></td>
     <td align="center"><a href="https://www.andrewm.codes"><img src="https://avatars1.githubusercontent.com/u/18423853?v=4" width="100px;" alt=""/><br /><sub><b>Andrew Mason</b></sub></a><br /><a href="#maintenance-andrewmcodes" title="Maintenance">🚧</a></td>
     <td align="center"><a href="http://gorails.com"><img src="https://avatars1.githubusercontent.com/u/67093?v=4" width="100px;" alt=""/><br /><sub><b>Chris Oliver</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=excid3" title="Code">💻</a> <a href="https://github.com/julianrubisch/futurism/pulls?q=is%3Apr+reviewed-by%3Aexcid3" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://github.com/leastbad"><img src="https://avatars2.githubusercontent.com/u/38150464?v=4" width="100px;" alt=""/><br /><sub><b>leastbad</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=leastbad" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/leastbad"><img src="https://avatars2.githubusercontent.com/u/38150464?v=4" width="100px;" alt=""/><br /><sub><b>leastbad</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=leastbad" title="Code">💻</a> <a href="https://github.com/julianrubisch/futurism/pulls?q=is%3Apr+reviewed-by%3Aleastbad" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="http://code.digimonkey.com"><img src="https://avatars0.githubusercontent.com/u/74207?v=4" width="100px;" alt=""/><br /><sub><b>M. E. Patterson</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/issues?q=author%3Amepatterson" title="Bug reports">🐛</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://fractaledmind.com"><img src="https://avatars3.githubusercontent.com/u/5077225?v=4" width="100px;" alt=""/><br /><sub><b>Stephen Margheim</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=fractaledmind" title="Code">💻</a></td>
+    <td align="center"><a href="http://hass.codes"><img src="https://avatars2.githubusercontent.com/u/1064205?v=4" width="100px;" alt=""/><br /><sub><b>Hassanin Ahmed</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=sas1ni69" title="Code">💻</a></td>
+    <td align="center"><a href="https://marcoroth.dev"><img src="https://avatars2.githubusercontent.com/u/6411752?v=4" width="100px;" alt=""/><br /><sub><b>Marco Roth</b></sub></a><br /><a href="https://github.com/julianrubisch/futurism/commits?author=marcoroth" title="Code">💻</a></td>
   </tr>
 </table>
 

data/lib/futurism/channel.rb

@@ -7,20 +7,29 @@ module Futurism
     end
 
     def receive(data)
-      resources = data["signed_params"].map { |signed_params|
-        [signed_params, Rails.application.message_verifier("futurism").verify(signed_params)]
-      }
+      resources = data.fetch_values("signed_params", "sgids") { |key| [nil] }.transpose
 
-      ApplicationController.renderer.instance_variable_set(:@env, connection.env)
+      new_env = connection.env.merge(ApplicationController.renderer.instance_variable_get(:@env))
+      ApplicationController.renderer.instance_variable_set(:@env, new_env)
 
-      resources.each do |signed_params, resource|
+      resources.each do |signed_params, sgid|
+        selector = "[data-signed-params='#{signed_params}']"
+        selector << "[data-sgid='#{sgid}']" if sgid.present?
         cable_ready["Futurism::Channel"].outer_html(
-          selector: "[data-signed-params='#{signed_params}']",
-          html: ApplicationController.render(resource)
+          selector: selector,
+          html: ApplicationController.render(resource(signed_params: signed_params, sgid: sgid))
         )
       end
 
       cable_ready.broadcast
     end
+
+    private
+
+    def resource(signed_params:, sgid:)
+      return GlobalID::Locator.locate_signed(sgid) if sgid.present?
+
+      Rails.application.message_verifier("futurism").verify(signed_params)
+    end
   end
 end

data/lib/futurism/channel.rb~

@@ -1,22 +1,35 @@
-class FuturismChannel < ApplicationCable::Channel
-  include CableReady::Broadcaster
+module Futurism
+  class Channel < ActionCable::Channel::Base
+    include CableReady::Broadcaster
 
-  def subscribed
-    stream_from "FuturismChannel"
-  end
+    def subscribed
+      stream_from "Futurism::Channel"
+    end
+
+    def receive(data)
+      resources = data.fetch_values("signed_params", "sgids") { |key| [nil] }.transpose
+
+      new_env = connection.env.merge(ApplicationController.renderer.instance_variable_get(:@env))
+      ApplicationController.renderer.instance_variable_set(:@env, new_env)
 
-  def receive(data)
-    resources = data["sgids"].map { |sgid|
-      [sgid, GlobalID::Locator.locate_signed(sgid)]
-    }
+      resources.each do |signed_params, sgid|
+        selector = "[data-signed-params='#{signed_params}']"
+        selector << "[data-sgid='#{sgid}']" if sgid.present?
+        cable_ready["Futurism::Channel"].outer_html(
+          selector: selector,
+          html: ApplicationController.render(resource(signed_params: signed_params, sgid: sgid))
+        )
+      end
 
-    resources.each do |sgid, resource|
-      cable_ready["FuturismChannel"].outer_html(
-        selector: "[data-sgid='#{sgid}']",
-        html: ApplicationController.render(resource)
-      )
+      cable_ready.broadcast
     end
 
-    cable_ready.broadcast
+    private
+
+    def resource(signed_params:, sgid:)
+      return GlobalID::Locator.locate_signed(sgid) if sgid.present?
+
+      Rails.application.message_verifier("futurism").verify(signed_params)
+    end
   end
 end

data/lib/futurism/helpers.rb

@@ -4,36 +4,71 @@ module Futurism
       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)
+        futurize_active_record(records_or_string, extends: extends, placeholder: placeholder, **options)
       elsif records_or_string.is_a?(String)
-        futurize_with_options(extends: extends, partial: records_or_string, locals: options, placeholder: placeholder)
+        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)
-      case extends
-      when :tr
-        content_tag :tr, placeholder, data: {signed_params: futurism_signed_params(options)}, is: "futurism-table-row"
+      collection = options.delete(:collection)
+      if collection.nil?
+        Element.new(extends: extends, placeholder: placeholder, options: options).render
       else
-        content_tag :"futurism-element", placeholder, data: {signed_params: futurism_signed_params(options)}
+        collection_class_name = collection.klass.name
+        as = options.delete(:as) || collection_class_name.downcase
+        collection.map { |record|
+          Element.new(extends: extends, placeholder: placeholder, options: options.deep_merge(locals: {as.to_sym => record})).render
+        }.join.html_safe
       end
     end
 
-    def futurize_active_record(records, extends:, placeholder:)
+    def futurize_active_record(records, extends:, placeholder:, **options)
       Array(records).map { |record|
+        Element.new(extends: extends, options: options.merge(model: record), placeholder: placeholder).render
+      }.join.html_safe
+    end
+
+    # wraps functionality for rendering a futurism element
+    class Element
+      include ActionView::Helpers
+
+      attr_reader :extends, :placeholder, :html_options, :model, :options
+
+      def initialize(extends:, placeholder:, options:)
+        @extends = extends
+        @placeholder = placeholder
+        @html_options = options.delete(:html_options) || {}
+        @model = options.delete(:model)
+        @options = options
+      end
+
+      def dataset
+        {
+          signed_params: signed_params,
+          sgid: model && model.to_sgid.to_s
+        }
+      end
+
+      def render
         case extends
+        when :li
+          content_tag :li, placeholder, {data: dataset, is: "futurism-li"}.merge(html_options)
         when :tr
-          content_tag :tr, placeholder, data: {signed_params: futurism_signed_params(record)}, is: "futurism-table-row"
+          content_tag :tr, placeholder, {data: dataset, is: "futurism-table-row"}.merge(html_options)
         else
-          content_tag :"futurism-element", placeholder, data: {signed_params: futurism_signed_params(record)}
+          content_tag :"futurism-element", placeholder, {data: dataset}.merge(html_options)
         end
-      }.join.html_safe
-    end
+      end
+
+      private
 
-    def futurism_signed_params(params)
-      Rails.application.message_verifier("futurism").generate(params)
+      def signed_params
+        Rails.application.message_verifier("futurism").generate(options)
+      end
     end
   end
 end

data/lib/futurism/helpers.rb~

@@ -1,13 +1,73 @@
-module FuturismHelper
-  def futurize(records, extends: :tr, &block)
-    placeholder = capture(&block)
-    Array(records).map { |record|
-      case extends
-      when :tr
-        content_tag :tr, placeholder, data: { sgid: record.to_sgid.to_s }, is: "futurism-table-row"
+module Futurism
+  module Helpers
+    def futurize(records_or_string = nil, extends:, **options, &block)
+      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)
+        futurize_with_options(extends: extends, placeholder: placeholder, partial: records_or_string, **options)
       else
-        content_tag :"futurism-element", placeholder, data: { sgid: record.to_sgid.to_s }
+        futurize_with_options(extends: extends, placeholder: placeholder, **options)
       end
-    }.join.html_safe
+    end
+
+    def futurize_with_options(extends:, placeholder:, **options)
+      collection = options.delete(:collection)
+      if collection.nil?
+        Element.new(extends: extends, placeholder: placeholder, options: options).render
+      else
+        collection_class_name = collection.klass.name
+        as = options.delete(:as) || collection_class_name.downcase
+        collection.map { |record|
+          Element.new(extends: extends, placeholder: placeholder, options: options.deep_merge(locals: {as.to_sym => record})).render
+        }.join.html_safe
+      end
+    end
+
+    def futurize_active_record(records, extends:, placeholder:, **options)
+      Array(records).map { |record|
+        Element.new(extends: extends, options: options.merge(model: record), placeholder: placeholder).render
+      }.join.html_safe
+    end
+
+    # wraps functionality for rendering a futurism element
+    class Element
+      include ActionView::Helpers
+
+      attr_reader :extends, :placeholder, :html_options, :model, :options
+
+      def initialize(extends:, placeholder:, options:)
+        @extends = extends
+        @placeholder = placeholder
+        @html_options = options.delete(:html_options) || {}
+        @model = options.delete(:model)
+        @options = options
+      end
+
+      def dataset
+        {
+          signed_params: signed_params,
+          sgid: model && model.to_sgid.to_s
+        }
+      end
+
+      def render
+        case extends
+        when :li
+          content_tag :li, placeholder, {data: dataset, is: "futurism-li"}.merge(html_options)
+        when :tr
+          content_tag :tr, placeholder, {data: dataset, is: "futurism-table-row"}.merge(html_options)
+        else
+          content_tag :"futurism-element", placeholder, {data: dataset}.merge(html_options)
+        end
+      end
+
+      private
+
+      def signed_params
+        Rails.application.message_verifier("futurism").generate(options)
+      end
+    end
   end
 end

data/lib/futurism/version.rb

@@ -1,3 +1,3 @@
 module Futurism
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: futurism
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Julian Rubisch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-21 00:00:00.000000000 Z
+date: 2020-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler