kagazkit 0.1.0__tar.gz

kagazkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Farjad Hasan
+
+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.

kagazkit-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: kagazkit
+Version: 0.1.0
+Summary: KagazKit - Your Ultimate PDF Toolkit. Merge, Split, Convert, and more.
+Author: Farjad Hasan
+License: MIT License
+        
+        Copyright (c) 2024 Farjad Hasan
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/farjad-hasan/kagazkit
+Project-URL: Bug Tracker, https://github.com/farjad-hasan/kagazkit/issues
+Project-URL: LinkedIn, https://www.linkedin.com/in/farjadh/
+Project-URL: X, https://x.com/im_farjad
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: customtkinter==5.2.2
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: PyPDF2>=3.0.0
+Requires-Dist: tkinterdnd2>=0.3.0
+Requires-Dist: packaging>=23.0
+Dynamic: license-file
+
+# KagazKit
+
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.9%2B-blue)
+![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+> **Note**: This project is currently under active development.
+
+**KagazKit** (“Kagaz” means paper) is a modern, secure, and professional PDF toolkit built with Python and CustomTkinter. It provides an elegant interface for merging PDFs, converting images to PDFs, splitting, rotating, and more.
+
+## Features
+
+- **Modern UI**: Dark mode support, professional design using CustomTkinter.
+- **Secure**: Validation of file inputs and safe handling of file operations.
+- **Merge PDFs**: Combine multiple PDF files with ease.
+- **Image to PDF**: Convert standard image formats (JPG, PNG) to PDF.
+- **Tools**: Split and Rotate PDFs functionality.
+- **Drag & Drop**: Intuitive file management.
+
+## Installation
+
+1.  Clone the repository:
+    ```bash
+    git clone https://github.com/farjad-hasan/kagazkit.git
+    cd kagazkit
+    ```
+
+2.  Create a virtual environment:
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows: venv\Scripts\activate
+    ```
+
+3.  Install dependencies:
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+4.  Install the package in editable mode:
+    ```bash
+    pip install -e .
+    ```
+
+## Usage
+
+Run the application:
+
+```bash
+kagazkit
+# Or directly via python
+python src/kagazkit/main.py
+```
+
+## Contributing
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

kagazkit-0.1.0/README.md

@@ -0,0 +1,60 @@
+# KagazKit
+
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.9%2B-blue)
+![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+> **Note**: This project is currently under active development.
+
+**KagazKit** (“Kagaz” means paper) is a modern, secure, and professional PDF toolkit built with Python and CustomTkinter. It provides an elegant interface for merging PDFs, converting images to PDFs, splitting, rotating, and more.
+
+## Features
+
+- **Modern UI**: Dark mode support, professional design using CustomTkinter.
+- **Secure**: Validation of file inputs and safe handling of file operations.
+- **Merge PDFs**: Combine multiple PDF files with ease.
+- **Image to PDF**: Convert standard image formats (JPG, PNG) to PDF.
+- **Tools**: Split and Rotate PDFs functionality.
+- **Drag & Drop**: Intuitive file management.
+
+## Installation
+
+1.  Clone the repository:
+    ```bash
+    git clone https://github.com/farjad-hasan/kagazkit.git
+    cd kagazkit
+    ```
+
+2.  Create a virtual environment:
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows: venv\Scripts\activate
+    ```
+
+3.  Install dependencies:
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+4.  Install the package in editable mode:
+    ```bash
+    pip install -e .
+    ```
+
+## Usage
+
+Run the application:
+
+```bash
+kagazkit
+# Or directly via python
+python src/kagazkit/main.py
+```
+
+## Contributing
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

kagazkit-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kagazkit"
+version = "0.1.0"
+description = "KagazKit - Your Ultimate PDF Toolkit. Merge, Split, Convert, and more."
+readme = "README.md"
+authors = [
+  { name = "Farjad Hasan" },
+]
+license = { file = "LICENSE" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "customtkinter==5.2.2",
+    "Pillow>=10.0.0",
+    "PyPDF2>=3.0.0",
+    "tkinterdnd2>=0.3.0",
+    "packaging>=23.0"
+]
+
+[project.scripts]
+kagazkit = "kagazkit.main:main"
+
+[project.urls]
+"Homepage" = "https://github.com/farjad-hasan/kagazkit"
+"Bug Tracker" = "https://github.com/farjad-hasan/kagazkit/issues"
+"LinkedIn" = "https://www.linkedin.com/in/farjadh/"
+"X" = "https://x.com/im_farjad"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra -q"
+testpaths = [
+    "tests",
+]
+
+[tool.ruff]
+select = ["E", "F", "I"]
+ignore = ["E501", "F401", "F841"]
+line-length = 88
+target-version = "py39"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

kagazkit-0.1.0/setup.cfg

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

kagazkit-0.1.0/src/kagazkit/core/actions.py

@@ -0,0 +1,192 @@
+"""
+Core actions module for PDF Master.
+Contains the business logic for merging PDFs and converting images to PDFs.
+"""
+
+from pathlib import Path
+from typing import List, Union
+
+from PIL import Image
+from PyPDF2 import PdfMerger, PdfReader, PdfWriter
+
+from .validators import FileValidationError, Validator
+
+
+class PDFActionError(Exception):
+    """Custom exception for action failures."""
+    pass
+
+class PDFManager:
+    """Manager class for PDF operations."""
+
+    @staticmethod
+    def merge_pdfs(file_paths: List[Union[str, Path]], output_path: Union[str, Path]) -> Path:
+        """
+        Merges multiple PDFs into a single file.
+
+        Args:
+            file_paths: List of paths to the PDF files to merge.
+            output_path: Path where the merged PDF should be saved.
+
+        Returns:
+            Path to the output file.
+
+        Raises:
+            PDFActionError: If merging fails.
+            FileValidationError: If input files are invalid.
+        """
+        # Validate inputs
+        try:
+            validated_paths = Validator.validate_paths(file_paths, file_type='pdf')
+        except FileValidationError as e:
+            raise PDFActionError(f"Validation failed: {e}")
+
+        merger = PdfMerger()
+        
+        try:
+            for path in validated_paths:
+                merger.append(str(path))
+            
+            output_path = Path(output_path)
+            # Ensure output directory exists (though UI should handle this)
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            
+            merger.write(str(output_path))
+            merger.close()
+            return output_path
+            
+        except Exception as e:
+            try:
+                merger.close()
+            except: 
+                pass
+            raise PDFActionError(f"Failed to merge PDFs: {e}")
+
+    @staticmethod
+    def convert_images_to_pdf(image_paths: List[Union[str, Path]], output_path: Union[str, Path]) -> Path:
+        """
+        Converts a list of images to a single PDF.
+
+        Args:
+            image_paths: List of paths to image files.
+            output_path: Path for the output PDF.
+
+        Returns:
+            Path to the output file.
+            
+        Raises:
+            PDFActionError: If conversion fails.
+        """
+        try:
+            validated_paths = Validator.validate_paths(image_paths, file_type='image')
+        except FileValidationError as e:
+            raise PDFActionError(f"Validation failed: {e}")
+
+        if not validated_paths:
+             raise PDFActionError("No valid images provided.")
+
+        try:
+            # Open images and convert to RGB (required for PDF)
+            images = []
+            for path in validated_paths:
+                img = Image.open(path)
+                if img.mode != 'RGB':
+                    img = img.convert('RGB')
+                images.append(img)
+
+            # Save first image and append the rest
+            first_image = images[0]
+            rest_images = images[1:]
+            
+            output_path = Path(output_path)
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+
+            first_image.save(
+                str(output_path), 
+                "PDF", 
+                resolution=100.0, 
+                save_all=True, 
+                append_images=rest_images
+            )
+            
+            # Close images to free resources
+            for img in images:
+                img.close()
+                
+            return output_path
+
+        except Exception as e:
+            raise PDFActionError(f"Failed to convert images to PDF: {e}")
+            
+    @staticmethod
+    def split_pdf(file_path: Union[str, Path], output_dir: Union[str, Path]) -> List[Path]:
+        """
+        Splits a PDF into individual pages.
+        
+        Args:
+            file_path: Path to the source PDF.
+            output_dir: Directory to save the pages.
+            
+        Returns:
+            List of paths to the generated files.
+        """
+        try:
+            Validator.validate_pdf(file_path)
+        except FileValidationError as e:
+            raise PDFActionError(f"Validation failed: {e}")
+            
+        src_path = Path(file_path)
+        out_dir = Path(output_dir)
+        out_dir.mkdir(parents=True, exist_ok=True)
+        
+        generated_files = []
+        
+        try:
+            reader = PdfReader(src_path)
+            base_name = src_path.stem
+            
+            for i, page in enumerate(reader.pages):
+                writer = PdfWriter()
+                writer.add_page(page)
+                
+                out_filename = out_dir / f"{base_name}_page_{i+1}.pdf"
+                with open(out_filename, "wb") as out_file:
+                    writer.write(out_file)
+                
+                generated_files.append(out_filename)
+                
+            return generated_files
+            
+        except Exception as e:
+            raise PDFActionError(f"Failed to split PDF: {e}")
+
+    @staticmethod
+    def rotate_pdf(file_path: Union[str, Path], output_path: Union[str, Path], rotation: int) -> Path:
+        """
+        Rotates all pages of a PDF.
+        
+        Args:
+            file_path: Path to source PDF.
+            output_path: Path to save result.
+            rotation: Degrees to rotate (90, 180, 270).
+        """
+        try:
+            Validator.validate_pdf(file_path)
+        except FileValidationError as e:
+            raise PDFActionError(f"Validation failed: {e}")
+            
+        try:
+            reader = PdfReader(file_path)
+            writer = PdfWriter()
+            
+            for page in reader.pages:
+                page.rotate(rotation)
+                writer.add_page(page)
+                
+            output_path = Path(output_path)
+            with open(output_path, "wb") as f:
+                writer.write(f)
+                
+            return output_path
+        except Exception as e:
+             raise PDFActionError(f"Failed to rotate PDF: {e}")

kagazkit-0.1.0/src/kagazkit/core/validators.py

@@ -0,0 +1,129 @@
+"""
+Input validation module for PDF Master.
+Handles security checks for file inputs, ensuring only valid and safe files are processed.
+"""
+
+from pathlib import Path
+from typing import List, Union
+
+
+class FileValidationError(Exception):
+    """Custom exception for file validation failures."""
+    pass
+
+class Validator:
+    """Validator class for file security checks."""
+
+    # Magic numbers for file type verification
+    MAGIC_NUMBERS = {
+        'pdf': b'%PDF',
+        'png': b'\x89PNG\r\n\x1a\n',
+        'jpg': b'\xff\xd8\xff',
+        'jpeg': b'\xff\xd8\xff',
+    }
+
+    @staticmethod
+    def validate_file(file_path: Union[str, Path]) -> bool:
+        """
+        Validates a single file exists and is a file.
+
+        Args:
+            file_path: Path to the file.
+
+        Returns:
+            True if valid.
+
+        Raises:
+            FileValidationError: If file does not exist or is not a file.
+        """
+        path = Path(file_path)
+        if not path.exists():
+            raise FileValidationError(f"File not found: {file_path}")
+        if not path.is_file():
+            raise FileValidationError(f"Path is not a file: {file_path}")
+        return True
+
+    @classmethod
+    def validate_pdf(cls, file_path: Union[str, Path]) -> bool:
+        """
+        Validates that a file is a valid PDF using magic numbers.
+        
+        Args:
+            file_path: Path to the PDF file.
+            
+        Returns:
+            True if valid.
+            
+        Raises:
+            FileValidationError: If not a valid PDF.
+        """
+        cls.validate_file(file_path)
+        try:
+            with open(file_path, 'rb') as f:
+                header = f.read(4)
+                if not header.startswith(cls.MAGIC_NUMBERS['pdf']):
+                    raise FileValidationError(f"Invalid PDF file header: {file_path}")
+        except OSError as e:
+            raise FileValidationError(f"Error reading file {file_path}: {e}")
+            
+        return True
+
+    @classmethod
+    def validate_image(cls, file_path: Union[str, Path]) -> bool:
+        """
+        Validates that a file is a supported image (PNG/JPG) using magic numbers.
+        
+        Args:
+            file_path: Path to the image file.
+            
+        Returns:
+            True if valid.
+            
+        Raises:
+            FileValidationError: If not a valid image.
+        """
+        cls.validate_file(file_path)
+        path = Path(file_path)
+        ext = path.suffix.lower().lstrip('.')
+        
+        if ext not in ['png', 'jpg', 'jpeg']:
+            raise FileValidationError(f"Unsupported image extension: {ext}")
+            
+        magic = cls.MAGIC_NUMBERS.get(ext)
+        if not magic:
+             # Should be covered by extension check, but for safety
+             raise FileValidationError(f"Unsupported image type: {ext}")
+
+        read_len = len(magic)
+        
+        try:
+            with open(file_path, 'rb') as f:
+                header = f.read(read_len)
+                if not header.startswith(magic):
+                    raise FileValidationError(f"Invalid {ext.upper()} file header: {file_path}")
+        except OSError as e:
+             raise FileValidationError(f"Error reading file {file_path}: {e}")
+             
+        return True
+
+    @classmethod
+    def validate_paths(cls, paths: List[Union[str, Path]], file_type: str = 'pdf') -> List[Path]:
+        """
+        Validates a list of file paths.
+        
+        Args:
+            paths: List of file paths.
+            file_type: Type validation to apply ('pdf' or 'image').
+            
+        Returns:
+            List of validated Path objects.
+        """
+        validated_paths = []
+        for p in paths:
+            path_obj = Path(p)
+            if file_type == 'pdf':
+                cls.validate_pdf(path_obj)
+            elif file_type == 'image':
+                cls.validate_image(path_obj)
+            validated_paths.append(path_obj)
+        return validated_paths

kagazkit-0.1.0/src/kagazkit/main.py

@@ -0,0 +1,18 @@
+"""
+Entry point for PDF Master application.
+"""
+import os
+import sys
+
+# Ensure src is in pythonpath
+sys.path.append(os.path.join(os.path.dirname(__file__), '..', '..'))
+
+from kagazkit.ui.app import PDFMasterApp
+
+
+def main():
+    app = PDFMasterApp()
+    app.mainloop()
+
+if __name__ == "__main__":
+    main()

kagazkit-0.1.0/src/kagazkit/ui/app.py

@@ -0,0 +1,91 @@
+"""
+Main application window module.
+"""
+import customtkinter as ctk
+from tkinterdnd2 import TkinterDnD
+
+from .pages.image_page import ImagePage
+from .pages.merge_page import MergePage
+from .pages.tools_page import ToolsPage
+
+# Set theme
+ctk.set_appearance_mode("System")
+ctk.set_default_color_theme("blue")
+
+class PDFMasterApp(ctk.CTk, TkinterDnD.DnDWrapper):
+    """
+    Main application class for PDF Master.
+    Inherits from CTk for modern UI and DnDWrapper for Drag and Drop support.
+    """
+    
+    def __init__(self):
+        super().__init__()
+        self.TkdndVersion = TkinterDnD._require(self)
+        
+        self.title("KagazKit")
+        self.geometry("900x600")
+        
+        # Configure grid layout (1x2)
+        self.grid_rowconfigure(0, weight=1)
+        self.grid_columnconfigure(1, weight=1)
+        
+        # Create Sidebar
+        self.sidebar_frame = ctk.CTkFrame(self, width=140, corner_radius=0)
+        self.sidebar_frame.grid(row=0, column=0, sticky="nsew")
+        self.sidebar_frame.grid_rowconfigure(5, weight=1)
+
+        self.logo_label = ctk.CTkLabel(self.sidebar_frame, text="KagazKit", font=ctk.CTkFont(size=20, weight="bold"))
+        self.logo_label.grid(row=0, column=0, padx=20, pady=(20, 10))
+        
+        self.sidebar_button_merge = ctk.CTkButton(self.sidebar_frame, text="Merge PDFs", command=self.show_merge_page)
+        self.sidebar_button_merge.grid(row=1, column=0, padx=20, pady=10)
+        
+        self.sidebar_button_convert = ctk.CTkButton(self.sidebar_frame, text="Image to PDF", command=self.show_image_page)
+        self.sidebar_button_convert.grid(row=2, column=0, padx=20, pady=10)
+        
+        self.sidebar_button_tools = ctk.CTkButton(self.sidebar_frame, text="Tools", command=self.show_tools_page)
+        self.sidebar_button_tools.grid(row=3, column=0, padx=20, pady=10)
+        
+        # Pages - Container
+        self.pages_frame = ctk.CTkFrame(self, corner_radius=0, fg_color="transparent")
+        self.pages_frame.grid(row=0, column=1, sticky="nsew", padx=0, pady=0)
+        self.pages_frame.grid_rowconfigure(0, weight=1)
+        self.pages_frame.grid_columnconfigure(0, weight=1)
+        
+        self.merge_page = MergePage(self.pages_frame)
+        self.image_page = ImagePage(self.pages_frame)
+        self.tools_page = ToolsPage(self.pages_frame)
+        
+        # Show default page
+        self.show_merge_page()
+
+    def show_merge_page(self):
+        self.select_frame(self.sidebar_button_merge)
+        self.image_page.grid_forget()
+        self.tools_page.grid_forget()
+        self.merge_page.grid(row=0, column=0, sticky="nsew")
+
+    def show_image_page(self):
+        self.select_frame(self.sidebar_button_convert)
+        self.merge_page.grid_forget()
+        self.tools_page.grid_forget()
+        self.image_page.grid(row=0, column=0, sticky="nsew")
+
+    def show_tools_page(self):
+        self.select_frame(self.sidebar_button_tools)
+        self.merge_page.grid_forget()
+        self.image_page.grid_forget()
+        self.tools_page.grid(row=0, column=0, sticky="nsew")
+        
+    def select_frame(self, button):
+        # Reset all buttons
+        self.sidebar_button_merge.configure(fg_color=["#3B8ED0", "#1F6AA5"]) # Default blue
+        self.sidebar_button_convert.configure(fg_color=["#3B8ED0", "#1F6AA5"])
+        self.sidebar_button_tools.configure(fg_color=["#3B8ED0", "#1F6AA5"])
+        
+        # Highlight selected
+        button.configure(fg_color=["#36719F", "#144870"])
+
+if __name__ == "__main__":
+    app = PDFMasterApp()
+    app.mainloop()