kairavkkp / merge-pdf

My first PyPi Package. Merge Image and PDF files using customizations within a folder using the Command line.

Merge-PDF

Merge PDF files using customizations within a folder using Command line.

How to Install

pip install mergemypdf

How to use

• Open Terminal
• Move to the directory where PDFs are present.
• Run mergemypdf -h for more info.

Usage:

mergemypdf -c <number_of_pdfs> -o <order_of_merging> -f <output_pdf_filename>

Examples:

mergemypdf -c 10 -o 1 -f merged.pdf

mergemypdf -p password -f merged.pdf

mergemypdf -ep 1 -p password

mergemypdf -a 1 -f merged.pdf

Optional arguments:

- s : <pdf_name_starting_with_string> 
- e : <pdf_name_endswith_string> 
- cn: <pdf_name_containing_string>

Note:

• -c represents number of PDFs needed to merge.
• -o represents order of merging PDFs, 0 is Ascending, 1 is descending and 2 is Shuffle. Default is Ascending.
• -s represents start string in PDF file's name.
• -e represents end string in PDF file's name.
• -cn represents string containing in PDF file's name.
• -f represents saved file name. Default names are randomly generated, adviced to specify a name everytime.
• -i represents the flag if only images need to be merged within a folder. Default is false.
• -ip represents the flag if both images and pdfs need to be merged within a folder. Default is false.
• -p represents password used to decrypt PDFs. If the PDFs have individually different passwords omit this and you will be prompted to enter each password.
• -epub represents the flag if only EPUBs need to be merged within a folder. Default is false.
• -ep represents the flag if both EPUBs and PDFs need to be merged within a folder. Default is false.
• -ie represents the flag if both images and EPUBs need to be merged within a folder. Default is false.
• -a represents the flag if all support file types (PDF, Images and EPUBS) need to be merged within a folder. Default is false.

Usage of Optional Arguments.

• mergemypdf -s 09 Only merge PDFs starting with 09.
• mergemypdf -e Derivation Only merge PDFs ending with Derivation.
• mergemypdf -cn Lecture Only merge PDFs having keyword 'Lecture' in the name.
• mergemypdf -i 1 Only merge Images from the directory.
• mergemypdf -ip 1 Merge both Images and PDFs from the directory.
• mergemypdf -p test123 Merge all PDFs from directory using the supplied password on any encrypted PDFs.
• mergemypdf -epub 1 Only merge EPUB files from the directory.
• mergemypdf -ep 1 Merge both EPUBs and PDFs from the directory.
• mergemypdf -ie 1 Merge both Images and EPUBs from the directory.
• mergemypdf -a 1 Merge PDFs, Images and EPUBs from the directory.

merge-pdf's Issues

Add epub support

Automated Build push using Twine Github Actions

Add JPG to PDF functionality

Incorporate Pytest to incorporate automated testing

The goal is to have automated tests that would check if the package is working as intended or not. We can add sample files as tests and build them. It would be taken care of by GitHub actions as a part of CI. Let's Do this.

Add Smart Rotate

Add function for repititive tasks.

Completely Transfer to PyMuPDF.

Add support for Encrypted PDF Files

[BUG] Cannot detect files with uppercase .PDF extension during input

This script/package is not able to merge pdf files that have an uppercase .PDF extension:

Add GIFs for easy understanding of usage.