Metadata-Version: 2.1
Name: pdf_utility
Version: 0.0.1
Summary: PDF Manipulation Utilities
Author: Sahil Kale
License: Prosperity 3.0.0
Project-URL: Homepage, https://github.com/sahil-kale/pdf-util
Project-URL: Issues, https://github.com/sahil-kale/pdf-util/issues
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: pikepdf
Requires-Dist: pillow
Requires-Dist: click

# PDF Utility
A simple command-line utility to combine multiple PDF/image files into a single PDF.

## Features
- Combine individual PDF files or entire folders of PDFs.
- Support for recursive folder traversal.
- Specify custom output file paths.
- Works as a CLI tool for seamless integration into your workflows.

### Coming Soon
- File Size Reduction

## Installation
Using pip: `pip install pdf_util`

*Note: the shortcut `pdf_util` can be directly used, but sometimes pip shortcuts do not work on windows. In this case, the module can be run with `python -m pdf_util <args>`.*

Using executable:
- Download the executable artifact from the latest `Build Windows Executable` job
- Execute the executable, ex: `path/to/pdf_util.exe --help`

## Usage
Combine Specific Files
To combine specific PDF files into a single output: `pdf_util --operation combine path/to/file1.pdf path/to/file2.png --output_path output.pdf`

Combine All PDFs in a Folder
To combine all PDF files in a specific folder: `pdf_util --operation combine -r path/to/folder --output_path output.pdf`

Note: images (.png, .jpg) are supported as file input
