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

update to 24.11

Author: boiledgas

README.md

@@ -9,15 +9,10 @@ These SDKs are now fully supported. If you have any questions, see any bugs or h
 
 Extract Text & Images of a PDF document online https://products.aspose.app/pdf/parser.
 
-## 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
 ```
     go get -u github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v24

api_client.go

@@ -176,7 +176,7 @@ func (c *APIClient) prepareRequest (
 
     // set custom header
     headerParams["x-aspose-client"] = "go sdk"
-    headerParams["x-aspose-client-version"] = "24.10.0"
+    headerParams["x-aspose-client-version"] = "24.11.0"
 
     // Detect postBody type and post.
     if postBody != nil {

doc_recognition_mode.go

@@ -27,4 +27,5 @@ type DocRecognitionMode string
 const (
 	DocRecognitionModeTextbox DocRecognitionMode = "Textbox"
 	DocRecognitionModeFlow DocRecognitionMode = "Flow"
+	DocRecognitionModeEnhancedFlow DocRecognitionMode = "EnhancedFlow"
 )

docs/DocRecognitionMode.md

@@ -6,6 +6,7 @@ Name | Type | Value | Description
 ------------ | ------------- | ------------- | -------------
 **DocRecognitionModeTextbox** | **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.
 **DocRecognitionModeFlow** | **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.
+**DocRecognitionModeEnhancedFlow** | **string** | "EnhancedFlow" | An alternative Flow mode that supports the recognition of tables.
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)[[View Source]](../doc_recognition_mode.go)
 

docs/PdfApi.md

@@ -95,6 +95,7 @@ Method | HTTP request | Description
 [**GetImageExtractAsPng**](PdfApi.md#GetImageExtractAsPng) | **Get** /pdf/{name}/images/{imageId}/extract/png | Extract document image in PNG format
 [**GetImageExtractAsTiff**](PdfApi.md#GetImageExtractAsTiff) | **Get** /pdf/{name}/images/{imageId}/extract/tiff | Extract document image in TIFF format
 [**GetImages**](PdfApi.md#GetImages) | **Get** /pdf/{name}/pages/{pageNumber}/images | Read document images.
+[**GetImagesExtractSvg**](PdfApi.md#GetImagesExtractSvg) | **Get** /pdf/{name}/pages/{pageNumber}/images/extract/svg | Extract SVG images from document page.
 [**GetImportFieldsFromFdfInStorage**](PdfApi.md#GetImportFieldsFromFdfInStorage) | **Get** /pdf/{name}/import/fdf | Update fields from FDF file in storage.
 [**GetImportFieldsFromXfdfInStorage**](PdfApi.md#GetImportFieldsFromXfdfInStorage) | **Get** /pdf/{name}/import/xfdf | Update fields from XFDF file in storage.
 [**GetImportFieldsFromXmlInStorage**](PdfApi.md#GetImportFieldsFromXmlInStorage) | **Get** /pdf/{name}/import/xml | Import from XML file (located on storage) to PDF format and return resulting file in response. 
@@ -3300,6 +3301,40 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **GetImagesExtractSvg**
+> SvgImages GetImagesExtractSvg(name, pageNumber, optional)
+Extract SVG images from document page.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The document name. | 
+  **pageNumber** | **int32**| The page number. | 
+ **optional** | **map[string]interface{}** | optional parameters | nil if no parameters
+
+### Optional Parameters
+Optional parameters are passed through a map[string]interface{}.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The document name. | 
+ **pageNumber** | **int32**| The page number. | 
+ **storage** | **string**| The document storage. | 
+ **folder** | **string**| The document folder. | 
+ **passBase64** | **string**| The password (Base64). | 
+
+### Return type
+
+[**SvgImages**](SvgImages.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **GetImportFieldsFromFdfInStorage**
 > []byte GetImportFieldsFromFdfInStorage(name, fdfFilePath, optional)
 Update fields from FDF file in storage.

docs/SvgImages.md

@@ -0,0 +1,13 @@
+# SvgImages
+SvgImages class
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**Code** | **int32** | Response status code. | [default to null]
+**Status** | **string** | Response status. | [optional] [default to null]
+**List** | **[]string** | List of SVG images | [optional] [default to null]
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)[[View Source]](../svg_images.go)
+
+

images_test.go

@@ -545,3 +545,28 @@ func TestGetImageExtractAsPng(t *testing.T) {
 		fmt.Printf("%d\tTestGetImageExtractAsPng - %db\n", GetBaseTest().GetTestNumber(), len(response))
 	}
 }
+
+func TestGetImagesExtractSvg(t *testing.T) {
+
+	name := "Alfa.pdf"
+	pageNumber := int32(1)
+
+	if err := GetBaseTest().UploadFile(name); err != nil {
+		t.Error(err)
+	}
+
+	args := map[string]interface{}{
+		"folder": GetBaseTest().remoteFolder,
+	}
+
+	response, httpResponse, err := GetBaseTest().PdfAPI.GetImagesExtractSvg(name, pageNumber, args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else if len(response.List) == 0 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tTestGetImagesExtractSvg - %db\n", GetBaseTest().GetTestNumber(), len(response.List))
+	}
+}

pdf_api.go

@@ -7292,6 +7292,92 @@ func (a *PdfApiService) GetImages(name string, pageNumber int32, localVarOptiona
 	return successPayload, localVarHttpResponse, err
 }
 
+/* PdfApiService Extract SVG images from document page.
+ @param name The document name.
+ @param pageNumber The page number.
+ @param optional (nil or map[string]interface{}) with one or more of:
+     @param "storage" (string) The document storage.
+     @param "folder" (string) The document folder.
+     @param "passBase64" (string) The password (Base64).
+ @return SvgImages*/
+func (a *PdfApiService) GetImagesExtractSvg(name string, pageNumber int32, localVarOptionals map[string]interface{}) (SvgImages,  *http.Response, error) {
+	var (
+		localVarHttpMethod = strings.ToUpper("Get")
+		localVarPostBody interface{}
+		localVarFileName string
+		localVarFileBytes []byte
+	 	successPayload SvgImages
+	)
+
+	// create path and map variables
+	localVarPath := a.client.cfg.BasePath + "/pdf/{name}/pages/{pageNumber}/images/extract/svg"
+	localVarPath = strings.Replace(localVarPath, "{"+"name"+"}", fmt.Sprintf("%v", name), -1)
+	localVarPath = strings.Replace(localVarPath, "{"+"pageNumber"+"}", fmt.Sprintf("%v", pageNumber), -1)
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _url.Values{}
+	localVarFormParams := _url.Values{}
+
+	if err := typeCheckParameter(localVarOptionals["storage"], "string", "storage"); err != nil {
+		return successPayload, nil, err
+	}
+	if err := typeCheckParameter(localVarOptionals["folder"], "string", "folder"); err != nil {
+		return successPayload, nil, err
+	}
+	if err := typeCheckParameter(localVarOptionals["passBase64"], "string", "passBase64"); err != nil {
+		return successPayload, nil, err
+	}
+
+	if localVarTempParam, localVarOk := localVarOptionals["storage"].(string); localVarOk {
+		localVarQueryParams.Add("storage", parameterToString(localVarTempParam, ""))
+	}
+	if localVarTempParam, localVarOk := localVarOptionals["folder"].(string); localVarOk {
+		localVarQueryParams.Add("folder", parameterToString(localVarTempParam, ""))
+	}
+	if localVarTempParam, localVarOk := localVarOptionals["passBase64"].(string); localVarOk {
+		localVarQueryParams.Add("passBase64", parameterToString(localVarTempParam, ""))
+	}
+	// to determine the Content-Type header
+	localVarHttpContentTypes := []string{ "application/json",  }
+
+	// set Content-Type header
+	localVarHttpContentType := selectHeaderContentType(localVarHttpContentTypes)
+	if localVarHttpContentType != "" {
+		localVarHeaderParams["Content-Type"] = localVarHttpContentType
+	}
+
+	// to determine the Accept header
+	localVarHttpHeaderAccepts := []string{
+		"application/json",
+		}
+
+	// set Accept header
+	localVarHttpHeaderAccept := selectHeaderAccept(localVarHttpHeaderAccepts)
+	if localVarHttpHeaderAccept != "" {
+		localVarHeaderParams["Accept"] = localVarHttpHeaderAccept
+	}
+	r, err := a.client.prepareRequest(localVarPath, localVarHttpMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, localVarFileName, localVarFileBytes)
+	if err != nil {
+		return successPayload, nil, err
+	}
+
+	localVarHttpResponse, err := a.client.callAPI(r)
+	if err != nil || localVarHttpResponse == nil {
+		return successPayload, localVarHttpResponse, err
+	}
+	defer localVarHttpResponse.Body.Close()
+	if localVarHttpResponse.StatusCode >= 300 {
+		bodyBytes, _ := io.ReadAll(localVarHttpResponse.Body)
+		return successPayload, localVarHttpResponse, reportError("Status: %v, Body: %s", localVarHttpResponse.Status, bodyBytes)
+	}
+    
+	if err = deserializeDTO(localVarHttpResponse.Body, &successPayload); err != nil {
+		return successPayload, localVarHttpResponse, err
+	}
+
+	return successPayload, localVarHttpResponse, err
+}
+
 /* PdfApiService Update fields from FDF file in storage.
  @param name The document name.
  @param fdfFilePath The Fdf file path.

svg_images.go

@@ -0,0 +1,32 @@
+/*
+*
+* Copyright (c) 2024 Aspose.PDF Cloud
+* Permission is hereby granted, free of charge, to any person obtaining a copy
+* of this software and associated documentation files (the "Software"), to deal
+* in the Software without restriction, including without limitation the rights
+* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+* copies of the Software, and to permit persons to whom the Software is
+* furnished to do so, subject to the following conditions:
+* The above copyright notice and this permission notice shall be included in all
+* copies or substantial portions of the Software.
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+* SOFTWARE.
+*
+*/
+
+package asposepdfcloud
+
+// SvgImages class
+type SvgImages struct {
+	// Response status code.
+	Code int32 `json:"Code"`
+	// Response status.
+	Status string `json:"Status,omitempty"`
+	// List of SVG images
+	List []string `json:"List,omitempty"`
+}