Module: ActiveStorage::HotCell::Client::Analyzers::Analyzing

Included in:
Audio, Image, Video
Defined in:
lib/active_storage/hot_cell/client/analyzers/analyzing.rb

Overview

What every analyzer here shares: one round trip to the cell, and the permanent-versus-transient failure split. An analyzer names the client it asks and the KEYS it slices the cell's superset down to — the cell knows more than Rails writes, and an extra key would change the shape of every blob's metadata.

Which way metadata fails is the whole design of the method. The built-in vips analyzer rescues every Vips::Error and returns an empty hash, which Rails then merges with analyzed: true — so an undecodable image is recorded as successfully analyzed, forever, and nothing ever re-enqueues AnalyzeJob. That is right for a permanent verdict and catastrophic for a transient one.

So a permanent failure follows the built-in behaviour and lets the blob be marked analyzed, with the reason written to the log so it can be re-decided later against a newer library. A transient failure is not rescued at all, which is what leaves the blob analyzed: false and eligible to be tried again.

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(analyzer) ⇒ Object 



26
27
28
 
# File 'lib/active_storage/hot_cell/client/analyzers/analyzing.rb', line 26

def self.included(analyzer)
  analyzer.class_attribute :client, instance_accessor: false
end

Instance Method Details

#metadata ⇒ Object 



30
31
32
33
34
35
 
# File 'lib/active_storage/hot_cell/client/analyzers/analyzing.rb', line 30

def metadata
  measured.slice(*self.class::KEYS)
rescue self.class.client.cell.permanent => error
  logger.warn "hotcell: #{blob.filename} could not be analyzed and will not be retried: #{error.message}"
  {}
end