Added a new method to log21.Logger class: log21.Logger.clear_line.

Author: MPCodeWriter21

CHANGES-LOG.md

@@ -6,6 +6,11 @@ Help this project by [Donation](DONATE.md)
 Changes log
 -----------
 
+### 2.3.4
+
+Added a new method to `log21.Logger` class: `log21.Logger.clear_line`. This method clears the current line in the
+console and moves the cursor to the beginning of the line.
+
 ### 2.3.3
 
 Fixed a bug that would cause an error creating a progress bar with no value set for width in systems without support for

README.md

@@ -53,10 +53,10 @@ python setup.py install
 Changes
 -------
 
-### 2.3.3
+### 2.3.4
 
-Fixed a bug that would cause an error creating a progress bar with no value set for width in systems without support for
-os.get_terminal_size().
+Added a new method to `log21.Logger` class: `log21.Logger.clear_line`. This method clears the current line in the
+console and moves the cursor to the beginning of the line.
 
 [Full Changes Log](https://github.com/MPCodeWriter21/log21/blob/master/CHANGES-LOG.md)
 

log21/Logger.py

@@ -191,3 +191,14 @@ def progress_bar(self):
     @progress_bar.setter
     def progress_bar(self, value: '_log21.ProgressBar'):
         self._progress_bar = value
+
+    def clear_line(self, length: int = None):
+        """
+        Clear the current line.
+
+        :param length: The length of the line to clear.
+        :return:
+        """
+        for handler in self.handlers:
+            if hasattr(handler, 'clear_line'):
+                handler.clear_line(length)

log21/StreamHandler.py

@@ -58,6 +58,26 @@ def emit(self, record):
             self.check_nl(record)
         super().emit(record)
 
+    def clear_line(self, length: int = None):
+        """
+        Clear the current line.
+
+        :param length: The length of the line to clear.
+        :return:
+        """
+        if IS_WINDOWS:
+            file_descriptor = getattr(self.stream, 'fileno', None)
+            if file_descriptor:
+                file_descriptor = file_descriptor()
+                if file_descriptor in (1, 2):
+                    if length is None:
+                        length = _os.get_terminal_size(file_descriptor)[0]
+                    self.stream.write('\r' + (' ' * (length - 1)) + '\r')
+        else:
+            if length is None:
+                length = _os.get_terminal_size()[0]
+            self.stream.write('\r' + (' ' * (length - 1)) + '\r')
+
 
 # A stream handler that supports colorizing.
 class ColorizingStreamHandler(StreamHandler):

log21/__init__.py

@@ -21,7 +21,7 @@
 from log21.Formatters import ColorizingFormatter, DecolorizingFormatter
 from log21.Colors import Colors, get_color, get_colors, ansi_escape, get_color_name, closest_color
 
-__version__ = "2.3.3"
+__version__ = "2.3.4"
 __author__ = "CodeWriter21 (Mehrad Pooryoussof)"
 __github__ = "Https://GitHub.com/MPCodeWriter21/log21"
 __all__ = ['ColorizingStreamHandler', 'DecolorizingFileHandler', 'ColorizingFormatter', 'DecolorizingFormatter',

setup.py

@@ -7,7 +7,7 @@
     long_description = file.read()
 
 DESCRIPTION = 'A simple logging package that helps you log colorized messages in Windows console.'
-VERSION = '2.3.3'
+VERSION = '2.3.4'
 
 setup(
     name='log21',