.

Author: GSAUC3

App.py

@@ -6,10 +6,14 @@
 
 class App:
     def __init__(self,root,title) -> None:
+        # root is the window where all the widgits will be displayed 
         self.root = root 
         self.root.title(title)
         self.root.geometry('805x440')
+        # create a button and tell it where to display the button  i.e. self.root 
         ttk.Button(self.root,text = 'start sorting',command=self._start).grid(row=0,column=14)
+        # now to add this created widget (button) on the screen (window (self.root)) 
+        # use either grid or pack 
         ttk.Button(self.root,text = 'shuffle',command=self._shuffle).grid(row=0,column=13)
         self.canvas = Canvas(self.root,width=800,height=405,highlightbackground='dodgerblue',
                              bg = 'black',highlightthickness=2)
@@ -22,9 +26,11 @@ def __init__(self,root,title) -> None:
         self._shuffle()
 
     def __reset_colors(self,color ='dodgerblue'):
+        # lets create a function to reset the colors  
         self._colors = [color for _ in range(self.N)] 
 
     def _shuffle(self):
+        # define a shuffle function  
         self.__reset_colors()
         random.shuffle(self.data)
         self._display(self._colors)
@@ -73,5 +79,33 @@ def _start(self):
 
 if __name__ == '__main__':
     window = Style(theme = 'darkly').master 
+    # window is an instance of ttkbootstrap's Style class 
     App(window,'Bubble sort')
-    window.mainloop()
+    
+    window.mainloop()
+    # tells Python to run the Tkinter event loop.
+    # This method listens for events, such as button clicks or keypresses, 
+    # and blocks any code that comes after it from running 
+    '''
+    The mainloop() function in Tkinter is a method that starts an event loop, 
+    which listens for events and responds to them accordingly.
+    It is a crucial function in GUI programming with Tkinter
+    since it is responsible for keeping the GUI responsive
+    and handling user input.
+
+    When you create a GUI application using Tkinter, you define 
+    various widgets like buttons, labels, and entry boxes, and 
+    then bind them to specific events like button clicks or key
+    presses. Once you have set up your application, you need 
+    to start the mainloop() function to start the event loop.
+
+    The mainloop() function runs indefinitely until the user 
+    closes the application window or calls the quit() method.
+    It continuously listens for events such as mouse clicks,
+    key presses, and other user input events, and dispatches
+    them to the appropriate widgets for processing.
+
+    In summary, the purpose of the mainloop() function in 
+    Tkinter is to start the event loop that listens for
+    user input events and keeps the GUI responsive.
+    '''