base_editing_bootstrap 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3e85aa56464a6efc36c36170a8d8473b8c6c97107f62ba9a3d9599232c0d30b
-  data.tar.gz: 48c8890bba4d8740cfb1a210a93a9743b658fa3ef505f0c39db5b6b621504a35
+  metadata.gz: 489e2ffcb61b916547f555b4b80a90e9d542c0738afb83dd104418e29865a542
+  data.tar.gz: 3f7cba0e07451401983eeef463ff0a18ad97f2aee1a5c16a836980d4e77e4ca3
 SHA512:
-  metadata.gz: 9716d018b278998444613dec959a1cf70938d17b02828ff3c5b4bd1efa3ef5ec94e46fefcc06de6f8329f04201f12a2a57ad3375867d5e9f693f0c18a16db4e3
-  data.tar.gz: 6236f739ce354a526bbab9664337dccecc6b54f39976c7491cbc3bc15b8d8d4f310714bb0df6c08b5815d37343563da1dfc1528d6b865cf7eaadcd6c235bad5d
+  metadata.gz: 2e62893f671fe1ef62e0c9fe52cef3c104fdab7646bb1a03b774ae9d9c5650f288e7329b5e4c5e29fda3f935c0e3706a1af8ecb90b220a16fa1f6f5e8759e726
+  data.tar.gz: 52055575f2459020e2963d8af95da7c904c3301cf8c4127685a1529f062ab884d9fa77fe59b22b3ff20234e23b5ee0d5db84ae9cfc472cda58ea7748cf63ec9c

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
 - - -
+## 1.10.0 - 2025-09-12
+#### Features
+- Automatic Nested attributes - (dad38de) - Marino Bonetti
+
+- - -
+
 ## 1.9.0 - 2025-07-30
 #### Bug Fixes
 - Correct add is-invalid class on relation fields - (21e4a92) - Marino Bonetti

data/README.md

@@ -1,11 +1,14 @@
 # BaseEditingBootstrap
+
 [![Gem Version](https://badge.fury.io/rb/base_editing_bootstrap.svg)](https://badge.fury.io/rb/base_editing_bootstrap)
 
 ### Active tested on:
+
 * rails: 7.x,8.x
 * ruby: 3.x
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -13,29 +16,46 @@ gem "base_editing_bootstrap"
 ```
 
 And then execute:
+
 ```bash
 $ bundle
 ```
 
 Or install it yourself as:
+
 ```bash
 $ gem install base_editing_bootstrap
 ```
 
 Then run installer:
+
 ```bash
 $ bundle exec rails g base_editing_bootstrap:install
 ```
 
 **Si presume quindi che ActiveStorage sia correttamente installato, completo del javascript per il direct upload**
 
+### Note for NestedAttributes
+
+Seguire le istruzioni per installare anche NestedAttributeForm Controller per stimulus:
+
+```shell
+bin/importmap pin @stimulus-components/rails-nested-form
+```
+
+e seguire installazione https://www.stimulus-components.com/docs/stimulus-rails-nested-form
+
 ### Generators
+
 Then Install dependency (if you run base_editing_bootstrap:install you are good to go):
+
 ```bash
 
 bundle exec rails g pundit:install
 ```
-Aggiungere ad ApplicationController 
+
+Aggiungere ad ApplicationController
+
 ```ruby
   include Pundit::Authorization
 ```
@@ -48,40 +68,43 @@ documentazione e avrete la vostra versione di boostrap installata.
 Installare `gem "factory_bot_rails"`
 
 ### Initializers
+
 E' possibile configurare BaseEditingBootstrap con alcune impostazioni:
+
 ```ruby
   BaseEditingBootstrap.configure do |config|
-    ##
-    # Controller da cui derivare poi il BaseEditingController da cui derivano 
-    # tutti i controller sottostanti
-    # @default "ApplicationController"
-    # config.inherited_controller = 'ApplicationController'
-
-    ##
-    # Configurazione per alterare lo standard di azione post aggiornamento record
-    # il default è andare nella pagina di editing del record
-    # possibili valori :edit , :index
-    # config_accessor :after_success_update_redirect, default: :edit
-
-    ##
-    # Configurazione per alterare lo standard di azione post creazione record
-    # il default è andare nella pagina di editing del record
-    # possibili valori :edit , :index  
-    # config_accessor :after_success_create_redirect, default: :edit
-  
-  end
+  ##
+  # Controller da cui derivare poi il BaseEditingController da cui derivano 
+  # tutti i controller sottostanti
+  # @default "ApplicationController"
+  # config.inherited_controller = 'ApplicationController'
+
+  ##
+  # Configurazione per alterare lo standard di azione post aggiornamento record
+  # il default è andare nella pagina di editing del record
+  # possibili valori :edit , :index
+  # config_accessor :after_success_update_redirect, default: :edit
+
+  ##
+  # Configurazione per alterare lo standard di azione post creazione record
+  # il default è andare nella pagina di editing del record
+  # possibili valori :edit , :index  
+  # config_accessor :after_success_create_redirect, default: :edit
+
+end
 
 ```
 
 ## Usage
+
 Utilizzo per modello base, in questo esempio prendiamo come modello Post come esempio del dummy.
 
-- Creare il Modello ed includere 
+- Creare il Modello ed includere
   ```ruby
    include BaseEditingBootstrap::BaseModel
   ```
 - La factory nelle spec deve contenere il trait `with_invalid_attributes` per definire la situazione di dati per record
-  non valido. ES:  
+  non valido. ES:
   ```ruby
   trait :with_invalid_attributes do
    name {nil} # name dovrebbe essere obbligatorio nel modello
@@ -126,13 +149,13 @@ Utilizzo per modello base, in questo esempio prendiamo come modello Post come es
     ```shell
     rails g base_editing_bootstrap:field_override ModelName field1 field2:type
     ```
-  - è possibile customizzare 
-    - un text help per ogni campo andando ad aggiungere nelle traduzioni la relativa 
+  - è possibile customizzare
+    - un text help per ogni campo andando ad aggiungere nelle traduzioni la relativa
       traduzione nella posizione: `it.activerecord.attributes.MODEL.FIELD/help_text` oppure `help_text_html` in caso di
       contenuto con html
-    - un blocco per l'unità di misura accanto al campo aggiungendo alle traduzioni: 
+    - un blocco per l'unità di misura accanto al campo aggiungendo alle traduzioni:
       `it.activerecord.attributes.MODEL.FIELD/unit`
-      
+
 - [OPTIONAL] la medesima cosa è possibile fare con il rendering dei campi
   delle celle della tabella
   ```shell
@@ -148,48 +171,51 @@ Utilizzo per modello base, in questo esempio prendiamo come modello Post come es
   **Cell Field**:
   - created_at => timestamps.html.erb
   - updated_at => timestamps.html.erb
-  - Enum              => _enum.html.erb
+  - Enum => _enum.html.erb
     Per gli enum, le traduzioni dei labels di ogni valore provengono da i18n
     attraverso l'helper: `Utilities::EnumHelper#enum_translation` con variant `:cell_field`
     il quale sfrutta human_attribute_name del modello con 'attributo.enum_value',
     quindi ad esempio per un modello `Post` con enum `categoria` e un enum `importante`, la ricerca nelle traduzioni
     saranno così composte:
     - it.activerecord.attributes.post/categoria.importante_cell_field
-    - it.activerecord.attributes.categoria.importante_cell_field  
+    - it.activerecord.attributes.categoria.importante_cell_field
     - it.attributes.importante_cell_field
     - it.activerecord.attributes.post/categoria.importante
     - it.activerecord.attributes.categoria.importante
     - it.attributes.importante => nil
-  - default    => base.html.erb
-  
+  - default => base.html.erb
+
   **Form Field**
-  - Integer           => _integer.html.erb
-  - Float             => _decimal.html.erb
-  - Decimal           => _decimal.html.erb
-  - DateTime          => _datetime.html.erb
-  - Date              => _date.html.erb
-  - Boolean           => _boolean.html.erb
-  - Enum              => _enum.html.erb
+  - Integer => _integer.html.erb
+  - Float => _decimal.html.erb
+  - Decimal => _decimal.html.erb
+  - DateTime => _datetime.html.erb
+  - Date => _date.html.erb
+  - Boolean => _boolean.html.erb
+  - Enum => _enum.html.erb
     Per gli enum, le traduzioni dei labels di ogni valore provengono da i18n
     attraverso l'helper: `Utilities::EnumHelper#enum_translation`" con variante `:form_field`
-    il quale sfrutta human_attribute_name del modello con 'attributo.enum_value', 
+    il quale sfrutta human_attribute_name del modello con 'attributo.enum_value',
     quindi ad esempio per un modello `Post` con enum `categoria` e un enum `importante`, la ricerca nelle traduzioni
-    saranno così composte: 
+    saranno così composte:
     - it.activerecord.attributes.post/categoria.importante_form_field
     - it.activerecord.attributes.categoria.importante_form_field
     - it.attributes.importante_form_field
     - it.activerecord.attributes.post/categoria.importante
     - it.activerecord.attributes.categoria.importante
     - it.attributes.importante => nil
-  - belongs_to      => _belongs_to_select.html.erb 
+  - belongs_to => _belongs_to_select.html.erb
     Come si può leggere dal partial, il modello che viene utilizzato come base dati per la collection deve
     avere come metodo `option_label` che deve ritornare la label da utilizzare nelle options.
     Di default questo metodo utilizza il semplice #to_s
     Ha anche un metodo per il valore da utilizzare come chiave, di default viene dedotto dalla reflection
     come anche il nome della classe da utilizzare come sorgente dei dati della collection
-  - Default/String    => _base.html.erb
-  
-  In futuro si prevede di aggiungere automatismi per renderizzare senza 
+  - accept_nested_field => _accept_nested_field.html.erb
+    Questo partial renderizza una tabella per i campi associati al modello.  
+    Più informazioni nelle note per il [nested attributes](#nested-attributes)
+  - Default/String => _base.html.erb
+
+  In futuro si prevede di aggiungere automatismi per renderizzare senza
   l'intervento dell'utente dei campi.
 - [OPTIONAL] Search Form:  
   Per poter aggiungere una form di ricerca basta aggiungere alla policy
@@ -205,22 +231,40 @@ Utilizzo per modello base, in questo esempio prendiamo come modello Post come es
   #...
   ```
 
+### Nested Attributes
+
+Il funzionamento si basa completamente sul sistema di NestedAttributes
+di [Rails](https://api.rubyonrails.org/classes/ActiveRecord/NestedAttributes/ClassMethods.html)  
+Note:
+
+- Nelle policy bisogna definire come campo da editare il nome della relazione/nested_attribute
+- Nella policy bisogna inoltre definire per i permitted_attributes anche il
+  `XXXXX_attributes => [Array attributi da editare] + [:id,:_destroy]`
+- Il permitted _destroy vale solamente nel caso in cui si definisca nei nested_attributes che debba essere cancellabile.
+- I campi visualizzati del modello sono presi dalla relativa policy.
+
+Fai riferimento all'implementazione di esempio del dummy `Company->addresses`
+
 ### Translations
+
 Traduzioni disponibili:  
-Per i bottoni della index, è possibile eseguire l'override del testo presente nel bottone. 
+Per i bottoni della index, è possibile eseguire l'override del testo presente nel bottone.
 Leggere la documentazione nel file `app/helpers/base_editing_helper.rb#translate_with_controller_scoped`
 
-
 ## Testing helpers
 
 ### Requirements(installed with generators)
+
 ```ruby
 group :test do
   gem 'rails-controller-testing'
 end
 ```
-### Usage 
+
+### Usage
+
 Controllers:
+
 ```ruby
 require 'rails_helper'
 RSpec.describe "ServiceControllers", type: :request do
@@ -229,7 +273,9 @@ RSpec.describe "ServiceControllers", type: :request do
   end
 end
 ```
+
 Model:
+
 ```ruby
 require 'rails_helper'
 RSpec.describe Service, type: :model do
@@ -238,7 +284,9 @@ RSpec.describe Service, type: :model do
                   ransack_permitted_associations: []
 end
 ```
+
 Policy
+
 ```ruby
 require 'rails_helper'
 ##
@@ -264,10 +312,11 @@ end
 ```
 
 ## Message translations
+
 I messaggi di generati per il flash provengono dal metodo BaseEditingBootstrap::ActionTranslation.human_action_message  
 e seguono una logica simile ad human_attribute_name.  
 Sono già presenti i messaggi di default, a cui viene passato il nome del modello,  
-ma è possibile fare override del messaggio con la classe: 
+ma è possibile fare override del messaggio con la classe:
 
 ```yaml
 LANG:
@@ -281,22 +330,24 @@ LANG:
           created: "customized %{model} created"
     unsuccessful:
       messages:
-        created: 
+        created:
         updated: 
 ```
 
+## Contributing
 
+1. Setup env with:
 
-## Contributing
-1. Setup env with:  
 ```shell
 docker compose run app spec/dummy/bin/setup
 ```
 
-2. Start environment with:  
+2. Start environment with:
+
 ```shell
 docker compose up
 ```
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/helpers/utilities/form_helper.rb

@@ -24,14 +24,20 @@ module Utilities
         type = :enum
         generic_field = "enum"
       elsif form.object.class.respond_to?(:reflect_on_association) &&
-        form.object.class.reflect_on_association(field.to_s).is_a?(ActiveRecord::Reflection::BelongsToReflection) &&
-        !form.object.class.reflect_on_association(field.to_s).polymorphic? # non deve essere polymorphic
+            form.object.class.reflect_on_association(field.to_s).is_a?(ActiveRecord::Reflection::BelongsToReflection) &&
+            !form.object.class.reflect_on_association(field.to_s).polymorphic? # non deve essere polymorphic
         # Abbiamo una relazione belongs_to da gestire
         reflection = form.object.class.reflect_on_association(field.to_s)
         type = :belongs_to
         generic_field = "belongs_to_select"
         locals[:relation_class] = reflection.klass
         locals[:foreign_key] = reflection.foreign_key
+      elsif form.object.class.respond_to?(:nested_attributes_options) &&
+            form.object.class.nested_attributes_options.key?(field.to_sym)
+        type= :nested_attributes
+        generic_field = "accept_nested_field"
+        reflection = form.object.class.reflect_on_association(field.to_s)
+        locals[:new_object] = reflection.klass.new(reflection.foreign_key => form.object)
       else
         if form.object.class.respond_to?(:type_for_attribute)
           type = form.object.class.type_for_attribute(field).type

data/app/views/base_editing/_nested_row_form.html.erb

@@ -0,0 +1,16 @@
+<tr class="nested-form-wrapper" data-new-record="<%= form.object.new_record? %>" id="<%= dom_id(form.object) %>">
+
+  <% policy(form.object).editable_attributes.each do |field| %>
+    <td>
+      <%= form_print_field(form, field) %>
+      <%= error_messages_for(form.object, field) %>
+    </td>
+
+  <% end %>
+
+  <td class="d-flex justify-content-end">
+    <button type="button" class="btn btn-outline-danger" data-action="nested-form#remove"><%= icon("trash") %></button>
+    <%= form.hidden_field :_destroy %>
+  </td>
+
+</tr>

data/app/views/base_editing/form_field/_accept_nested_field.html.erb

@@ -0,0 +1,48 @@
+<%# locals: (form:, field:,new_object:) -%>
+<%= content_tag :table, class: "table", data: {controller: 'nested-form'} do %>
+
+  <thead>
+  <tr>
+    <% policy(new_object).editable_attributes.each do |field| %>
+      <th>
+        <%= new_object.class.human_attribute_name(field) %>
+      </th>
+    <% end %>
+    <th class="text-end">
+      <button type="button" data-action="nested-form#add" class="btn btn-outline-success"><%= icon("plus-lg") %></button>
+    </th>
+  </tr>
+  </thead>
+
+  <template data-nested-form-target="template">
+    <%= form.fields_for field, new_object, child_index: 'NEW_RECORD' do |form_for_sections| %>
+      <%= render "nested_row_form", form: form_for_sections %>
+    <% end %>
+  </template>
+
+  <tbody>
+
+  <%= form.fields_for field do |form_for_sections| %>
+    <%= render "nested_row_form", form: form_for_sections %>
+  <% end %>
+
+  <!-- Inserted elements will be injected before that target. -->
+  <tr data-nested-form-target="target"></tr>
+
+  </tbody>
+
+
+<% end %>
+
+<% if form.object.errors.key?(field) %>
+
+  <div class="row">
+    <div class="col-12">
+      <div class="alert alert-danger">
+        <%= form.object.errors[field].join(", ") %>
+      </div>
+    </div>
+  </div>
+
+<% end %>
+

data/lib/base_editing_bootstrap/VERSION

@@ -1 +1 @@
-1.9.0
+1.10.0

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

@@ -30,6 +30,16 @@ module BaseEditingBootstrap
           gem 'rails-controller-testing', group: :test, comment: "Required if used with controllers spec"
         end
       end
+
+      def install_nested_attributes_dependencies
+        # attualmente penso sia più sensato semplicemente scrivere a video i passaggi necessari, dato che
+        # potrebbe essere già presente importmap, nested_attribute_controller e le varie configurazioni
+
+        say "Install dependencies for nested attributes:"
+        say "   bin/importmap pin @stimulus-components/rails-nested-form"
+        say "Attiva quindi come spiegato qua: https://www.stimulus-components.com/docs/stimulus-rails-nested-form il controller"
+
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: base_editing_bootstrap
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Marino Bonetti
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-30 00:00:00.000000000 Z
+date: 2025-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -350,6 +350,7 @@ files:
 - app/views/base_editing/_index_main_buttons.html.erb
 - app/views/base_editing/_index_title_header.html.erb
 - app/views/base_editing/_navbar.html.erb
+- app/views/base_editing/_nested_row_form.html.erb
 - app/views/base_editing/_new_page_title_header.html.erb
 - app/views/base_editing/_search.html.erb
 - app/views/base_editing/_search_field.erb
@@ -363,6 +364,7 @@ files:
 - app/views/base_editing/cell_field/_enum.html.erb
 - app/views/base_editing/cell_field/_timestamps.html.erb
 - app/views/base_editing/edit.html.erb
+- app/views/base_editing/form_field/_accept_nested_field.html.erb
 - app/views/base_editing/form_field/_base.html.erb
 - app/views/base_editing/form_field/_belongs_to_select.html.erb
 - app/views/base_editing/form_field/_boolean.html.erb