pdf2csv 0.1.1

A python library and CLI tool to convert PDF files to CSV files.

PDF to CSV Converter

This project provides a tool to convert tables from PDF files into CSV format using the Docling library. It extracts tables from PDFs and saves them as CSV files, optionally reversing text for right-to-left languages.

How It Works

1. PDF Input: Provide the path to the PDF file you want to convert.
2. Table Extraction: The tool uses Docling's DocumentConverter to extract tables from the PDF.
3. DataFrame Conversion: Each extracted table is converted into a pandas DataFrame.
4. Optional Text Reversal: If the rtl option is enabled, text in the DataFrame is reversed.
5. CSV Output: The DataFrames are saved as CSV files in the specified output directory.

Dependencies

This project heavily depends on the Docling library for PDF table extraction. Ensure you have it installed before running the converter.

CLI Usage

You can use the CLI tool to convert PDF files to CSV:

pdf2csv convert-cli <pdf_path> --output-dir <output_dir> --rtl --verbose

Example:

pdf2csv convert-cli example.pdf --output-dir ./output --rtl --verbose

With uvx

You can use the CLI tool with uvx:

uvx pdf2csv convert-cli <pdf_path> --output-dir <output_dir> --rtl --verbose

Example:

uvx pdf2csv convert-cli example.pdf --output-dir ./output --rtl --verbose

Python Usage

You can also use the converter directly in your Python code:

from pdf2csv.converter import convert

pdf_path = "example.pdf"
output_dir = "./output"
rtl = True

dfs = convert(pdf_path, output_dir=output_dir, rtl=rtl)
for df in dfs:
    print(df)

TODO:

• Convert datatype to numeric
• [ ]