ConsoleLib 1.3.1__tar.gz → 1.3.3__tar.gz

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

@@ -1,5 +1,5 @@
 """
-ConsoleLib - The best Console Renderer of the Python.
+ConsoleLib - The best Console Library of the Python.
 By: Suleiman
 Copyright © Suleiman 2026
 All rights are reserved.
@@ -10,7 +10,203 @@ import time
 import subprocess as CMD
 import math
 import random
-
+from typing import Optional, Iterator, List
+class Colors:
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    DIM = "\033[2m"
+    ITALIC = "\033[3m"
+    UNDERLINE = "\033[4m"
+    BLINK = "\033[5m"
+    REVERSE = "\033[7m"
+    HIDDEN = "\033[8m"
+    STRIKE = "\033[9m"
+    BLACK = "\033[30m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    MAGENTA = "\033[35m"
+    CYAN = "\033[36m"
+    WHITE = "\033[37m"
+    BRIGHT_BLACK = "\033[90m"
+    BRIGHT_RED = "\033[91m"
+    BRIGHT_GREEN = "\033[92m"
+    BRIGHT_YELLOW = "\033[93m"
+    BRIGHT_BLUE = "\033[94m"
+    BRIGHT_MAGENTA = "\033[95m"
+    BRIGHT_CYAN = "\033[96m"
+    BRIGHT_WHITE = "\033[97m"
+    BG_BLACK = "\033[40m"
+    BG_RED = "\033[41m"
+    BG_GREEN = "\033[42m"
+    BG_YELLOW = "\033[43m"
+    BG_BLUE = "\033[44m"
+    BG_MAGENTA = "\033[45m"
+    BG_CYAN = "\033[46m"
+    BG_WHITE = "\033[47m"
+    BG_BRIGHT_BLACK = "\033[100m"
+    BG_BRIGHT_RED = "\033[101m"
+    BG_BRIGHT_GREEN = "\033[102m"
+    BG_BRIGHT_YELLOW = "\033[103m"
+    BG_BRIGHT_BLUE = "\033[104m"
+    BG_BRIGHT_MAGENTA = "\033[105m"
+    BG_BRIGHT_CYAN = "\033[106m"
+    BG_BRIGHT_WHITE = "\033[107m"
+    @staticmethod
+    def rgb(r, g, b):
+        return f"\033[38;2;{r};{g};{b}m"
+    @staticmethod
+    def bg_rgb(r, g, b):
+        return f"\033[48;2;{r};{g};{b}m"
+    @staticmethod
+    def colorize(text, color, reset=True):
+        reset_code = Colors.RESET if reset else ""
+        return f"{color}{text}{reset_code}"
+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.3}/ConsoleLib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ConsoleLib
-Version: 1.3.1
+Version: 1.3.3
 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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ConsoleLib
-Version: 1.3.1
+Version: 1.3.3
 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.3}/pyproject.toml

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