Merge pull request #79 from aspose-pdf-cloud/develop

update to 24.11

Author: boiledgas

README.md

@@ -29,15 +29,10 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 24.10
-- Develop a method to add XMP metadata.
-- Develop a method to obtain XMP metadata in the XML form.
-- Develop a method to obtain XMP metadata in the JSON form.
+## Enhancements in Version 24.11
+- Add DocRecognitionMode EnhancedFlow mode.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
-## Bugs fixed in Version 24.10
-- PDF XFA form to Acro from conversion API results corrupt PDF.
-
 ## Installation
 
 ### Build a gem
@@ -51,15 +46,15 @@ gem build aspose_pdf_cloud.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./aspose_pdf_cloud-24.10.0.gem
+gem install ./aspose_pdf_cloud-24.11.0.gem
 ```
-(for development, run `gem install --dev ./aspose_pdf_cloud-24.10.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./aspose_pdf_cloud-24.11.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'aspose_pdf_cloud', '~> 24.10.0'
+    gem 'aspose_pdf_cloud', '~> 24.11.0'
 
 ### Install from Git
 

docs/DocRecognitionMode.md

@@ -6,6 +6,7 @@ Name | Type | Value | Description
 ------------ | ------------- | ------------- | -------------
 **TEXTBOX** | **String** | 'Textbox' | This mode is fast and good for maximally preserving original look of the PDF file, but editability of the resulting document could be limited.Every visually grouped block of text int the original PDF file is converted into a textbox in the resulting document. This achieves maximal resemblance of the output document to the original PDF file. The output document will look good, but it will consist entirely of textboxes and it could makes further editing of the document in Microsoft Word quite hard.This is the default mode.
 **FLOW** | **String** | 'Flow' | Full recognition mode, the engine performs grouping and multi-level analysis to restore the original document author's intent and produce a maximally editable document. The downside is that the output document might look different from the original PDF file.
+**ENHANCED_FLOW** | **String** | 'EnhancedFlow' | An alternative Flow mode that supports the recognition of tables.
 
 
 

docs/PdfApi.md

@@ -95,6 +95,7 @@ Method | HTTP request | Description
 [**get_image_extract_as_png**](PdfApi.md#get_image_extract_as_png) | **GET** /pdf/\{name}/images/\{imageId}/extract/png | Extract document image in PNG format
 [**get_image_extract_as_tiff**](PdfApi.md#get_image_extract_as_tiff) | **GET** /pdf/\{name}/images/\{imageId}/extract/tiff | Extract document image in TIFF format
 [**get_images**](PdfApi.md#get_images) | **GET** /pdf/\{name}/pages/\{pageNumber}/images | Read document images.
+[**get_images_extract_svg**](PdfApi.md#get_images_extract_svg) | **GET** /pdf/\{name}/pages/\{pageNumber}/images/extract/svg | Extract SVG images from document page.
 [**get_import_fields_from_fdf_in_storage**](PdfApi.md#get_import_fields_from_fdf_in_storage) | **GET** /pdf/\{name}/import/fdf | Update fields from FDF file in storage.
 [**get_import_fields_from_xfdf_in_storage**](PdfApi.md#get_import_fields_from_xfdf_in_storage) | **GET** /pdf/\{name}/import/xfdf | Update fields from XFDF file in storage.
 [**get_import_fields_from_xml_in_storage**](PdfApi.md#get_import_fields_from_xml_in_storage) | **GET** /pdf/\{name}/import/xml | Import from XML file (located on storage) to PDF format and return resulting file in response. 
@@ -2626,6 +2627,32 @@ Name | Type | Description  | Notes
 
 
 
+# **get_images_extract_svg**
+> SvgImages get_images_extract_svg(name, page_number, opts)
+
+Extract SVG images from document page.
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **String**| The document name. | 
+ **page_number** | **Integer**| The page number. | 
+ **storage** | **String**| The document storage. | [optional] 
+ **folder** | **String**| The document folder. | [optional] 
+ **pass_base64** | **String**| The password (Base64). | [optional] 
+
+### Return type
+
+[**SvgImages**](SvgImages.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **get_import_fields_from_fdf_in_storage**
 > File get_import_fields_from_fdf_in_storage(name, fdf_file_path, opts)
 

docs/SvgImages.md

@@ -0,0 +1,11 @@
+# AsposePdfCloud::SvgImages
+SvgImages class
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **Integer** | Response status code. | 
+**status** | **String** | Response status. | [optional] 
+**list** | **Array<String>** | List of SVG images | [optional] 
+
+

lib/aspose_pdf_cloud.rb

@@ -257,6 +257,7 @@
 require_relative 'aspose_pdf_cloud/models/strike_out_annotation_response'
 require_relative 'aspose_pdf_cloud/models/strike_out_annotations'
 require_relative 'aspose_pdf_cloud/models/strike_out_annotations_response'
+require_relative 'aspose_pdf_cloud/models/svg_images'
 require_relative 'aspose_pdf_cloud/models/table'
 require_relative 'aspose_pdf_cloud/models/table_recognized'
 require_relative 'aspose_pdf_cloud/models/table_recognized_response'

lib/aspose_pdf_cloud/api/pdf_api.rb

@@ -6893,6 +6893,87 @@ def get_images_with_http_info(name, page_number, opts = {})
       return data, status_code, headers
     end
 
+    # Extract SVG images from document page.
+    # 
+    # @param name The document name.
+    # @param page_number The page number.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :pass_base64 The password (Base64).
+    # @return [SvgImages]
+    def get_images_extract_svg(name, page_number, opts = {})
+      @api_client.request_token_if_needed
+      data, _status_code, _headers = get_images_extract_svg_with_http_info(name, page_number, opts)
+      rescue ApiError => error
+        if error.code == 401
+          @api_client.request_token_if_needed
+          data, _status_code, _headers = get_images_extract_svg_with_http_info(name, page_number, opts)
+        else
+          raise
+        end
+      return data
+    end
+
+    # Extract SVG images from document page.
+    # 
+    # @param name The document name.
+    # @param page_number The page number.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :pass_base64 The password (Base64).
+    # @return [Array<(SvgImages, Fixnum, Hash)>] SvgImages data, response status code and response headers
+    def get_images_extract_svg_with_http_info(name, page_number, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: PdfApi.get_images_extract_svg ..."
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling PdfApi.get_images_extract_svg"
+      end
+      # verify the required parameter 'page_number' is set
+      if @api_client.config.client_side_validation && page_number.nil?
+        fail ArgumentError, "Missing the required parameter 'page_number' when calling PdfApi.get_images_extract_svg"
+      end
+      # resource path
+      local_var_path = "/pdf/{name}/pages/{pageNumber}/images/extract/svg".sub('{' + 'name' + '}', name.to_s).sub('{' + 'pageNumber' + '}', page_number.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'storage'] = opts[:'storage'] if !opts[:'storage'].nil?
+      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
+      query_params[:'passBase64'] = opts[:'pass_base64'] if !opts[:'pass_base64'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+      # Fix header in file
+      post_body = nil
+
+      # http body (model)
+      # Fix header in file
+      # post_body = nil
+      auth_names = ['JWT']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'SvgImages')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PdfApi#get_images_extract_svg\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update fields from FDF file in storage.
     # 
     # @param name The document name.
@@ -11073,8 +11154,8 @@ def get_pdf_in_storage_to_doc_with_http_info(name, opts = {})
       if @api_client.config.client_side_validation && opts[:'format'] && !['Doc', 'DocX'].include?(opts[:'format'])
         fail ArgumentError, 'invalid value for "format", must be one of Doc, DocX'
       end
-      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow'].include?(opts[:'mode'])
-        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow'
+      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow', 'EnhancedFlow'].include?(opts[:'mode'])
+        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow, EnhancedFlow'
       end
       # resource path
       local_var_path = "/pdf/{name}/convert/doc".sub('{' + 'name' + '}', name.to_s)
@@ -24932,8 +25013,8 @@ def put_pdf_in_request_to_doc_with_http_info(out_path, opts = {})
       if @api_client.config.client_side_validation && opts[:'format'] && !['Doc', 'DocX'].include?(opts[:'format'])
         fail ArgumentError, 'invalid value for "format", must be one of Doc, DocX'
       end
-      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow'].include?(opts[:'mode'])
-        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow'
+      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow', 'EnhancedFlow'].include?(opts[:'mode'])
+        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow, EnhancedFlow'
       end
       # resource path
       local_var_path = "/pdf/convert/doc"
@@ -26166,8 +26247,8 @@ def put_pdf_in_storage_to_doc_with_http_info(name, out_path, opts = {})
       if @api_client.config.client_side_validation && opts[:'format'] && !['Doc', 'DocX'].include?(opts[:'format'])
         fail ArgumentError, 'invalid value for "format", must be one of Doc, DocX'
       end
-      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow'].include?(opts[:'mode'])
-        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow'
+      if @api_client.config.client_side_validation && opts[:'mode'] && !['Textbox', 'Flow', 'EnhancedFlow'].include?(opts[:'mode'])
+        fail ArgumentError, 'invalid value for "mode", must be one of Textbox, Flow, EnhancedFlow'
       end
       # resource path
       local_var_path = "/pdf/{name}/convert/doc".sub('{' + 'name' + '}', name.to_s)

lib/aspose_pdf_cloud/models/doc_recognition_mode.rb

@@ -27,6 +27,7 @@ class DocRecognitionMode
 
     TEXTBOX = "Textbox".freeze
     FLOW = "Flow".freeze
+    ENHANCED_FLOW = "EnhancedFlow".freeze
 
     # Builds the enum from string
     # @param [String] The enum value in the form of the string