Add multipage conversion (save_in_group) parameter to document conversion

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## Unreleased
+
+### Added
+* Multi page conversion parameter (`save_in_group`) added to `DocumentConverter#convert` options.
+
 ## 4.4.2 — 2024-05-29
 
 ### Fixed

api_examples/rest_api/post_convert_document.rb

@@ -3,5 +3,7 @@
 Uploadcare.config.secret_key = 'YOUR_SECRET_KEY'
 
 document_params = { uuid: '1bac376c-aa7e-4356-861b-dd2657b5bfd2', format: :pdf }
-options = { store: true }
+options = { store: '1' }
+# for multipage conversion
+# options = { store: '1', save_in_group: '1' }
 Uploadcare::DocumentConverter.convert(document_params, options)

lib/uploadcare/client/conversion/base_conversion_client.rb

@@ -50,7 +50,8 @@ def build_body_for_many(arr, options, url_builder_class)
                 **build_paths_body(params)
               )
             end,
-            store: options[:store]
+            store: options[:store],
+            save_in_group: options[:save_in_group]
           }.compact.to_json
         end
       end

spec/support/vcr.rb

@@ -13,4 +13,5 @@
       i.request.body = "Big string (#{i.request.body.size / (1024 * 1024)}) MB"
     end
   end
+  config.configure_rspec_metadata!
 end

spec/uploadcare/client/conversion/document_conversion_client_spec.rb

@@ -12,9 +12,7 @@ module Conversion
 
             shared_examples 'succeeds documents conversion' do
               it 'returns a convert documents response' do
-                VCR.use_cassette('document_convert_convert_many') do
-                  expect(subject).to be_success
-                end
+                expect(subject).to be_success
               end
             end
 
@@ -29,7 +27,21 @@ module Conversion
             end
             let(:options) { { store: false } }
 
-            context 'when all params are present' do
+            context 'when all params are present', vcr: 'document_convert_convert_many' do
+              it_behaves_like 'succeeds documents conversion'
+            end
+
+            context 'multipage conversion', vcr: 'document_convert_to_multipage' do
+              let(:array_of_params) do
+                [
+                  {
+                    uuid: '23d29586-713e-4152-b400-05fb54730453',
+                    format: 'png'
+                  }
+                ]
+              end
+              let(:options) { { store: '0', save_in_group: '1' } }
+
               it_behaves_like 'succeeds documents conversion'
             end
           end