For Uploadcare::ConversionApi added `get_document_conversion_format…

…s_info` method to get the possible document conversion formats. (#145)

* For  added  method to get the possible document conversion formats.

* Exclude Metrics/ModuleLength for specs

.rubocop.yml

@@ -34,3 +34,7 @@ Style/OpenStructUse:
  - 'spec/uploadcare/rails/active_record/mount_uploadcare_file_spec.rb'
  - 'spec/uploadcare/rails/active_record/mount_uploadcare_group_spec.rb'
  - 'spec/uploadcare/rails/objects/file_spec.rb'
+
+Metrics/ModuleLength:
+ Exclude:
+ - 'spec/**/*'

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 The format is based now on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+* For `Uploadcare::ConversionApi` added `get_document_conversion_formats_info` method to get the possible document conversion formats.
+
 ## 3.4.2 — 2024-05-11
 
 ### Added

lib/uploadcare/rails/api/rest/conversion_api.rb

@@ -21,6 +21,12 @@ def get_video_conversion_status(token)
  Uploadcare::VideoConverter.status(token)
  end
 
+ # Conversion formats info
+ # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/Conversion/operation/documentConvertInfo
+ def get_document_conversion_formats_info(uuid)
+ Uploadcare::DocumentConverter.info(uuid)
+ end
+
  # Converts documents
  # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/documentConvert
  def convert_document(document_params, options = {})

spec/uploadcare/rails/api/rest/conversion_api_spec.rb

@@ -14,7 +14,13 @@ module Rest
 
  context 'when checking methods' do
  it 'responds to expected REST methods' do
- %i[convert_video get_video_conversion_status convert_document get_document_conversion_status].each do |m|
+ %i[
+ convert_video
+ get_video_conversion_status
+ convert_document
+ get_document_conversion_status
+ get_document_conversion_formats_info
+ ].each do |m|
  expect(subject).to respond_to(m)
  end
  end
@@ -88,6 +94,19 @@ module Rest
  expect(response.success[:error]).to be_nil
  end
  end
+
+ it 'gets document conversion formats info' do
+ VCR.use_cassette('conversion_api_get_document_conversion_formats_info') do
+ uuid = 'b3b32bcb-9bd8-4ee2-a4df-95bcee96b47e'
+ response = subject.get_document_conversion_formats_info(uuid)
+ expect(response).to be_success
+ expect(response.success[:error]).to be_nil
+ expect(response.success[:format][:name]).to be_a(String)
+ conversion_formats = response.success[:format][:conversion_formats]
+ expect(conversion_formats).to be_a(Array)
+ expect(conversion_formats.first[:name]).to be_a(String)
+ end
+ end
  end
 
  context 'and when request is failed' do

uploadcare-rails.gemspec

@@ -44,5 +44,5 @@ Gem::Specification.new do |gem|
 
  gem.version = Uploadcare::Rails::VERSION
  gem.add_dependency 'rails', '>= 6'
- gem.add_dependency 'uploadcare-ruby', '>= 4.4.1'
+ gem.add_dependency 'uploadcare-ruby', '>= 4.4.2'
 end