imagetopdf-gui 2.0.0__tar.gz

imagetopdf_gui-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WAEL SAHLI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imagetopdf_gui-2.0.0/MANIFEST.in

@@ -0,0 +1,22 @@
+# Include documentation
+include README.md
+include LICENSE
+
+# Include screenshot for documentation
+include Screenshot.png
+
+# Include requirements files
+include requirements.txt
+
+# Exclude tests from distribution
+prune tests
+prune __pycache__
+prune *.egg-info
+
+# Exclude development files
+exclude .gitignore
+exclude .gitattributes
+
+# Exclude output and logs directories
+prune output
+prune logs

imagetopdf_gui-2.0.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: imagetopdf-gui
+Version: 2.0.0
+Summary: A lightweight GUI application for converting images to PDF and PDF files to images
+Author: WAEL SAHLI
+License: MIT
+Project-URL: Homepage, https://github.com/overcrash66/ImageToPDF
+Project-URL: Bug Tracker, https://github.com/overcrash66/ImageToPDF/issues
+Project-URL: Source, https://github.com/overcrash66/ImageToPDF
+Keywords: pdf,image,converter,gui,pyside6
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.5.0
+Requires-Dist: PyPDF2>=3.0.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pymupdf>=1.23.0
+Dynamic: license-file
+
+# ImageToPDF
+
+A lightweight GUI application for converting images to PDF and PDF files to images. Built with PySide6, PyPDF2, and PyMuPDF.
+
+![Screenshot](Screenshot.png)
+
+## Features
+
+- **Image to PDF Conversion**: Convert multiple images (JPEG, PNG) into a single merged PDF document
+- **PDF to Image Conversion**: Extract individual pages from PDF files as JPEG images
+- **Batch Processing**: Handle multiple images at once
+- **Automatic Duplicate Handling**: Prevents overwriting files with automatic naming
+- **User-Friendly GUI**: Intuitive interface with visual feedback
+- **File Validation**: Validates file types, sizes, and paths before processing
+- **Logging System**: Comprehensive logging for debugging and monitoring
+- **Output Organization**: All converted files are saved in a dedicated output folder
+- **Error Handling**: Robust error handling with user-friendly messages
+
+## Requirements
+
+- Python 3.6 or higher
+- PyMuPDF (fitz) - Required for PDF to JPEG conversion
+
+## Installation
+
+### 1. Install Python Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Install PyMuPDF (Required for CLI tool)
+
+```bash
+pip install pymupdf
+```
+
+### 3. Run the Application
+
+```bash
+python ImageToPdf.py
+```
+
+## Usage
+
+### GUI Application (ImageToPdf.py)
+
+1. **Convert Images to PDF**:
+   - Click on any "Image 1-12" button to select image files
+   - Selected images will be highlighted in green
+   - Click "Convert Images To PDF" to merge all selected images into a single PDF
+   - Output file will be saved as `Merged_PDF_[timestamp].pdf` in the `output` folder
+
+2. **Convert PDF to JPEG**:
+   - Click "Convert PDF To JPEG" button
+   - Select a PDF file
+   - Each PDF page will be converted to a separate JPEG image
+   - Output images will be saved in the `output` folder with naming format: `Converted-PDF-page[number]_[timestamp].jpeg`
+
+3. **Clear Selection**:
+   - Click "Clear All Selection" to reset all selected images
+
+### Command Line Tool (Python_Lib.py)
+
+Convert PDF files to JPEG images from the command line:
+
+```bash
+python Python_Lib.py /path/to/your/file.pdf
+```
+
+This will extract each page as a separate JPEG image in the `output` folder.
+
+## Project Structure
+
+```
+ImageToPDF/
+├── ImageToPdf.py          # GUI Application
+├── Python_Lib.py          # CLI Tool
+├── constants.py           # Application constants
+├── logger.py              # Logging configuration
+├── utils.py               # Utility functions
+├── requirements.txt       # Python dependencies
+├── README.md              # This file
+├── Screenshot.png         # Application screenshot
+└── logs/                  # Log files (auto-created)
+    └── image_to_pdf.log
+```
+
+## Technology Stack
+
+- **GUI Framework**: PySide6
+- **PDF Processing**: PyPDF2, PyMuPDF (fitz)
+- **Image Processing**: Pillow (PIL)
+- **Logging**: Python logging module
+- **CLI**: argparse
+
+## Improvements
+
+This version includes the following improvements over the original:
+
+- **Security**: Added file path validation and sanitization
+- **Error Handling**: Comprehensive error handling with user-friendly messages
+- **Logging**: Full logging system for debugging and monitoring
+- **Code Quality**: Type hints, docstrings, and consistent code style
+- **Configuration**: Centralized constants file for easy maintenance
+- **Output Organization**: Dedicated output folder for all converted files
+- **File Size Limits**: Maximum file size validation to prevent memory issues
+- **Code Comments**: Detailed comments explaining functionality
+- **Type Safety**: Type hints for better code clarity and IDE support
+- **Modularity**: Separated concerns into utility modules
+- **Documentation**: Improved README with project structure and usage examples
+
+## Notes
+
+- The application has been tested on Windows 10 and Windows 11
+- Both GUI ([`ImageToPdf.py`](ImageToPdf.py:1)) and command-line tool ([`Python_Lib.py`](Python_Lib.py:1)) can be used independently
+- Converted files are saved in the `output` folder
+- Log files are saved in the `logs` folder
+- Last updated: 2026-02-08
+
+## License
+
+This project is created by WAEL SAHLI.
+
+## Support
+
+For issues or questions, please refer to the log files in the `logs` directory for detailed error information.

imagetopdf_gui-2.0.0/README.md

@@ -0,0 +1,127 @@
+# ImageToPDF
+
+A lightweight GUI application for converting images to PDF and PDF files to images. Built with PySide6, PyPDF2, and PyMuPDF.
+
+![Screenshot](Screenshot.png)
+
+## Features
+
+- **Image to PDF Conversion**: Convert multiple images (JPEG, PNG) into a single merged PDF document
+- **PDF to Image Conversion**: Extract individual pages from PDF files as JPEG images
+- **Batch Processing**: Handle multiple images at once
+- **Automatic Duplicate Handling**: Prevents overwriting files with automatic naming
+- **User-Friendly GUI**: Intuitive interface with visual feedback
+- **File Validation**: Validates file types, sizes, and paths before processing
+- **Logging System**: Comprehensive logging for debugging and monitoring
+- **Output Organization**: All converted files are saved in a dedicated output folder
+- **Error Handling**: Robust error handling with user-friendly messages
+
+## Requirements
+
+- Python 3.6 or higher
+- PyMuPDF (fitz) - Required for PDF to JPEG conversion
+
+## Installation
+
+### 1. Install Python Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Install PyMuPDF (Required for CLI tool)
+
+```bash
+pip install pymupdf
+```
+
+### 3. Run the Application
+
+```bash
+python ImageToPdf.py
+```
+
+## Usage
+
+### GUI Application (ImageToPdf.py)
+
+1. **Convert Images to PDF**:
+   - Click on any "Image 1-12" button to select image files
+   - Selected images will be highlighted in green
+   - Click "Convert Images To PDF" to merge all selected images into a single PDF
+   - Output file will be saved as `Merged_PDF_[timestamp].pdf` in the `output` folder
+
+2. **Convert PDF to JPEG**:
+   - Click "Convert PDF To JPEG" button
+   - Select a PDF file
+   - Each PDF page will be converted to a separate JPEG image
+   - Output images will be saved in the `output` folder with naming format: `Converted-PDF-page[number]_[timestamp].jpeg`
+
+3. **Clear Selection**:
+   - Click "Clear All Selection" to reset all selected images
+
+### Command Line Tool (Python_Lib.py)
+
+Convert PDF files to JPEG images from the command line:
+
+```bash
+python Python_Lib.py /path/to/your/file.pdf
+```
+
+This will extract each page as a separate JPEG image in the `output` folder.
+
+## Project Structure
+
+```
+ImageToPDF/
+├── ImageToPdf.py          # GUI Application
+├── Python_Lib.py          # CLI Tool
+├── constants.py           # Application constants
+├── logger.py              # Logging configuration
+├── utils.py               # Utility functions
+├── requirements.txt       # Python dependencies
+├── README.md              # This file
+├── Screenshot.png         # Application screenshot
+└── logs/                  # Log files (auto-created)
+    └── image_to_pdf.log
+```
+
+## Technology Stack
+
+- **GUI Framework**: PySide6
+- **PDF Processing**: PyPDF2, PyMuPDF (fitz)
+- **Image Processing**: Pillow (PIL)
+- **Logging**: Python logging module
+- **CLI**: argparse
+
+## Improvements
+
+This version includes the following improvements over the original:
+
+- **Security**: Added file path validation and sanitization
+- **Error Handling**: Comprehensive error handling with user-friendly messages
+- **Logging**: Full logging system for debugging and monitoring
+- **Code Quality**: Type hints, docstrings, and consistent code style
+- **Configuration**: Centralized constants file for easy maintenance
+- **Output Organization**: Dedicated output folder for all converted files
+- **File Size Limits**: Maximum file size validation to prevent memory issues
+- **Code Comments**: Detailed comments explaining functionality
+- **Type Safety**: Type hints for better code clarity and IDE support
+- **Modularity**: Separated concerns into utility modules
+- **Documentation**: Improved README with project structure and usage examples
+
+## Notes
+
+- The application has been tested on Windows 10 and Windows 11
+- Both GUI ([`ImageToPdf.py`](ImageToPdf.py:1)) and command-line tool ([`Python_Lib.py`](Python_Lib.py:1)) can be used independently
+- Converted files are saved in the `output` folder
+- Log files are saved in the `logs` folder
+- Last updated: 2026-02-08
+
+## License
+
+This project is created by WAEL SAHLI.
+
+## Support
+
+For issues or questions, please refer to the log files in the `logs` directory for detailed error information.

imagetopdf_gui-2.0.0/imagetopdf/__init__.py

@@ -0,0 +1,21 @@
+"""
+ImageToPDF-GUI - A lightweight GUI application for converting images to PDF and PDFs to images.
+
+This package provides both a graphical user interface and command-line tools
+for image and PDF conversion operations.
+"""
+
+__version__ = "2.0.0"
+__author__ = "WAEL SAHLI"
+__package_name__ = "imagetopdf-gui"
+
+from imagetopdf.constants import APP_NAME, APP_VERSION, APP_AUTHOR
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "__package_name__",
+    "APP_NAME",
+    "APP_VERSION",
+    "APP_AUTHOR",
+]

imagetopdf_gui-2.0.0/imagetopdf/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for running the package as a module: python -m imagetopdf
+
+This launches the GUI application.
+"""
+
+from imagetopdf.app import main
+
+if __name__ == "__main__":
+    main()

imagetopdf_gui-2.0.0/imagetopdf/app.py

@@ -0,0 +1,283 @@
+"""
+ImageToPDF - GUI Application for converting images to PDF and PDFs to images.
+Built with PySide6, PyPDF2, and PyMuPDF.
+"""
+
+import sys
+import os
+import subprocess
+from typing import List, Optional
+from PySide6.QtWidgets import (
+    QFileDialog, QWidget, QLabel, QPushButton, QApplication, QMainWindow,
+    QHBoxLayout, QVBoxLayout, QMessageBox, QProgressBar
+)
+from PySide6.QtGui import QFont
+from PySide6 import QtCore
+from PyPDF2 import PdfMerger, PdfReader
+from PIL import Image
+from datetime import datetime
+
+from imagetopdf.constants import (
+    APP_NAME, APP_VERSION, MAX_IMAGE_BUTTONS, BUTTON_TEXT_COLOR,
+    BUTTON_SELECTED_COLOR, BUTTON_TEXT_COLOR_SELECTED, WINDOW_MINIMIZE_FLAG,
+    PDF_OUTPUT_PREFIX, PDF_OUTPUT_SUFFIX, JPEG_OUTPUT_PREFIX, JPEG_OUTPUT_SUFFIX,
+    SUCCESS_IMAGE_TO_PDF, SUCCESS_PDF_TO_JPEG, TITLE_INFO, TITLE_WARNING,
+    TITLE_ERROR, TITLE_DONE
+)
+from imagetopdf.logger import default_logger
+from imagetopdf.utils import (
+    validate_file_path, get_file_extension, sanitize_filename,
+    generate_unique_filename, create_output_directory, get_timestamp,
+    log_file_operation
+)
+
+CREATE_NO_WINDOW = WINDOW_MINIMIZE_FLAG
+
+
+class ImageToPdfConverter(QMainWindow):
+    """
+    Main GUI application for ImageToPDF conversion.
+    """
+    
+    def __init__(self):
+        super().__init__()
+        self.logger = default_logger
+        self.initUI()
+    
+    def initUI(self):
+        """Initialize the user interface."""
+        self.setWindowTitle(f"{APP_NAME} v{APP_VERSION}")
+        self.setWindowFlags(QtCore.Qt.WindowMinimizeButtonHint | QtCore.Qt.WindowType.WindowCloseButtonHint)
+        self.setStyleSheet("#myWidget {background-color:#002633;}")
+        
+        self.central_widget = QWidget()
+        self.setCentralWidget(self.central_widget)
+        
+        self.qv_box = QVBoxLayout(self.central_widget)
+        self.qh_box = QHBoxLayout()
+        
+        # Create image selection buttons and labels
+        self.buttons = [self.create_button(f"Image {i}") for i in range(1, MAX_IMAGE_BUTTONS + 1)]
+        self.labels = [QLabel() for _ in range(MAX_IMAGE_BUTTONS)]
+        
+        for button in self.buttons:
+            self.qv_box.addWidget(button)
+        
+        for label in self.labels:
+            label.setStyleSheet('color: red;')
+            self.qv_box.addWidget(label)
+        
+        # Create action buttons with specific handlers
+        self.button_clear = self.create_button("Clear All Selection", self.clear_all_selection)
+        self.button_clear.setEnabled(False)
+        self.button_pdf_to_image = self.create_button("Convert PDF To JPEG", self.convert_pdf_to_jpeg)
+        self.button_image_to_pdf = self.create_button("Convert Images To PDF", self.convert_images_to_pdf)
+        
+        self.qh_box.addWidget(self.button_clear)
+        self.qh_box.addWidget(self.button_pdf_to_image)
+        self.qh_box.addWidget(self.button_image_to_pdf)
+        self.qv_box.addLayout(self.qh_box)
+
+        # Initialize state
+        self.image_paths: List[str] = [""] * MAX_IMAGE_BUTTONS
+        self.pdf_path: Optional[str] = None
+
+        self.logger.info("Application initialized successfully")
+    
+    def create_button(self, text: str, handler=None) -> QPushButton:
+        """
+        Create a styled button.
+
+        Args:
+            text: Button text
+            handler: Optional click handler function
+
+        Returns:
+            Configured QPushButton
+        """
+        button = QPushButton(text)
+        button.setFont(QFont('Times', 10, weight=QFont.Bold))
+        # Only connect handler if provided (explicit connection in initUI handles the rest)
+        if handler:
+            button.clicked.connect(handler)
+        else:
+            button.clicked.connect(self.button_clicked)
+        button.setStyleSheet(f'QPushButton {{background-color: {BUTTON_TEXT_COLOR}; color: white;}}')
+        return button
+    
+    def button_clicked(self):
+        """Handle button click events."""
+        button = self.sender()
+        button_text = button.text()
+        
+        try:
+            image_number = int(button_text.split()[-1])
+        except (ValueError, IndexError):
+            self.logger.warning(f"Invalid button text: {button_text}")
+            return
+        
+        if 1 <= image_number <= MAX_IMAGE_BUTTONS:
+            self.select_image(image_number)
+        else:
+            self.logger.warning(f"Image number out of range: {image_number}")
+    
+    def select_image(self, image_number: int):
+        """
+        Select an image file for conversion.
+        
+        Args:
+            image_number: Image button number (1-12)
+        """
+        file_path, _ = QFileDialog.getOpenFileName(
+            self, 'Open file', '', "Image files (*.jpeg *.jpg *.png)"
+        )
+        
+        if file_path:
+            is_valid, error_msg = validate_file_path(file_path)
+            
+            if not is_valid:
+                self.logger.error(f"Invalid file selected: {file_path} - {error_msg}")
+                QMessageBox.warning(self, TITLE_WARNING, error_msg)
+                return
+            
+            self.image_paths[image_number - 1] = file_path
+            filename = os.path.basename(file_path)
+            self.labels[image_number - 1].setText(f"Selected Image is: {filename}")
+            self.buttons[image_number - 1].setStyleSheet(
+                f'QPushButton {{background-color: {BUTTON_SELECTED_COLOR}; color: {BUTTON_TEXT_COLOR_SELECTED};}}'
+            )
+            self.logger.info(f"Image {image_number} selected: {file_path}")
+            self.update_button_state()
+    
+    def update_button_state(self):
+        """Update button enable states based on selected images."""
+        has_selection = any(self.image_paths)
+        self.button_clear.setEnabled(has_selection)
+        self.logger.debug(f"Button state updated: has_selection={has_selection}")
+    
+    def clear_all_selection(self):
+        """Clear all selected images."""
+        self.image_paths = [""] * MAX_IMAGE_BUTTONS
+        for label in self.labels:
+            label.clear()
+        for button in self.buttons:
+            button.setStyleSheet(f'QPushButton {{background-color: {BUTTON_TEXT_COLOR}; color: white;}}')
+        self.update_button_state()
+        self.logger.info("All selections cleared")
+    
+    def convert_pdf_to_jpeg(self):
+        """Convert PDF file to JPEG images."""
+        file_dialog = QFileDialog(self, 'Open file', '', "PDF files (*.pdf)")
+        pdf_path, _ = file_dialog.getOpenFileName()
+        
+        if pdf_path:
+            is_valid, error_msg = validate_file_path(pdf_path)
+            
+            if not is_valid:
+                self.logger.error(f"Invalid PDF file: {pdf_path} - {error_msg}")
+                QMessageBox.warning(self, TITLE_WARNING, error_msg)
+                return
+            
+            try:
+                self.logger.info(f"Starting PDF to JPEG conversion: {pdf_path}")
+                subprocess.Popen([sys.executable, '-m', 'imagetopdf.cli', pdf_path], creationflags=CREATE_NO_WINDOW)
+                QMessageBox.information(self, TITLE_INFO, SUCCESS_PDF_TO_JPEG)
+            except Exception as e:
+                error_msg = f"Failed to convert PDF: {str(e)}"
+                self.logger.error(error_msg)
+                QMessageBox.critical(self, TITLE_ERROR, error_msg)
+    
+    def convert_images_to_pdf(self):
+        """Convert selected images to a single PDF file."""
+        selected_images = [path for path in self.image_paths if path]
+        
+        if not selected_images:
+            self.logger.warning("No images selected for conversion")
+            QMessageBox.warning(self, TITLE_WARNING, "Please select at least one image to convert to PDF.")
+            return
+        
+        try:
+            self.logger.info(f"Starting image to PDF conversion: {len(selected_images)} images")
+            output_dir = create_output_directory()
+            
+            # Convert each image to PDF
+            pdf_paths = []
+            for image_path in selected_images:
+                try:
+                    image = Image.open(image_path)
+                    image = image.convert('RGB')
+                    base_name = sanitize_filename(os.path.splitext(os.path.basename(image_path))[0])
+                    pdf_path = generate_unique_filename(base_name, PDF_OUTPUT_SUFFIX, output_dir)
+                    
+                    image.save(pdf_path)
+                    pdf_paths.append(pdf_path)
+                    log_file_operation(self.logger, "Image saved as PDF", pdf_path, True)
+                    
+                except Exception as e:
+                    error_msg = f"Failed to convert image {image_path}: {str(e)}"
+                    self.logger.error(error_msg)
+                    QMessageBox.critical(self, TITLE_ERROR, error_msg)
+                    return
+            
+            # Merge all PDFs
+            try:
+                merger = PdfMerger()
+                for pdf_path in pdf_paths:
+                    merger.append(pdf_path)
+                
+                timestamp = get_timestamp()
+                self.pdf_path = os.path.join(
+                    output_dir,
+                    f"{PDF_OUTPUT_PREFIX}{timestamp}{PDF_OUTPUT_SUFFIX}"
+                )
+                merger.write(self.pdf_path)
+                merger.close()
+                log_file_operation(self.logger, "PDF merged", self.pdf_path, True)
+                
+                # Clean up temporary PDFs
+                for pdf_path in pdf_paths:
+                    try:
+                        os.remove(pdf_path)
+                        log_file_operation(self.logger, "Temporary PDF removed", pdf_path, True)
+                    except Exception as e:
+                        self.logger.warning(f"Failed to remove temporary PDF {pdf_path}: {str(e)}")
+                
+                self.update_button_state()
+                QMessageBox.information(self, TITLE_INFO, SUCCESS_IMAGE_TO_PDF)
+                self.logger.info(f"Successfully created merged PDF: {self.pdf_path}")
+                
+            except Exception as e:
+                error_msg = f"Failed to merge PDFs: {str(e)}"
+                self.logger.error(error_msg)
+                QMessageBox.critical(self, TITLE_ERROR, error_msg)
+                return
+                
+        except Exception as e:
+            error_msg = f"Unexpected error during conversion: {str(e)}"
+            self.logger.error(error_msg)
+            QMessageBox.critical(self, TITLE_ERROR, error_msg)
+    
+    def error(self, message: str):
+        """
+        Display error message.
+        
+        Args:
+            message: Error message to display
+        """
+        QMessageBox.critical(self, TITLE_ERROR, message)
+
+
+def main():
+    """Main entry point for the GUI application."""
+    try:
+        myApp = QApplication(sys.argv)
+        converter = ImageToPdfConverter()
+        converter.show()
+        sys.exit(myApp.exec())
+    except Exception as e:
+        print(f"Fatal error: {str(e)}")
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

imagetopdf_gui-2.0.0/imagetopdf/cli.py

@@ -0,0 +1,94 @@
+"""
+PDF to JPEG Converter - Command-line utility for converting PDF files to JPEG images.
+"""
+
+import fitz  # PyMuPDF
+import argparse
+import os
+from datetime import datetime
+from typing import Optional
+
+from imagetopdf.constants import (
+    APP_NAME, APP_VERSION, APP_AUTHOR, JPEG_OUTPUT_PREFIX, JPEG_OUTPUT_SUFFIX,
+    SUCCESS_PDF_TO_JPEG, TITLE_DONE
+)
+from imagetopdf.logger import default_logger
+from imagetopdf.utils import (
+    validate_file_path, create_output_directory, get_pdf_timestamp,
+    log_file_operation
+)
+
+
+def convert_to_jpeg(pdf_path: str) -> None:
+    """
+    Convert a PDF file to JPEG images using PyMuPDF.
+    
+    Args:
+        pdf_path: Path to the PDF file
+    """
+    logger = default_logger
+    
+    # Validate input file
+    is_valid, error_msg = validate_file_path(pdf_path)
+    if not is_valid:
+        logger.error(f"Invalid PDF file: {pdf_path} - {error_msg}")
+        print(f"Error: {error_msg}")
+        return
+    
+    try:
+        logger.info(f"Starting PDF to JPEG conversion: {pdf_path}")
+        doc = fitz.open(pdf_path)
+        print("Processing... Please Wait...")
+        
+        output_dir = create_output_directory()
+        
+        for page_index in range(len(doc)):
+            page = doc.load_page(page_index)
+            pix = page.get_pixmap()
+            
+            timestamp = get_pdf_timestamp()
+            output_filename = f"{JPEG_OUTPUT_PREFIX}{page_index + 1}_{timestamp}{JPEG_OUTPUT_SUFFIX}"
+            output_path = os.path.join(output_dir, output_filename)
+            
+            pix.save(output_path)
+            print(f"Saved: {output_path}")
+            log_file_operation(logger, "Page converted to JPEG", output_path, True)
+        
+        doc.close()
+        
+        message = f"{SUCCESS_PDF_TO_JPEG}\n\n{APP_NAME} v{APP_VERSION}\nCreated by {APP_AUTHOR}\nLast update: {datetime.now().strftime('%Y-%m-%d')}"
+        print(f"\n{message}")
+        
+    except Exception as e:
+        error_msg = f"Error occurred: {str(e)}"
+        logger.error(error_msg)
+        print(f"Error: {error_msg}")
+
+
+def main():
+    """Main entry point for the CLI tool."""
+    parser = argparse.ArgumentParser(
+        description=f'{APP_NAME} v{APP_VERSION} - Convert PDF files to JPEG images',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=f"""
+Examples:
+  pdf-to-jpeg document.pdf
+  pdf-to-jpeg /path/to/document.pdf
+
+{APP_NAME} v{APP_VERSION} - {APP_AUTHOR}
+        """
+    )
+    
+    parser.add_argument(
+        'pdf_path',
+        metavar='PDF_PATH',
+        type=str,
+        help='Path to the PDF file to convert'
+    )
+    
+    args = parser.parse_args()
+    convert_to_jpeg(args.pdf_path)
+
+
+if __name__ == "__main__":
+    main()

imagetopdf_gui-2.0.0/imagetopdf/constants.py

@@ -0,0 +1,64 @@
+"""
+Constants configuration for ImageToPDF application.
+"""
+
+# Application Configuration
+APP_NAME = "ImageToPDF"
+APP_VERSION = "2.0.0"
+APP_AUTHOR = "WAEL SAHLI"
+
+# GUI Configuration
+MAX_IMAGE_BUTTONS = 12
+BUTTON_TEXT_COLOR = "#007399"
+BUTTON_SELECTED_COLOR = "#B2D17C"
+BUTTON_TEXT_COLOR_SELECTED = "#000000"
+WINDOW_MINIMIZE_FLAG = 0x08000000
+
+# File Configuration
+IMAGE_EXTENSIONS = {'.jpeg', '.jpg', '.png'}
+PDF_EXTENSIONS = {'.pdf'}
+DEFAULT_OUTPUT_DIR = "output"
+
+# PDF Configuration
+PDF_MERGER_APPEND_MODE = 'a'
+PDF_MERGER_WRITE_MODE = 'wb'
+
+# Image Configuration
+IMAGE_FORMAT_RGB = 'RGB'
+IMAGE_FORMAT_PNG = 'PNG'
+IMAGE_FORMAT_JPEG = 'JPEG'
+
+# Naming Configuration
+TIMESTAMP_FORMAT = "%Y%m%d%H%M%S"
+PDF_TIMESTAMP_FORMAT = "%d-%m-%Y_%H-%M-%S-%f"
+PDF_OUTPUT_PREFIX = "Merged_PDF_"
+PDF_OUTPUT_SUFFIX = ".pdf"
+JPEG_OUTPUT_PREFIX = "Converted-PDF-page"
+JPEG_OUTPUT_SUFFIX = ".jpeg"
+
+# File Size Limits (in bytes)
+MAX_FILE_SIZE = 100 * 1024 * 1024  # 100MB
+MAX_IMAGE_SIZE = 50 * 1024 * 1024  # 50MB
+
+# Logging Configuration
+LOG_LEVEL = "INFO"
+LOG_FORMAT = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+LOG_FILE = "image_to_pdf.log"
+
+# Error Messages
+ERROR_INVALID_FILE = "Invalid file format. Please select a valid image or PDF file."
+ERROR_FILE_TOO_LARGE = "File is too large. Maximum size is {max_size}."
+ERROR_NO_FILES_SELECTED = "Please select at least one image to convert to PDF."
+ERROR_PDF_CONVERSION_FAILED = "Failed to convert PDF to JPEG."
+ERROR_IMAGE_CONVERSION_FAILED = "Failed to convert images to PDF."
+ERROR_UNKNOWN = "An unknown error occurred."
+
+# Success Messages
+SUCCESS_IMAGE_TO_PDF = "Images converted to PDF successfully.\nAll images are available in the output folder."
+SUCCESS_PDF_TO_JPEG = "PDF file converted successfully.\nAll images are available in the output folder."
+
+# UI Messages
+TITLE_INFO = "Info"
+TITLE_WARNING = "Warning"
+TITLE_ERROR = "Error"
+TITLE_DONE = "Done"

imagetopdf_gui-2.0.0/imagetopdf/logger.py

@@ -0,0 +1,54 @@
+"""
+Logging configuration for ImageToPDF application.
+"""
+
+import logging
+import os
+from datetime import datetime
+from imagetopdf.constants import LOG_LEVEL, LOG_FORMAT, LOG_FILE
+
+
+def setup_logger(name: str = __name__) -> logging.Logger:
+    """
+    Set up and configure a logger with file and console handlers.
+    
+    Args:
+        name: Name of the logger
+        
+    Returns:
+        Configured logger instance
+    """
+    logger = logging.getLogger(name)
+    logger.setLevel(getattr(logging, LOG_LEVEL))
+    
+    # Avoid adding multiple handlers if logger already has them
+    if logger.handlers:
+        return logger
+    
+    # Create formatters
+    file_formatter = logging.Formatter(LOG_FORMAT)
+    console_formatter = logging.Formatter('%(levelname)s: %(message)s')
+    
+    # File handler
+    log_dir = "logs"
+    os.makedirs(log_dir, exist_ok=True)
+    log_path = os.path.join(log_dir, LOG_FILE)
+    
+    file_handler = logging.FileHandler(log_path)
+    file_handler.setLevel(logging.DEBUG)
+    file_handler.setFormatter(file_formatter)
+    
+    # Console handler
+    console_handler = logging.StreamHandler()
+    console_handler.setLevel(logging.INFO)
+    console_handler.setFormatter(console_formatter)
+    
+    # Add handlers to logger
+    logger.addHandler(file_handler)
+    logger.addHandler(console_handler)
+    
+    return logger
+
+
+# Create a default logger instance
+default_logger = setup_logger()

imagetopdf_gui-2.0.0/imagetopdf/utils.py

@@ -0,0 +1,162 @@
+"""
+Utility functions for file operations and validation.
+"""
+
+import os
+import logging
+from pathlib import Path
+from typing import List, Tuple, Optional
+from imagetopdf.constants import (
+    IMAGE_EXTENSIONS, PDF_EXTENSIONS, MAX_FILE_SIZE, MAX_IMAGE_SIZE,
+    ERROR_INVALID_FILE, ERROR_FILE_TOO_LARGE, ERROR_UNKNOWN
+)
+from imagetopdf.logger import default_logger
+
+
+def validate_file_path(file_path: str) -> Tuple[bool, Optional[str]]:
+    """
+    Validate a file path and check if it exists and has a valid extension.
+    
+    Args:
+        file_path: Path to the file
+        
+    Returns:
+        Tuple of (is_valid, error_message)
+    """
+    if not file_path:
+        return False, "File path cannot be empty"
+    
+    if not os.path.exists(file_path):
+        return False, "File does not exist"
+    
+    if not os.path.isfile(file_path):
+        return False, "Path is not a file"
+    
+    file_ext = os.path.splitext(file_path)[1].lower()
+    
+    if file_ext in IMAGE_EXTENSIONS:
+        file_size = os.path.getsize(file_path)
+        if file_size > MAX_IMAGE_SIZE:
+            return False, ERROR_FILE_TOO_LARGE.format(max_size=MAX_IMAGE_SIZE)
+    elif file_ext in PDF_EXTENSIONS:
+        file_size = os.path.getsize(file_path)
+        if file_size > MAX_FILE_SIZE:
+            return False, ERROR_FILE_TOO_LARGE.format(max_size=MAX_FILE_SIZE)
+    else:
+        return False, ERROR_INVALID_FILE
+    
+    return True, None
+
+
+def get_file_extension(file_path: str) -> str:
+    """
+    Get the file extension from a file path.
+    
+    Args:
+        file_path: Path to the file
+        
+    Returns:
+        File extension including the dot
+    """
+    return os.path.splitext(file_path)[1].lower()
+
+
+def sanitize_filename(filename: str) -> str:
+    """
+    Sanitize a filename by removing invalid characters.
+    
+    Args:
+        filename: Original filename
+        
+    Returns:
+        Sanitized filename
+    """
+    # Remove invalid characters (including spaces for cross-platform compatibility)
+    invalid_chars = '<>:"/\\|?* '
+    for char in invalid_chars:
+        filename = filename.replace(char, '_')
+    
+    # Remove leading/trailing spaces and dots
+    filename = filename.strip('. ')
+    
+    return filename
+
+
+def generate_unique_filename(base_name: str, extension: str, output_dir: str = ".") -> str:
+    """
+    Generate a unique filename by appending a counter if the file already exists.
+    
+    Args:
+        base_name: Base filename without extension
+        extension: File extension including the dot
+        output_dir: Output directory path
+        
+    Returns:
+        Unique filename
+    """
+    output_path = os.path.join(output_dir, base_name + extension)
+    
+    if not os.path.exists(output_path):
+        return output_path
+    
+    counter = 1
+    while True:
+        new_name = f"{base_name}_{counter}{extension}"
+        new_path = os.path.join(output_dir, new_name)
+        if not os.path.exists(new_path):
+            return new_path
+        counter += 1
+
+
+def create_output_directory() -> str:
+    """
+    Create output directory if it doesn't exist.
+    
+    Returns:
+        Path to the output directory
+    """
+    output_dir = "output"
+    os.makedirs(output_dir, exist_ok=True)
+    return output_dir
+
+
+def get_timestamp(format_str: str = "%Y%m%d%H%M%S") -> str:
+    """
+    Get current timestamp in specified format.
+    
+    Args:
+        format_str: Timestamp format string
+        
+    Returns:
+        Formatted timestamp
+    """
+    from datetime import datetime
+    return datetime.now().strftime(format_str)
+
+
+def get_pdf_timestamp(format_str: str = "%d-%m-%Y_%H-%M-%S-%f") -> str:
+    """
+    Get current timestamp in PDF-specific format.
+    
+    Args:
+        format_str: Timestamp format string
+        
+    Returns:
+        Formatted timestamp
+    """
+    from datetime import datetime
+    return datetime.now().strftime(format_str)
+
+
+def log_file_operation(logger: logging.Logger, operation: str, file_path: str, success: bool = True):
+    """
+    Log file operation with context.
+    
+    Args:
+        logger: Logger instance
+        operation: Operation description
+        file_path: Path to the file
+        success: Whether the operation was successful
+    """
+    status = "SUCCESS" if success else "FAILED"
+    logger.info(f"{operation}: {file_path} [{status}]")

imagetopdf_gui-2.0.0/imagetopdf_gui.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+MANIFEST.in
+README.md
+Screenshot.png
+pyproject.toml
+requirements.txt
+setup.py
+imagetopdf/__init__.py
+imagetopdf/__main__.py
+imagetopdf/app.py
+imagetopdf/cli.py
+imagetopdf/constants.py
+imagetopdf/logger.py
+imagetopdf/utils.py

imagetopdf_gui-2.0.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "imagetopdf-gui"
+version = "2.0.0"
+authors = [
+    { name = "WAEL SAHLI" }
+]
+description = "A lightweight GUI application for converting images to PDF and PDF files to images"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Office/Business",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Utilities",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+keywords = ["pdf", "image", "converter", "gui", "pyside6"]
+dependencies = [
+    "PySide6>=6.5.0",
+    "PyPDF2>=3.0.0",
+    "Pillow>=10.0.0",
+    "pymupdf>=1.23.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/overcrash66/ImageToPDF"
+"Bug Tracker" = "https://github.com/overcrash66/ImageToPDF/issues"
+"Source" = "https://github.com/overcrash66/ImageToPDF"
+
+[project.scripts]
+imagetopdf = "imagetopdf.app:main"
+pdf-to-jpeg = "imagetopdf.cli:main"
+
+[project.gui-scripts]
+imagetopdf-gui = "imagetopdf.app:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["imagetopdf*"]
+exclude = ["tests*"]

imagetopdf_gui-2.0.0/requirements.txt

@@ -0,0 +1,14 @@
+# ImageToPDF Requirements
+# Python 3.6+
+
+# GUI Framework
+PySide6>=6.5.0
+
+# PDF Processing
+PyPDF2>=3.0.0
+
+# Image Processing
+Pillow>=10.0.0
+
+# PDF to Image
+pymupdf>=1.23.0

imagetopdf_gui-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

imagetopdf_gui-2.0.0/setup.py

@@ -0,0 +1,11 @@
+"""
+Setup script for imagetopdf-gui package.
+
+This file is maintained for backwards compatibility with older pip versions.
+The primary configuration is in pyproject.toml.
+"""
+
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()