hot-glue 0.6.29 → 0.6.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2adecf8cc5b25919ee16219a6dbf4176a178a1a393adf6a79ae1370a9fe89a9
-  data.tar.gz: 0e02cf776a658911f19bc65f057eb60b57cb04e54a783883e6eb17cc05c0a2fb
+  metadata.gz: fd6bfe4a874a5e894d6b315e72c145f1a563ac3a851e2d4849e41eb127b4402f
+  data.tar.gz: d88aeb4540484a0335150c0d637a8781b1781ff33b227cd65b60d96fa13703ac
 SHA512:
-  metadata.gz: 7789fd5eae2defcc87512f2d10fb3e40c8c68c8ae33380ea072b80239b985edd4f3a1cb4593472fc468e084b4ff480c450ea6edc79384fa3a3013fede972aff6
-  data.tar.gz: 0c5ed6e3d2478c86c6bfa08ed0b4e0306ff9160673c557cb02e633509ce5e93d636b4bd36c11e5d955de5443e5945d71c23caca424979dc9cc0f6377e88b418a
+  metadata.gz: 16e4242488830bb7b4da394a9e6e919b32ef885ddf5ce506e05954ca5830b918a47b2662661289d0bf4adbb6b3e4bf5d89fdb2ddbb59f9333126622461fabb81
+  data.tar.gz: 9ac25352156d69caf694303602f968990441cded93504d6fc340df1b92091bb450f6372d409c10ba2be8a0599e1217e5d037e053b908c2b5136bad148f7719cb

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hot-glue (0.6.28)
+    hot-glue (0.6.30)
       ffaker (~> 2.16)
       rails (> 5.1)
 

data/README.md

@@ -558,22 +558,24 @@ The child object is named `Rule` but it can belong to a Blast or an Agent. (Agen
 
 We build the blast & agent controllers like so:
 
-bin/rails generate hot_glue:scaffold Blast  --downnest='blast_rules(rules)'
-bin/rails generate hot_glue:scaffold Agent  --downnest='agent_rules(rules)'
+
+`bin/rails generate hot_glue:scaffold Blast  --downnest='blast_rules(rules)'`
+
+`bin/rails generate hot_glue:scaffold Agent  --downnest='agent_rules(rules)'`
 
 Notice that the relationship name is `rules` (not blast_rules), so what goes before the parenthesis is the controller name (with prefix)
 What goes inside the controller name is the real relationship name.
 
 For the children, we can't build one controller for the Rule, instead we build one for the `AgentRules` and another for the `BlastRules`
 
-bin/rails generate hot_glue:scaffold Rule  --nested='blast(ruleable)' --controller-prefix='Blast'
-bin/rails generate hot_glue:scaffold Rule  --nested='agent(ruleable)' --controller-prefix='Agent'
+`bin/rails generate hot_glue:scaffold Rule  --nested='blast(ruleable)' --controller-prefix='Blast'`
+`bin/rails generate hot_glue:scaffold Rule  --nested='agent(ruleable)' --controller-prefix='Agent'`
 
 (I realize building one child controller for each type of polymorph is tedius, but this is the best solution I could come up with.)
 
 As these are children, what goes into the `--netsed` setting inside the parentheses is the polymorphic name specified by `as:` when declaring the `belongs_to`
 
-routes.rb
+config/routes.rb
 
 ```
         resources :agents do
@@ -585,6 +587,22 @@ routes.rb
         end
 ```
 
+Outside a polymorphic relationship, you sometimes have children with `belongs_to` that uses a custom name instead of the name of the class (using class_name on the belongs to)
+
+Imagine a `followings` table with two foreign keys: follower_id and follows_id (both pointing to a BskyUser)
+
+
+`belongs_to :follower, class_name: "BskyUser", foreign_key: :follower_id`
+`belongs_to :follows, class_name: "BskyUser", foreign_key: :follows_id`
+
+
+Here, specify nested using square braces for the non-standard parent name
+
+`--nested='bsky_users[follower]'` and `--nested='bsky_users[follows]'`
+
+
+
+
 ### `--stacked-downnesting`
 
 This puts the downnested portals on top of one another (stacked top to bottom) instead of side-by-side (left to right). This is useful if you have a lot of downnested portals and you want to keep the page from getting too wide.
@@ -1068,9 +1086,11 @@ Here, the `cost` and `price` fields will be displayed as wrapped in `number_to_c
 You can also use a binary modifier, which can apply to booleans, datetimes, times, dates or anything else. When using the binary modify, a specific value is displayed if the field is truthy and another one is display if the field is falsy.
 You specify it using a pipe | character like so:
 
+Example binary modification: 
+
 `--modify=paid_at{paid|unpaid}`
 
-here, even though `paid_at` is a datetime field, it will display as-if it is a binary -- showing either the truthy 
+Here, even though `paid_at` is a datetime field, it will display as-if it is a binary -- showing either the truthy 
 label or the falsy label depending on if `paid_at` is or is not null in the database.  
 For all fields except booleans, this affects only the viewable output — 
 what you see on the list page and on the edit page for show-only fields.  
@@ -1081,20 +1101,25 @@ You will need to separately specify them as show-only if you want them to be non
 
 Notice that each modifiers can be used with specific field types. 
 
-| user modifier                 | what it does                                                                                                                                                         | Field types                       |   |   |
-|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|---|---|
-| $                             | wraps output in `number_to_currency()`                                                                                                                               | floats and integers               |   |   |
+| user modifier                 | what it does                                                                                                                                                         | Field types                       |   |    |
+|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|---|----|
+| $                             | wraps output in `number_to_currency()`                                                                                                                               | floats and integers               |   |    |
 | (truthy label)\|(falsy label) | specify a binary switch with a pipe (\|) character if the value is truthy, it will display as "truthy label" if the value is falsy, it will display as "falsy label" | booleans, datetimes, dates, times |   |    |
-| partials                      | applies to enums only, you must have a partial whose name matches each enum type                                                                                     | enums only                        |   |   |
-| tinymce                       | applies to text fields only, be sure to setup TineMCE globally                                                                                                       | text fields only                  |    |   |
-| typeahead                     | turns a foreign key (only) into a searchable typeahead field                                                                                                         | foreign keys only                 |   |   |
-| timezone                      | turns a string (varchar) into a drop down of timezones                                                                                                               | foreign keys only                 |   |   |
-| include_blank                 | special modifier for association fields, adds include_blank to the created dropdown                                                                                   |                                   |
+| partials                      | applies to enums only, you must have a partial whose name matches each enum type                                                                                     | enums only                        |   |    |
+| tinymce                       | applies to text fields only, be sure to setup TineMCE globally                                                                                                       | text fields only                  |   |    |
+| typeahead                     | turns a foreign key (only) into a searchable typeahead field                                                                                                         | foreign keys only                 |   |    |
+| timezone                      | turns a string (varchar) into a drop down of timezones                                                                                                               | foreign keys only                 |   |    |
+| include_blank                 | special modifier for association fields, adds include_blank to the created dropdown                                                                                  |                                   |
+| urlwrap                       | wrap this field in a URL                                                                                                                                             | any printable field               |   |    |
 | none                          | special modifier for using badges                                                                                                                                    |
 
 Except for "(truthy label)" and "(falsy label)" which use the special syntax, use the modifier _exactly_ as it is named.
 
-apply badge behavior using `[` and `]` markers after the modification marker. 
+Some modifiers take a 3rd parameter in `[` and `]` markers after the modification marker. The 3rd parameters function depends on which modifier you are using. 
+
+
+#### Binary (use | to separate "true value" from "false value")
+Can take a bootstrap badge name as 3rd parameter
 
 `--modify=opened_at{opened|closed}[bg-primary|bg-secondary]`
 Applies a badge `bg-primary` to rows with opened_at truthy and `bg-secondary` to rows with opened_at falsy.
@@ -1102,10 +1127,50 @@ Applies a badge `bg-primary` to rows with opened_at truthy and `bg-secondary` to
 to display a badge on everything, use the `none` modifier with the
 `--modify=opened_at{none}[bg-dark]`
 
+#### $
 For the `$` modifier only, if the field name ends with `_cents`, the modifier will automatically divide the field by 100 before displaying it.
-
 (This is consistent with Stripe'e paradigm to always store money in cents, and this way I force myself to put `_cents` on the end of my field names to remind myself that they are in cents.)
 
+
+#### Typeahead
+3rd parameter (in `[...]`) used to specify the nested set IF the typeahead itself is nested (optional)
+- see the typeahead section for details
+
+#### urlwrap
+
+Use to wrap the field contents in a clickable link.
+
+`rails generate hot_glue:scaffold BskyUser --gd --modify='handle{urlwrap}[bsky_url]'`
+
+Here, we are telling Hot Glue that we want to modify the field called `handle` to be wrapped in a URL.
+We form that URL but calling the helper method `bsky_url` (must be defined in your helpers)
+
+When we do make that call, notice that we pass two arguments to bsky_url (not seen):
+1) the field we are modifying
+2) the object
+
+
+`bsky_url(bsky_user.handle, bsky_user)`
+
+(`bsky_user.handle` is the field to be modified, what will become the link text. `bsky_user` is the instance of the model
+object as it is displayed to the screen)
+
+its implementation might look like this:
+
+```
+module BskyUserHelper
+
+  def bsky_url(link_text, bsky_user)
+    link_to link_text, "https://#{bsky_user.handle}", target: "_blank"
+  end
+end
+```
+In this case I happen to be turning piece of text _that is the link itself_ into a link,
+which is why you see `"https://#{bsky_user.handle}"` in the URL being generated, but this is arbitrary.
+You can make any piece of text into a link, the helper method is only used to construct the link.
+
+
+
 ### `--alt-foreign-key-lookup=`
 
 Use for a join table to specify that a field should be looked up by a different field. For example, when you want to lookup a user by a (complete) email address.
@@ -2161,7 +2226,29 @@ This means that to find users within the search, the essential piece of informat
   end
 ```
 
+If you want your typeahead to accept an input for a non-matched field, you need to use a factory (see `--factory-creation`)
 
+Here, we assume that Authors are nested within a library (an arbitrary abstraction to demonstrate a typeahead at a nested route)
+
+```
+      factory = AuthorsFactory.new(
+        library: library,
+        query: params[:authors_query],
+        author_params: modified_params)
+```
+
+Your authors factory will need to check the params for `author_params[:author_id].empty?`
+
+
+When the factory is passed an empty string here, it is from a non-matched lookup. You will either lookup the author_id if provided, or create a new one if not
+```
+      if !author_params[:author_id].empty?
+        author = Author.find(author_params[:author_id])
+      else
+        author = Target.find_or_create_by!(library: library,  name: query)
+      end
+```
+Notice this is creating a new author by the `name` field, which should be same field you are searching by in the typeahead.
 
 --
 
@@ -2244,13 +2331,28 @@ These automatic pickups for partials are detected at build time. This means that
 
 # VERSION HISTORY
 
-#### 2025-10-11 - v0.6.39
+#### 2025-10-28 - v0.6.31
+
+- new modification directive: `urlwrap`: use to wrap the field contents in a clickable link.
+See docs for "urlwrap" in the `--modify=` section above
+
+- Fixes for typeaheads: corrects search url when the typeahead is built against a two-word model name
+
+- Fixes for source reflection on has_many associations
+
+#### 2025-10-19 - v0.6.30
+- fixes references from search typeaheads to a typeahead controller which is nested
+- `--nested` can now take square braces if the relationship from child to parent (belongs_to) uses a non-standard association name; @downnest_object fix for data array; changes to object_scope to accomodate new paradigm
+
+
+
+#### 2025-10-11 - v0.6.29
 
 • When specifying  a alt lookup in non-Gd mode, we treat this a security concern because alt lookups can get any related record from the database; if you use a factory when creating your object, you can pass the lookup to the factory and scope your lookup in there; fix to not raise exception when specified an alt lookup in non-Gd mode if you are also using a factory
 
 • Attachments now have a graceful fail if the attachment is invariable (cannot be made into a thumbnail), and so there is no thumbnail to display. Instead, a small box with the file type ("pdf" or "msword") is shown in place where the thumbnail would display
 
-• Adds a 'tripple' implementation for newer pagination gems: will_paginate and pagy. HG will auto detect which pagination gem you have in your Gemfile, and pick ONE of the three based on this preference order: Pagy over will_paginate; will_paginate over Kaminari, no pagination if none of the three are installed.
+• Adds a 'triple' implementation for newer pagination gems: will_paginate and pagy. HG will auto detect which pagination gem you have in your Gemfile, and pick ONE of the three based on this preference order: Pagy over will_paginate; will_paginate over Kaminari, no pagination if none of the three are installed.
 
 Kaminari is barely workable with newer Rails and seems somewhat abandoned; will_paginate is officially in maintenance mode, so Pagy is the way to go. I have implemented all three for the widest legacy support. On my Rails Cookbook pages, I have replaced Kaminari with Pagy.
 

data/lib/generators/hot_glue/fields/association_field.rb

@@ -103,8 +103,7 @@ class AssociationField < Field
 
       search_url  = "#{namespace ? namespace + "_" : ""}" +
         modify_as[:nested].join("_") + ( modify_as[:nested].any? ? "_" : "") +
-        + "#{assoc.class_name.downcase.pluralize}_typeahead_index_url"
-
+        + "#{assoc.name.to_s.pluralize}_typeahead_index_url"
 
       if @modify_as[:nested].any?
         search_url  << "(" + modify_as[:nested].collect{|x| "#{x}"}.join(",") + ")"
@@ -204,7 +203,10 @@ class AssociationField < Field
     assoc_name = name.to_s.gsub("_id","")
     assoc = eval("#{class_name}.reflect_on_association(:#{assoc_name})")
     if modify_as && modify_as[:typeahead]
-      search_url  = "#{namespace ? namespace + "_" : ""}#{assoc.class_name.downcase.pluralize}_typeahead_index_url"
+
+
+      search_url  = "#{namespace ? namespace + "_" : ""}#{ modify_as[:nested][0] ? modify_as[:nested][0] + "_" : ""}#{assoc.name.to_s.pluralize}_typeahead_index_url"
+
 
       # \"q[0][#{name}_search]\"
       # @q['0']['#{name}_search']

data/lib/generators/hot_glue/fields/field.rb

@@ -146,7 +146,13 @@ class Field
 
     elsif modify_as[:timezone]
       res += "<%= #{singular}.#{name} %>"
+    elsif modify_as[:urlwrap]
+      # helper_method =  modify_as[:helper_method].split(" ")[0]
+      # param = modify_as[:helper_method].split(" ")[1]
+
+      res += "<%= #{modify_as[:helper_method]}(#{singular}.#{name}, #{singular})  %>"
     elsif modify_as[:enum]
+
     elsif modify_as[:none]
         field_view_output
       # res += "<%= render partial: #{singular}.#{name}, locals: {#{singular}: #{singular}} %>"

data/lib/generators/hot_glue/layout_strategy/bootstrap.rb

@@ -39,7 +39,6 @@ class LayoutStrategy::Bootstrap < LayoutStrategy::Base
   end
 
   def downnest_portal_column_width(downnest)
-
     "col-sm-#{ builder.layout_object[:portals][downnest][:size] }"
   end
 

data/lib/generators/hot_glue/scaffold_generator.rb

@@ -300,6 +300,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
           setting =~ /(.*){(.*)}/
           key, lookup_as = $1, $2
         end
+
         if ["$"].include?($2)
           @modify_as[key.to_sym] =  {cast: $2, badges: $3}
         elsif $2.include?("|")
@@ -322,6 +323,10 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
           @modify_as[key.to_sym] =  {timezone: 1, badges: $3}
         elsif $2 == "include_blank"
           @modify_as[key.to_sym] =  {include_blank: true}
+        elsif $2 == "urlwrap"
+          helper_method = $3
+          @modify_as[key.to_sym] = { urlwrap: true,
+                                     helper_method: helper_method }
         elsif $2 == "none"
           @modify_as[key.to_sym] =  {none: 1, badges: $3}
         else
@@ -456,11 +461,10 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
 
         child_name.gsub!("+","")
 
-
-        @downnest_object[child] = {
+        @downnest_object[child_name] = {
           name: child_name,
           extra_size: extra_size,
-          polymorph_as: polymorph_as
+          polymorph_as: polymorph_as,
         }
       end
     end
@@ -512,17 +516,27 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
 
     if !@nested.nil?
       @nested_set = @nested.split("/").collect { |arg|
-        if arg.include?("(")
+        if arg.include?("[") && arg.include?("(")
+          arg =~ /(.*)\((.*)\)\[(.*)\]/
+          singular, polymorph_as, parent_name = $1, $2, $3
+
+        elsif arg.include?("(")
           arg =~ /(.*)\((.*)\)/
           singular, polymorph_as = $1, $2
+          parent_name = singular
+        elsif arg.include?("[")
+          arg =~ /(.*)\[(.*)\]/
+          singular, parent_name = $1, $2
         else
           singular = arg
+          parent_name = singular
         end
 
         {
           singular: singular,
           plural: singular.pluralize,
-          polymorph_as: polymorph_as
+          polymorph_as: polymorph_as,
+          parent_name: parent_name
         }
       }
       puts "NESTING: #{@nested_set}"
@@ -1426,17 +1440,34 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
   end
 
   def object_scope
+    if @nested_set.any? && @nested_set.last[:parent_name]
+      last_parent = @nested_set.last[:parent_name]
+      foreign_key =  eval("#{singular_class}.reflect_on_association(:#{last_parent})").foreign_key
+      association = eval(singular_class).reflect_on_association(@nested_set.last[:parent_name].to_sym)
+                                        .klass.reflect_on_all_associations(:has_many)
+                                        .to_a.find{|x|
+
+          if x.source_reflection
+            x.table_name == plural
+          end
+      }.plural_name
+
+    else
+      association = plural
+    end
+
+
     if @auth && !@god
       if @nested_set.none?
-        @auth + ".#{plural}"
+        @auth + ".#{association}"
       else
-        "@" + @nested_set.last[:singular] + ".#{plural}"
+        "@" + @nested_set.last[:singular] + ".#{association}"
       end
     else
       if @nested_set.none?
         @singular_class
       else
-        "@" + @nested_set.last[:singular] + ".#{plural}"
+        "@" + @nested_set.last[:singular] + ".#{association}"
       end
     end
   end
@@ -1825,7 +1856,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
     else
       if !@self_auth
 
-        res << spaces(4) + "@#{ plural_name } = #{ object_scope.gsub("@",'') }#{ n_plus_one_includes }#{record_scope}#{".all" if n_plus_one_includes.blank? && record_scope.blank? }"
+        res << spaces(4) + "@#{ plural_name } = #{ object_scope.gsub("@",'') }#{record_scope}#{ n_plus_one_includes }#{".all" if n_plus_one_includes.blank? && record_scope.blank? }"
 
         if @search_fields
           res << @search_fields.collect{ |field|

data/lib/generators/hot_glue/templates/controller.rb.erb

@@ -24,15 +24,15 @@ class <%= controller_class_name %> < <%= controller_descends_from %>
   before_action :<%= arg[:singular] %><%= ", if: -> { params.include?(:#{arg[:singular]}_id) }" if arg[:optional] %><% } %><% end %>
   before_action :load_<%= singular_name %>, only: %i[<%= "show edit update" unless @no_edit %> <%= "destroy" unless @no_delete %>]
   after_action -> { flash.discard }, if: -> { request.format.symbol == :turbo_stream }<% if @nested_set.any? %>
-    def <%= @nested_set[0][:singular] %><% if @god
+
+  def <%= @nested_set[0][:singular] %><% if @god
        next_object = nil
        collect_objects = @nested_set.reverse.collect {|x|
-           if eval("#{next_object || class_name}.reflect_on_association(:#{x[:singular]})").nil? #&& eval("! #{next_object || class_name}.instance_methods.include?(:#{x[:singular]})")
-             raise "***** Unable to find the association `#{x[:singular]}` on the class #{next_object || class_name} ..... you probably want to add `belongs_to :#{x[:singular]}` to the #{next_object || class_name} object?"
-           end
-           # if  eval("#{next_object || class_name}.reflect_on_association(:#{x[:singular]})")
-           next_object = eval("#{next_object || class_name}.reflect_on_association(:#{x[:singular]})").class_name
+           assoc_name = x[:parent_name] || x[:singular]
+           # if eval("#{next_object || class_name}.reflect_on_association(:#{assoc_name})").nil?
+           #   raise "***** Unable to find the association `#{assoc_name}` on the class #{next_object || class_name} ..... you probably want to add `belongs_to :#{assoc_name}` to the #{next_object || class_name} object?"
            # end
+           next_object = eval("#{next_object || class_name}.reflect_on_association(:#{assoc_name})").class_name
        }
        root_object = collect_objects.last
      else
@@ -42,6 +42,7 @@ class <%= controller_class_name %> < <%= controller_descends_from %>
          root_object = @auth + "." + @nested_set[0][:plural]
        end
      end
+
  %><% if !@god && @nested_set[0][:singular] == @auth_identifier %>
     @<%= @nested_set[0][:singular] %> ||= <%= root_object %>
  <% else %>
@@ -63,7 +64,7 @@ class <%= controller_class_name %> < <%= controller_descends_from %>
   def load_<%= singular_name %>
     <% if @nested_set[0] && @nested_set[0][:optional] %>if params.include?(:<%= @nested_set.last[:singular] %>_id)
       @<%= singular_name %> = <%= object_scope.gsub("@",'') %>.find(params[:id])
-    else <% end %>@<%= singular_name %> = <%= object_scope %>.find(params[:id])<% if @nested_set[0] && @nested_set[0][:optional]  %>
+    else <% end %>@<%= singular_name %> = <%= object_scope.gsub("@",'') %>.find(params[:id])<% if @nested_set[0] && @nested_set[0][:optional]  %>
     end<% end %>
   end
   <% else %>

data/lib/hotglue/version.rb

@@ -1,5 +1,5 @@
 module HotGlue
   class Version
-    CURRENT = '0.6.29'
+    CURRENT = '0.6.31'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hot-glue
 version: !ruby/object:Gem::Version
-  version: 0.6.29
+  version: 0.6.31
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-11 00:00:00.000000000 Z
+date: 2025-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails