module ActiveStorage::Blob::Analyzable
def analyze
You won't ordinarily need to call this method from a Rails application. New blobs are automatically and asynchronously
Outside of a Rails application, manipulate +ActiveStorage.analyzers+ instead.
Rails.application.config.active_storage.analyzers.delete ActiveStorage::Analyzer::VideoAnalyzer
# Remove the built-in video analyzer:
Rails.application.config.active_storage.analyzers.append DOCXAnalyzer
# Add a custom analyzer for Microsoft Office documents:
in an initializer:
In a Rails application, add or remove analyzers by manipulating +Rails.application.config.active_storage.analyzers+
metadata is extracted from it.
first analyzer for which +accept?+ returns true when given the blob. If no registered analyzer accepts the blob, no
To choose the analyzer for a blob, Active Storage calls +accept?+ on each registered analyzer in order. It uses the
libraries they require.
ActiveStorage::Analyzer::VideoAnalyzer for information about the specific attributes they extract and the third-party
with built-in analyzers for images and videos. See ActiveStorage::Analyzer::ImageAnalyzer and
Extracts and stores metadata from the file associated with this blob using a relevant analyzer. Active Storage comes
def analyze update! metadata: metadata.merge(extract_metadata_via_analyzer) end
def analyze_later
This method is automatically called for a blob when it's attached for the first time. You can call it to analyze a blob
Enqueues an ActiveStorage::AnalyzeJob which calls #analyze, or calls #analyze inline based on analyzer class configuration.
def analyze_later if analyzer_class.analyze_later? ActiveStorage::AnalyzeJob.perform_later(self) else analyze end end
def analyzed?
def analyzed? analyzed end
def analyzer
def analyzer analyzer_class.new(self) end
def analyzer_class
def analyzer_class ActiveStorage.analyzers.detect { |klass| klass.accept?(self) } || ActiveStorage::Analyzer::NullAnalyzer end
def extract_metadata_via_analyzer
def extract_metadata_via_analyzer analyzer.metadata.merge(analyzed: true) end