active_storage_dashboard 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37a9ff508b9a3249ca7bda98dbfca0f7aa2629e35168958b0eca00d82d2cd27f
-  data.tar.gz: 6eac31451e7615696babb0f89de47d31f881d6ab392d9600907ed26b5733574e
+  metadata.gz: 52688deaa501817d673f48ffe6844b5eacf8907e7772a8947685af641e7f44df
+  data.tar.gz: 6bb6a6aba5a21ba5bf4ab7d66c54b9803a3523ed37c3d7274917698d107dc6aa
 SHA512:
-  metadata.gz: 86378de269473f43fdc742d95f2dce3197f22ddc4726a5e9e91f56ae4a77a05df3fa2094ac0789d20734edbc99235050db81ffecddce74117422113ab43f13df
-  data.tar.gz: 466081bfa71b093cfbed38febfb5810a020cf8a40922f6098e41848a0a90a0bc6d6968302a0b381dc8b163851f6034a5bf0bf13a39c43b54dda64bd296c78ee7
+  metadata.gz: e109061b41d12ecfa053d87e2e0a1a5b90083e27a04a9d8dcc40702909d414cd027d6bbc61681c407c5d0e2fac4c107505722058d97a51aa139cad6f0e4a7f38
+  data.tar.gz: b9ad63bb467d849d9591c3f539bd96aaa3706b8d84ae037162f33bed921a2e75978624bb960179ff0a95298b32dede9eb0265b006e56431be41dc3dba9bfa017

data/README.md

@@ -46,20 +46,41 @@ Then visit `/active-storage-dashboard` in your browser to see the beautiful dash
 
 The dashboard provides direct file download capabilities from both the list and detail views. Simply click on the download button to get your files.
 
+### Tasks
+
+The dashboard includes a task to remove unused blobs and attachments. 
+
+You can run this task from the command line:
+
+```bash
+$ rails active_storage:dashboard:purge_orphans
+```
+Re-analyze blobs that are not yet analyzed
+```bash
+$ rails active_storage:dashboard:reanalyze
+```
+
+Regenerate missing or outdated variants
+```bash
+$ rails active_storage:dashboard:regenerate_variants
+```
+
+
+
 ### 📸 Screenshots
 
 <details>
   <summary>Click to see more screenshots</summary>
-  
+
   #### Dashboard Overview
   ![Dashboard Overview](https://github.com/giovapanasiti/active_storage_dashboard/blob/main/screenshots/dashboard.png)
-  
+
   #### Blob Details
   ![Blob Details](https://github.com/giovapanasiti/active_storage_dashboard/blob/main/screenshots/blob-details.png)
-  
+
   #### Files Gallery
   ![Files Gallery](https://github.com/giovapanasiti/active_storage_dashboard/blob/main/screenshots/files-gallery.png)
-  
+
 </details>
 
 ## 🔒 Security Considerations
@@ -81,6 +102,11 @@ constraints lambda { |req| req.session[:user_id].present? || (req.env['warden']
 end
 ```
 
+Or, in your environment config or `application.rb`:
+```ruby
+config.active_storage_dashboard.base_controller_class = "AdminController"
+```
+
 
 ## 🤝 Contributing
 
@@ -88,4 +114,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/giovap
 
 ## 📝 License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). 
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/controllers/active_storage_dashboard/application_controller.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module ActiveStorageDashboard
-  class ApplicationController < ActionController::Base
+  class ApplicationController < ActiveStorageDashboard.base_controller_class.constantize
     protect_from_forgery with: :exception
-    
+
     # Simple pagination without external dependencies
     helper_method :paginate
 
@@ -12,4 +12,4 @@ module ActiveStorageDashboard
       scope.limit(per_page).offset((@page - 1) * per_page)
     end
   end
-end 
+end

data/lib/active_storage_dashboard/analyzer.rb

@@ -0,0 +1,9 @@
+module ActiveStorageDashboard
+  class Analyzer
+    def self.call
+      ActiveStorage::Blob.find_each do |blob|
+        blob.analyze unless blob.analyzed?
+      end
+    end
+  end
+end

data/lib/active_storage_dashboard/engine.rb

@@ -3,10 +3,18 @@
 module ActiveStorageDashboard
   class Engine < ::Rails::Engine
     isolate_namespace ActiveStorageDashboard
-    
+
     # Ensure URLs are generated correctly by setting defaults
     initializer "active_storage_dashboard.url_options" do |app|
       ActiveStorageDashboard::Engine.routes.default_url_options = app.routes.default_url_options
     end
+
+    config.active_storage_dashboard = ActiveSupport::OrderedOptions.new
+
+    config.before_initialize do
+      config.active_storage_dashboard.each do |key, value|
+        ActiveStorageDashboard.public_send("#{key}=", value)
+      end
+    end
   end
-end 
+end

data/lib/active_storage_dashboard/orphan_purger.rb

@@ -0,0 +1,13 @@
+module ActiveStorageDashboard
+  class OrphanPurger
+    def self.call
+      scope = ActiveStorage::Blob.left_outer_joins(:attachments)
+                                 .where(active_storage_attachments: { id: nil })
+
+      scope.find_each do |blob|
+        blob.purge
+        puts "Purged blob #{blob.id}"
+      end
+    end
+  end
+end

data/lib/active_storage_dashboard/variant_regenerator.rb

@@ -0,0 +1,18 @@
+module ActiveStorageDashboard
+  class VariantRegenerator
+    def self.call
+      unless defined?(ActiveStorage::VariantRecord)
+        puts "ActiveStorage::VariantRecord not found (Rails < 7.1). Skipping."
+        return
+      end
+
+      ActiveStorage::VariantRecord.find_each do |variant|
+        begin
+          variant.image.representation(variant.variation).processed
+        rescue => e
+          warn "Failed variant #{variant.id}: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/active_storage_dashboard.rb

@@ -1,8 +1,19 @@
 # frozen_string_literal: true
+require "rails/railtie"
 
 require "active_storage_dashboard/version"
 require "active_storage_dashboard/engine"
 
+require "active_storage_dashboard/orphan_purger"
+require "active_storage_dashboard/analyzer"
+require "active_storage_dashboard/variant_regenerator"
+
 module ActiveStorageDashboard
-  # Your code goes here...
-end 
+  mattr_accessor :base_controller_class, default: "ActionController::Base"
+
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load File.expand_path("tasks/active_storage_dashboard_tasks.rake", __dir__)
+    end
+  end
+end

data/lib/tasks/active_storage_dashboard_tasks.rake

@@ -1,6 +1,21 @@
-# frozen_string_literal: true
+namespace :active_storage do
+  namespace :dashboard do
+    desc "Purge blobs that have no attachments"
+    task purge_orphans: :environment do
+      ActiveStorageDashboard::OrphanPurger.call
+    end
 
-# desc "Explaining what the task does"
-# task :active_storage_dashboard do
-#   # Task goes here
-# end 
+    desc "Re-analyze blobs that are not yet analyzed"
+    task reanalyze: :environment do
+      ActiveStorageDashboard::Analyzer.call
+    end
+
+    desc "Recreate missing or outdated variants"
+    task regenerate_variants: :environment do
+      ActiveStorageDashboard::VariantRegenerator.call
+    end
+
+    desc "Run all maintenance tasks"
+    task all: [:purge_orphans, :reanalyze, :regenerate_variants]
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: active_storage_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Giovanni Panasiti
 bindir: bin
 cert_chain: []
-date: 2025-05-17 00:00:00.000000000 Z
+date: 2025-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -49,7 +49,10 @@ files:
 - app/views/layouts/active_storage_dashboard/application.html.erb
 - config/routes.rb
 - lib/active_storage_dashboard.rb
+- lib/active_storage_dashboard/analyzer.rb
 - lib/active_storage_dashboard/engine.rb
+- lib/active_storage_dashboard/orphan_purger.rb
+- lib/active_storage_dashboard/variant_regenerator.rb
 - lib/active_storage_dashboard/version.rb
 - lib/tasks/active_storage_dashboard_tasks.rake
 homepage: https://github.com/giovapanasiti/active_storage_dashboard