lato_storage 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1d05661b7389e2ddbde1a533b1da8175cfb487df74268efaae8d36aedddfb8b7
+  data.tar.gz: e9d0f31b63fafc2d37553733a3170cccce4c7a9d694d2e29a7f37497d7a55417
+SHA512:
+  metadata.gz: 7994b4bab09fba75f5868af1d5a71bbe6c62604438a2d96dfee8b92fab54baf2478e043e7ed79f46d2697d39f3fcccdc91c5dd7e539ea0467eb7326457b28f59
+  data.tar.gz: a60279cc560d60620ddd78bdf7752d8a8ded7684714e4c073e7e5a69caa14b9341ffc2d01310103319ee5d3b92cfc2d6db9337c2f56b5eca19037473917fe8fc

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Gregorio Galante
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,71 @@
+# Lato Storage
+Manage application storage (ActiveStorage data) on Lato projects.
+
+🚨 THIS GEM IN UNDER DEVELOPMENT 🚨
+
+NOTE: This gem is using [Active Storage Dashboard](https://github.com/giovapanasiti/active_storage_dashboard) as reference for the interface and the functionality. The idea is to provide a similar interface inside Lato.
+
+## Installation
+Add required dependencies to your application's Gemfile:
+
+```ruby
+# Use lato as application panel
+gem "lato"
+gem "lato_storage"
+```
+
+Install gem and run required tasks:
+
+```bash
+$ bundle
+$ rails lato_storage:install:application
+$ rails lato_storage:install:migrations
+$ rails db:migrate
+```
+
+Mount lato storage routes on the **config/routes.rb** file:
+
+```ruby
+Rails.application.routes.draw do
+  mount LatoStorage::Engine => "/lato-storage"
+
+  # ....
+end
+```
+
+Import Lato Scss on **app/assets/stylesheets/application.scss** file:
+```scss
+@import 'lato_storage/application';
+
+// ....
+```
+
+Import Lato Storage Js on **app/javascript/application.js** file:
+```js
+import "lato_storage/application";
+
+// ....
+```
+
+## Development
+
+Clone repository, install dependencies, run migrations and start:
+
+```shell
+$ git clone https://github.com/Lato-GAM/lato_storage
+$ cd lato_storage
+$ bundle
+$ rails db:migrate
+$ rails db:seed
+$ foreman start -f Procfile.dev
+```
+
+## Publish
+
+```shell
+$ ruby ./bin/publish.rb
+```
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"

data/app/assets/config/lato_storage_manifest.js

@@ -0,0 +1,2 @@
+//= link_directory ../stylesheets/lato_storage .css
+//= link_tree ../javascripts/lato_storage .js

data/app/assets/javascripts/lato_storage/application.js

@@ -0,0 +1 @@
+console.log("Lato Settings JS loaded");

data/app/controllers/lato_storage/application_controller.rb

@@ -0,0 +1,30 @@
+module LatoStorage
+  class ApplicationController < Lato::ApplicationController
+    layout 'lato/application'
+    before_action :authenticate_session
+    before_action :authenticate_lato_storage_admin
+    before_action { active_sidebar(:lato_storage); active_navbar(:lato_storage) }
+
+    def index
+      @blobs_count = ActiveStorage::Blob.count
+      @attachments_count = ActiveStorage::Attachment.count
+      @variant_records_count = defined?(ActiveStorage::VariantRecord) ? ActiveStorage::VariantRecord.count : 0
+      @deletable_blobs_count = ActiveStorage::Blob.unattached.where('active_storage_blobs.created_at < ?', 12.hours.ago).count
+      
+      @total_storage = ActiveStorage::Blob.sum(:byte_size)
+      @avg_storage = @total_storage / @blobs_count if @blobs_count.positive?
+
+      @content_types = ActiveStorage::Blob.group(:content_type).count.sort_by { |_, count| -count }.first(5)
+
+      @largest_blobs = ActiveStorage::Blob.order(byte_size: :desc).limit(3)
+    end
+
+    protected
+
+    def authenticate_lato_storage_admin
+      return true if @session.user&.lato_storage_admin
+
+      redirect_to lato.root_path, alert: 'You have not access to this section.'
+    end
+  end
+end

data/app/helpers/lato_storage/application_helper.rb

@@ -0,0 +1,16 @@
+module LatoStorage
+  module ApplicationHelper
+
+    def format_bytes(bytes)
+      return '0 B' if bytes.nil? || bytes == 0
+      
+      units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+      exponent = (Math.log(bytes) / Math.log(1024)).to_i
+      exponent = [exponent, units.size - 1].min
+      
+      converted = bytes.to_f / (1024 ** exponent)
+      "#{format('%.2f', converted)} #{units[exponent]}"
+    end
+
+  end
+end

data/app/jobs/lato_storage/application_job.rb

@@ -0,0 +1,4 @@
+module LatoStorage
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/lato_storage/application_mailer.rb

@@ -0,0 +1,6 @@
+module LatoStorage
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/views/lato_storage/application/index.html.erb

@@ -0,0 +1,134 @@
+<%= lato_page_head I18n.t('lato_storage.storage') %>
+
+<div class="row">
+  <div class="col col-6 col-lg-3 mb-3">
+    <div class="card">
+      <div class="card-body text-center">
+        <div class="fw-bold fs-2"><%= @blobs_count %></div>
+        <div><%= I18n.t('lato_storage.total_blobs') %></div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col col-6 col-lg-3 mb-3">
+    <div class="card">
+      <div class="card-body text-center">
+        <div class="fw-bold fs-2"><%= @attachments_count %></div>
+        <div><%= I18n.t('lato_storage.total_attachments') %></div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col col-6 col-lg-3 mb-3">
+    <div class="card">
+      <div class="card-body text-center">
+        <div class="fw-bold fs-2"><%= @variant_records_count %></div>
+        <div><%= I18n.t('lato_storage.total_variant_records') %></div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col col-6 col-lg-3 mb-3">
+    <div class="card">
+      <div class="card-body text-center">
+        <div class="fw-bold fs-2"><%= @deletable_blobs_count %></div>
+        <div><%= I18n.t('lato_storage.deletable_blobs') %></div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col col-12 col-lg-6 mb-3">
+    <div class="card">
+      <div class="card-header">
+        <h5 class="card-title mb-0">
+          <%= I18n.t('lato_storage.content_type_distribution') %>
+        </h5>
+      </div>
+      <div class="card-body">
+        <% if @content_types.any? %>
+          <% total = @content_types.sum { |_, count| count } %>
+          <ul class="list-group list-group-flush">
+            <% @content_types.each do |content_type, count| %>
+              <li class="list-group-item">
+                <div class="d-flex justify-content-between align-items-center">
+                  <strong><%= content_type %></strong>
+                  <span class="badge bg-primary rounded-pill">
+                    <%= count %> files
+                  </span>
+                </div>
+
+                <div class="progress mt-2">
+                  <div class="progress-bar" role="progressbar" style="width: <%= (count.to_f / total * 100).round(2) %>%" aria-valuenow="<%= count %>" aria-valuemin="0" aria-valuemax="<%= total %>"></div>
+                </div>
+              </li>
+            <% end %>
+          </ul>
+        <% else %>
+          <div class="alert alert-info mb-0">
+            <%= I18n.t('lato_storage.no_content_types') %>
+          </div>
+        <% end %>
+      </div>
+    </div>
+  </div>
+
+  <div class="col col-12 col-lg-6 mb-3">
+    <div class="card mb-3">
+      <div class="card-header">
+        <h5 class="card-title mb-0">
+          <%= I18n.t('lato_storage.storage_usage') %>
+        </h5>
+      </div>
+      <div class="card-body row">
+        <div class="col col-12 col-md-6 mb-3 mb-md-0">
+          <div class="card">
+            <div class="card-body text-center">
+              <div class="fw-bold fs-2"><%= format_bytes @total_storage %></div>
+              <div><%= I18n.t('lato_storage.total_storage') %></div>
+            </div>
+          </div>
+        </div>
+
+        <div class="col col-12 col-md-6 mb-3 mb-md-0">
+          <div class="card">
+            <div class="card-body text-center">
+              <div class="fw-bold fs-2"><%= format_bytes @avg_storage %></div>
+              <div><%= I18n.t('lato_storage.avg_storage') %></div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <div class="card">
+      <div class="card-header">
+        <h5 class="card-title mb-0">
+          <%= I18n.t('lato_storage.largest_blobs') %>
+        </h5>
+      </div>
+      <div class="card-body">
+        <% if @largest_blobs.any? %>
+          <div class="list-group list-group-flush">
+            <% @largest_blobs.each do |blob| %>
+              <a class="list-group-item list-group-item-action" href="<%= main_app.url_for(blob) %>" target="_blank" rel="noopener noreferrer" download>
+                <div class="d-flex justify-content-between align-items-center">
+                  <strong><%= blob.filename %></strong>
+                  <div class="d-flex align-items-center">
+                    <span class="badge bg-primary rounded-pill">
+                      <%= format_bytes blob.byte_size %>
+                    </span>
+                    <i class="bi bi-download ms-2"></i>
+                  </div>
+                </div>
+              </a>
+            <% end %>
+          </div>
+        <% else %>
+          <div class="alert alert-info mb-0">
+            <%= I18n.t('lato_storage.no_largest_blobs') %>
+          </div>
+        <% end %>
+      </div>
+    </div>
+  </div>
+</div>

data/config/importmap.rb

@@ -0,0 +1,2 @@
+pin "lato_storage/application", to: "lato_storage/application.js"
+pin_all_from LatoStorage::Engine.root.join("app/assets/javascripts/lato_storage/controllers"), under: "controllers", to: "lato_storage/controllers"

data/config/locales/en.yml

@@ -0,0 +1,14 @@
+en:
+  lato_storage:
+    storage: "Storage"
+    total_blobs: "Total Blobs"
+    total_attachments: "Total Attachments"
+    total_variant_records: "Total Variant Records"
+    total_storage: "Total Storage"
+    avg_storage: "Storage per Blob"
+    content_type_distribution: "Content Type Distribution"
+    no_content_types: "No Content Types available"
+    storage_usage: "Storage Usage"
+    largest_blobs: "Largest Blobs"
+    no_largest_blobs: "No Blobs available"
+    deletable_blobs: "Deletable Blobs"

data/config/locales/it.yml

@@ -0,0 +1,14 @@
+it:
+  lato_storage:
+    storage: "Storage"
+    total_blobs: "Blob totali"
+    total_attachments: "Allegati totali"
+    total_variant_records: "Varianti totali"
+    total_storage: "Storage totale"
+    avg_storage: "Storage per Blob"
+    content_type_distribution: "Distribuzione dei contenuti"
+    no_content_types: "Nessun tipo di contenuto disponibile"
+    storage_usage: "Utilizzo dello storage"
+    largest_blobs: "Blob più grandi"
+    no_largest_blobs: "Nessun blob disponibile"
+    deletable_blobs: "Blob eliminabili"

data/config/routes.rb

@@ -0,0 +1,3 @@
+LatoStorage::Engine.routes.draw do
+  root 'application#index'
+end

data/db/migrate/20250328072343_add_lato_storage_admin_to_lato_user.rb

@@ -0,0 +1,5 @@
+class AddLatoStorageAdminToLatoUser < ActiveRecord::Migration[7.1]
+  def change
+    add_column :lato_users, :lato_storage_admin, :boolean, default: false
+  end
+end

data/lib/lato_storage/config.rb

@@ -0,0 +1,10 @@
+module LatoStorage
+  # Config
+  # This class contains the default configuration of the engine.
+  ##
+  class Config
+    
+    def initialize
+    end
+  end
+end

data/lib/lato_storage/engine.rb

@@ -0,0 +1,13 @@
+module LatoStorage
+  class Engine < ::Rails::Engine
+    isolate_namespace LatoStorage
+
+    initializer 'lato_storage.importmap', before: 'importmap' do |app|
+      app.config.importmap.paths << root.join('config/importmap.rb')
+    end
+
+    initializer "lato_storage.precompile" do |app|
+      app.config.assets.precompile << "lato_storage_manifest.js"
+    end
+  end
+end

data/lib/lato_storage/version.rb

@@ -0,0 +1,3 @@
+module LatoStorage
+  VERSION = "3.0.0"
+end

data/lib/lato_storage.rb

@@ -0,0 +1,15 @@
+require "lato_storage/version"
+require "lato_storage/engine"
+require "lato_storage/config"
+
+module LatoStorage
+  class << self
+    def config
+      @config ||= Config.new
+    end
+
+    def configure
+      yield config
+    end
+  end
+end

data/lib/tasks/lato_storage_tasks.rake

@@ -0,0 +1,11 @@
+require 'fileutils'
+
+namespace :lato_storage do
+  namespace :install do
+    desc 'Install Lato storage engine and run tasks on main rails application'
+    # Usage: rails lato_storage:install:application
+    task :application do
+      # Free for future use...
+    end
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: lato_storage
+version: !ruby/object:Gem::Version
+  version: 3.0.0
+platform: ruby
+authors:
+- Gregorio Galante
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.1
+- !ruby/object:Gem::Dependency
+  name: lato
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Rails engine to manage application storage on Lato projects!
+email:
+- me@gregoriogalante.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/config/lato_storage_manifest.js
+- app/assets/javascripts/lato_storage/application.js
+- app/assets/stylesheets/lato_storage/application.scss
+- app/controllers/lato_storage/application_controller.rb
+- app/helpers/lato_storage/application_helper.rb
+- app/jobs/lato_storage/application_job.rb
+- app/mailers/lato_storage/application_mailer.rb
+- app/views/lato_storage/application/index.html.erb
+- config/importmap.rb
+- config/locales/en.yml
+- config/locales/it.yml
+- config/routes.rb
+- db/migrate/20250328072343_add_lato_storage_admin_to_lato_user.rb
+- lib/lato_storage.rb
+- lib/lato_storage/config.rb
+- lib/lato_storage/engine.rb
+- lib/lato_storage/version.rb
+- lib/tasks/lato_storage_tasks.rake
+homepage: https://github.com/Lato-org/lato_storage
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Lato-org/lato_storage
+  source_code_uri: https://github.com/Lato-org/lato_storage
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: Another engine for Lato projects
+test_files: []