lato 3.18.1 → 3.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e61b931ff0b3fe86aa8c722e1ca3b016be7799e935d072979de181a4e025b89
-  data.tar.gz: 487f4fc01d7f58be47a74556498922f05230869998d91cfb95459d766746d118
+  metadata.gz: 3e9bc22ce3f30979695df7a71d397d319eae7b5ac80a5b28d4581a2fa959efe5
+  data.tar.gz: 9616d1b12c930765ae3c00a1fbcc813c37310193a776cee7ee7d2c469779e3e2
 SHA512:
-  metadata.gz: f82274922dc305b1e19a506b7958fd0c89dbb52ad00923bb1b9d1e72b16002a6f8e71bac6b4fde9f1af4ae4eb56884be3056b3ac5e99a735b9ecfb4fbb5a3acb
-  data.tar.gz: c8db5342fd6e9aa26b298ac91a9ed939907e8b02499603b4e5b2359f3b1cb9c891028d7f7d344c858f07cce16e9275c33a2de16c94538591db5a6b7fa5481737
+  metadata.gz: 93f49738ee88b189cc814d2dba9221a6602ec667a8db504535668481b710eb59a0f663d015a833113d2dd56872719651eae789aa83af7e705cd204e5978f849d
+  data.tar.gz: f6eff2ccfce2088fb82a968d8688fde484824f3c05ec8331ffbd9fb2a83d6bd5ce66c210a4785421c29a2258ee9d20e1b0cdbd6f2b2581d6a8e2765aa2b1009b

data/README.md

@@ -121,6 +121,17 @@ rails lato:generate:favicon
 rails lato:generate:pwa
 ```
 
+## Upgrading
+
+To upgrade Lato to the latest version, run the following commands:
+
+```bash
+bundle update lato
+rails lato:install:application
+rails lato:install:migrations
+rails db:migrate
+```
+
 ## Development
 
 Clone repository, install dependencies, run migrations and start:

data/app/jobs/lato/application_job.rb

@@ -24,6 +24,36 @@ module Lato
       )
     end
 
+    # This method can be used to add a log message to the operation.
+    def add_operation_log(message)
+      return false unless operation?
+
+      @operation.update(
+        logs: @operation.logs + [[Time.now.utc, message]]
+      )
+    end
+
+    # This method can be used to replace a log message to the operation.
+    def replace_operation_log(message, index = -1)
+      return false unless operation?
+        
+      logs = @operation.logs
+      index = 0 if logs.empty?
+      logs[index] = [Time.now.utc, message]
+      @operation.update(
+        logs: logs
+      )
+    end
+
+    # This method can be used to clear all logs of the operation.
+    def clear_operation_logs
+      return false unless operation?
+        
+      @operation.update(
+        logs: []
+      )
+    end
+
     # This method can be used to save a file as output of the operation.
     def save_operation_output_file(file_path)
       return false unless operation?
@@ -43,8 +73,15 @@ module Lato
       @operation.update(
         active_job_output: @operation.active_job_output.merge(_message: message)
       )
+    end
+
+    # This method can be used to save an action as output of the operation.
+    def save_operation_output_action(label, href, attributes = {})
+      return false unless operation?
 
-      true
+      @operation.update(
+        active_job_output: @operation.active_job_output.merge(_action: { label: label, href: href, attributes: attributes })
+      )
     end
 
     private

data/app/models/lato/operation.rb

@@ -25,6 +25,7 @@ module Lato
 
     before_create do
       self.status = :created
+      self.logs ||= []
       self.active_job_input ||= {}
       self.active_job_output ||= {}
     end
@@ -40,6 +41,10 @@ module Lato
       active_job_output && !active_job_output['_message'].blank?
     end
 
+    def output_action?
+      active_job_output && !active_job_output['_action'].blank?
+    end
+
     def output_error?
       active_job_output && !active_job_output['_error'].blank?
     end
@@ -59,6 +64,10 @@ module Lato
       active_job_output['_message']
     end
 
+    def output_action
+      active_job_output['_action']
+    end
+
     # Operations
     ##
 

data/app/views/lato/components/_operation.html.erb

@@ -14,6 +14,7 @@
       <div class="text-center">
         <h2><%= I18n.t('lato.operation_title') %></h2>
         <p><%= I18n.t('lato.operation_subtitle') %></p>
+
         <% if operation.percentage.nil? %>
           <div class="progress" style="height: 20px;">
             <div class="progress-bar progress-bar-animated progress-bar-striped bg-primary" role="progressbar" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
@@ -43,6 +44,12 @@
             <%= operation.output_message %>
           </p>
         <% end %>
+
+        <% if operation.output_action? %>
+          <div class="mt-3 d-flex justify-content-center">
+            <%= link_to operation.output_action['label'], operation.output_action['href'], { class: 'btn btn-primary' }.merge(operation.output_action['attributes']) %>
+          </div>
+        <% end %>
       </div>
     <% end %>
 
@@ -61,6 +68,19 @@
       </div>
     <% end %>
 
+    <% if operation.logs&.any? %>
+      <div class="mt-4">
+        <div class="border rounded p-3 bg-light" style="max-height: 300px; overflow-y: auto;">
+          <% operation.logs.reverse.each do |log| %>
+            <div class="mb-2 pb-2 border-bottom d-flex justify-content-between align-items-center">
+              <p class="mb-0"><%= log[1] %></p>
+              <small class="text-muted ms-2"><%= I18n.l(Time.parse(log[0]), format: '%H:%M:%S') %></small>
+            </div>
+          <% end %>
+        </div>
+      </div>
+    <% end %>
+
     <% unless operation.finished? %>
       <%= link_to '', lato.operation_path(operation), class: 'd-none', data: { lato_operation_target: 'update', turbo_frame: '_self' } %>
     <% end %>

data/db/migrate/20251218192614_add_logs_on_lato_operation.rb

@@ -0,0 +1,5 @@
+class AddLogsOnLatoOperation < ActiveRecord::Migration[8.1]
+  def change
+    add_column :lato_operations, :logs, :json
+  end
+end

data/lib/lato/version.rb

@@ -1,3 +1,3 @@
 module Lato
-  VERSION = "3.18.1"
+  VERSION = "3.19.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lato
 version: !ruby/object:Gem::Version
-  version: 3.18.1
+  version: 3.19.0
 platform: ruby
 authors:
 - Gregorio Galante
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-18 00:00:00.000000000 Z
+date: 2025-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -296,6 +296,7 @@ files:
 - db/migrate/20240222171418_add_indexes_on_lato_users_email.rb
 - db/migrate/20240318074025_add_authenticator_secret_to_user.rb
 - db/migrate/20251206170443_add_webauthn_id_to_user.rb
+- db/migrate/20251218192614_add_logs_on_lato_operation.rb
 - lib/lato.rb
 - lib/lato/btstrap.rb
 - lib/lato/config.rb