mini_magick 3.8.1 → 4.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 4f4ae6b4f7d224af6275ad37b108c978f3fd8817
-  data.tar.gz: 69d6e3f3b1289af2dd54a0309166e71fce1e2f45
+SHA256:
+  metadata.gz: 3ab4ce03957b9a0f941f9bd2c34a5dcab63faffac5143eb6e7c90d7d860b57c5
+  data.tar.gz: 7bd78f0c862f1ca72b34e3c6fc4d14297adfa9dd6bc36218a35ef68c235320b5
 SHA512:
-  metadata.gz: 248c08f2af654156c2a422bb3bb3e48a9b97087bab6dacace044bbc2175465c9a2e5de09eac05cb4110cc4efcc8a47f25424f03f6effa6df2cbb2fda85524557
-  data.tar.gz: 3c000c0861b8e66312d875b8858cdc3fe0b32c842332b70c979675acbf9b4fc62fcb4732c5c49db96240e0bf400974a90ee01e90a34b1c3d817eaf60444030fb
+  metadata.gz: 16c4bfa3744a2bea117bff0118afcbf89fac2f3d9e92c5c8af2b095f6c1381c1d000bede5086ccffd72ecca8152845cde11a5ff762186bd90793ee5d83e03a77
+  data.tar.gz: fe593ad2a7bfd4b6f2d9892533fd5347046e7dfb6cfd8e3bc6049cb1ae7686f5af60c23f33254175bca4728a58bdeeab2b9bfb873ebd94c46f14e68e086f002f

data/lib/mini_gmagick.rb

@@ -1,2 +1,3 @@
 require 'mini_magick'
+
 MiniMagick.processor = :gm

data/lib/mini_magick/configuration.rb

@@ -0,0 +1,198 @@
+require 'mini_magick/utilities'
+require 'logger'
+
+module MiniMagick
+  module Configuration
+
+    ##
+    # Set whether you want to use [ImageMagick](http://www.imagemagick.org) or
+    # [GraphicsMagick](http://www.graphicsmagick.org).
+    #
+    # @return [Symbol] `:imagemagick`, `:imagemagick7`, or `:graphicsmagick`
+    #
+    attr_accessor :cli
+
+    ##
+    # If you don't have the CLI tools in your PATH, you can set the path to the
+    # executables.
+    #
+    attr_writer :cli_path
+    # @private (for backwards compatibility)
+    attr_accessor :processor_path
+
+    ##
+    # Adds a prefix to the CLI command.
+    # For example, you could use `firejail` to run all commands in a sandbox.
+    # Can be a string, or an array of strings.
+    # e.g. 'firejail', or ['firejail', '--force']
+    #
+    # @return [String]
+    # @return [Array<String>]
+    #
+    attr_accessor :cli_prefix
+
+    ##
+    # If you don't want commands to take too long, you can set a timeout (in
+    # seconds).
+    #
+    # @return [Integer]
+    #
+    attr_accessor :timeout
+    ##
+    # When get to `true`, it outputs each command to STDOUT in their shell
+    # version.
+    #
+    # @return [Boolean]
+    #
+    attr_reader :debug
+    ##
+    # Logger for {#debug}, default is `MiniMagick::Logger.new(STDOUT)`, but
+    # you can override it, for example if you want the logs to be written to
+    # a file.
+    #
+    # @return [Logger]
+    #
+    attr_accessor :logger
+
+    ##
+    # If set to `true`, it will `identify` every newly created image, and raise
+    # `MiniMagick::Invalid` if the image is not valid. Useful for validating
+    # user input, although it adds a bit of overhead. Defaults to `true`.
+    #
+    # @return [Boolean]
+    #
+    attr_accessor :validate_on_create
+    ##
+    # If set to `true`, it will `identify` every image that gets written (with
+    # {MiniMagick::Image#write}), and raise `MiniMagick::Invalid` if the image
+    # is not valid. Useful for validating that processing was sucessful,
+    # although it adds a bit of overhead. Defaults to `true`.
+    #
+    # @return [Boolean]
+    #
+    attr_accessor :validate_on_write
+
+    ##
+    # If set to `false`, it will not raise errors when ImageMagick returns
+    # status code different than 0. Defaults to `true`.
+    #
+    # @return [Boolean]
+    #
+    attr_accessor :whiny
+
+    ##
+    # Instructs MiniMagick how to execute the shell commands. Available
+    # APIs are "open3" (default) and "posix-spawn" (requires the "posix-spawn"
+    # gem).
+    #
+    # @return [String]
+    #
+    attr_accessor :shell_api
+
+    def self.extended(base)
+      base.validate_on_create = true
+      base.validate_on_write = true
+      base.whiny = true
+      base.shell_api = "open3"
+      base.logger = Logger.new($stdout).tap { |l| l.level = Logger::INFO }
+    end
+
+    ##
+    # @yield [self]
+    # @example
+    #   MiniMagick.configure do |config|
+    #     config.cli = :graphicsmagick
+    #     config.timeout = 5
+    #   end
+    #
+    def configure
+      yield self
+    end
+
+    CLI_DETECTION = {
+      imagemagick:    "mogrify",
+      graphicsmagick: "gm",
+      imagemagick7:   "magick",
+    }
+
+    # @private (for backwards compatibility)
+    def processor
+      @processor ||= CLI_DETECTION.values.detect do |processor|
+        MiniMagick::Utilities.which(processor)
+      end
+    end
+
+    # @private (for backwards compatibility)
+    def processor=(processor)
+      @processor = processor.to_s
+
+      unless CLI_DETECTION.value?(@processor)
+        raise ArgumentError,
+          "processor has to be set to either \"magick\", \"mogrify\" or \"gm\"" \
+          ", was set to #{@processor.inspect}"
+      end
+    end
+
+    ##
+    # Get [ImageMagick](http://www.imagemagick.org) or
+    # [GraphicsMagick](http://www.graphicsmagick.org).
+    #
+    # @return [Symbol] `:imagemagick` or `:graphicsmagick`
+    #
+    def cli
+      if instance_variable_defined?("@cli")
+        instance_variable_get("@cli")
+      else
+        cli = CLI_DETECTION.key(processor) or
+          fail MiniMagick::Error, "You must have ImageMagick or GraphicsMagick installed"
+
+        instance_variable_set("@cli", cli)
+      end
+    end
+
+    ##
+    # Set whether you want to use [ImageMagick](http://www.imagemagick.org) or
+    # [GraphicsMagick](http://www.graphicsmagick.org).
+    #
+    def cli=(value)
+      @cli = value
+
+      if not CLI_DETECTION.key?(@cli)
+        raise ArgumentError,
+          "CLI has to be set to either :imagemagick, :imagemagick7 or :graphicsmagick" \
+          ", was set to #{@cli.inspect}"
+      end
+    end
+
+    ##
+    # If you set the path of CLI tools, you can get the path of the
+    # executables.
+    #
+    # @return [String]
+    #
+    def cli_path
+      if instance_variable_defined?("@cli_path")
+        instance_variable_get("@cli_path")
+      else
+        processor_path = instance_variable_get("@processor_path") if instance_variable_defined?("@processor_path")
+
+        instance_variable_set("@cli_path", processor_path)
+      end
+    end
+
+    ##
+    # When set to `true`, it outputs each command to STDOUT in their shell
+    # version.
+    #
+    def debug=(value)
+      warn "MiniMagick.debug is deprecated and will be removed in MiniMagick 5. Use `MiniMagick.logger.level = Logger::DEBUG` instead."
+      logger.level = value ? Logger::DEBUG : Logger::INFO
+    end
+
+    # Backwards compatibility
+    def reload_tools
+      warn "MiniMagick.reload_tools is deprecated because it is no longer necessary"
+    end
+
+  end
+end

data/lib/mini_magick/image/info.rb

@@ -0,0 +1,192 @@
+require "json"
+
+module MiniMagick
+  class Image
+    # @private
+    class Info
+      ASCII_ENCODED_EXIF_KEYS = %w[ExifVersion FlashPixVersion]
+
+      def initialize(path)
+        @path = path
+        @info = {}
+      end
+
+      def [](value, *args)
+        case value
+        when "format", "width", "height", "dimensions", "size", "human_size"
+          cheap_info(value)
+        when "colorspace"
+          colorspace
+        when "mime_type"
+          mime_type
+        when "resolution"
+          resolution(*args)
+        when "signature"
+          signature
+        when /^EXIF\:/i
+          raw_exif(value)
+        when "exif"
+          exif
+        when "details"
+          details
+        when "data"
+          data
+        else
+          raw(value)
+        end
+      end
+
+      def clear
+        @info.clear
+      end
+
+      def cheap_info(value)
+        @info.fetch(value) do
+          format, width, height, size = self["%m %w %h %b"].split(" ")
+
+          path = @path
+          path = path.match(/\[\d+\]$/).pre_match if path =~ /\[\d+\]$/
+
+          @info.update(
+            "format"     => format,
+            "width"      => Integer(width),
+            "height"     => Integer(height),
+            "dimensions" => [Integer(width), Integer(height)],
+            "size"       => File.size(path),
+            "human_size" => size,
+          )
+
+          @info.fetch(value)
+        end
+      rescue ArgumentError, TypeError
+        raise MiniMagick::Invalid, "image data can't be read"
+      end
+
+      def colorspace
+        @info["colorspace"] ||= self["%r"]
+      end
+
+      def mime_type
+        "image/#{self["format"].downcase}"
+      end
+
+      def resolution(unit = nil)
+        output = identify do |b|
+          b.units unit if unit
+          b.format "%x %y"
+        end
+        output.split(" ").map(&:to_i)
+      end
+
+      def raw_exif(value)
+        self["%[#{value}]"]
+      end
+
+      def exif
+        @info["exif"] ||= (
+          hash = {}
+          output = self["%[EXIF:*]"]
+
+          output.each_line do |line|
+            line = line.chomp("\n")
+
+            case MiniMagick.cli
+            when :imagemagick, :imagemagick7
+              if match = line.match(/^exif:/)
+                key, value = match.post_match.split("=", 2)
+                value = decode_comma_separated_ascii_characters(value) if ASCII_ENCODED_EXIF_KEYS.include?(key)
+                hash[key] = value
+              else
+                hash[hash.keys.last] << "\n#{line}"
+              end
+            when :graphicsmagick
+              next if line == "unknown"
+              key, value = line.split("=", 2)
+              value.gsub!("\\012", "\n") # convert "\012" characters to newlines
+              hash[key] = value
+            end
+          end
+
+          hash
+        )
+      end
+
+      def raw(value)
+        @info["raw:#{value}"] ||= identify { |b| b.format(value) }
+      end
+
+      def signature
+        @info["signature"] ||= self["%#"]
+      end
+
+      def details
+        warn "[MiniMagick] MiniMagick::Image#details has been deprecated, as it was causing too many parsing errors. You should use MiniMagick::Image#data instead, which differs in a way that the keys are in camelcase." if MiniMagick.imagemagick? || MiniMagick.imagemagick7?
+
+        @info["details"] ||= (
+          details_string = identify(&:verbose)
+          key_stack = []
+          details_string.lines.to_a[1..-1].each_with_object({}) do |line, details_hash|
+            next if !line.valid_encoding? || line.strip.length.zero?
+
+            level = line[/^\s*/].length / 2 - 1
+            if level >= 0
+              key_stack.pop until key_stack.size <= level
+            else
+              # Some metadata, such as SVG clipping paths, will be saved without
+              # indentation, resulting in a level of -1
+              last_key = details_hash.keys.last
+              details_hash[last_key] = '' if details_hash[last_key].empty?
+              details_hash[last_key] << line
+              next
+            end
+
+            key, _, value = line.partition(/:[\s]/).map(&:strip)
+            hash = key_stack.inject(details_hash) { |_hash, _key| _hash.fetch(_key) }
+            if value.empty?
+              hash[key] = {}
+              key_stack.push key
+            else
+              hash[key] = value
+            end
+          end
+        )
+      end
+
+      def data
+        raise Error, "MiniMagick::Image#data isn't supported on GraphicsMagick. Use MiniMagick::Image#details instead." if MiniMagick.graphicsmagick?
+
+        @info["data"] ||= (
+          json = MiniMagick::Tool::Convert.new do |convert|
+            convert << path
+            convert << "json:"
+          end
+
+          data = JSON.parse(json)
+          data = data.fetch(0) if data.is_a?(Array)
+          data.fetch("image")
+        )
+      end
+
+      def identify
+        MiniMagick::Tool::Identify.new do |builder|
+          yield builder if block_given?
+          builder << path
+        end
+      end
+
+      private
+
+      def decode_comma_separated_ascii_characters(encoded_value)
+        return encoded_value unless encoded_value.include?(',')
+        encoded_value.scan(/\d+/).map(&:to_i).map(&:chr).join
+      end
+
+      def path
+        value = @path
+        value += "[0]" unless value =~ /\[\d+\]$/
+        value
+      end
+
+    end
+  end
+end