Aspose.PDF for Rust via C++ 25.10

Author: OleksandrAndriienko

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "asposepdf"
-version = "1.25.9"
+version = "1.25.10"
 edition = "2021"
 license = "MIT"
 description = "Aspose.PDF for Rust via C++ is a powerful toolkit that allows developers to manipulate PDF files directly and helps do various tasks for PDF. Contains unique features for converting PDF to other formats."

README.md

@@ -9,33 +9,35 @@ Contains unique features for converting PDF to other formats.
 
 - **Create and manage documents**
   - `new`, `open`, `save`, `save_as`, `set_license`
-    Create, load, save as, and save PDF; apply license keys.
+    Create, load, save as, and save PDF-document; apply license keys.
+  - `append`, `append_pages`, `merge_documents`, `split_document`, `split`, `split_at_page`, `split_at`
+    Append full documents or specific pages; merge multiple PDF-documents; split a PDF-document by page ranges or at a specific page.
 
 - **Page management**
   - `add`, `insert`, `delete`, `count`
     Add, insert, delete, and count pages in a document.
 
 - **Document-level operations**
   - `optimize`, `optimize_resource`, `grayscale`, `rotate`, `set_background`, `repair`
-    Optimize PDF layout and resources, convert to grayscale, rotate pages, set background, and repair corrupted documents.
+    Optimize PDF-document layout and resources, convert to grayscale, rotate pages, set background, and repair corrupted documents.
   - `replace_text`, `add_page_num`, `add_text_header`, `add_text_footer`, `flatten`
     Replace text, add page numbers, insert custom text in the header or footer, and flatten PDF-document.
-  - `remove_annotations`, `remove_attachments`, `remove_blank_pages`, `remove_bookmarks`, `remove_hidden_text`, `remove_images`, `remove_javascripts`
-    Remove annotations, attachments, blank pages, bookmarks, hidden text, images, and embedded JavaScript code.
+  - `remove_annotations`, `remove_attachments`, `remove_blank_pages`, `remove_bookmarks`, `remove_hidden_text`, `remove_images`, `remove_tables`, `remove_javascripts`
+    Remove annotations, attachments, blank pages, bookmarks, hidden text, images, tables, and embedded JavaScript code.
 
 - **Page-level operations**
   - `rotate`, `set_size`, `grayscale`, `add_text`
     Rotate individual pages, set page size, convert pages to grayscale, and add text.
   - `page_replace_text`, `page_add_page_num`, `page_add_text_header`, `page_add_text_footer`
     Replace text on a specific page, add page number to a page, and insert custom text in the header or footer of a page.
-  - `page_remove_annotations`, `page_remove_hidden_text`, `page_remove_images`
-    Remove annotations, hidden text, and images on a specific page.
+  - `page_remove_annotations`, `page_remove_hidden_text`, `page_remove_images`, `page_remove_tables`
+    Remove annotations, hidden text, images and tables on a specific page.
 
 - **Content extraction**
-  - `extract_text`
-    Retrieve plain text content from PDF pages.
+  - `extract_text`, `bytes`
+    Retrieve plain text content, and raw data from PDF-document.
   - `export_fdf`, `export_xfdf`, `export_xml`
-    Export data from the previously opened PDF document with AcroForm to FDF, XFDF, or XML formats.
+    Export data from the previously opened PDF-document with AcroForm to FDF, XFDF, or XML formats.
 
 ### PDF converting and saving
 
@@ -55,6 +57,16 @@ Contains unique features for converting PDF to other formats.
   - `about`
     Return metadata information about the Aspose.PDF for Rust via C++ with product name, version, release date, and license status.
 
+### PDF analysis
+
+- **Document statistics:**
+  - `word_count`, `character_count`
+    Return the number of words and characters in the entire PDF document.
+
+- **Page statistics:**
+  - `page_word_count`, `page_character_count`, `page_is_blank`
+    Return the number of words and characters on a specific page and check if a page is blank.
+
 ## Platforms
 
 Implemented support for Linux x64, macOS x86_64, macOS arm64 and Windows x64 platforms.

examples/append.rs

@@ -0,0 +1,17 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open the primary PDF-document
+    let pdf = Document::open("sample.pdf")?;
+
+    // Open another PDF-document to append
+    let another_pdf = Document::open("sample1page.pdf")?;
+
+    // Append pages from another PDF-document
+    pdf.append(&another_pdf)?;
+
+    // Save the previously opened PDF-document with new filename
+    pdf.save_as("sample_append.pdf")?;
+
+    Ok(())
+}

examples/append_pages.rs

@@ -0,0 +1,17 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open the primary PDF-document
+    let pdf = Document::open("sample1page.pdf")?;
+
+    // Open another PDF-document to append
+    let another_pdf = Document::open("sample.pdf")?;
+
+    // Append specific pages (1 and 3) from another PDF-document
+    pdf.append_pages(&another_pdf, "1,3")?;
+
+    // Save the previously opened PDF-document with new filename
+    pdf.save_as("sample_append_pages.pdf")?;
+
+    Ok(())
+}

examples/bytes.rs

@@ -0,0 +1,14 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Create a new PDF-document
+    let pdf = Document::new()?;
+
+    // Return the contents of the PDF-document as a byte vector
+    let data = pdf.bytes()?;
+
+    // Print length of the byte vector
+    println!("Length: {}", data.len());
+
+    Ok(())
+}

examples/character_count.rs

@@ -0,0 +1,14 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open a PDF-document from file
+    let pdf = Document::open("sample.pdf")?;
+
+    // Return character count in PDF-document
+    let count = pdf.character_count()?;
+
+    // Print the character count
+    println!("Character count: {}", count);
+
+    Ok(())
+}

examples/merge_documents.rs

@@ -0,0 +1,17 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Create a new PDF-document
+    let pdf1 = Document::new()?;
+
+    // Open a PDF-document named "sample.pdf"
+    let pdf2 = Document::open("sample.pdf")?;
+
+    // Create a new PDF-document by merging the provided PDF-documents
+    let pdf_merged = Document::merge_documents(&[&pdf1, &pdf2])?;
+
+    // Save the previously opened PDF-document with new filename
+    pdf_merged.save_as("sample_merge_documents.pdf")?;
+
+    Ok(())
+}

examples/page_character_count.rs

@@ -0,0 +1,17 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open a PDF-document from file
+    let pdf = Document::open("sample.pdf")?;
+
+    // Specify the page number (1-based index)
+    let page_number = 1;
+
+    // Return character count on the specified page
+    let count = pdf.page_character_count(page_number)?;
+
+    // Print the character count
+    println!("Character count on page {}: {}", page_number, count);
+
+    Ok(())
+}

examples/page_is_blank.rs

@@ -0,0 +1,17 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open a PDF-document from file
+    let pdf = Document::open("sample.pdf")?;
+
+    // Specify the page number (1-based index)
+    let page_number = 1;
+
+    // Return page is blank in PDF-document
+    let is_blank = pdf.page_is_blank(page_number)?;
+
+    // Print if the specified page is blank
+    println!("Is page {} blank? {}", page_number, is_blank);
+
+    Ok(())
+}

examples/page_remove_tables.rs

@@ -0,0 +1,14 @@
+use asposepdf::Document;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Open a PDF-document from file
+    let pdf = Document::open("sample.pdf")?;
+
+    // Remove tables in page
+    pdf.page_remove_tables(1)?;
+
+    // Save the previously opened PDF-document with new filename
+    pdf.save_as("sample_page1_remove_tables.pdf")?;
+
+    Ok(())
+}