ttykit 0.3.7__tar.gz → 0.4.0__tar.gz

{ttykit-0.3.7/src/ttykit.egg-info → ttykit-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ttykit
-Version: 0.3.7
+Version: 0.4.0
 Summary: Helping made beatiful out in terminal
 Author: He-STALIN
 Author-email: hene.stalin@gmail.com
@@ -46,60 +46,72 @@ Dynamic: license-file
 [![Python Version](https://img.shields.io/badge/python-3.13+-blue.svg)](https://python.org)
 [![GitHub license](https://img.shields.io/github/license/He-STALIN/ttykit)](LICENSE)
 [![Repository](https://img.shields.io/badge/Repository-GitHub-4b93ff?style=flat&logo=github&logoColor=white)](https://github.com/He-STALIN/ttykit)
+[![Downloads](https://img.shields.io/pypi/dm/ttykit)](https://pypi.org/project/ttykit/)
 
 </div>
 
+##### Вы из России? Смотрите [русскую версию](/docs/ru/README.ru.md)
+
 ---
 
-## 📦 For Start
+## For Start
 ### Manually:
-
-```bash
-git clone https://github.com/He-STALIN/ttykit.git
-```
+- Clone repository
+    ```bash
+    git clone https://github.com/He-STALIN/ttykit.git
+    ```
 
 - Change dir and exec
-
-```bash
-pip install .
-```
+    ```bash
+    pip install .
+    ```
 ### Auto
 - exec `pip install ttykit`
 
 - And use in your projects!
 
-## License
-- This lib uploading with MIT License [See License](LICENSE)
+## Support the project
+- If you would like the project to continue developing, you can make a [donation](https://yoomoney.ru/to/4100118618732284/100).
+- Account: `4100 1186 1873 2284` (YouMoney)
+- or
+- Find bugs in the library and report them in the `issues` section on GitHub.
 
 ## Code Examples
 
-### Status
-```python
-from ttykit import Status, TaskState
-
-with Status("Something unit", spinner="line") as status:
-    <some action>
-    status.set_state(TaskState.SUCCESS)
-```
-
-### Progress
-```python
-from ttykit import Progress
-
-with Progress(100, "Some desc", 40) as progress:
-    <some action>
-    progress.update(<value>)
-    <some action again>
-    progress.finish()
-```
-or
-```python
-with Progress(100, "Some desc", 40) as progress:
-    while not progress.finished:
-        <some actions>
-        progress.advance(<step>)
-        <maybe action again>
-```
+- ### Status
+    ```python
+    from ttykit import Status, TaskState
+
+    with Status("Something unit", spinner="line") as status:
+        <some action>
+        status.set_state(TaskState.SUCCESS)
+    ```
+
+- ### Progress
+    ```python
+    from ttykit import Progress
+
+    with Progress(100, "Some desc", 40) as progress:
+        <some action>
+        progress.update(<value>)
+        <some action again>
+        progress.finish()
+    ```
+
+- **for more code examples see** [CODE USE](docs/en/CODE_USE.md)
 
 ## Also
 - also you can use prepared colors in this lib
+
+## License
+- This lib uploading with MIT License. [See License](LICENSE)
+
+## Versions
+- You interesting see versions? You can see [CHANGELOG](docs/en/CHANGELOG.md)
+
+---
+<div align="center">
+
+*ttykit by He_STALIN. All right reserved*
+
+</div>

ttykit-0.4.0/README.md

@@ -0,0 +1,78 @@
+<div align="center">
+
+# TTYKit
+
+> **Helping made beautiful out in terminal**
+
+[![Python Version](https://img.shields.io/badge/python-3.13+-blue.svg)](https://python.org)
+[![GitHub license](https://img.shields.io/github/license/He-STALIN/ttykit)](LICENSE)
+[![Repository](https://img.shields.io/badge/Repository-GitHub-4b93ff?style=flat&logo=github&logoColor=white)](https://github.com/He-STALIN/ttykit)
+[![Downloads](https://img.shields.io/pypi/dm/ttykit)](https://pypi.org/project/ttykit/)
+
+</div>
+
+##### Вы из России? Смотрите [русскую версию](/docs/ru/README.ru.md)
+
+---
+
+## For Start
+### Manually:
+- Clone repository
+    ```bash
+    git clone https://github.com/He-STALIN/ttykit.git
+    ```
+
+- Change dir and exec
+    ```bash
+    pip install .
+    ```
+### Auto
+- exec `pip install ttykit`
+
+- And use in your projects!
+
+## Support the project
+- If you would like the project to continue developing, you can make a [donation](https://yoomoney.ru/to/4100118618732284/100).
+- Account: `4100 1186 1873 2284` (YouMoney)
+- or
+- Find bugs in the library and report them in the `issues` section on GitHub.
+
+## Code Examples
+
+- ### Status
+    ```python
+    from ttykit import Status, TaskState
+
+    with Status("Something unit", spinner="line") as status:
+        <some action>
+        status.set_state(TaskState.SUCCESS)
+    ```
+
+- ### Progress
+    ```python
+    from ttykit import Progress
+
+    with Progress(100, "Some desc", 40) as progress:
+        <some action>
+        progress.update(<value>)
+        <some action again>
+        progress.finish()
+    ```
+
+- **for more code examples see** [CODE USE](docs/en/CODE_USE.md)
+
+## Also
+- also you can use prepared colors in this lib
+
+## License
+- This lib uploading with MIT License. [See License](LICENSE)
+
+## Versions
+- You interesting see versions? You can see [CHANGELOG](docs/en/CHANGELOG.md)
+
+---
+<div align="center">
+
+*ttykit by He_STALIN. All right reserved*
+
+</div>

{ttykit-0.3.7 → ttykit-0.4.0}/pyproject.toml

@@ -8,7 +8,7 @@ include = ["ttykit*"]
 
 [project]
 name = "ttykit"
-version = "0.3.7"
+version = "0.4.0"
 description = "Helping made beatiful out in terminal"
 requires-python = ">=3.13"
 authors = [
@@ -21,7 +21,7 @@ keywords = ['tty', 'terminal', 'formatting']
 dependencies = ["keyboard"]
 
 [project.scripts]
-ttykit-spinner = "ttykit.spinner:main"
+ttykit-spinner = "ttykit.examples.spinner:main"
 
 [project.optional-dependencies]
 test = ["pytest"]

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/__init__.py

@@ -3,6 +3,7 @@
 from .progress import Progress
 from .status import Status
 from ._state import TaskState, Colors, Styles, RESET
+from .tree import Tree
 from .console.console import Console
 from .console.TUI import TUI
 import traceback
@@ -19,6 +20,7 @@ __all__ = [
     'Status',
     'TaskState',
     'Console',
+    'Tree',
     'TUI',
     'get_console',
     'set_custom_hook'
@@ -59,11 +61,13 @@ def set_custom_hook(Traceback: bool= False) -> None:
         Traceback (bool): replace Traceback on custom or not. Default `False`
     """
 
+    print("[WARNING] this method 'set_custom_hook' unstable and may not working")
+
     if Traceback:
         print('set custom excepthook...')
         sys.excepthook = custom_excepthook
 
 __name__ = 'ttykit'
 __author__ = 'He-STALIN'
-__version__ = '0.3.7'
+__version__ = '0.4.0'
 __license__ = 'MIT'

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/_state.py

@@ -21,6 +21,34 @@ class Colors:
     LIGHT_WHITE = "\033[97m"
     RESET = "\033[0m"
 
+    def get(name: str = None, default: str = None) -> str:
+        """Return the color ANSI code from color name
+
+        Args:
+            name (str): name of color
+            default (str | None): what will be return if color not found
+        Returns:
+            color (str): ANSi code of color
+        """
+        match name.lower():
+            case "black": return Colors.BLACK
+            case "red": return Colors.RED
+            case "green": return Colors.GREEN
+            case "yellow": return Colors.YELLOW
+            case "blue": return Colors.BLUE
+            case "purple": return Colors.PURPLE
+            case "cyan": return Colors.CYAN
+            case "white": return Colors.WHITE
+            case "dark_grey": return Colors.DARK_GREY
+            case "light_red": return Colors.LIGHT_RED
+            case "light_green": return Colors.LIGHT_GREEN
+            case "light_yellow": return Colors.LIGHT_YELLOW
+            case "light_blue": return Colors.LIGHT_BLUE
+            case "light_purple": return Colors.LIGHT_PURPLE
+            case "light_cyan": return Colors.LIGHT_CYAN
+            case "light_white": return Colors.LIGHT_WHITE
+            case _: return default
+
 class Styles:
     """Applied styles for text in the terminal. Can be mixed with `class Colors`"""
     RESET = "\033[0m"
@@ -33,6 +61,27 @@ class Styles:
     REVERSE = "\033[7m"
     STRIKETHROUGH = "\033[9m"
 
+    def get(name: str = None, default: str = None) -> str:
+        """Return the style ANSI code from style name
+        
+        Args:
+            name (str): name of style
+            default (str | None): what will be return if style not found
+        Returns:
+            style (str): ANSi code of style
+        """
+        match name.lower():
+            case "bold": return Styles.BOLD
+            case "dim": return Styles.DIM
+            case "italic": return Styles.ITALIC
+            case "underline": return Styles.UNDERLINE
+            case "blink": return Styles.BLINK
+            case "rapid_blink": return Styles.RAPID_BLINK
+            case "reverse": return Styles.REVERSE
+            case "strikethrough": return Styles.STRIKETHROUGH
+            case "reset": return Styles.RESET
+            case _: return default
+
 RESET = "\033[0m"
 
 class TaskState(Enum):

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/console/TUI.py

@@ -41,6 +41,9 @@ class TUI:
     """
     def __init__(self, title: str):
         super().__init__()
+
+        print("[WARNING] Class 'TUI' not fully completed and may contain errors.")
+
         self.TITLE: str = title if title else "Text UI"
         self.FOOTER: str = "For control use arrows Up/Down and Enter to select"
         self.DEFAULT_SPACE = "   "

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/console/console.py

@@ -1,7 +1,8 @@
 import sys
 import os
-from typing import Optional, Literal, Mapping, Any
-from ttykit import Colors, Styles
+from typing import Optional, Literal, Mapping
+from ttykit.segmentation import Segmentation
+from getpass import getpass
 
 from .const import ColorSystem, WINDOWS
 
@@ -35,8 +36,8 @@ class Console:
         self._force_terminal = None
         self.stderr = stderr
         self.no_color = no_color
-        self.height = None
-        self.width = None
+        self.height = width
+        self.width = height
 
         if color_system is None:
             self._color_system = None
@@ -46,21 +47,21 @@ class Console:
         if force_terminal is not None:
             self._force_terminal = force_terminal
 
-        if width is None:
+        if self.width is None:
             try:
                 size = os.get_terminal_size()
-                width = size.columns
+                self.width = size.columns
             except OSError:
                 print('Error calculating width of the terminal. Use default value (80)')
-                width = 80
+                self.width = 80
 
-        if height is None:
+        if self.height is None:
             try:
                 size = os.get_terminal_size()
-                height = size.lines
+                self.height = size.lines
             except OSError:
                 print('Error calculating height of the terminal. Use default value (24)')
-                height
+                self.height
 
     def _print_error(self, msg: str=None):
         if msg is None:
@@ -130,49 +131,17 @@ class Console:
                 return ColorSystem.EIGHT_BIT
             return ColorSystem.STANDARD
 
-    def _get_style_code(self, style: str) -> str:
-        styles = {
-            'bold': Styles.BOLD,
-            'dim': Styles.DIM,
-            'italic': Styles.ITALIC,
-            'underline': Styles.UNDERLINE,
-            'blink': Styles.BLINK,
-            'rapid_blink': Styles.RAPID_BLINK,
-            'reverse': Styles.REVERSE
-        }
-        return styles.get(style, '')
-
-    def _get_color_code(self, color: str) -> str:
-        colors = {
-            "black": Colors.BLACK,
-            "red": Colors.RED,
-            "green": Colors.GREEN,
-            "yellow": Colors.YELLOW,
-            "blue": Colors.BLUE,
-            "purple": Colors.PURPLE,
-            "cyan": Colors.CYAN,
-            "white": Colors.WHITE,
-            "dark_grey": Colors.DARK_GREY,
-            "light_red": Colors.LIGHT_RED,
-            "light_green": Colors.LIGHT_GREEN,
-            "light_yellow": Colors.LIGHT_YELLOW,
-            "light_blue": Colors.LIGHT_BLUE,
-            "light_purple": Colors.LIGHT_PURPLE,
-            "light_cyan": Colors.LIGHT_CYAN,
-            "light_white": Colors.LIGHT_WHITE
-        }
-        return colors.get(color, "")
-
     def bell(self):
         sys.stdout.write("\a")
         sys.stdout.flush()
 
     def print(self,
             *args,
-            sep: str | None=" ",
-            end: str | None ="\n",
-            style: str | None=None,
-            color: str | None=None) -> None:
+            sep: Optional[str] =" ",
+            end: Optional[str] ="\n",
+            justify: str = "left",
+            fillchar: str = " "
+            ) -> None:
         """
         Print the args to a stream
 
@@ -180,10 +149,17 @@ class Console:
             *args (Any): args to write to a stream
             sep (str | None): string inserted between values, default a space.
             end (str | None): string appended after the last value, default a newline.
-            style: style of args write to a steam, default `None`.
-            color: color of args write to a stream, default `None`.
+            justify (str): justify of text in the terminal. Avaliable: "left", "center", "right".
+            fillchar (str): char for fill free space in line. Default " ".
         Returns:
             None: write in `stdout`
+
+        ### Example
+            code:
+                print("[blue] This is test string")
+
+            output:
+                <div style="color: blue;"> This is test string</div>
         """
         if not self.isTerminal or self.no_color:
             #? Just out, without colors or styles
@@ -194,42 +170,45 @@ class Console:
         
         #? Apply the style with color to args
         text = sep.join(str(a) for a in args)
-        if color and self.color_system:
-            color_code = self._get_color_code(color.lower())
-            text = f"{color_code}{text}{Colors.RESET}"
-
-        if style:
-            style_code = self._get_style_code(style.lower())
-            text = f"{style_code}{text}"
 
+        text = Segmentation(text).auto_compile()
+
+        match justify:
+            case "left":
+                text = text.ljust(self.width, fillchar)
+            case "center":
+                text = text.center(self.width, fillchar)
+            case "right":
+                text = text.rjust(self.width, fillchar)
+            case unknown:
+                raise ValueError(f"Unknown type '{unknown}' for text justify")
+        
         sys.stdout.write(text + end)
         sys.stdout.flush()
 
 
     def input(self,
-            prompt = '',
+            prompt: str = '',
             *,
-            style: str | None = None,
-            color: str | None = None,
-            password: bool = False) -> str:
+            password: bool = False,
+            justify: str = "left",
+            fillchar: str = " ") -> str:
         """
         Displays a prompt if have and waits for input from user.
 
         Args:
             prompt: text to render in prompt
-            style (str | None): style for prompt render. Required prompt
-            color (str | None): color for prompt render. Required prompt
             password (bool): if `True`, hide typed text. Default `False`
         Returns:
             result (str): typed text from user from stdin
         """
 
         if prompt:
-            self.print(prompt, style=style, color=color, end='')
+            self.print(prompt, end='', justify=justify, fillchar=fillchar)
 
         if password:
             # TODO: realize text hidding
-            Warning("This attribute in developing. Please, set 'password=False'")
+            result = getpass(prompt='')
         else:
             result = input()
         return result

{ttykit-0.3.7/src/ttykit → ttykit-0.4.0/src/ttykit/examples}/spinner.py

@@ -1,6 +1,6 @@
 import time
-from .status import Status, TaskState
-from ._state import STATUS_ANIMATION
+from ttykit.status import Status, TaskState
+from ttykit._state import STATUS_ANIMATION
 
 def show_all_spinners():
     for name in STATUS_ANIMATION.keys():

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/progress.py

@@ -1,5 +1,6 @@
 import sys
 from ._state import *
+import time
 
 class Progress:
     """
@@ -10,7 +11,8 @@ class Progress:
         prefix (str): some description of bar. Can be empty
         bar_length (int): how many characters in bar length. Default: 30
         bar_style: bar performance style. Default: `line`. Avaliable styles: `line`, `points`, `blocks`, `arrow`. 
-        frames (bool): use bracket or not. Default: False
+        frames (bool): use bracket or not. Default: `False`
+        show_ETA (bool): show ETA (Estimated Time of Arrival). Default: `True`
     Returns:
         None: write in the terminal
     Examples:
@@ -30,7 +32,7 @@ class Progress:
         Loading ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 40%
         ```
     """
-    def __init__(self, total: int=100, prefix: str=None, bar_length: int=30, bar_style='line', frames: bool=False):
+    def __init__(self, total: int=100, prefix: str=None, bar_length: int=30, bar_style='line', frames: bool=False, show_ETA: bool = True):
         self.total = total
         self.prefix = prefix if prefix else ""
         self.bar_length = bar_length
@@ -40,6 +42,10 @@ class Progress:
         self.bar_bg = temp['bg']
         self.current = 0
         self.finished = False
+        self.show_ETA = show_ETA
+
+        if self.show_ETA:
+            self.start_time = time.time()
 
     def __enter__(self):
         return self
@@ -66,7 +72,17 @@ class Progress:
         percent =  int(self.current / self.total * 100)
         filled = int(self.current / self.total * self.bar_length)
         bar = str(self.bar_filled) * filled + str(self.bar_bg) * (self.bar_length - filled)
-        sys.stdout.write(f"\r{self.prefix} {"[ " if self.frames else ""}{bar}{" ]" if self.frames else ""} {percent}%")
+
+        eta: str = " ETA: --:--:--" if self.show_ETA else ""
+        if self.show_ETA and self.current > 0:
+            elapsed = time.time() - self.start_time
+            rate = self.current / elapsed
+            seconds = (self.total - self.current) / rate
+            minutes, seconds = divmod(seconds, 60)
+            hours, minutes = divmod(minutes, 60)
+            eta = f" ETA: {int(hours):02d}:{int(minutes):02d}:{int(seconds):02d}"
+        
+        sys.stdout.write(f"\r{self.prefix} {"[ " if self.frames else ""}{bar}{" ]" if self.frames else ""} {percent}%{eta}")
         sys.stdout.flush()
 
     def stop(self):

ttykit-0.4.0/src/ttykit/segmentation.py

@@ -0,0 +1,97 @@
+import re
+from ._state import Styles, Colors
+
+
+class Segmentation:
+    """Split text into non-empty pieces using a regular expression."""
+
+    def __init__(self, text: str, separator: str = r"\s+"):
+        if not isinstance(text, str):
+            raise TypeError("text must be a string")
+
+        if not isinstance(separator, str):
+            raise TypeError("separator must be a regular expression string")
+
+        re.compile(separator)
+        self.text = text
+        self.separator = separator
+
+    def segment(self) -> list[str]:
+        """Return text pieces separated by the configured regular expression."""
+        return [
+            piece.strip()
+            for piece in re.split(self.separator, self.text)
+            if piece.strip()
+        ]
+
+    def __call__(self) -> list[str]:
+        """Segment the stored text."""
+        return self.segment()
+
+    def _apply_tag(self, tag: str, stack: list):
+        clean = tag.strip("[]").split()
+        for t in clean:
+            if t == "/":
+                stack.clear()
+            elif t.startswith("/"):
+                name = t[1:]
+                if name in stack:
+                    stack.remove(name)
+            else:
+                stack.append(t)
+
+    def _get_ansi_from_stack(self, stack: list) -> str:
+        ansi = ""
+        for style in stack:
+            ansi += Colors.get(style, "") + Styles.get(style, "")
+        return ansi
+
+    def auto_compile(self) -> str:
+        result = ""
+        style_stack = []
+        pos = 0
+        last_ansi = ""
+
+        for match in re.finditer(r"\[/?\w*(?:\s+\w+)*\]", self.text):
+            # Текст до тега
+            if match.start() > pos:
+                result += self.text[pos:match.start()]
+
+            # Обработка тега
+            tag = match.group()
+            self._apply_tag(tag, style_stack)
+
+            # Сброс предыдущих ANSI и применение новых
+            new_ansi = self._get_ansi_from_stack(style_stack)
+            if new_ansi != last_ansi:
+                result += Styles.RESET + new_ansi
+                last_ansi = new_ansi
+
+            pos = match.end()
+
+        # Остаток текста
+        if pos < len(self.text):
+            result += self.text[pos:]
+
+        result += Styles.RESET
+        return result
+
+    def clean_tag(self, tag: str) -> list:
+        """
+        Очищает тег от лишних символов и возвращает список стилей.
+        
+        Пример:
+            "[blue bold]" -> ["blue", "bold"]
+            "[/red]"      -> ["/red"]
+            "[/]"         -> ["/"]
+        """
+        # Убираем квадратные скобки
+        tag = tag.strip("[]")
+        
+        # Разбиваем по пробелам
+        parts = tag.split()
+        
+        # Убираем пустые строки
+        parts = [p for p in parts if p]
+        
+        return parts

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit/status.py

@@ -16,9 +16,9 @@ class Status:
     Examples:
     ### Realization:
     ```python
-    from ttykit import CustomStatus, TaskState
+    from ttykit import Status, TaskState
 
-    with CustomStatus("Unit Test 8", spinner="dots12") as status:
+    with Status("Unit Test 8", spinner="dots12") as status:
         # <task1>
         status.set_message("Unit Test 9")
         # <task2>
@@ -37,7 +37,7 @@ class Status:
     [  OK  ] Loading Unit Test 9
     ```
     """
-    def __init__(self, message: str, spinner="bar", color="CYAN"):
+    def __init__(self, message: str, spinner: str="bar", color="CYAN"):
         self.message = message
         self.color = color
         self.spinner = spinner
@@ -73,7 +73,7 @@ class Status:
         self.animation_thread.start()
 
     def _get_color(self):
-        return (Colors.CYAN if self.color == "CYAN" else Colors.GREEN if self.color == "GREEN" else Colors.RED)
+        return Colors.get(self.color, Colors.get('cyan'))
 
 
     def set_message(self, new_message: str):

ttykit-0.4.0/src/ttykit/tree.py

@@ -0,0 +1,58 @@
+from typing import List
+from ttykit.console.console import Console
+
+class Tree:
+    """Build tree and render in terminal
+    
+    Args:
+        label (str): name of current node.
+    Returns:
+        instance (self): instance of this class
+
+    ### Methods
+        add (label)
+            adding child tree in main
+        print ():
+            render tree in terminal
+    """
+    def __init__(self, label: str):
+        self.label = label
+        self.children: List["Tree"] = []
+        self.console = Console()
+
+    def add(self, label: str) -> "Tree":
+        """Adding child tree in current tree"""
+        child = Tree(label)
+        self.children.append(child)
+        return child
+
+    def _render(self, prefix: str = "", is_last: bool = True, is_root: bool = True) -> list:
+        """Rendering tree nodes with lines
+
+        Args:
+            prefix (str): name of node
+            is_last (bool): if `True`, use final line
+            is_root (bool): if `True`, node have root access
+        Returns:
+            lines (list): list of tree lines
+        """
+        lines = []
+
+        if is_root:
+            lines.append(self.label)
+            child_prefix = ""
+        else:
+            connector = "└── " if is_last else "├── "
+            lines.append(prefix + connector + self.label)
+            child_prefix = prefix + ("    " if is_last else "│   ")
+
+        for i, child in enumerate(self.children):
+            is_last_child = (i == len(self.children) - 1)
+            lines.extend(child._render(child_prefix, is_last_child, is_root=False))
+
+        return lines
+
+    def print(self):
+        """Render tree in terminal stream"""
+        for line in self._render():
+            self.console.print(line)

{ttykit-0.3.7 → ttykit-0.4.0/src/ttykit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ttykit
-Version: 0.3.7
+Version: 0.4.0
 Summary: Helping made beatiful out in terminal
 Author: He-STALIN
 Author-email: hene.stalin@gmail.com
@@ -46,60 +46,72 @@ Dynamic: license-file
 [![Python Version](https://img.shields.io/badge/python-3.13+-blue.svg)](https://python.org)
 [![GitHub license](https://img.shields.io/github/license/He-STALIN/ttykit)](LICENSE)
 [![Repository](https://img.shields.io/badge/Repository-GitHub-4b93ff?style=flat&logo=github&logoColor=white)](https://github.com/He-STALIN/ttykit)
+[![Downloads](https://img.shields.io/pypi/dm/ttykit)](https://pypi.org/project/ttykit/)
 
 </div>
 
+##### Вы из России? Смотрите [русскую версию](/docs/ru/README.ru.md)
+
 ---
 
-## 📦 For Start
+## For Start
 ### Manually:
-
-```bash
-git clone https://github.com/He-STALIN/ttykit.git
-```
+- Clone repository
+    ```bash
+    git clone https://github.com/He-STALIN/ttykit.git
+    ```
 
 - Change dir and exec
-
-```bash
-pip install .
-```
+    ```bash
+    pip install .
+    ```
 ### Auto
 - exec `pip install ttykit`
 
 - And use in your projects!
 
-## License
-- This lib uploading with MIT License [See License](LICENSE)
+## Support the project
+- If you would like the project to continue developing, you can make a [donation](https://yoomoney.ru/to/4100118618732284/100).
+- Account: `4100 1186 1873 2284` (YouMoney)
+- or
+- Find bugs in the library and report them in the `issues` section on GitHub.
 
 ## Code Examples
 
-### Status
-```python
-from ttykit import Status, TaskState
-
-with Status("Something unit", spinner="line") as status:
-    <some action>
-    status.set_state(TaskState.SUCCESS)
-```
-
-### Progress
-```python
-from ttykit import Progress
-
-with Progress(100, "Some desc", 40) as progress:
-    <some action>
-    progress.update(<value>)
-    <some action again>
-    progress.finish()
-```
-or
-```python
-with Progress(100, "Some desc", 40) as progress:
-    while not progress.finished:
-        <some actions>
-        progress.advance(<step>)
-        <maybe action again>
-```
+- ### Status
+    ```python
+    from ttykit import Status, TaskState
+
+    with Status("Something unit", spinner="line") as status:
+        <some action>
+        status.set_state(TaskState.SUCCESS)
+    ```
+
+- ### Progress
+    ```python
+    from ttykit import Progress
+
+    with Progress(100, "Some desc", 40) as progress:
+        <some action>
+        progress.update(<value>)
+        <some action again>
+        progress.finish()
+    ```
+
+- **for more code examples see** [CODE USE](docs/en/CODE_USE.md)
 
 ## Also
 - also you can use prepared colors in this lib
+
+## License
+- This lib uploading with MIT License. [See License](LICENSE)
+
+## Versions
+- You interesting see versions? You can see [CHANGELOG](docs/en/CHANGELOG.md)
+
+---
+<div align="center">
+
+*ttykit by He_STALIN. All right reserved*
+
+</div>

{ttykit-0.3.7 → ttykit-0.4.0}/src/ttykit.egg-info/SOURCES.txt

@@ -4,8 +4,9 @@ pyproject.toml
 src/ttykit/__init__.py
 src/ttykit/_state.py
 src/ttykit/progress.py
-src/ttykit/spinner.py
+src/ttykit/segmentation.py
 src/ttykit/status.py
+src/ttykit/tree.py
 src/ttykit.egg-info/PKG-INFO
 src/ttykit.egg-info/SOURCES.txt
 src/ttykit.egg-info/dependency_links.txt
@@ -14,4 +15,5 @@ src/ttykit.egg-info/requires.txt
 src/ttykit.egg-info/top_level.txt
 src/ttykit/console/TUI.py
 src/ttykit/console/console.py
-src/ttykit/console/const.py
+src/ttykit/console/const.py
+src/ttykit/examples/spinner.py

ttykit-0.4.0/src/ttykit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ttykit-spinner = ttykit.examples.spinner:main

ttykit-0.3.7/README.md

@@ -1,66 +0,0 @@
-<div align="center">
-
-# TTYKit
-
-> **Helping made beautiful out in terminal**
-
-[![Python Version](https://img.shields.io/badge/python-3.13+-blue.svg)](https://python.org)
-[![GitHub license](https://img.shields.io/github/license/He-STALIN/ttykit)](LICENSE)
-[![Repository](https://img.shields.io/badge/Repository-GitHub-4b93ff?style=flat&logo=github&logoColor=white)](https://github.com/He-STALIN/ttykit)
-
-</div>
-
----
-
-## 📦 For Start
-### Manually:
-
-```bash
-git clone https://github.com/He-STALIN/ttykit.git
-```
-
-- Change dir and exec
-
-```bash
-pip install .
-```
-### Auto
-- exec `pip install ttykit`
-
-- And use in your projects!
-
-## License
-- This lib uploading with MIT License [See License](LICENSE)
-
-## Code Examples
-
-### Status
-```python
-from ttykit import Status, TaskState
-
-with Status("Something unit", spinner="line") as status:
-    <some action>
-    status.set_state(TaskState.SUCCESS)
-```
-
-### Progress
-```python
-from ttykit import Progress
-
-with Progress(100, "Some desc", 40) as progress:
-    <some action>
-    progress.update(<value>)
-    <some action again>
-    progress.finish()
-```
-or
-```python
-with Progress(100, "Some desc", 40) as progress:
-    while not progress.finished:
-        <some actions>
-        progress.advance(<step>)
-        <maybe action again>
-```
-
-## Also
-- also you can use prepared colors in this lib

ttykit-0.3.7/src/ttykit.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-ttykit-spinner = ttykit.spinner:main