pdf2s 0.1.0

Extended PDF Manipulation Toolkit

PDF Toolkit 🔖

A Swiss Army knife for PDF manipulations with Markdown conversion capabilities

Features ✨

• Merge PDFs with regex filename filtering
• Split PDFs by:
  • Page ranges (e.g., "1-3,5-8")
  • Fixed page chunks (e.g., every 5 pages)
  • Special "all" keyword for full document split
• Convert Markdown ↔ PDF:
  • Preserve formatting with custom CSS styles
  • Basic text extraction from PDF to Markdown
• CLI Interface with intuitive subcommands
• Pipx Installable for easy system-wide use

Installation 📦

pipx install pdf2s

System Requirements:

• Python 3.8+
• libpangocairo-1.0-0 (for WeasyPrint)
  • Ubuntu/Debian: sudo apt-get install libpangocairo-1.0-0

Usage 💻

$ pdf-toolkit --help
Usage: pdf-toolkit [OPTIONS] COMMAND [ARGS]...

Commands:
  merge    Merge PDF files
  split    Split PDF files
  md2pdf   Convert Markdown to PDF
  pdf2md   Convert PDF to Markdown

Merge PDFs

# Merge all PDFs in directory (sorted)
pdf-toolkit merge ./documents merged.pdf --sort

# Merge only files matching regex pattern
pdf-toolkit merge ./reports final_report.pdf -r 'Q[1-4]_2023'

Split PDFs

# Split into individual pages
pdf-toolkit split input.pdf output_dir

# Split every 5 pages
pdf-toolkit split input.pdf output_dir --pages 5

# Split specific ranges
pdf-toolkit split input.pdf output_dir --ranges "1-3,5-8"

# Split entire document
pdf-toolkit split input.pdf output_dir --ranges "all"

Markdown Conversion

# MD to PDF with custom styling
pdf-toolkit md2pf input.md output.pdf --style styles.css

# PDF to Markdown
pdf-toolkit pdf2md input.pdf output.md

Development 🛠️

1. Clone repository
2. Install dependencies:

pipx install poetry
poetry install

3. Run tests:

poetry run pytest

Contributing 🤝

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a Pull Request

Report issues using the GitHub Issues tracker.

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.