ConsoleLib 1.3.1__tar.gz → 1.3.2__tar.gz

{consolelib-1.3.1 → consolelib-1.3.2}/ConsoleLib/__init__.py

@@ -10,7 +10,151 @@ import time
 import subprocess as CMD
 import math
 import random
-
+from typing import Optional, Iterator, List
+class Animate:
+    def clear_screen():
+        os.system('cls' if os.name == 'nt' else 'clear')    
+    class ProgressBar:
+        def __init__(
+            self,
+            total: int,
+            prefix: str = "Progress:",
+            suffix: str = "Complete",
+            length: int = 40,
+            fill: str = "█",
+            empty: str = "░",
+            show_percent: bool = True,
+            show_counter: bool = True,
+            auto_clear: bool = False,
+            clear_delay: float = 0.5,
+        ):
+            self.total = total
+            self.prefix = prefix
+            self.suffix = suffix
+            self.length = length
+            self.fill = fill
+            self.empty = empty
+            self.show_percent = show_percent
+            self.show_counter = show_counter
+            self.auto_clear = auto_clear
+            self.clear_delay = clear_delay
+            self.current = 0
+            self._lock = threading.Lock()
+            self._finished = False
+            self._cleared = False
+    
+        def update(self, increment: int = 1) -> None:
+            with self._lock:
+                if self._finished:
+                    return
+                self.current = min(self.current + increment, self.total)
+                self._print_bar()
+    
+                if self.current >= self.total:
+                    self._finished = True
+                    print()
+    
+        def set(self, value: int) -> None:
+            with self._lock:
+                if self._finished:
+                    return
+                self.current = max(0, min(value, self.total))
+                self._print_bar()
+                if self.current >= self.total:
+                    self._finished = True
+                    print()
+        def _print_bar(self) -> None:
+            percent = self.current / self.total
+            filled_len = int(self.length * percent)
+            bar = self.fill * filled_len + self.empty * (self.length - filled_len)
+            parts = [self.prefix, f"[{bar}]"]
+            if self.show_percent:
+                parts.append(f"{percent:.1%}")
+            if self.show_counter:
+                parts.append(f"({self.current}/{self.total})")
+            if self.suffix:
+                parts.append(self.suffix)
+            line = " ".join(parts)
+            sys.stdout.write("\r" + line)
+            sys.stdout.flush()
+    
+        def __enter__(self):
+            if self.auto_clear and not self._cleared:
+                clear_screen()
+                self._cleared = True
+                if self.clear_delay > 0:
+                    time.sleep(self.clear_delay)
+            return self
+        def __exit__(self, exc_type, exc_val, exc_tb):
+            if not self._finished:
+                self._print_bar()
+            print()
+        def iterate(self, iterable: Iterator) -> Iterator:
+            for i, item in enumerate(iterable):
+                yield item
+                self.update(1)
+    def animate_print(
+        text: str,
+        delay: float = 0.05,
+        end: str = "\n",
+        flush: bool = True,
+        backspace_effect: bool = False,
+    ) -> None:
+        if backspace_effect:
+            for ch in text:
+                sys.stdout.write(ch)
+                sys.stdout.flush()
+                time.sleep(delay)
+            time.sleep(0.2)
+            for _ in text:
+                sys.stdout.write("\b \b")
+                sys.stdout.flush()
+                time.sleep(delay / 2)
+            for ch in text:
+                sys.stdout.write(ch)
+                sys.stdout.flush()
+                time.sleep(delay)
+            sys.stdout.write(end)
+            sys.stdout.flush()
+        else:
+            for ch in text:
+                sys.stdout.write(ch)
+                if flush:
+                    sys.stdout.flush()
+                time.sleep(delay)
+            sys.stdout.write(end)
+            if flush:
+                sys.stdout.flush()
+    def spinning_cursor(
+        message: str = "Loading",
+        duration: float = 3.0,
+        delay: float = 0.1,
+        frames: Optional[List[str]] = None,
+        clear_before: bool = False,
+    ) -> None:
+        if clear_before:
+            clear_screen()        
+        if frames is None:
+            frames = ["|", "/", "-", r"\\"]
+        end_time = time.time() + duration
+        idx = 0
+        while time.time() < end_time:
+            frame = frames[idx % len(frames)]
+            sys.stdout.write(f"\r{message} {frame} ")
+            sys.stdout.flush()
+            time.sleep(delay)
+            idx += 1
+        sys.stdout.write("\r" + " " * (len(message) + 3) + "\r")
+        sys.stdout.flush()
+    def countdown(seconds: int, message: str = "Countdown", clear_before: bool = False) -> None:
+        if clear_before:
+            clear_screen()       
+        for remaining in range(seconds, 0, -1):
+            sys.stdout.write(f"\r{message}: {remaining:2d} seconds remaining ")
+            sys.stdout.flush()
+            time.sleep(1)
+        sys.stdout.write(f"\r{message}: 0 seconds remaining! Done!\n")
+        sys.stdout.flush()
 class Render:
     @staticmethod
     def DrawPic(points=None, width=80, height=25, clear_before_draw=False, default_char=' '):

{consolelib-1.3.1 → consolelib-1.3.2}/ConsoleLib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ConsoleLib
-Version: 1.3.1
+Version: 1.3.2
 Summary: The library for easy and best control on the Console.
 Author-email: Suleiman <steal.apet@mail.ru>
 License: MIT

{consolelib-1.3.1 → consolelib-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ConsoleLib
-Version: 1.3.1
+Version: 1.3.2
 Summary: The library for easy and best control on the Console.
 Author-email: Suleiman <steal.apet@mail.ru>
 License: MIT

{consolelib-1.3.1 → consolelib-1.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ConsoleLib"
-version = "1.3.1"
+version = "1.3.2"
 description = "The library for easy and best control on the Console."
 authors = [{name = "Suleiman", email = "steal.apet@mail.ru"}]
 readme = "README.md"