pdfhandleretc 0.1.0

Lightweight command-line and Python API toolkit for PDF text extraction, encryption, permissions, and more.

PdfHandlerETC

PdfHandlerETC is a lightweight command-line and Python toolkit for handling common PDF tasks including text extraction, encryption, decryption, permissions inspection, word counting, page resizing, and file merging.

This project is released under the CC0 1.0 Public Domain Dedication.

Features

• Extract text from PDFs by page or range
• Encrypt and decrypt PDFs with customizable permissions
• Count words across entire documents or selected pages
• Inspect encryption status and permissions
• Resize page dimensions
• Merge two PDFs with optional visual separators (blank page or black bar)
• Detect duplicate PDFs based on text content
• Includes both a Python API and command-line interface (CLI)

Installation

Install from PyPI:

pip install pdfhandleretc

Or from source:

git clone https://github.com/yourusername/pdfhandleretc.git
cd pdfhandleretc
pip install .

Command-Line Usage

After installation, you can use the pdfhandler CLI tool:

pdfhandler extract document.pdf --pages "1-3, 5"
pdfhandler wordcount document.pdf --pages "1, 3"
pdfhandler encrypt document.pdf --output secure.pdf
pdfhandler decrypt secure.pdf --in-place
pdfhandler permissions secure.pdf
pdfhandler resize document.pdf 612 792 --output resized.pdf
pdfhandler dupe-check file1.pdf file2.pdf
pdfhandler merge intro.pdf appendix.pdf merged.pdf --add-separator black

Use --help for details:

pdfhandler --help
pdfhandler extract --help

Python Usage

from pdfhandler import PdfHandler, PdfHandlerUtils

handler = PdfHandler("example.pdf")

# Extract text
text = handler.get_pdf_text("1-2, 4")
print(text)

# Word count
print("Words:", handler.word_count("1-3"))

# Encrypt the file
handler.encrypt(output="example-encrypted.pdf")

# Show permissions
handler.print_permissions()

# Resize pages
handler.resize(width=612, height=792, output_path="resized.pdf")

# Merge with a visual separator (black bar or blank page)
PdfHandlerUtils.merge_pdfs(
    "intro.pdf",
    "appendix.pdf",
    "merged.pdf",
    add_separator="black"  # or "blank"
)

License

This project is licensed under the CC0 1.0 Universal public domain dedication. You may use, modify, and distribute it freely without attribution or restriction.

Dependencies

• pdfminer.six - for text extraction
• pikepdf - for encryption and PDF manipulation
• colorama - for cross-platform terminal colors