Sha256: 97d36f034f07c9d9f636577bc42d7709596982db741576b42574bdce0bb06259

Contents?: true

Size: 1.36 KB

Versions: 39

Compression:

Stored size: 1.36 KB

Contents

# frozen_string_literal: true

module ActiveStorage
  module Transformers
    # A Transformer applies a set of transformations to an image.
    #
    # The following concrete subclasses are included in Active Storage:
    #
    # * ActiveStorage::Transformers::ImageProcessingTransformer:
    #   backed by ImageProcessing, a common interface for MiniMagick and ruby-vips
    #
    # * ActiveStorage::Transformers::MiniMagickTransformer:
    #   backed by MiniMagick, a wrapper around the ImageMagick CLI
    class Transformer
      attr_reader :transformations

      def initialize(transformations)
        @transformations = transformations
      end

      # Applies the transformations to the source image in +file+, producing a target image in the
      # specified +format+. Yields an open Tempfile containing the target image. Closes and unlinks
      # the output tempfile after yielding to the given block. Returns the result of the block.
      def transform(file, format:)
        output = process(file, format: format)

        begin
          yield output
        ensure
          output.close!
        end
      end

      private
        # Returns an open Tempfile containing a transformed image in the given +format+.
        # All subclasses implement this method.
        def process(file, format:) #:doc:
          raise NotImplementedError
        end
    end
  end
end

Version data entries

39 entries across 39 versions & 4 rubygems

Version Path
activestorage-6.0.6.1 lib/active_storage/transformers/transformer.rb
activestorage-6.0.6 lib/active_storage/transformers/transformer.rb
activestorage-6.0.5.1 lib/active_storage/transformers/transformer.rb
activestorage-6.0.5 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.8 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.7 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.6 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.5 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.4 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.3 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.2 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4.1 lib/active_storage/transformers/transformer.rb
activestorage-6.0.4 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.7 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.6 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.5 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.4 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.3 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.2 lib/active_storage/transformers/transformer.rb
activestorage-6.0.3.1 lib/active_storage/transformers/transformer.rb