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

update to 23.4.0

Author: kaferi

README.md

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

api_client.go

@@ -37,13 +37,11 @@ type BaseTest struct {
 
 func (bt *BaseTest) UploadFile(name string) (err error) {
 	args := make(map[string]interface{})
-
-	file, err := os.Open(bt.localTestDataFolder + "/" + name)
+	file, err := os.Open(filepath.Join(bt.localTestDataFolder, name))
 	if err != nil {
 		return err
 	}
-
-	_, _, err = GetBaseTest().PdfAPI.UploadFile(GetBaseTest().remoteFolder+"/"+name, file, args)
+	_, _, err = GetBaseTest().PdfAPI.UploadFile(filepath.Join(GetBaseTest().remoteFolder, name), file, args)
 	return err
 }
 

base_test.go

@@ -0,0 +1,12 @@
+# OrganizeDocumentData
+Data for document organizing.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**Path** | **string** | Full filename of the document for organizing. | [default to null]
+**Pages** | **string** | 1-based page numbers of the document that make up the resulting document. | [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]](../organize_document_data.go)
+
+

docs/OrganizeDocumentData.md

@@ -0,0 +1,11 @@
+# OrganizeDocumentRequest
+Documents data for organizing.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**List** | [**[]OrganizeDocumentData**](OrganizeDocumentData.md) | List of document data for organizing. | [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]](../organize_document_request.go)
+
+

docs/OrganizeDocumentRequest.md

@@ -214,6 +214,8 @@ Method | HTTP request | Description
 [**PostListBoxFields**](PdfApi.md#PostListBoxFields) | **Post** /pdf/{name}/fields/listbox | Add document listbox fields.
 [**PostMovePage**](PdfApi.md#PostMovePage) | **Post** /pdf/{name}/pages/{pageNumber}/movePage | Move page to new position.
 [**PostOptimizeDocument**](PdfApi.md#PostOptimizeDocument) | **Post** /pdf/{name}/optimize | Optimize document.
+[**PostOrganizeDocument**](PdfApi.md#PostOrganizeDocument) | **Post** /pdf/{name}/organize | Merge selected pages of a document.
+[**PostOrganizeDocuments**](PdfApi.md#PostOrganizeDocuments) | **Post** /pdf/organize | Merge selected pages of different documents.
 [**PostPageCaretAnnotations**](PdfApi.md#PostPageCaretAnnotations) | **Post** /pdf/{name}/pages/{pageNumber}/annotations/caret | Add document page caret annotations.
 [**PostPageCertify**](PdfApi.md#PostPageCertify) | **Post** /pdf/{name}/pages/{pageNumber}/certify | Certify document page.
 [**PostPageCircleAnnotations**](PdfApi.md#PostPageCircleAnnotations) | **Post** /pdf/{name}/pages/{pageNumber}/annotations/circle | Add document page circle annotations.
@@ -7291,6 +7293,73 @@ 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)
 
+# **PostOrganizeDocument**
+> AsposeResponse PostOrganizeDocument(name, pages, outPath, optional)
+Merge selected pages of a document.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **string**| The original document name. | 
+  **pages** | **string**| 1-based page numbers of the source document that make up the resulting document. | 
+  **outPath** | **string**| Full filename of the resulting document. | 
+ **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 original document name. | 
+ **pages** | **string**| 1-based page numbers of the source document that make up the resulting document. | 
+ **outPath** | **string**| Full filename of the resulting document. | 
+ **storage** | **string**| The documents storage. | 
+ **folder** | **string**| The source document folder. | 
+
+### 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)
+
+# **PostOrganizeDocuments**
+> AsposeResponse PostOrganizeDocuments(organizeDocuments, outPath, optional)
+Merge selected pages of different documents.
+
+### Required Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **organizeDocuments** | [**OrganizeDocumentRequest**](OrganizeDocumentRequest.md)| Array of OrganizeDocumentData to make up the resulting document. | 
+  **outPath** | **string**| Full filename of the resulting document. | 
+ **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
+------------- | ------------- | ------------- | -------------
+ **organizeDocuments** | [**OrganizeDocumentRequest**](OrganizeDocumentRequest.md)| Array of OrganizeDocumentData to make up the resulting document. | 
+ **outPath** | **string**| Full filename of the resulting document. | 
+ **storage** | **string**| The documents storage. | 
+
+### 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)
+
 # **PostPageCaretAnnotations**
 > AsposeResponse PostPageCaretAnnotations(name, pageNumber, annotations, optional)
 Add document page caret annotations.

docs/PdfApi.md

@@ -23,6 +23,7 @@ package asposepdfcloud
 import (
 	"encoding/base64"
 	"fmt"
+	"path/filepath"
 	"testing"
 )
 
@@ -256,3 +257,50 @@ func TestPutDocumentDisplayProperties(t *testing.T) {
 		fmt.Printf("%d\tTestPutDocumentDisplayProperties - %d\n", GetBaseTest().GetTestNumber(), response.Code)
 	}
 }
+
+func TestPostOrganizeDocument(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.PostOrganizeDocument(
+		name, "1,4-2", filepath.Join(GetBaseTest().remoteFolder, name), args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tTestPostOrganizeDocument - %db\n", GetBaseTest().GetTestNumber(), response.Code)
+	}
+}
+
+func TestPostOrganizeDocuments(t *testing.T) {
+	name1 := "4pages.pdf"
+	if err := GetBaseTest().UploadFile(name1); err != nil {
+		t.Error(err)
+	}
+	name2 := "marketing.pdf"
+	if err := GetBaseTest().UploadFile(name2); err != nil {
+		t.Error(err)
+	}
+	request := OrganizeDocumentRequest{
+		List: []OrganizeDocumentData{
+			{Path: filepath.Join(GetBaseTest().remoteFolder, name1), Pages: "4-2"},
+			{Path: filepath.Join(GetBaseTest().remoteFolder, name2), Pages: "2"},
+			{Path: filepath.Join(GetBaseTest().remoteFolder, name1), Pages: "3,1"},
+		},
+	}
+	args := make(map[string]interface{})
+	response, httpResponse, err := GetBaseTest().PdfAPI.PostOrganizeDocuments(
+		request, filepath.Join(GetBaseTest().remoteFolder, "OrganizeMany.pdf"), args)
+	if err != nil {
+		t.Error(err)
+	} else if httpResponse.StatusCode < 200 || httpResponse.StatusCode > 299 {
+		t.Fail()
+	} else {
+		fmt.Printf("%d\tTestPostOrganizeDocuments - %db\n", GetBaseTest().GetTestNumber(), response.Code)
+	}
+}

document_test.go

@@ -0,0 +1,30 @@
+/*
+*
+* Copyright (c) 2023 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
+
+// Data for document organizing.
+type OrganizeDocumentData struct {
+	// Full filename of the document for organizing.
+	Path string `json:"Path"`
+	// 1-based page numbers of the document that make up the resulting document.
+	Pages string `json:"Pages"`
+}

organize_document_data.go

@@ -0,0 +1,28 @@
+/*
+*
+* Copyright (c) 2023 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
+
+// Documents data for organizing.
+type OrganizeDocumentRequest struct {
+	// List of document data for organizing.
+	List []OrganizeDocumentData `json:"List"`
+}

organize_document_request.go

@@ -22,6 +22,6 @@
 package asposepdfcloud
 
 type PageRange struct {
-	From int32 `json:"from,omitempty"`
-	To int32 `json:"to,omitempty"`
+	From int32 `json:"From,omitempty"`
+	To int32 `json:"To,omitempty"`
 }