Merge pull request #32 from aspose-pdf-cloud/holub

Fix: PDF pages (update metadata code snippet)

Author: AnHolub

pdf/nodejs/metadata/remove/_index.md

@@ -43,10 +43,11 @@ Aspose.PDF Cloud developers can easily load & remove metadata from PDF in just a
 
 {{% /blocks/products/pf/agp/text %}}
 
-1. Load your Application Secret and Key from the JSON file or set credentials in another way
-1. Create an object to connect to the Cloud API
+1. Create an object to connect to the Pdf.Cloud API
 1. Upload your document file
-1. Perform the deleting the metadata using ///////
+1. Create a new XmpMetadataProperty.  Set the name of the property you want to delete as the Key and `null` as the value
+1. Delete Metadata in the document using postXmpMetadata() function
+1. Perform some action after successful addition
 1. Download the result if needed it
 
 {{% /blocks/products/pf/agp/feature-section-col %}}
@@ -71,7 +72,76 @@ It is easy to get started with Aspose.PDF Cloud Node.js SDK and there is nothing
 
 ```js
 
-
+    import credentials from "./credentials.json"  with { type: "json" };
+    import fs from 'node:fs/promises';
+    import path from 'node:path';
+    import { PdfApi } from "asposepdfcloud";
+    import { XmpMetadata } from "asposepdfcloud/src/models/xmpMetadata.js";
+    import { XmpMetadataProperty } from "asposepdfcloud/src/models/xmpMetadataProperty.js";
+
+    const configParams = {
+        LOCAL_FOLDER: "C:\\Samples\\",
+        PDF_DOCUMENT_NAME: "sample.pdf",
+        LOCAL_RESULT_DOCUMENT_NAME: "output_sample.pdf",
+    };
+
+    const pdfApi = new PdfApi(credentials.id, credentials.key);
+
+    const pdfMetadatas = {
+        async uploadDocument() {
+            const pdfFilePath = path.join(configParams.LOCAL_FOLDER, configParams.PDF_DOCUMENT_NAME);
+            const pdfFileData = await fs.readFile(pdfFilePath);
+            await pdfApi.uploadFile(configParams.PDF_DOCUMENT_NAME, pdfFileData);
+        },
+        
+        async downloadResult() {
+            const changedPdfData = await pdfApi.downloadFile(configParams.PDF_DOCUMENT_NAME);
+            const filePath = path.join(configParams.LOCAL_FOLDER, configParams.LOCAL_RESULT_DOCUMENT_NAME);
+            await fs.writeFile(filePath, changedPdfData.body);
+            console.log("Downloaded: " + filePath);
+        },
+
+        async getMetadata () {
+            const responseMetadata = await pdfApi.getXmpMetadataJson(configParams.PDF_DOCUMENT_NAME);
+
+            if (responseMetadata.response.status == 200)
+            {
+                const props = responseMetadata.body.properties;
+                props.forEach((prop) =>{
+                    console.log(prop.key);
+                });
+            }
+        },
+
+        async deleteMetadata () {
+            const prop = new XmpMetadataProperty();
+            prop.key = 'dc:creator';
+            prop.value = null;        // null value means delete property...
+            prop.namespaceUri = 'http://purl.org/dc/elements/1.1/';
+
+            const metadata = new XmpMetadata();
+            metadata.properties = [prop];
+            
+            const response = await pdfApi.postXmpMetadata(configParams.PDF_DOCUMENT_NAME, metadata);
+
+            if (response.body.code == 200) {
+                console.log("Delete metadata '" + prop.key + "' successful!");
+                return true;
+            }
+        },
+    }
+
+    async function main() {
+        try {
+            await pdfMetadatas.uploadDocument();
+            await pdfMetadatas.getMetadata();
+            await pdfMetadatas.deleteMetadata();
+            await pdfMetadatas.getMetadata();
+            await pdfMetadatas.downloadResult();
+        } catch (error) {
+            console.error("Error:", error.message);
+        }
+    }
 ```
 
 {{% /blocks/products/pf/agp/code-block %}}

pdf/python/text/replace/_index.md

@@ -50,13 +50,15 @@ Aspose.PDF Cloud developers can easily load & replace Text in PDF in just a few
 
 {{% /blocks/products/pf/agp/text %}}
 
-1. Install [Python SDK](https://pypi.org/project/asposepdfcloud/).
-1. Go to the [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/).
-1. Create a new [Account](https://docs.aspose.cloud/display/storagecloud/Creating+and+Managing+Account) to access all applications and services or Sign In to your account.
-1. Click on Applications in the left menu to get Client Id and Client Secret.
-1. Check out the [Developer Guide](https://docs.aspose.cloud/pdf/developer-guide/) to replace Text in PDF via Python.
-1. Check out our [GitHub repository](https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python/) for a complete API list along with working examples.
-1. Check out the [API Reference page](https://reference.aspose.cloud/pdf/#/Document) for the description of APIs parameters.
+1. Defining Configuration Parameters
+1. Setting Up Logging
+1. Creating the PdfTexts Class
+1. Initializing the API Client
+1. Ensuring API Initialization
+1. Uploading the PDF Document
+1. Replacing Text in the PDF Document
+1. Specific Page Replacement
+1. Downloading the Processed PDF Document
 
 {{% /blocks/products/pf/agp/feature-section-col %}}
 
@@ -76,7 +78,122 @@ It is easy to get started with Aspose.PDF Cloud Python SDK and there is nothing
 
 ```python
 
-
+    import shutil
+    import json
+    import logging
+    from pathlib import Path
+    from asposepdfcloud import ApiClient, PdfApi, TextReplace, TextReplaceListRequest
+
+    class Config:
+        """Configuration parameters."""
+        CREDENTIALS_FILE = Path(r"C:\\Projects\\ASPOSE\\Pdf.Cloud\\Credentials\\credentials.json")
+        LOCAL_FOLDER = Path(r"C:\\Samples")
+        PDF_DOCUMENT_NAME = "sample.pdf"
+        LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
+        PAGE_NUMBER = 2
+        TEXT_SOURCE_FOR_REPLACE = "YOUR source text"
+        TEXT_NEW_VALUE = "YOUR new text"
+
+    # Configure logging
+    logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+    class PdfTexts:
+        """Class for managing PDF texts using Aspose PDF Cloud API."""
+
+        def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
+            self.pdf_api = None
+            self._init_api(credentials_file)
+
+        def _init_api(self, credentials_file: Path):
+            """Initialize the API client."""
+            try:
+                with credentials_file.open("r", encoding="utf-8") as file:
+                    credentials = json.load(file)
+                    api_key, app_id = credentials.get("key"), credentials.get("id")
+                    if not api_key or not app_id:
+                        raise ValueError("Error: Missing API keys in the credentials file.")
+                    self.pdf_api = PdfApi(ApiClient(api_key, app_id))
+            except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
+                logging.error(f"Failed to load credentials: {e}")
+
+        def _ensure_api_initialized(self):
+            """Check if the API is initialized before making API calls."""
+            if not self.pdf_api:
+                logging.error("PDF API is not initialized. Operation aborted.")
+                return False
+            return True
+
+        def upload_document(self):
+            """Upload a PDF document to the Aspose Cloud server."""
+            if not self._ensure_api_initialized():
+                return
+
+            file_path = Config.LOCAL_FOLDER / Config.PDF_DOCUMENT_NAME
+            try:
+                self.pdf_api.upload_file(Config.PDF_DOCUMENT_NAME, str(file_path))
+                logging.info(f"File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
+            except Exception as e:
+                logging.error(f"Failed to upload file: {e}")
+
+        def download_result(self):
+            """ Download the processed PDF document from the Aspose Cloud server """
+            if not self._ensure_api_initialized():
+                return
+
+            try:
+                temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
+                local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
+                shutil.move(temp_file, str(local_path))
+                logging.info(f"download_result(): File successfully downloaded: {local_path}")
+            except Exception as e:
+                logging.error(f"download_result(): Failed to download file: {e}")
+
+        def replace_document_texts(self):
+            """ Replace text in the PDF document """
+            if not self.pdf_api:
+                return
+
+            text_replace_obj = TextReplace(old_value=Config.TEXT_SOURCE_FOR_REPLACE, new_value=Config.TEXT_NEW_VALUE, regex=False)
+
+            text_replace_request = TextReplaceListRequest([text_replace_obj])
+
+            response = self.pdf_api.post_document_text_replace(
+                Config.PDF_DOCUMENT_NAME, text_replace_request
+            )
+
+            if response.code == 200:
+                print(f"Text '{Config.TEXT_SOURCE_FOR_REPLACE}' replaced with '{Config.TEXT_NEW_VALUE}' - successfully.")
+            else:
+                print("Failed to replace text in document.")
+
+        def replace_page_texts(self):
+            """ Replace text on the page in PDF document """
+            if not self.pdf_api:
+                return
+
+            text_replace_obj = TextReplace(old_value=Config.TEXT_NEW_VALUE, new_value=Config.TEXT_SOURCE_FOR_REPLACE, regex=False)
+
+            text_replace_request = TextReplaceListRequest([text_replace_obj])
+
+            response = self.pdf_api.post_page_text_replace(
+                Config.PDF_DOCUMENT_NAME,
+                Config.PAGE_NUMBER,
+                text_replace_request
+            )
+
+            if response.code == 200:
+                print(f"Text '{Config.TEXT_NEW_VALUE}' replaced with '{Config.TEXT_SOURCE_FOR_REPLACE}' - successfully.")
+            else:
+                print("Failed to replace text in document.")
+
+
+
+    if __name__ == "__main__":
+        pdf_texts = PdfTexts()
+        pdf_texts.upload_document()
+        pdf_texts.replace_document_texts()
+        pdf_texts.replace_page_texts()
+        pdf_texts.download_result()
 ```
 
 {{% /blocks/products/pf/agp/code-block %}}