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

Develop

Author: boiledgas

README.md

@@ -30,9 +30,8 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 25.1
+## Enhancements in Version 25.2
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
-
 ## Requirements.
 Python 2.7 and 3.4+
 

Uses-Cases/Attachments/add/appendAttachments.py

@@ -0,0 +1,89 @@
+import shutil
+import json
+import logging
+from pathlib import Path
+from asposepdfcloud import ApiClient, PdfApi, AttachmentInfo
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+
+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"
+    NEW_ATTACHMENT_FILE = "sample_video.mp4"
+    NEW_ATTACHMENT_MIME = "video/mp4"
+    PAGE_NUMBER = 2
+
+class PdfAttachments:
+    """Class for managing PDF attachments 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("init_api(): 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"init_api(): Failed to load credentials: {e}")
+
+    def upload_file(self, fileName: str):
+        """ Upload a local fileName to the Aspose Cloud server. """
+        if self.pdf_api:
+            file_path = Config.LOCAL_FOLDER / fileName
+            try:
+                self.pdf_api.upload_file(fileName, str(file_path))
+                logging.info(f"upload_file(): File '{fileName}' uploaded successfully.")
+            except Exception as e:
+                logging.error(f"upload_document(): Failed to upload file: {e}")
+
+    def upload_document(self):
+        """ Upload a PDF document to the Aspose Cloud server. """
+        self.upload_file(Config.PDF_DOCUMENT_NAME)
+
+    def download_result(self):
+        """ Download the processed PDF document from the Aspose Cloud server. """
+        if self.pdf_api:
+            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 append_attachmnet(self):
+        """Append a new attachment to the PDF document."""
+        if self.pdf_api:
+            new_attachment = AttachmentInfo(
+                path = Config.NEW_ATTACHMENT_FILE,
+                description = 'This is a sample attachment',
+                mime_type = Config.NEW_ATTACHMENT_MIME,
+                name = Config.NEW_ATTACHMENT_FILE
+            )
+
+            try:
+                response = self.pdf_api.post_add_document_attachment(Config.PDF_DOCUMENT_NAME, new_attachment)
+                if response.code == 200:
+                    logging.info(f"append_attachment(): attachment '{Config.NEW_ATTACHMENT_FILE}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
+                else:
+                    logging.error(f"append_attachment(): Failed to add attachment to the document. Response code: {response.code}")
+            except Exception as e:
+                logging.error(f"append_attachment(): Error while adding attachment: {e}")
+
+
+if __name__ == "__main__":
+    pdf_attachments = PdfAttachments()
+    pdf_attachments.upload_document()
+    pdf_attachments.upload_file(Config.NEW_ATTACHMENT_FILE)
+    pdf_attachments.append_attachmnet()
+    pdf_attachments.download_result()

Uses-Cases/Attachments/get/getAttachmentAndSave.py

@@ -0,0 +1,79 @@
+import shutil
+import json
+import logging
+from pathlib import Path
+from asposepdfcloud import ApiClient, PdfApi, AttachmentsResponse, AttachmentResponse, Attachment
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+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_file_with_attachment.pdf"
+    ATTACHMENT_PATH = ""
+
+class PdfAttachments:
+    """Class for managing PDF attachments 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("init_api(): 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"init_api(): Failed to load credentials: {e}")
+
+    def upload_document(self):
+        """Upload a PDF document to the Aspose Cloud server."""
+        if self.pdf_api:
+            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"upload_document(): File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
+            except Exception as e:
+                logging.error(f"upload_document(): Failed to upload file: {e}")
+
+    def get_attachments(self):
+        """Get attachments for the PDF document."""
+        if self.pdf_api:
+            try:
+                response : AttachmentsResponse = self.pdf_api.get_document_attachments(Config.PDF_DOCUMENT_NAME)
+                if response.code == 200:
+                    logging.info(f"get_attachmnets(): attachments '{response.attachments}' for the document '{Config.PDF_DOCUMENT_NAME}'.")
+                    Config.ATTACHMENT_PATH = response.attachments.list[0].links[0].href
+                else:
+                    logging.error(f"get_attachmnets(): Failed to get attachments to the document. Response code: {response.code}")
+            except Exception as e:
+                logging.error(f"get_attachmnets(): Error while adding attachment: {e}")
+
+    def get_attachment_by_id(self):
+        """Get attachment by Id for the PDF document and save it to local file."""
+        if self.pdf_api:
+            try:
+                response : AttachmentResponse = self.pdf_api.get_document_attachment_by_index(Config.PDF_DOCUMENT_NAME, Config.ATTACHMENT_PATH)
+                if response.code == 200:
+                    attachment: Attachment = response.attachment
+                    temp_file = self.pdf_api.get_download_document_attachment_by_index(Config.PDF_DOCUMENT_NAME, Config.ATTACHMENT_PATH)
+                    local_path = Config.LOCAL_FOLDER / attachment.name
+                    shutil.copy(temp_file, local_path)
+                    logging.info(f"get_attachment_by_id(): attachment '{local_path}' for the document '{Config.PDF_DOCUMENT_NAME}' successfuly saved.")
+                else:
+                    logging.error(f"get_attachment_by_id(): Failed to get attachment for the document '{Config.PDF_DOCUMENT_NAME}'. Response code: {response.code}")
+            except Exception as e:
+                logging.error(f"get_attachment_by_id(): Error while get attachment: {e}")
+
+
+if __name__ == "__main__":
+    pdf_attachments = PdfAttachments()
+    pdf_attachments.upload_document()
+    pdf_attachments.get_attachments()
+    pdf_attachments.get_attachment_by_id()

Uses-Cases/Bookmarks/add/appendBookmarks.py

@@ -0,0 +1,93 @@
+import shutil
+import json
+import logging
+from pathlib import Path
+from asposepdfcloud import ApiClient, PdfApi, Color, Bookmark
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+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"
+    NEW_BOOKMARK_TITLE = "• Increased performance.." #"• Productivity improvement"
+    PARENT_BOOKMARK_FOR_APPEND = ""                 #The parent bookmark path. Specify an empty string when adding a bookmark to the root.
+    NEW_BOOKMARK_PAGE_NUMBER = 3
+    BOOKMARK_PAGE_POSITION_X = 89
+    BOOKMARK_PAGE_POSITION_Y = 564
+    
+
+class PdfBookmarks:
+    """Class for managing PDF bokkmarks 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("init_api(): 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"init_api(): Failed to load credentials: {e}")
+
+    def upload_document(self):
+        """Upload a PDF document to the Aspose Cloud server."""
+        if self.pdf_api:
+            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"upload_document(): File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
+            except Exception as e:
+                logging.error(f"upload_document(): Failed to upload file: {e}")
+
+    def download_result(self):
+        """Download the processed PDF document from the Aspose Cloud server."""
+        if self.pdf_api:
+            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 append_bookmark_link(self):
+        """Append a new bookmark link to a specific page in the PDF document."""
+        if self.pdf_api:
+            newBookmark = Bookmark(
+                title = Config.NEW_BOOKMARK_TITLE,
+                italic = True,
+                bold = True,
+                color = Color(a=255,r=0,g=255,b=0),
+                level = 1,
+                page_display_left = Config.BOOKMARK_PAGE_POSITION_X,
+                page_display_top = Config.BOOKMARK_PAGE_POSITION_Y,
+                page_display_zoom = 2,
+                page_number = Config.NEW_BOOKMARK_PAGE_NUMBER
+            )
+
+            try:
+                response = self.pdf_api.post_bookmark(
+                    Config.PDF_DOCUMENT_NAME, Config.PARENT_BOOKMARK_FOR_APPEND, [newBookmark]
+                )
+                if response.code == 200:
+                    logging.info(f"append_bookmark_link(): Bookmark '{response.bookmarks.list[0].action}'->'{Config.NEW_BOOKMARK_TITLE}' added to page #{Config.NEW_BOOKMARK_PAGE_NUMBER}.")
+                else:
+                    logging.error(f"append_bookmark_link(): Failed to add bookmark '{Config.NEW_BOOKMARK_TITLE}' to the page #{Config.NEW_BOOKMARK_PAGE_NUMBER}. Response code: {response.code}")
+            except Exception as e:
+                logging.error(f"append_bookmark_link(): Error while adding bookmark: {e}")
+
+
+if __name__ == "__main__":
+    pdf_bookmarks = PdfBookmarks()
+    pdf_bookmarks.upload_document()
+    pdf_bookmarks.append_bookmark_link()
+    pdf_bookmarks.download_result()

Uses-Cases/Bookmarks/get/getBookmarkByPathAndShow.py

@@ -0,0 +1,62 @@
+import shutil
+import json
+import logging
+from pathlib import Path
+from asposepdfcloud import ApiClient, PdfApi, BookmarkResponse
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+
+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"
+    BOOKMARK_PATH = "/5"
+
+class PdfBookmarks:
+    """Class for managing PDF bookmarks 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 upload_document(self):
+        """Upload a PDF document to the Aspose Cloud server."""
+        if self.pdf_api:
+            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 get_bookmark(self):
+        """Get bookmark for a specific PDF document using bookmark path."""    
+        if self.pdf_api:
+            try:
+                response : BookmarkResponse = self.pdf_api.get_bookmark( Config.PDF_DOCUMENT_NAME, Config.BOOKMARK_PATH)
+                if response.code == 200:
+                    logging.info(f"Found bookmark => level: '{response.bookmark.level}' - action: '{response.bookmark.action}' - title: '{response.bookmark.title}'")
+                else:
+                    logging.error(f"Failed to find bookmark for the document. Response code: {response.code}")
+            except Exception as e:
+                logging.error(f"Error while find bookmark: {e}")
+
+if __name__ == "__main__":
+    pdf_bookmarks = PdfBookmarks()
+    pdf_bookmarks.upload_document()
+    pdf_bookmarks.get_bookmark()