first full version release (#2)

* create searchbar component

* add load folder path functionality

* made minor changes

* create appearance mode toggler component

* add utils package

* add/update components

* update main.py

* add treeview component

* update components

* update logic functions

* update main.py

* add app screenshot

* update requirements.txt

* first version push

Author: uzzielkyle

README.md

@@ -1,2 +1,5 @@
 # PDFMergeXpress
+
+![App Screenshot](img/screenshot1-development.png)
+
 A simple PDF merging app made with customtkinter library.

assets/themes/metal.json

@@ -0,0 +1,155 @@
+{
+    "CTk": {
+        "fg_color": ["#E0E0E0", "#363636"]
+    },
+    "CTkToplevel": {
+        "fg_color": ["#E0E0E0", "#363636"]
+    },
+    "CTkFrame": {
+        "corner_radius": 6,
+        "border_width": 0,
+        "fg_color": ["#C0C0C0", "#404040"],
+        "top_fg_color": ["#A0A0A0", "#505050"],
+        "border_color": ["#808080", "#606060"]
+    },
+    "CTkButton": {
+        "corner_radius": 6,
+        "border_width": 0,
+        "fg_color": ["#A0A0A0", "#505050"],
+        "hover_color": ["#909090", "#606060"],
+        "border_color": ["#3E454A", "#949A9F"],
+        "text_color": ["#F0F0F0", "#F0F0F0"],
+        "text_color_disabled": ["#C0C0C0", "#808080"]
+    },
+    "CTkLabel": {
+        "corner_radius": 0,
+        "fg_color": "transparent",
+        "text_color": ["#363636", "#F0F0F0"]
+    },
+    "CTkEntry": {
+        "corner_radius": 6,
+        "border_width": 2,
+        "fg_color": ["#F0F0F0", "#363636"],
+        "border_color": ["#808080", "#606060"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "placeholder_text_color": ["#878787", "#757575"]
+    },
+    "CTkCheckBox": {
+        "corner_radius": 6,
+        "border_width": 3,
+        "fg_color": ["#A0A0A0", "#505050"],
+        "border_color": ["#3E454A", "#949A9F"],
+        "hover_color": ["#A0A0A0", "#505050"],
+        "checkmark_color": ["#F0F0F0", "#D0D0D0"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "text_color_disabled": ["#808080", "#6C6C6C"]
+    },
+    "CTkSwitch": {
+        "corner_radius": 1000,
+        "border_width": 3,
+        "button_length": 0,
+        "fg_color": ["#B0B0B0", "#505050"],
+        "progress_color": ["#A0A0A0", "#505050"],
+        "button_color": ["#606060", "#D0D0D0"],
+        "button_hover_color": ["#404040", "#F0F0F0"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "text_color_disabled": ["#808080", "#6C6C6C"]
+    },
+    "CTkRadioButton": {
+        "corner_radius": 1000,
+        "border_width_checked": 6,
+        "border_width_unchecked": 3,
+        "fg_color": ["#A0A0A0", "#505050"],
+        "border_color": ["#3E454A", "#949A9F"],
+        "hover_color": ["#909090", "#606060"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "text_color_disabled": ["#808080", "#6C6C6C"]
+    },
+    "CTkProgressBar": {
+        "corner_radius": 1000,
+        "border_width": 0,
+        "fg_color": ["#B0B0B0", "#505050"],
+        "progress_color": ["#A0A0A0", "#505050"],
+        "border_color": ["#808080", "#808080"]
+    },
+    "CTkSlider": {
+        "corner_radius": 1000,
+        "button_corner_radius": 1000,
+        "border_width": 6,
+        "button_length": 0,
+        "fg_color": ["#B0B0B0", "#505050"],
+        "progress_color": ["#707070", "#808080"],
+        "button_color": ["#A0A0A0", "#505050"],
+        "button_hover_color": ["#909090", "#606060"]
+    },
+    "CTkOptionMenu": {
+        "corner_radius": 6,
+        "fg_color": ["#A0A0A0", "#505050"],
+        "button_color": ["#909090", "#606060"],
+        "button_hover_color": ["#707070", "#404040"],
+        "text_color": ["#F0F0F0", "#F0F0F0"],
+        "text_color_disabled": ["#C0C0C0", "#808080"]
+    },
+    "CTkComboBox": {
+        "corner_radius": 6,
+        "border_width": 2,
+        "fg_color": ["#F0F0F0", "#363636"],
+        "border_color": ["#808080", "#606060"],
+        "button_color": ["#808080", "#606060"],
+        "button_hover_color": ["#707070", "#404040"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "text_color_disabled": ["#A0A0A0", "#808080"]
+    },
+    "CTkScrollbar": {
+        "corner_radius": 1000,
+        "border_spacing": 4,
+        "fg_color": "transparent",
+        "button_color": ["#606060", "#505050"],
+        "button_hover_color": ["#404040", "#606060"]
+    },
+    "CTkSegmentedButton": {
+        "corner_radius": 6,
+        "border_width": 2,
+        "fg_color": ["#808080", "#363636"],
+        "selected_color": ["#A0A0A0", "#505050"],
+        "selected_hover_color": ["#909090", "#606060"],
+        "unselected_color": ["#808080", "#363636"],
+        "unselected_hover_color": ["#B0B0B0", "#505050"],
+        "text_color": ["#F0F0F0", "#F0F0F0"],
+        "text_color_disabled": ["#C0C0C0", "#808080"]
+    },
+    "CTkTextbox": {
+        "corner_radius": 6,
+        "border_width": 0,
+        "fg_color": ["#F0F0F0", "#1D1E1E"],
+        "border_color": ["#808080", "#606060"],
+        "text_color": ["#363636", "#F0F0F0"],
+        "scrollbar_button_color": ["#606060", "#505050"],
+        "scrollbar_button_hover_color": ["#404040", "#606060"]
+    },
+    "CTkScrollableFrame": {
+        "label_fg_color": ["#A0A0A0", "#505050"]
+    },
+    "DropdownMenu": {
+        "fg_color": ["#E0E0E0", "#363636"],
+        "hover_color": ["#C0C0C0", "#404040"],
+        "text_color": ["#363636", "#E0E0E0"]
+    },
+    "CTkFont": {
+        "macOS": {
+            "family": "SF Display",
+            "size": 13,
+            "weight": "normal"
+        },
+        "Windows": {
+            "family": "Roboto",
+            "size": 13,
+            "weight": "normal"
+        },
+        "Linux": {
+            "family": "Roboto",
+            "size": 13,
+            "weight": "normal"
+        }
+    }
+  }

components/__init__.py

@@ -0,0 +1,5 @@
+from .head import HeadComponent
+from .treeview import TreeView
+from .appearance_mode_toggler import AppearanceModeToggler
+from .searchbar import Searchbar
+from .merger import Merger

components/appearance_mode_toggler.py

@@ -0,0 +1,51 @@
+from typing import Optional, Tuple, Union
+from customtkinter import *
+
+class AppearanceModeToggler(CTkFrame):
+    def __init__(self, *args, 
+                 width: int = 100, 
+                 height: int = 100, 
+                 bg_color: str | Tuple[str, str] = "transparent", 
+                 fg_color: str | Tuple[str, str] = "transparent", 
+                 corner_radius: int = 0,
+                 **kwargs):
+        super().__init__(*args, width=width, height=height, bg_color=bg_color, fg_color=fg_color, corner_radius=corner_radius, **kwargs)
+        
+        self.grid_rowconfigure(1, weight=1)
+        
+        self.modes_list = ['System', 'Dark', 'Light']
+        
+        self.current_mode_var = StringVar(value='System')
+        
+        self.widget_label = CTkLabel(self, text='Appearance Mode', anchor='center')
+        self.widget_label.grid(row=0, column=0, padx=15, pady=0)
+        
+        self.dropdown_menu = CTkOptionMenu(self, values=self.modes_list, variable=self.current_mode_var, command=self.set)
+        self.dropdown_menu.grid(row=1, column=0, padx=10, pady=(0, 5), sticky='ew')
+        
+    def set(self, choice) -> None:
+        try:
+            set_appearance_mode(choice)
+            
+        except ValueError:
+            return
+        
+    def get(self) -> str:
+        print(self.dropdown_menu.get())
+    
+
+if __name__ == '__main__':
+    class Tester(CTk):
+        def __init__(self, fg_color: str | Tuple[str, str] | None = None, **kwargs):
+            super().__init__(fg_color, **kwargs)
+                    
+            self.grid_columnconfigure(0, weight=1)
+            
+            self.appearance_mode_toggler = AppearanceModeToggler(master=self)
+            self.appearance_mode_toggler.grid(row=0, column=0, padx=10, pady=10)
+        
+        
+    app = Tester()
+    
+    app.mainloop()
+    

components/head.py

@@ -0,0 +1,40 @@
+# A combination of a progress bar, button, and my very own searchbar widget.
+from typing import Optional, Tuple, Union
+from customtkinter import *
+from .searchbar import Searchbar
+from .merger import Merger
+
+
+class HeadComponent(CTkFrame):
+    WIDTH: int = 500
+    HEIGHT: int = 50
+    
+    def __init__(self, *args, 
+                 bg_color: str | Tuple[str, str] = 'transparent', 
+                 fg_color: str | Tuple[str, str] = 'whitesmoke', 
+                 corner_radius: int = 0,
+                 **kwargs):
+        super().__init__(*args, bg_color=bg_color, fg_color=fg_color, corner_radius=corner_radius, **kwargs)
+                
+        self.grid_columnconfigure(0, weight=1)
+        
+        self.searchbar = Searchbar(master=self)
+        self.searchbar.grid(row=0, column=0, padx=10, pady=(5, 0))
+    
+        self.merger = Merger(master=self, get_path_func=self.searchbar.get, clear_search_func=self.searchbar.clear)
+        self.merger.grid(row=1, column=0, padx=10, pady=(0, 5))
+            
+
+if __name__ == '__main__':
+    class Tester(CTk):
+        def __init__(self, fg_color: str | Tuple[str, str] | None = None, **kwargs):
+            super().__init__(fg_color, **kwargs)
+            
+            self.grid_columnconfigure(0, weight=1)
+        
+            self.head = HeadComponent(self)
+            self.head.grid(row=0, column=0)
+            
+            
+    app = Tester()
+    app.mainloop()    

components/merger.py

@@ -0,0 +1,111 @@
+from typing import Optional, Tuple, Union
+from customtkinter import *
+from utils.logics import LogicHandler
+from CTkMessagebox import CTkMessagebox
+from threading import Thread
+import os
+
+class Merger(CTkFrame):
+    WIDTH: int = 600
+    HEIGHT: int = 50
+    
+    def __init__(self, *args, 
+                get_path_func,
+                clear_search_func,
+                 bg_color: str | Tuple[str, str] = 'transparent', 
+                 fg_color: str | Tuple[str, str] = 'transparent', 
+                 corner_radius: int = 0,
+                 **kwargs):
+        super().__init__(*args, bg_color=bg_color, fg_color=fg_color, corner_radius=corner_radius, **kwargs)
+        
+        self.logic_handler = LogicHandler()
+        
+        self.get_path = get_path_func
+        self.clear_search = clear_search_func
+        
+        self.treeview_connection = None
+        
+        self.grid_columnconfigure((0, 1), weight=1)
+        
+        # Will figure out kung paano talaga magamit ito...
+        # 2023-11-07: By multithreading hehe
+        self.progress_bar = CTkProgressBar(self, orientation='horizontal', width=self.WIDTH - 110)
+        self.progress_bar.grid(row=0, column=0, columnspan=2, padx=0, pady=(0, 5), sticky='ew')
+        self.progress_bar.configure(mode='indeterminate')
+        
+        self.merge_btn = CTkButton(self, text='Merge', width=90, corner_radius=corner_radius, command=lambda: Thread(target=self.merge).start())
+        self.merge_btn.grid(row=0, column=2, padx=(20, 0), pady=(0, 5), sticky='ew')
+               
+    def merge(self) -> None:
+        try:
+            folder_path = self.get_path()
+                    
+            if not folder_path: 
+                self.blank_searchbar_message = CTkMessagebox(fg_color='whitesmoke', bg_color='whitesmoke', title='Blank Entry' ,message='Please input a folder path.', icon='warning', justify='center',font=('Arial', 11), option_focus='option_1', sound=True)
+                return
+                
+            self.clear_search()
+            self.clear_treeview()
+            self.working_state()
+            
+            if not folder_path.endswith(os.path.sep):
+                folder_path += os.path.sep
+                
+            folder_path = os.path.normpath(folder_path)
+            
+            roots_not_empty = self.logic_handler.scan_folders(folder_path=folder_path)
+                        
+            if not roots_not_empty:  
+                self.no_files_message = CTkMessagebox(fg_color='whitesmoke', bg_color='whitesmoke', title='No PDFs found' ,message='No PDF file inside the directory.', icon='info', justify='center',font=('Arial', 11), option_focus='option_1')
+                
+                self.idle_state()
+                
+                return
+                
+            outputs = self.logic_handler.deep_merging(main_path=folder_path, dirs=roots_not_empty)
+            
+            if not outputs:
+                self.no_merging_message = CTkMessagebox(fg_color='whitesmoke', bg_color='whitesmoke', title='No Merging Happened' ,message='The root directory (and its subdirectories) only contained one PDF file.', icon='info', justify='center',font=('Arial', 11), option_focus='option_1', sound=True)
+                
+                self.idle_state()
+                
+                return
+                
+            self.display_outputs(values=outputs)
+                
+            self.idle_state()
+        
+        except:
+            self.blank_searchbar_message = CTkMessagebox(fg_color='whitesmoke', bg_color='whitesmoke', title='Error' ,message='Error in merging PDFs.', icon='warning', justify='center',font=('Arial', 11), option_focus='option_1', sound=True)
+            
+            self.idle_state()
+        
+    def idle_state(self):
+        self.progress_bar.stop()
+        self.merge_btn.configure(state='normal')
+        
+    def working_state(self):
+        self.progress_bar.start()
+        self.merge_btn.configure(state='disabled')
+        
+    def set_treeview_connection(self, clear,  display_outputs):
+        self.clear_treeview = clear
+        self.display_outputs = display_outputs
+    
+            
+
+if __name__ == '__main__':
+    class Tester(CTk):
+        def __init__(self, fg_color: str | Tuple[str, str] | None = None, **kwargs):
+            super().__init__(fg_color, **kwargs)
+            
+            self.grid_columnconfigure(0, weight=1)
+            
+            self.Merger = Merger(master=self, width=750)
+            self.Merger.grid(row=0, column=0, padx=10, pady=10)
+            
+            
+    app = Tester()
+    
+    app.mainloop()
+