image_processing 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a52c42f1463cc15caf0dfe57bc8a5efeb464006a2a29bbf1b8c842ada339e4aa
-  data.tar.gz: 2344e1015b02f4b24363371d8877bdcc4fb28b9fb820e15d2e2446f7874443c6
+  metadata.gz: 5b790f3dd08c310a2413cb8cb6b33a9c602edb3509cdd1de2c8f94ebea702f17
+  data.tar.gz: 99d87927f2a6603939332f61292c2b2b582fecc5832b4562a92e8a5170e862d9
 SHA512:
-  metadata.gz: 90c29ed45d475cc54f814a368e894504f5bc012835ef989d3678568dfb3cd29aca144e88cb17d102ffc82dcbd94c4d46de7d9a5fbc0474c0f6b15c481a1f4bb3
-  data.tar.gz: 8a7f991cf00725e1d5618add34f9b57814e2e273d8b9575f49e61701e80259ac8c2cd61028cdaefc6b4a6694a8a922d2246f5f6b8f7ee7184ff31bd0f8644813
+  metadata.gz: 00b2e0b0b250473b55e4ca415fd00f1c9fa50458e2c280a4110949838c344cb49c52b5afe023e0c75b8e435460f55517a1aeb8497ae1adf72fdca1de3fab59e2
+  data.tar.gz: a87c6791a8dbc06d5e40a6a64aaefd7803a382aac5071e238f7f7bface47d026405603bb6da9cc4534f9472f65d2e70bf4614cd75b9962506781a2818ad81b73

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.2.0 (2026-09-29)
+
+* Save in the `#convert` format when the destination path has no extension, such as a `/dev/fd/N` path (thanks to @flavorjones)
+
 ## 2.1.0 (2026-09-01)
 
 * [minimagick] Add `inherit_fds:` so a loader can name an already-open input (thanks to @flavorjones)

data/lib/image_processing/mini_magick.rb

@@ -73,11 +73,21 @@ module ImageProcessing
 
       # Calls the built ImageMagick command to perform processing and save
       # the result to disk. Accepts additional options related to saving the
-      # image (e.g. quality).
-      def self.save_image(magick, destination_path, allow_splitting: false, **options)
+      # image (e.g. quality). `format` names the output format when given,
+      # otherwise ImageMagick infers it from the path's extension.
+      def self.save_image(magick, destination_path, format = nil, allow_splitting: false, **options)
         Utils.apply_options(magick, **options)
 
-        magick << destination_path
+        if format
+          # ImageMagick reads everything before the first colon as the
+          # format, so a format carrying a colon could redirect the output.
+          format = format.to_s
+          fail Error, "invalid format: #{format.inspect}" unless format.ascii_only? && format.match?(/\A\w+\z/)
+
+          magick << "#{format}:#{destination_path}"
+        else
+          magick << destination_path
+        end
         magick.call
 
         Utils.disallow_split_layers!(destination_path) unless allow_splitting

data/lib/image_processing/pipeline.rb

@@ -21,7 +21,11 @@ module ImageProcessing
         call_processor
       elsif destination
         handle_destination do
-          call_processor(destination: destination)
+          if format && !determine_format(destination)
+            call_processor(destination: destination, format: format)
+          else
+            call_processor(destination: destination)
+          end
         end
       else
         create_tempfile do |tempfile|

data/lib/image_processing/processor.rb

@@ -1,7 +1,7 @@
 module ImageProcessing
   # Abstract class inherited by individual processors.
   class Processor
-    def self.call(source:, loader:, operations:, saver:, destination: nil)
+    def self.call(source:, loader:, operations:, saver:, destination: nil, format: nil)
       unless source.is_a?(String) || source.is_a?(self::ACCUMULATOR_CLASS)
         fail Error, "invalid source: #{source.inspect}"
       end
@@ -19,7 +19,9 @@ module ImageProcessing
         accumulator = apply_operation(accumulator, operation)
       end
 
-      if destination
+      if destination && format
+        save_image(accumulator, destination, format, **saver)
+      elsif destination
         save_image(accumulator, destination, **saver)
       else
         accumulator

data/lib/image_processing/version.rb

@@ -1,3 +1,3 @@
 module ImageProcessing
-  VERSION = "2.1.0"
+  VERSION = "2.2.0"
 end

data/lib/image_processing/vips.rb

@@ -56,12 +56,24 @@ module ImageProcessing
 
       # Writes the Vips::Image object to disk. This starts the processing
       # pipeline defined in the Vips::Image object. Accepts additional
-      # saver-specific options (e.g. quality).
-      def self.save_image(image, path, saver: nil, quality: nil, **options)
+      # saver-specific options (e.g. quality). The saver is chosen by `format`
+      # when given, otherwise by the path's extension.
+      def self.save_image(image, path, format = nil, saver: nil, quality: nil, **options)
         options[:Q] = quality if quality
 
         if saver
           image.public_send(:"#{saver}save", path, **options)
+        elsif format
+          # Savers such as heifsave pick their encoding from the suffix (AV1
+          # for ".avif"), so save through a target, which takes the suffix
+          # separately from the path.
+          saver = ::Vips.vips_foreign_find_save_target(".#{format}")
+          fail ::Vips::Error, "No known saver for '#{format}'." unless saver
+
+          filename      = ::Vips.p2str(::Vips.vips_filename_get_filename(path))
+          option_string = ::Vips.p2str(::Vips.vips_filename_get_options(path))
+          options       = Utils.select_valid_options(saver, options)
+          image.write_to_target(::Vips::Target.new_to_file(filename), ".#{format}#{option_string}", **options)
         else
           options = Utils.select_valid_saver_options(path, options)
           image.write_to_file(path, **options)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: image_processing
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Janko Marohnić