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

update to 25.9

Author: boiledgas

README.md

@@ -9,13 +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 25.8
-- Implement document page resize functionality using the Pdf.Cloud API library.
+## Enhancements in Version 25.9
+- Implement PDF document page crop functionality using the Pdf.Cloud API library.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
-## Bugs fixed in Version 25.8
-- Implement delete watermark from PDF document using the Pdf.Cloud API library.
-
 ## Installation
 ```
     go get -u github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25

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"] = "25.8.0"
+    headerParams["x-aspose-client-version"] = "25.9.0"
 
     // Detect postBody type and post.
     if postBody != nil {

docs/PdfApi.md

@@ -212,6 +212,7 @@ Method | HTTP request | Description
 [**PostDocumentImageStamps**](PdfApi.md#PostDocumentImageStamps) | **Post** /pdf/{name}/stamps/image | Add document pages image stamps.
 [**PostDocumentImageStampsPageSpecified**](PdfApi.md#PostDocumentImageStampsPageSpecified) | **Post** /pdf/{name}/stamps/image/pagespecified | Add document image stamps to specified pages.
 [**PostDocumentPageNumberStamps**](PdfApi.md#PostDocumentPageNumberStamps) | **Post** /pdf/{name}/stamps/pagenumber | Add document page number stamps.
+[**PostDocumentPagesCrop**](PdfApi.md#PostDocumentPagesCrop) | **Post** /pdf/{name}/crop | Crop PDF document pages.
 [**PostDocumentPagesResize**](PdfApi.md#PostDocumentPagesResize) | **Post** /pdf/{name}/resize | Rsize PDF document.
 [**PostDocumentPagesRotate**](PdfApi.md#PostDocumentPagesRotate) | **Post** /pdf/{name}/rotate | Rotate PDF document.
 [**PostDocumentTextFooter**](PdfApi.md#PostDocumentTextFooter) | **Post** /pdf/{name}/footer/text | Add document text footer.
@@ -7255,6 +7256,42 @@ 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)
 
+# **PostDocumentPagesCrop**
+> AsposeResponse PostDocumentPagesCrop(name, pages, rect, optional)
+Crop PDF document pages.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The document name. | 
+  **pages** | **string**| Comma separated list of pages and page ranges. (Example: 1,3-5,8) | 
+  **rect** | [**Rectangle**](Rectangle.md)| Rectangle of document area. | 
+ **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. | 
+ **pages** | **string**| Comma separated list of pages and page ranges. (Example: 1,3-5,8) | 
+ **rect** | [**Rectangle**](Rectangle.md)| Rectangle of document area. | 
+ **storage** | **string**| The document storage. | 
+ **folder** | **string**| The document folder. | 
+ **password** | **string**| Base64 encoded password. | 
+
+### Return type
+
+[**AsposeResponse**](AsposeResponse.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)
+
 # **PostDocumentPagesResize**
 > AsposeResponse PostDocumentPagesResize(name, height, width, pages, optional)
 Rsize PDF document.

document_test.go

@@ -341,4 +341,23 @@ func TestPostDocumentPagesResize(t *testing.T) {
 	} else {
 		fmt.Printf("%d\tPostDocumentPagesResize - %db\n", GetBaseTest().GetTestNumber(), response.Code)
 	}
-}
+}
+
+func TestPostDocumentPagesCrop(t *testing.T) {
+	name := "4pages.pdf"
+	if err := GetBaseTest().UploadFile(name); err != nil {
+		t.Error(err)
+	}
+	args := map[string]interface{}{
+		"folder": GetBaseTest().remoteFolder,
+	}
+	response, httpResponse, err := GetBaseTest().PdfAPI.PostDocumentPagesCrop(
+		name, "2-3", Rectangle{LLX: 0, LLY: 0, URX: 800, URY: 400}, args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tPostDocumentPagesCrop - %db\n", GetBaseTest().GetTestNumber(), response.Code)
+	}
+}

pdf_api.go

@@ -17353,6 +17353,95 @@ func (a *PdfApiService) PostDocumentPageNumberStamps(name string, stamp PageNumb
 	return successPayload, localVarHttpResponse, err
 }
 
+/* PdfApiService Crop PDF document pages.
+ @param name The document name.
+ @param pages Comma separated list of pages and page ranges. (Example: 1,3-5,8)
+ @param rect Rectangle of document area.
+ @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 "password" (string) Base64 encoded password.
+ @return AsposeResponse*/
+func (a *PdfApiService) PostDocumentPagesCrop(name string, pages string, rect Rectangle, localVarOptionals map[string]interface{}) (AsposeResponse,  *http.Response, error) {
+	var (
+		localVarHttpMethod = strings.ToUpper("Post")
+		localVarPostBody interface{}
+		localVarFileName string
+		localVarFileBytes []byte
+	 	successPayload AsposeResponse
+	)
+
+	// create path and map variables
+	localVarPath := a.client.cfg.BasePath + "/pdf/{name}/crop"
+	localVarPath = strings.Replace(localVarPath, "{"+"name"+"}", fmt.Sprintf("%v", name), -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["password"], "string", "password"); err != nil {
+		return successPayload, nil, err
+	}
+
+	localVarQueryParams.Add("pages", parameterToString(pages, ""))
+	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["password"].(string); localVarOk {
+		localVarQueryParams.Add("password", 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
+	}
+	// body params
+	localVarPostBody = &rect
+	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 Rsize PDF document.
  @param name The document name.
  @param height Page Height

uses_cases/parser/parse_get_forms_fdf.go

@@ -0,0 +1,29 @@
+package main
+
+import (
+	"fmt"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func ParseExtractFormsAsFDF(pdf_api *asposepdfcloud.PdfApiService, documentName string, outputFDFName string, remoteFolder string) {
+	// Extract Form fields from the document to FDF file
+	uploadFile(pdf_api, documentName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	fdfPath := path.Join(remoteFolder, outputFDFName)
+
+	_, httpResponse, err := pdf_api.PutExportFieldsFromPdfToFdfInStorage(documentName, fdfPath, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("ParseExtractFormsAsFDF(): Failed to extract Form fields from the document.")
+	} else {
+		fmt.Println("ParseExtractFormsAsFDF(): Forms fields successfully extracted from the document '" + documentName + "'.")
+		downloadFile(pdf_api, outputFDFName, outputFDFName)
+	}
+}

uses_cases/parser/parse_get_forms_xml.go

@@ -0,0 +1,29 @@
+package main
+
+import (
+	"fmt"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func ParseExtractFormsAsXML(pdf_api *asposepdfcloud.PdfApiService, documentName string, outputXMLName string, remoteFolder string) {
+	// Extract Form fields from the document to XML file
+	uploadFile(pdf_api, documentName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	xmlPath := path.Join(remoteFolder, outputXMLName)
+
+	_, httpResponse, err := pdf_api.PutExportFieldsFromPdfToXmlInStorage(documentName, xmlPath, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("ParseExtractFormsAsXML(): Failed to extract Form fields from the document.")
+	} else {
+		fmt.Println("ParseExtractFormsAsXML(): Forms fields successfully extracted from the document '" + documentName + "'.")
+		downloadFile(pdf_api, outputXMLName, outputXMLName)
+	}
+}

uses_cases/parser/parse_get_images.go

@@ -0,0 +1,43 @@
+package main
+
+import (
+	"fmt"
+	"os"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func ParseExtractImages(pdf_api *asposepdfcloud.PdfApiService, documentName string, pageNumber int32, localFolder string, remoteFolder string) {
+	// Extract Images from the page of PDF document
+	uploadFile(pdf_api, documentName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	respImages, httpResponse, err := pdf_api.GetImages(documentName, pageNumber, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("ParseExtractImages(): Failed to extract images from the page of document.")
+	} else {
+		for _, image := range respImages.Images.List {
+
+			response, httpResponse, err := pdf_api.GetImageExtractAsPng(documentName, image.Id, args)
+
+			if err != nil {
+				fmt.Println(err.Error())
+			} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+				fmt.Println("ParseExtractImages(): Failed to extract image.")
+			} else {
+				fmt.Println("ParseExtractImages(): Images'" + image.Id + "' successfully extracted from the page of document.")
+
+				fileName := path.Join(localFolder, (image.Id + ".png"))
+				f, _ := os.Create(fileName)
+				_, _ = f.Write(response)
+				fmt.Println("File '" + fileName + "' successfully downloaded.")
+			}
+		}
+	}
+}

uses_cases/parser/parse_get_tables.go

@@ -0,0 +1,49 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func ParseExtractTables(pdf_api *asposepdfcloud.PdfApiService, documentName string, localFolder string, remoteFolder string) {
+	// Extract tables form the document
+	uploadFile(pdf_api, documentName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	result, httpResponse, err := pdf_api.GetDocumentTables(documentName, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("ExtractTables(): Failed to extract tables from the document.")
+	} else {
+		if result.Tables == nil || len(result.Tables.List) == 0 {
+			fmt.Println("ExtractTables(): Tables not found in the document.")
+		} else {
+			resultJson := "[\n"
+			for _, t := range result.Tables.List {
+				respTable, httpResponse, err := pdf_api.GetTable(documentName, t.Id, args)
+				if err != nil {
+					fmt.Println(err.Error())
+				} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+					fmt.Println("ExtractTables(): Failed to extract table from the document.")
+				} else {
+					fmt.Println("table", respTable.Table)
+					jsTable, _ := json.Marshal(respTable.Table)
+					resultJson += string(jsTable) + ",\n\n"
+				}
+			}
+			resultJson += "]"
+			fileName := path.Join(localFolder, ("parsed_tables_output.json"))
+			f, _ := os.Create(fileName)
+			_, _ = f.Write([]byte(resultJson))
+			fmt.Println("File '" + fileName + "' successfully downloaded.")
+		}
+	}
+}