trt-secnd-attempt 0.0.2

Extract OCR text and annotations from PDF files

# -------------------------

# Documentation

# -------------------------

"""

PDF Annot Extractor

===================

A Python package for extracting:

- OCR text from PDF pages

- PDF annotations (comments, highlights, etc.)

---

INSTALLATION

---

pip install .

---

USAGE

---

1) Python API

---

from pdf_annot_extractor import PDFTextAnnotationExtractor

# Basic usage (output defaults to current folder)

extractor = PDFTextAnnotationExtractor("file.pdf")

# Save OCR text (one file per page)

extractor.save_text()

# Export annotations to Excel

extractor.export_annotations_excel()

2) Custom Output Folder

---

extractor = PDFTextAnnotationExtractor("file.pdf", "output/")

extractor.save_text()

extractor.export_annotations_excel("output/result.xlsx")

3) Directory Processing

---

from pdf_annot_extractor import process_directory

results = process_directory("pdfs/")

4) CLI Usage

---

Extract annotations to Excel:

python extractor.py --input file.pdf --output result.xlsx

Extract text files:

python extractor.py --input file.pdf --mode text

Process directory:

python extractor.py --input pdfs/ --output all.xlsx

---

OPTIONS

---

--input : PDF file or directory

--output : Output file (optional for text mode)

--mode : text | excel

--lang : OCR language (default: ara)

---

NOTES

---

- Default output folder is current working directory if not specified

- Requires Tesseract OCR installed with Arabic language pack

- Requires Poppler for pdf2image

---

EXAMPLE

---

python extractor.py --input my.pdf --mode text

→ Creates:

page_001.txt

page_002.txt

...

python extractor.py --input my.pdf --output annotations.xlsx

→ Creates:

annotations.xlsx