Merge pull request #1 from lefkovitzj/release/1.8.0

Release PyPdfApp Version 1.8

Implement various bugfixes and refactor codebase to better adhere to PEP8 coding standards and best practices.

Develop new features:
- Create a "Redact" feature.
- Create a "Highlight" feature.
- Manipulate links within a PDF.
- Add quick scroll panel with page previews.

Bring documentation, license and demo PDF up to date.

Author: lefkovitzj

.gitignore

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

README.md

@@ -41,10 +41,11 @@
 
 <!-- ABOUT THE PROJECT -->
 ## About The Project
-
-<img src="documentation-images/application-demo.png" alt="Application demo using the demo.pdf file">
-
-This is an example of `app.py` being used to open the `demo.pdf` file.
+<div align="center">
+  <img src="documentation-images/application-demo.png" alt="Application demo using the demo.pdf file" width="60%">
+</div>
+<br>
+This is an example of `app.pyw` being used to open the `demo.pdf` file.
 
 
 ### Built With
@@ -168,6 +169,11 @@ The following submenus are available, with different actions for each of the fou
    * Verify Signature
    * Add Signer Account
    * Set Signer Account
+7. Markup:
+   * Freehand Draw
+   * Link Editor
+   * Redact
+   * Highlight
 
 <br><br>
 #### Application Hotkeys
@@ -198,14 +204,14 @@ Unless disabled in settings.json, the following keyboard shortcuts are available
 - [x] Add file tampering checker utility application. (Completed v1.3)
 - [x] Add page rotation feature. (Completed v1.4)
 - [x] Add watermark feature. (Completed v1.4)
-- [x] Add digital signature creation and verification systsm.
-- [x] Add a "red pen markup" feature to draw on PDF pages.
-- [x] Add functionality for multiple PDF files at once.
-- [x] Add functionality to create a new PDF from a blank page.
-- [ ] Create a "Redact" feature.
-- [ ] Create a "Highlight" feature.
-- [ ] Manipulate links within a PDF.
-- [ ] Add quick scroll panel with page previews.
+- [x] Add digital signature creation and verification systsm. (Completed v1.5)
+- [x] Add a "red pen markup" feature to draw on PDF pages. (Completed v1.6)
+- [x] Add functionality for multiple PDF files at once. (Completed v1.6)
+- [x] Add functionality to create a new PDF from a blank page. (Completed v1.7)
+- [x] Create a "Redact" feature. (Completed v1.8)
+- [x] Create a "Highlight" feature. (Completed v1.8)
+- [x] Manipulate links within a PDF. (Completed v1.8)
+- [x] Add quick scroll panel with page previews. (Completed v1.8)
 - [ ] Add tooltips to all buttons.
 - [ ] Add settings page.
 - [ ] Allow user-adjusted keybinds.

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

demo.pdf

@@ -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