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

update to 25.6

Author: boiledgas

README.md

@@ -9,8 +9,8 @@ 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.5
-- Add a method for comparing pdf files.
+## Enhancements in Version 25.6
+- Develop Rotate Document Pages method.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
 ## 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.5.0"
+    headerParams["x-aspose-client-version"] = "25.6.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.
+[**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.
 [**PostDocumentTextReplace**](PdfApi.md#PostDocumentTextReplace) | **Post** /pdf/{name}/text/replace | Document's replace text method.
@@ -7253,6 +7254,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)
 
+# **PostDocumentPagesRotate**
+> AsposeResponse PostDocumentPagesRotate(name, rotationAngle, pages, optional)
+Rotate PDF document.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The document name. | 
+  **rotationAngle** | **string**| Rotation Angle (CKW). Can be 90, 180, 270. | 
+  **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. | 
+ **rotationAngle** | **string**| Rotation Angle (CKW). Can be 90, 180, 270. | 
+ **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)
+
 # **PostDocumentTextFooter**
 > AsposeResponse PostDocumentTextFooter(name, textFooter, optional)
 Add document text footer.

document_test.go

@@ -304,3 +304,22 @@ func TestPostOrganizeDocuments(t *testing.T) {
 		fmt.Printf("%d\tTestPostOrganizeDocuments - %db\n", GetBaseTest().GetTestNumber(), response.Code)
 	}
 }
+
+func TestPostDocumentPagesRotate(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.PostDocumentPagesRotate(
+		name, string(Rotationon90), "2-3", args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tPostDocumentPagesRotate - %db\n", GetBaseTest().GetTestNumber(), response.Code)
+	}
+}

images_test.go

@@ -154,8 +154,20 @@ func TestPutReplaceMultipleImage(t *testing.T) {
 		"folder":        GetBaseTest().remoteFolder,
 		"imageFilePath": GetBaseTest().remoteFolder + "/" + imageFileName,
 	}
+	
+	responseImages1, _, err := GetBaseTest().PdfAPI.GetImages(name, 1, args)
+	if err != nil {
+		t.Error(err)
+	}
+	imageID1 := responseImages1.Images.List[0].Id	
+	responseImages2, _, err := GetBaseTest().PdfAPI.GetImages(name, 16, args)
+	if err != nil {
+		t.Error(err)
+	}
+	imageID2 := responseImages2.Images.List[0].Id
+
 	response, httpResponse, err := GetBaseTest().PdfAPI.PutReplaceMultipleImage(name,
-		[]string{"GE5TENJVGQZTWMJYGQWDINRUFQ2DCMRMGY4TC", "GE5TIMJSGY3TWMJXG4WDIMBZFQ2DCOJMGQ3DK"}, args)
+		[]string{imageID1, imageID2}, args)
 	if err != nil {
 		t.Error(err)
 	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {

pdf_api.go

@@ -17353,6 +17353,94 @@ func (a *PdfApiService) PostDocumentPageNumberStamps(name string, stamp PageNumb
 	return successPayload, localVarHttpResponse, err
 }
 
+/* PdfApiService Rotate PDF document.
+ @param name The document name.
+ @param rotationAngle Rotation Angle (CKW). Can be 90, 180, 270.
+ @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) PostDocumentPagesRotate(name string, rotationAngle string, 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}/rotate"
+	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("rotationAngle", parameterToString(rotationAngle, ""))
+	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 Add document text footer.
  @param name The document name.
  @param textFooter The text footer.

uses_cases/attachments/attachments_main.go renamed to uses_cases/attachments/attachments_helper.go

@@ -63,17 +63,3 @@ func downloadFile(pdf_api *asposepdfcloud.PdfApiService, name string) {
 	result_data, _, _ := pdf_api.DownloadFile(path.Join(REMOTE_FOLDER, name), args)
 	saveByteArrayToFile(LOCAL_FOLDER, PDF_OUTPUT, result_data)
 }
-
-func main() {
-	pdfApi := initPdfApi()
-
-	uploadFile(pdfApi, PDF_DOCUMENT_WITH_ATTACH)
-	getDocumentAttachments(pdfApi, PDF_DOCUMENT_WITH_ATTACH, REMOTE_FOLDER)
-	getAttachmentByIndex(pdfApi, PDF_DOCUMENT_WITH_ATTACH, 1, REMOTE_FOLDER, LOCAL_FOLDER)
-
-	uploadFile(pdfApi, PDF_DOCUMENT)
-	uploadFile(pdfApi, NEW_ATTACHMENT_FILE)
-	appendAttachment(pdfApi, PDF_DOCUMENT, NEW_ATTACHMENT_FILE, NEW_ATTACHMENT_DECRIPTION, NEW_ATTACHMENT_MIME, REMOTE_FOLDER)
-
-	downloadFile(pdfApi, PDF_DOCUMENT)
-}

uses_cases/attachments/attachments_launch.go

@@ -0,0 +1,10 @@
+package main
+
+func main() {
+	pdfApi := initPdfApi()
+
+	getDocumentAttachments(pdfApi, PDF_DOCUMENT_WITH_ATTACH, REMOTE_FOLDER)
+	getAttachmentByIndex(pdfApi, PDF_DOCUMENT_WITH_ATTACH, 1, REMOTE_FOLDER, LOCAL_FOLDER)
+
+	appendAttachment(pdfApi, PDF_DOCUMENT, NEW_ATTACHMENT_FILE, NEW_ATTACHMENT_DECRIPTION, NEW_ATTACHMENT_MIME, REMOTE_FOLDER)
+}

uses_cases/bookmarks/append_bookmark.go

@@ -7,6 +7,8 @@ import (
 )
 
 func appendBookmark(pdf_api *asposepdfcloud.PdfApiService, document_name string, bookmark_path string, title string, remote_folder string) {
+	uploadFile(pdf_api, document_name)
+
 	args := map[string]interface{}{
 		"folder": remote_folder,
 	}
@@ -26,12 +28,12 @@ func appendBookmark(pdf_api *asposepdfcloud.PdfApiService, document_name string,
 		Color:             &asposepdfcloud.Color{A: 0x00, R: 0x00, G: 0xFF, B: 0x00},
 	}
 
-	result, httpResponse, err := pdf_api.PostBookmark(document_name, bookmark_path, []asposepdfcloud.Bookmark{bookmark}, args)
+	_, httpResponse, err := pdf_api.PostBookmark(document_name, bookmark_path, []asposepdfcloud.Bookmark{bookmark}, args)
 	if err != nil {
 		fmt.Println(err.Error())
 	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
 		fmt.Println("Unexpected error!")
 	} else {
-		fmt.Println(result.Bookmarks)
+		downloadFile(pdf_api, document_name, "appended_attachment_")
 	}
 }

uses_cases/bookmarks/bookmarks_main.go renamed to uses_cases/bookmarks/bookmarks_helper.go

@@ -1,6 +1,7 @@
 package main
 
 import (
+	"fmt"
 	"os"
 	"path"
 	"path/filepath"
@@ -18,8 +19,10 @@ const (
 )
 
 func initPdfApi() *asposepdfcloud.PdfApiService {
-	AppSID := "*************"
-	AppKey := "*************"
+	// Initialize Credentials and create Pdf.Cloud service object
+	AppSID := "******" // Your Application SID
+	AppKey := "******" // Your Application Key
+
 	pdfApi := asposepdfcloud.NewPdfApiService(AppSID, AppKey, "")
 	return pdfApi
 }
@@ -31,23 +34,13 @@ func uploadFile(pdf_api *asposepdfcloud.PdfApiService, name string) {
 	file, _ := os.Open(filepath.Join(LOCAL_FOLDER, name))
 	_, _, _ = pdf_api.UploadFile(filepath.Join(REMOTE_FOLDER, name), file, args)
 }
-func downloadFile(pdf_api *asposepdfcloud.PdfApiService, name string) {
+func downloadFile(pdf_api *asposepdfcloud.PdfApiService, name string, output_prefix string) {
 	args := map[string]interface{}{
 		"folder": REMOTE_FOLDER,
 	}
 	result_data, _, _ := pdf_api.DownloadFile(path.Join(REMOTE_FOLDER, name), args)
-	fileName := path.Join(LOCAL_FOLDER, PDF_OUTPUT)
+	fileName := path.Join(LOCAL_FOLDER, output_prefix+PDF_OUTPUT)
 	f, _ := os.Create(fileName)
 	_, _ = f.Write(result_data)
-}
-
-func main() {
-	pdfApi := initPdfApi()
-	uploadFile(pdfApi, PDF_DOCUMENT)
-	extractDocumentBookmarks(pdfApi, PDF_DOCUMENT, REMOTE_FOLDER)
-	extractBookmark(pdfApi, PDF_DOCUMENT, BOOKMARK_PATH, REMOTE_FOLDER)
-	appendBookmark(pdfApi, PDF_DOCUMENT, BOOKMARK_PATH, BOOKMARK_TITLE, REMOTE_FOLDER)
-	replaceBookmark(pdfApi, PDF_DOCUMENT, BOOKMARK_PATH, BOOKMARK_TITLE, REMOTE_FOLDER)
-	removeBookmark(pdfApi, PDF_DOCUMENT, BOOKMARK_PATH, REMOTE_FOLDER)
-	downloadFile(pdfApi, PDF_DOCUMENT)
+	fmt.Println("Result file'" + fileName + "' successfully downloaded!")
 }