eapyTool 0.3.1__tar.gz → 0.3.2__tar.gz

{eapytool-0.3.1 → eapytool-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eapyTool
-Version: 0.3.1
+Version: 0.3.2
 Summary: A Python utility library for math, algebra, data structures, and everyday tools
 Project-URL: Homepage, https://github.com/eapy/eapy
 Project-URL: Repository, https://github.com/eapy/eapy
@@ -147,6 +147,11 @@ A Python utility library that extends the standard library with math, algebra, d
 ### Local Storage
 - `Storage` — persistent key-value store with subpath support
 
+### Colored Text
+- `Color` — ANSI color codes (foreground, background, styles)
+- `colorText(text, color, style, bg)` — return colored text string
+- `printColor(text, color, style, bg)` — print colored text
+
 ## Installation
 
 ```bash

{eapytool-0.3.1 → eapytool-0.3.2}/README.md

@@ -124,6 +124,11 @@ A Python utility library that extends the standard library with math, algebra, d
 ### Local Storage
 - `Storage` — persistent key-value store with subpath support
 
+### Colored Text
+- `Color` — ANSI color codes (foreground, background, styles)
+- `colorText(text, color, style, bg)` — return colored text string
+- `printColor(text, color, style, bg)` — print colored text
+
 ## Installation
 
 ```bash

{eapytool-0.3.1 → eapytool-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "eapyTool"
-version = "0.3.1"
+version = "0.3.2"
 description = "A Python utility library for math, algebra, data structures, and everyday tools"
 readme = "README.md"
 license = "MPL-2.0"

{eapytool-0.3.1 → eapytool-0.3.2}/src/eapy/__init__.py

@@ -1,6 +1,6 @@
 """eapy - A Python utility library for math, algebra, data structures, and everyday tools."""
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 
 from eapy.core import (
     # Timer
@@ -90,4 +90,6 @@ from eapy.core import (
     dotProduct, crossProduct, normalize,
     # Local storage
     Storage,
+    # Colored text
+    Color, colorText, printColor,
 )

{eapytool-0.3.1 → eapytool-0.3.2}/src/eapy/core.py

@@ -2188,4 +2188,63 @@ class Storage:
             os.makedirs(self.base_path, exist_ok=True)
 
     def __repr__(self):
-        return f"Storage(base_path='{self.base_path}')"
+        return f"Storage(base_path='{self.base_path}')"
+
+
+# ======================================================== Colored text ========================================================
+
+class Color:
+    """ANSI color codes for terminal output."""
+    RESET = "\033[0m"
+    # Foreground colors
+    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 foreground
+    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"
+    # Styles
+    BOLD = "\033[1m"
+    DIM = "\033[2m"
+    ITALIC = "\033[3m"
+    UNDERLINE = "\033[4m"
+    # Background colors
+    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"
+
+
+def colorText(text: str, color: str = "", style: str = "", bg: str = "") -> str:
+    """Return text wrapped with ANSI color codes.
+    
+    Args:
+        text: The text to colorize.
+        color: Foreground color (e.g., Color.RED, Color.BLUE).
+        style: Style (e.g., Color.BOLD, Color.UNDERLINE).
+        bg: Background color (e.g., Color.BG_RED).
+    
+    Returns:
+        Colored text string.
+    """
+    codes = style + bg + color
+    return f"{codes}{text}{Color.RESET}"
+
+
+def printColor(text: str, color: str = "", style: str = "", bg: str = ""):
+    """Print colored text to terminal."""
+    print(colorText(text, color, style, bg))

{eapytool-0.3.1 → eapytool-0.3.2}/tests/test_core.py

@@ -36,6 +36,7 @@ from eapy.core import (
     isNumber, isString, isList, isDict, isCallable,
     dotProduct, crossProduct, normalize,
     Storage,
+    Color, colorText, printColor,
 )
 from math import pi
 import os
@@ -725,3 +726,27 @@ class TestStorage:
         self.store.set("x", 1)
         self.store.clear()
         assert self.store.exists("x") is False
+
+
+# ======================================================== Colored text ========================================================
+
+class TestColor:
+    def test_colorText(self):
+        result = colorText("hello", Color.RED)
+        assert Color.RED in result
+        assert Color.RESET in result
+        assert "hello" in result
+
+    def test_colorText_with_style(self):
+        result = colorText("bold", Color.GREEN, Color.BOLD)
+        assert Color.BOLD in result
+        assert Color.GREEN in result
+
+    def test_colorText_with_bg(self):
+        result = colorText("bg", bg=Color.BG_BLUE)
+        assert Color.BG_BLUE in result
+
+    def test_printColor(self, capsys):
+        printColor("test", Color.YELLOW)
+        captured = capsys.readouterr()
+        assert "test" in captured.out