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

update to 25.8

Author: boiledgas

README.md

@@ -9,12 +9,12 @@ 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.7
-- Add possibility to hide subject field in signature appearance.
+## Enhancements in Version 25.8
+- Implement document page resize 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.7
-- PostDeleteStamps removing stamps from PDF page is incorrect.
+## Bugs fixed in Version 25.8
+- Implement delete watermark from PDF document using the Pdf.Cloud API library.
 
 ## Installation
 ```

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.7.0"
+    headerParams["x-aspose-client-version"] = "25.8.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.
+[**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.
 [**PostDocumentTextHeader**](PdfApi.md#PostDocumentTextHeader) | **Post** /pdf/{name}/header/text | Add document text header.
@@ -7254,6 +7255,44 @@ 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)
 
+# **PostDocumentPagesResize**
+> AsposeResponse PostDocumentPagesResize(name, height, width, pages, optional)
+Rsize PDF document.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The document name. | 
+  **height** | **float64**| Page Height | 
+  **width** | **float64**| Page width | 
+  **pages** | **string**| Comma separated list of pages and page ranges. (Example: 1,3-5,8) | 
+ **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. | 
+ **height** | **float64**| Page Height | 
+ **width** | **float64**| Page width | 
+ **pages** | **string**| Comma separated list of pages and page ranges. (Example: 1,3-5,8) | 
+ **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)
+
 # **PostDocumentPagesRotate**
 > AsposeResponse PostDocumentPagesRotate(name, rotationAngle, pages, optional)
 Rotate PDF document.

document_test.go

@@ -322,4 +322,23 @@ func TestPostDocumentPagesRotate(t *testing.T) {
 	} else {
 		fmt.Printf("%d\tPostDocumentPagesRotate - %db\n", GetBaseTest().GetTestNumber(), response.Code)
 	}
+}
+
+func TestPostDocumentPagesResize(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.PostDocumentPagesResize(
+		name, 100, 200, "2-3", args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tPostDocumentPagesResize - %db\n", GetBaseTest().GetTestNumber(), response.Code)
+	}
 }

pdf_api.go

@@ -17353,6 +17353,96 @@ func (a *PdfApiService) PostDocumentPageNumberStamps(name string, stamp PageNumb
 	return successPayload, localVarHttpResponse, err
 }
 
+/* PdfApiService Rsize PDF document.
+ @param name The document name.
+ @param height Page Height
+ @param width Page width
+ @param pages Comma separated list of pages and page ranges. (Example: 1,3-5,8)
+ @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) PostDocumentPagesResize(name string, height float64, width float64, pages string, 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}/resize"
+	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("height", parameterToString(height, ""))
+	localVarQueryParams.Add("width", parameterToString(width, ""))
+	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
+	}
+	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 Rotate PDF document.
  @param name The document name.
  @param rotationAngle Rotation Angle (CKW). Can be 90, 180, 270.

uses_cases/pages/page_save_as_image.go

@@ -0,0 +1,30 @@
+package main
+
+import (
+	"fmt"
+	"os"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func SavePageAsPNG(pdf_api *asposepdfcloud.PdfApiService, document string, pageNumber int32, outputPNG string, remoteFolder string) {
+	// Show page information of the PDF document.
+	uploadFile(pdf_api, document)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	result, httpResponse, err := pdf_api.GetPageConvertToPng(document, pageNumber, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("Unexpected error!")
+	} else {
+		fileName := path.Join(LOCAL_FOLDER, outputPNG)
+		f, _ := os.Create(fileName)
+		_, _ = f.Write(result)
+		fmt.Println("File '" + outputPNG + "' successfully downloaded.")
+	}
+}

uses_cases/pages/pages_add.go

@@ -0,0 +1,26 @@
+package main
+
+import (
+	"fmt"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func AppendNewPage(pdf_api *asposepdfcloud.PdfApiService, document string, outputDocument string, remoteFolder string) {
+	// Append page to the PDF document.
+	uploadFile(pdf_api, document)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	result, httpResponse, err := pdf_api.PutAddNewPage(document, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("Unexpected error!")
+	} else {
+		fmt.Println("Successfully added new page. ", result.Pages.List)
+		downloadFile(pdf_api, document, outputDocument, "append_")
+	}
+}

uses_cases/pages/pages_append_image_stamp.go

@@ -0,0 +1,40 @@
+package main
+
+import (
+	"fmt"
+	"path"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func AppendPageStampImage(pdf_api *asposepdfcloud.PdfApiService, documentName string, outputDocument string, imageFileName string, pageNumber int32, width float64, height float64, remoteFolder string) {
+	// Append image stamp to page of the PDF document.
+	uploadFile(pdf_api, documentName)
+	uploadFile(pdf_api, imageFileName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	stamp := asposepdfcloud.ImageStamp{
+		Background:          true,
+		HorizontalAlignment: asposepdfcloud.HorizontalAlignmentCenter,
+		VerticalAlignment:   asposepdfcloud.VerticalAlignmentCenter,
+		Opacity:             1,
+		Rotate:              asposepdfcloud.RotationNone,
+		RotateAngle:         45,
+		Width:               width,
+		Height:              height,
+		Zoom:                1,
+		FileName:            path.Join(remoteFolder, imageFileName),
+	}
+	_, httpResponse, err := pdf_api.PostPageImageStamps(documentName, pageNumber, []asposepdfcloud.ImageStamp{stamp}, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("appendStampImage()): Failed to append image stamp to the document.")
+	} else {
+		fmt.Println("appendStampImage(): image stamp '"+imageFileName+"' appended successfully pn page", pageNumber, " to the document '"+documentName+"'.")
+		downloadFile(pdf_api, documentName, outputDocument, "add_image_stamp_")
+	}
+}

uses_cases/pages/pages_append_text_stamp.go

@@ -0,0 +1,39 @@
+package main
+
+import (
+	"fmt"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func AppendPageStampText(pdf_api *asposepdfcloud.PdfApiService, documentName string, pageNumber int32, outputDocument string, text_value string, remoteFolder string) {
+	// Append text stamp to page of the PDF document.
+	uploadFile(pdf_api, documentName)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	textStamp := asposepdfcloud.TextStamp{
+		Background:          true,
+		HorizontalAlignment: asposepdfcloud.HorizontalAlignmentCenter,
+		VerticalAlignment:   asposepdfcloud.VerticalAlignmentCenter,
+		Opacity:             1,
+		Rotate:              asposepdfcloud.RotationNone,
+		RotateAngle:         30,
+		Zoom:                1,
+		TextAlignment:       asposepdfcloud.HorizontalAlignmentCenter,
+		Value:               text_value,
+		TextState:           &asposepdfcloud.TextState{FontSize: 14, FontStyle: asposepdfcloud.FontStylesBoldItalic, Font: "Arial", ForegroundColor: &asposepdfcloud.Color{A: 0xFF, R: 0xFF, G: 0x00, B: 0x00}},
+	}
+
+	_, httpResponse, err := pdf_api.PostPageTextStamps(documentName, pageNumber, []asposepdfcloud.TextStamp{textStamp}, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("appendStampText(): Failed to append text stamp to the document.")
+	} else {
+		fmt.Println("appendStampText(): text stamp '"+text_value+"' appended successfully on page", pageNumber, " to the document '"+documentName+"'.")
+		downloadFile(pdf_api, documentName, outputDocument, "add_text_stamp_")
+	}
+}

uses_cases/pages/pages_delete.go

@@ -0,0 +1,26 @@
+package main
+
+import (
+	"fmt"
+
+	asposepdfcloud "github.com/aspose-pdf-cloud/aspose-pdf-cloud-go/v25"
+)
+
+func DeletePage(pdf_api *asposepdfcloud.PdfApiService, document string, pageNumber int32, outputDocument string, remoteFolder string) {
+	// Delete page of the PDF document.
+	uploadFile(pdf_api, document)
+
+	args := map[string]interface{}{
+		"folder": remoteFolder,
+	}
+
+	_, httpResponse, err := pdf_api.DeletePage(document, pageNumber, args)
+	if err != nil {
+		fmt.Println(err.Error())
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		fmt.Println("Unexpected error!")
+	} else {
+		fmt.Println("Successfully delete ", pageNumber, " page.")
+		downloadFile(pdf_api, document, outputDocument, "delete_")
+	}
+}