Simple, user-friendly tool for merging cover sheets with document files.
Description
SheetFusion is a simple, user-friendly tool designed to merge cover sheets with document files, primarily for academic and professional use. It automates the creation of personalized PDFs by combining individual cover pages with a standard document, such as exams or reports. This straightforward software offers a practical solution for those needing to distribute customized documents efficiently. It is written in Python and uses the [PyPDF3](https://github.com/sfneal/PyPDF3) library. It was created to merge cover sheets with exams. That is why the arguments are named as they are. However, it can be used to merge any PDF file with any other PDF file.SheetFusion
runs on any system with Python
installed:
-
Python: Python 3.x is required. Verify your Python installation by running
python --version
orpython3 --version
in your command line. -
Operating System: Compatible with Windows, macOS, Linux, and any OS supporting Python.
python3 -m pip install sheetfusion
You could use the following commands to clone and install SheetFusion. Make sure to replace X.X.X with the built version.
git clone https://github.com/SMZ70/SheetFusion.git
cd SheetFusion
python3 -m build
python3 -m pip install dist/sheetfusion-X.X.X.tar.gz
SheetFusion
is a command-line tool designed for merging cover sheets with exams. To use it, follow the command syntax below (see Examples for quick start).
python3 -m sheetfusion [--help] --cover-sheets --exam [--output-dir] [--overwrite]
or:
sheetfusion [--help] --cover-sheets --exam [--output-dir] [--overwrite]
--help
,-h
Show this help message and exit.
--cover-sheets
,-c
Specify the PDF file containing the cover sheets.--exam
,-e
Specify the PDF file containing the exam.
--output-dir
,-o
Define the directory to output the merged PDFs to.--overwrite
Enable overwriting of existing files.
The following examples demonstrate how to use SheetFusion
:
python3 -m sheetfusion -c cover_sheets.pdf -e exam.pdf
python3 -m sheetfusion -c cover_sheets.pdf -e exam.pdf -o output_dir
If the output directory already contains files with the same name as the merged PDFs, SheetFusion
will not overwrite them by default. To enable overwriting, use the --overwrite
flag.
python3 -m sheetfusion -c cover_sheets.pdf -e exam.pdf -o output_dir --overwrite
See the CHANGELOG for more information.
SheetFusion
is open-source software licensed under the MIT License. For more details, see the LICENSE file in this repository.
Thank you for your interest in SheetFusion! For bug reports, feature requests, or general inquiries related to the project, please use GitHub Issues. This is the fastest way to get your questions answered. It also allows other users to benefit from the discussion.