Add docstrings for file counting and moving functions in file_classifier.py and file_organiser.py

Author: heshinth

src/tidyfile/modules/file_classifier.py

@@ -154,6 +154,15 @@ def categorize_files_by_type(files: List[str]) -> Dict[str, List[str]]:
 
 
 def file_count(files: list):
+    """
+    Counts the total number of files and categories in the given list of files.
+
+    Args:
+        files (list): A list of file paths to be categorized and counted.
+
+    Returns:
+        tuple: A tuple containing the total number of files and the total number of categories.
+    """
     category_count = 0
     file_count = 0
     categorized_data = categorize_files_by_type(files)

src/tidyfile/modules/file_organiser.py

@@ -6,6 +6,15 @@
 
 
 def move_files_to_categories(files: list):
+    """
+    Moves files into categorized folders based on their type.
+
+    Args:
+        files (list): A list of file paths to be categorized and moved.
+
+    The function categorizes the given files by their type and moves them into corresponding folders.
+    If the category folder does not exist, it creates the folder. Logs the actions performed and any errors encountered.
+    """
     categorised_files = categorize_files_by_type(files)
 
     for category, filenames in categorised_files.items():