Metadata-Version: 2.4
Name: toolvix
Version: 0.1.4
Summary: Simple dynamic file, PDF, and image automation tools for Python
Author-email: "A.Preetam krishna" <preetam.200729@gmail.com>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=10.0
Requires-Dist: pypdf>=4.0
Requires-Dist: pdf2docx>=0.5.6
Requires-Dist: PyMuPDF>=1.24
Requires-Dist: python-pptx>=0.6.23
Requires-Dist: cryptography>=42.0
Provides-Extra: windows
Requires-Dist: pywin32>=306; extra == "windows"

# Toolvix

Toolvix is a Python library for simple file, PDF, PowerPoint, Word, and image automation.

Most functions can automatically discover matching files in the current working folder. Functions also accept a `source` path or a list of paths, which makes chaining and controlled file processing possible.

## Installation

```cmd
python -m pip install toolvix
```

**or**

```cmd
py -m pip install toolvix
```

For Word/PowerPoint to PDF conversion on Windows:

```cmd
python -m pip install "toolvix[windows]"
```

**or**

```cmd
py -m pip install "toolvix[windows]"
```

Microsoft Word or PowerPoint must be installed for the corresponding conversion.

## API Reference

| # | Package | Function Name | Function Syntax | Automatic Input | Output | Details |
|---:|---|---|---|---|---|---|
| 1 | filetools | `fileEncrypt()` | `fileEncrypt(source=None)` | All non-`.encrypted` files | Encrypted `.encrypted` files | [Function details](docs/functions/fileEncrypt.md) |
| 2 | filetools | `fileDecrypt()` | `fileDecrypt(source=None)` | All `.encrypted` files | Decrypted original files | [Function details](docs/functions/fileDecrypt.md) |
| 3 | pdftools | `pdfMerge()` | `pdfMerge(output_file="Merged.pdf", source=None)` | All PDFs | One merged PDF | [Function details](docs/functions/pdfMerge.md) |
| 4 | pdftools | `pdfExtract()` | `pdfExtract(pages, output_file="extracted.pdf", source=None)` | First PDF | Extracted PDF | [Function details](docs/functions/pdfExtract.md) |
| 5 | pdftools | `pdfProtect()` | `pdfProtect(output_file="protected.pdf", password="12345", source=None)` | First PDF | Protected PDF | [Function details](docs/functions/pdfProtect.md) |
| 6 | pdftools | `pdfToword()` | `pdfToword(output_file=None, source=None)` | All PDFs | DOCX file(s) | [Function details](docs/functions/pdfToword.md) |
| 7 | pdftools | `pdfToppt()` | `pdfToppt(output_file=None, source=None)` | All PDFs | PPTX file(s) | [Function details](docs/functions/pdfToppt.md) |
| 8 | pdftools | `pptTopdf()` | `pptTopdf(output_file=None, source=None)` | All PPTX files | PDF file(s) | [Function details](docs/functions/pptTopdf.md) |
| 9 | pdftools | `wordTopdf()` | `wordTopdf(output_file=None, source=None)` | All DOCX files | PDF file(s) | [Function details](docs/functions/wordTopdf.md) |
| 10 | imagetools | `imageTopdf()` | `imageTopdf(output_file="photos.pdf", source=None)` | All supported images | One PDF | [Function details](docs/functions/imageTopdf.md) |
| 11 | imagetools | `imageResize()` | `imageResize(width=1920, height=1080, source=None)` | All supported images | Resized image(s) | [Function details](docs/functions/imageResize.md) |
| 12 | imagetools | `imageWatermark()` | `imageWatermark(watermarkText="PREETAM", textSize=100, transparency=45, angle=25, source=None)` | All supported images | Watermarked image(s) | [Function details](docs/functions/imageWatermark.md) |
| 13 | imagetools | `imageCompressor()` | `imageCompressor(targetSizeMB=1, source=None)` | All supported images | Compressed JPG(s) | [Function details](docs/functions/imageCompressor.md) |
| 14 | pdftools | `pdfToimage()` | `pdfToimage(source=None)` | All PDFs | Page PNG image(s) | [Function details](docs/functions/pdfToimage.md) |

## Examples & Usage Guide

The complete guide contains 60 practical examples covering individual functions, explicit inputs, and chained/nested functions.

[Toolvix Examples & Usage Guide](docs/examples.md)
