Implement Dynamic Progress Logger

Implements koii-network#12723

Implements koii-network#12654

# Implement Dynamic Progress Logger

## Task
Write a function to log output dynamically updating a progress bar.

## Acceptance Criteria
All tests must pass.

## Summary of Changes
Added a new utility function that creates a dynamically updating progress bar for logging output. The function allows real-time tracking of progress with customizable parameters.

## Test Cases
 - Verify progress bar initializes correctly with given parameters
 - Confirm progress bar updates incrementally
 - Check that progress bar handles edge cases like 0% and 100%
 - Ensure progress bar displays correctly with different total steps
 - Test progress bar works with various output types and lengths

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

Author: beso

progress_logger.py

@@ -0,0 +1,45 @@
+class ProgressLogger:
+    """
+    A class to log output dynamically updating a progress bar.
+
+    Attributes:
+        total_steps (int): The total number of steps to track.
+        current_step (int): The current step being logged.
+        progress_bar (str): The progress bar string.
+    """
+
+    def __init__(self, total_steps: int, prefix: str = ""):
+        """
+        Initialize the ProgressLogger instance.
+
+        Args:
+            total_steps (int): The total number of steps to track.
+            prefix (str, optional): The prefix message for the log. Defaults to "".
+        """
+        self.total_steps = total_steps
+        self.current_step = 0
+        self.progress_bar = "[====>                    ]"
+        self.prefix = prefix
+
+    def logging(self, current_step: int) -> None:
+        """
+        Log the current step with a dynamically updating progress bar.
+
+        Args:
+            current_step (int): The current step to log.
+
+        Raises:
+            ValueError: If the current_step is less than 0 or greater than total_steps.
+        """
+        if current_step < 0 or current_step > self.total_steps:
+            raise ValueError("Current step must be between 0 and total steps.")
+
+        self.current_step = current_step
+        percentage = (current_step / self.total_steps) * 100
+        filled_length = int(round(percentage / 100 * len(self.progress_bar) - 1))
+        self.progress_bar = (
+            f"[{'=' * filled_length}>{' ' * (len(self.progress_bar) - filled_length - 1)}]"
+        )
+
+        log_message = f"{self.prefix} - Step {current_step}/{self.total_steps} ({percentage:.2f}%): {self.progress_bar}"
+        print(log_message, end="\r")