Merge branch 'feature/quickscroll-panel' into release/1.8.0

Author: lefkovitzj

.gitignore

@@ -0,0 +1,11 @@
+# Python bytecode
+__pycache__/*
+
+# Test credentials & signed files for PDF signature
+credentials/*
+signatures/*
+utility-apps/signature-key-server/key-files/*
+
+# Sample documents
+samples/*
+*.pdf

Utility Apps/tamper_check.py

@@ -1,13 +1,13 @@
-"""
-    Author: lefkovitj (https://lefkovitzj.github.io)
-    File Last Modified: 1/4/2025
-    Project Name: PyPdfApp
-    File Name: app.py
-"""
-
-# Project Imports.
-import pypdfgui
-
-if __name__ == "__main__":
-    """ Run the PyPdfApp application. """
-    pypdfgui.App()
+"""
+    Author: lefkovitj (https://lefkovitzj.com)
+    File Last Modified: 8/28/2025
+    Project Name: PyPdfApp
+    File Name: app.py
+"""
+
+# Project Imports.
+import pypdfgui
+
+if __name__ == "__main__":
+    # Run the PyPdfApp application.
+    pypdfgui.App()

app.py

@@ -0,0 +1,13 @@
+"""
+    Author: lefkovitj (https://lefkovitzj.com)
+    File Last Modified: 8/28/2025
+    Project Name: PyPdfApp
+    File Name: app.py
+"""
+
+# Project Imports.
+import pypdfgui
+
+if __name__ == "__main__":
+    # Run the PyPdfApp application.
+    pypdfgui.App()

app.pyw

@@ -1,42 +1,43 @@
-"""
-    Author: lefkovitj (https://lefkovitzj.github.io)
-    File Last Modified: 8/15/2024
-    Project Name: PyPdfApp
-    File Name: gui.py
-"""
-
-import customtkinter as ctk
-
-class GUI_Menu():
-    def __init__(self, menu_name, tk_parent, button_texts, button_binds, button_statuses):
-        if len(button_texts) != len(button_binds):
-            raise ValueError(f"Lists button_text and button_binds must be of the same size. Got lists of length {len(button_texts)} and {len(button_binds)} instead.")
-
-        self.name = menu_name
-        self.buttons = []
-        self.texts = button_texts
-        self.binds = button_binds
-        self.states = button_statuses
-    def get_button_texts(self):
-        return self.texts
-    def get_button_commands(self):
-        return self.binds
-    def get_button_states(self):
-        return_list = []
-        for item in self.states:
-            if item == True:
-                return_list.append("normal")
-            else:
-                return_list.append("disabled")
-        return return_list
-    def get_name(self):
-        return self.name
-
-def gui_get_file(initial_directory="", limit_filetypes=[]):
-    """ Open file explorer (using tkinter) to select a file. """
-    root = Tk() # Create the GUI window.
-    root.withdraw()
-    complete_file_path = filedialog.askopenfilename(title="File Select", initialdir = os.getcwd() + "/" + initial_directory, filetypes = limit_filetypes) # Select the file.
-    root.destroy()
-    file_path, file_name = os.path.split(complete_file_path) # Get the filepath and filename to return to the user.
-    return complete_file_path, file_name
+"""
+    Author: lefkovitj (https://lefkovitzj.com)
+    File Last Modified: 8/29/2025
+    Project Name: PyPdfApp
+    File Name: gui.py
+"""
+
+class GuiMenu():
+    """Represent a menu that can be selected via the menus dropdown"""
+    def __init__(self, menu_name, button_texts, button_binds, button_statuses):
+        if len(button_texts) != len(button_binds):
+            raise ValueError(
+                ("Lists button_text and button_binds must be of the same size. "
+                 f"Got lists of length {len(button_texts)} and {len(button_binds)} instead.")
+            )
+
+        self.name = menu_name
+        self.buttons = []
+        self.texts = button_texts
+        self.binds = button_binds
+        self.states = button_statuses
+
+    def get_button_texts(self):
+        """Getter for .texts"""
+        return self.texts
+
+    def get_button_commands(self):
+        """Getter for .binds"""
+        return self.binds
+
+    def get_button_states(self):
+        """Reformatted getter for .states"""
+        return_list = []
+        for item in self.states:
+            if item is True:
+                return_list.append("normal")
+            else:
+                return_list.append("disabled")
+        return return_list
+
+    def get_name(self):
+        """Getter for .name"""
+        return self.name

extract.py

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Joseph Lefkovitz
+Copyright (c) 2025 Joseph Lefkovitz
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

gui.py

@@ -1,32 +1,23 @@
 """
-    Author: lefkovitj (https://lefkovitzj.github.io)
-    File Last Modified: 1/4/2025
+    Author: lefkovitj (https://lefkovitzj.com)
+    File Last Modified: 8/31/2025
     Project Name: PyPdfApp
     File Name: load.py
 """
 
 # Python Standard Library Imports.
-import os
 import sys
-from tkinter import *
-from tkinter import filedialog
 import traceback
 
 # Third-party Module Imports.
-from PIL import Image, ImageTk
 import fitz
 import customtkinter as ctk
 
-def gui_get_file(initial_directory="", limit_filetypes=[]):
-    """ Open file explorer (using tkinter) to select a file. """
-    root = Tk() # Create the GUI window.
-    root.withdraw()
-    complete_file_path = filedialog.askopenfilename(title="File Select", initialdir = os.getcwd() + "/" + initial_directory, filetypes = limit_filetypes) # Select the file.
-    root.destroy()
-    file_path, file_name = os.path.split(complete_file_path) # Get the filepath and filename to return to the user.
-    return complete_file_path, file_name
+# Project imports.
+from manipulate import gui_get_file
 
 def open_pdf():
+    """Open and load a PDF via the system filedialog"""
     if len(sys.argv) == 1: # No argument provided, request file path.
         file_path = gui_get_file(limit_filetypes=[("PDF",".pdf")])[0]
         if file_path == "":
@@ -38,13 +29,14 @@ def open_pdf():
         fitz_doc = fitz.open(file_path)
         doc_password = ""
         while fitz_doc.is_encrypted:
-            if doc_password==None:
+            if doc_password is None:
                 return None
             pass_dialog = ctk.CTkInputDialog(text="Password", title="Open PDF")
             doc_password = pass_dialog.get_input()
             fitz_doc.authenticate(doc_password)
         return file_path, fitz_doc, doc_password
 
-    except Exception: # Handle any application errors by returning them to the user without crashing.
-            print(f"Error Message: \"{traceback.format_exc()}\"")
-            return None
+    # Handle any application errors by returning them to the user without crashing.
+    except Exception:
+        print(f"Error Message: \"{traceback.format_exc()}\"")
+        return None