termcraft 0.1.0__py3-none-any.whl

termcraft/__init__.py

@@ -0,0 +1,25 @@
+from .colors import colorize, Colors
+from .styles import set_theme, get_theme
+from .banners import title, success, error, warning, info
+from .borders import draw_line, separator
+from .boxes import message
+from .tables import dict_ui, table
+from .lists import bullet, numbered
+from .trees import tree
+from .progress import progress, spinner
+from .jsonview import json_view
+from .icons import icon
+
+__all__ = [
+    "colorize", "Colors",
+    "set_theme", "get_theme",
+    "title", "success", "error", "warning", "info",
+    "draw_line", "separator",
+    "message",
+    "dict_ui", "table",
+    "bullet", "numbered",
+    "tree",
+    "progress", "spinner",
+    "json_view",
+    "icon"
+]

termcraft/banners.py

@@ -0,0 +1,32 @@
+from .styles import get_theme
+from .colors import colorize
+
+def title(text: str, color: str = "cyan", align: str = "left", width: int = 50):
+    theme = get_theme()
+    top = theme["tl"] + theme["h"] * (width - 2) + theme["tr"]
+    bottom = theme["bl"] + theme["h"] * (width - 2) + theme["br"]
+    
+    if align == "center":
+        content = text.center(width - 4)
+    elif align == "right":
+        content = text.rjust(width - 4)
+    else:
+        content = text.ljust(width - 4)
+        
+    middle = f"{theme['v']} {content} {theme['v']}"
+    
+    print(colorize(top, color))
+    print(colorize(middle, color, bold=True))
+    print(colorize(bottom, color))
+
+def success(text: str):
+    print(colorize(f"✔ {text}", color="green", bold=True))
+
+def error(text: str):
+    print(colorize(f"✖ {text}", color="red", bold=True))
+
+def warning(text: str):
+    print(colorize(f"⚠ {text}", color="yellow", bold=True))
+
+def info(text: str):
+    print(colorize(f"ℹ {text}", color="blue", bold=True))

termcraft/borders.py

@@ -0,0 +1,13 @@
+from .styles import get_theme
+from .colors import colorize
+
+def draw_line(length: int = 50, color: str = "") -> str:
+    theme = get_theme()
+    line = theme["h"] * length
+    return colorize(line, color)
+
+def separator(length: int = 50, color: str = "black", bold: bool = True) -> str:
+    # Use bold black as a dim color if the terminal supports it
+    theme = get_theme()
+    line = theme["h"] * length
+    return colorize(line, color, bold=bold)

termcraft/boxes.py

@@ -0,0 +1,21 @@
+from .styles import get_theme
+from .colors import colorize
+
+def message(text: str, title: str = "", color: str = "", width: int = 50):
+    theme = get_theme()
+    top = theme["tl"] + theme["h"] * (width - 2) + theme["tr"]
+    if title:
+        title_str = f" {title} "
+        if len(title_str) < width - 2:
+            top = theme["tl"] + theme["h"] + title_str + theme["h"] * (width - 3 - len(title_str)) + theme["tr"]
+            
+    bottom = theme["bl"] + theme["h"] * (width - 2) + theme["br"]
+    
+    import textwrap
+    lines = textwrap.wrap(text, width - 4)
+    
+    print(colorize(top, color))
+    for line in lines:
+        content = line.ljust(width - 4)
+        print(colorize(f"{theme['v']} {content} {theme['v']}", color))
+    print(colorize(bottom, color))

termcraft/colors.py

@@ -0,0 +1,41 @@
+import sys
+import colorama
+from colorama import Fore, Back, Style
+
+# Initialize colorama for Windows support
+colorama.init(autoreset=True)
+
+# Force UTF-8 encoding on Windows to prevent UnicodeEncodeError
+if sys.stdout.encoding.lower() != "utf-8" and hasattr(sys.stdout, "reconfigure"):
+    sys.stdout.reconfigure(encoding="utf-8")
+
+class Colors:
+    RESET = Style.RESET_ALL
+    BOLD = Style.BRIGHT
+    DIM = Style.DIM
+    NORMAL = Style.NORMAL
+
+    BLACK = Fore.BLACK
+    RED = Fore.RED
+    GREEN = Fore.GREEN
+    YELLOW = Fore.YELLOW
+    BLUE = Fore.BLUE
+    MAGENTA = Fore.MAGENTA
+    CYAN = Fore.CYAN
+    WHITE = Fore.WHITE
+    
+    BG_BLACK = Back.BLACK
+    BG_RED = Back.RED
+    BG_GREEN = Back.GREEN
+    BG_YELLOW = Back.YELLOW
+    BG_BLUE = Back.BLUE
+    BG_MAGENTA = Back.MAGENTA
+    BG_CYAN = Back.CYAN
+    BG_WHITE = Back.WHITE
+
+def colorize(text: str, color: str = "", bg: str = "", bold: bool = False) -> str:
+    res = ""
+    if color: res += getattr(Colors, color.upper(), "")
+    if bg: res += getattr(Colors, f"BG_{bg.upper()}", "")
+    if bold: res += Colors.BOLD
+    return f"{res}{text}{Colors.RESET}"

termcraft/emoji/__init__.py

@@ -0,0 +1,17 @@
+from .emoji import emoji
+from .status import success_emoji, error_emoji, loading_emoji, build_emoji, deploy_emoji
+from .banner import emoji_banner
+from .loader import emoji_spinner
+from .weather import sun, rain, cloud, snow
+from .react import thumbs_up, fire, clap, idea
+from .sets import tech, education, finance, ai
+
+__all__ = [
+    "emoji",
+    "success_emoji", "error_emoji", "loading_emoji", "build_emoji", "deploy_emoji",
+    "emoji_banner",
+    "emoji_spinner",
+    "sun", "rain", "cloud", "snow",
+    "thumbs_up", "fire", "clap", "idea",
+    "tech", "education", "finance", "ai"
+]

termcraft/emoji/banner.py

@@ -0,0 +1,7 @@
+from ..banners import title
+from .emoji import emoji
+
+def emoji_banner(text: str, icon: str = "rocket", color: str = "cyan", align: str = "center"):
+    e = emoji(icon)
+    styled_text = f"{e} {text} {e}"
+    title(styled_text, color=color, align=align)

termcraft/emoji/emoji.py

@@ -0,0 +1,24 @@
+EMOJIS = {
+    "rocket": "🚀",
+    "check": "✅",
+    "warning": "⚠️",
+    "error": "❌",
+    "info": "ℹ️",
+    "fire": "🔥",
+    "clap": "👏",
+    "idea": "💡",
+    "thumbs_up": "👍",
+    "sun": "☀️",
+    "rain": "🌧️",
+    "cloud": "☁️",
+    "snow": "❄️",
+    "gear": "⚙️",
+    "computer": "💻",
+    "book": "📚",
+    "money": "💰",
+    "robot": "🤖",
+    "brain": "🧠"
+}
+
+def emoji(name: str, fallback: str = "") -> str:
+    return EMOJIS.get(name, fallback or name)

termcraft/emoji/loader.py

@@ -0,0 +1,14 @@
+import sys
+import time
+from ..colors import colorize
+
+def emoji_spinner(text: str = "Loading...", duration: int = 3):
+    emojis = ["🕛", "🕐", "🕑", "🕒", "🕓", "🕔", "🕕", "🕖", "🕗", "🕘", "🕙", "🕚"]
+    end_time = time.time() + duration
+    i = 0
+    while time.time() < end_time:
+        sys.stdout.write(f"\r{emojis[i]} {text}")
+        sys.stdout.flush()
+        time.sleep(0.1)
+        i = (i + 1) % len(emojis)
+    sys.stdout.write(f"\r{colorize('✅', 'green')} {text} (Done) \n")

termcraft/emoji/react.py

@@ -0,0 +1,6 @@
+from .emoji import emoji
+
+def thumbs_up() -> str: return emoji("thumbs_up")
+def fire() -> str: return emoji("fire")
+def clap() -> str: return emoji("clap")
+def idea() -> str: return emoji("idea")

termcraft/emoji/sets.py

@@ -0,0 +1,13 @@
+from .emoji import emoji
+
+def tech() -> list:
+    return [emoji("computer"), emoji("gear"), emoji("rocket")]
+
+def education() -> list:
+    return [emoji("book"), emoji("idea"), emoji("brain")]
+
+def finance() -> list:
+    return [emoji("money"), "📈", "🏦"]
+
+def ai() -> list:
+    return [emoji("robot"), emoji("brain"), emoji("rocket")]

termcraft/emoji/status.py

@@ -0,0 +1,7 @@
+from .emoji import emoji
+
+def success_emoji() -> str: return emoji("check")
+def error_emoji() -> str: return emoji("error")
+def loading_emoji() -> str: return "⏳"
+def build_emoji() -> str: return emoji("gear")
+def deploy_emoji() -> str: return emoji("rocket")

termcraft/emoji/weather.py

@@ -0,0 +1,6 @@
+from .emoji import emoji
+
+def sun() -> str: return emoji("sun")
+def rain() -> str: return emoji("rain")
+def cloud() -> str: return emoji("cloud")
+def snow() -> str: return emoji("snow")

termcraft/icons.py

@@ -0,0 +1,16 @@
+ICONS = {
+    "check": "✔",
+    "cross": "✖",
+    "warning": "⚠",
+    "info": "ℹ",
+    "arrow_right": "➔",
+    "star": "★",
+    "heart": "♥",
+    "bullet": "•",
+    "square": "■",
+    "triangle_right": "▶",
+    "triangle_down": "▼"
+}
+
+def icon(name: str) -> str:
+    return ICONS.get(name, "?")

termcraft/jsonview.py

@@ -0,0 +1,20 @@
+import json
+from .colors import colorize
+
+def json_view(data: dict, indent: int = 2):
+    formatted = json.dumps(data, indent=indent)
+    
+    lines = formatted.split("\n")
+    for i, line in enumerate(lines):
+        if ":" in line:
+            parts = line.split(":", 1)
+            key = parts[0]
+            val = parts[1]
+            key = colorize(key, "cyan", bold=True)
+            if '"' in val:
+                val = colorize(val, "green")
+            elif any(c.isdigit() for c in val) and not ("true" in val or "false" in val or "null" in val):
+                val = colorize(val, "blue")
+            lines[i] = f"{key}:{val}"
+    
+    print("\n".join(lines))

termcraft/lists.py

@@ -0,0 +1,9 @@
+from .colors import colorize
+
+def bullet(items: list, color: str = "cyan", bullet_char: str = "•"):
+    for item in items:
+        print(f"{colorize(bullet_char, color)} {item}")
+
+def numbered(items: list, color: str = "cyan"):
+    for i, item in enumerate(items, 1):
+        print(f"{colorize(str(i) + '.', color)} {item}")

termcraft/progress.py

@@ -0,0 +1,24 @@
+import sys
+import time
+from .colors import colorize
+
+def progress(percent: int, length: int = 40, color: str = "cyan", text: str = "Progress"):
+    percent = max(0, min(100, percent))
+    filled_len = int(length * percent // 100)
+    bar = "█" * filled_len + "░" * (length - filled_len)
+    
+    sys.stdout.write(f"\r{text} |{colorize(bar, color)}| {percent}% Complete")
+    sys.stdout.flush()
+    if percent == 100:
+        print()
+
+def spinner(text: str = "Loading...", duration: int = 3, color: str = "cyan"):
+    chars = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+    end_time = time.time() + duration
+    i = 0
+    while time.time() < end_time:
+        sys.stdout.write(f"\r{colorize(chars[i], color)} {text}")
+        sys.stdout.flush()
+        time.sleep(0.1)
+        i = (i + 1) % len(chars)
+    sys.stdout.write(f"\r{colorize('✔', 'green')} {text} (Done) \n")

termcraft/styles.py

@@ -0,0 +1,30 @@
+THEMES = {
+    "ascii": {
+        "tl": "+", "tr": "+", "bl": "+", "br": "+",
+        "h": "-", "v": "|", "t_down": "+", "t_up": "+", "t_right": "+", "t_left": "+", "cross": "+"
+    },
+    "minimal": {
+        "tl": "┌", "tr": "┐", "bl": "└", "br": "┘",
+        "h": "─", "v": "│", "t_down": "┬", "t_up": "┴", "t_right": "├", "t_left": "┤", "cross": "┼"
+    },
+    "unicode": {
+        "tl": "╭", "tr": "╮", "bl": "╰", "br": "╯",
+        "h": "─", "v": "│", "t_down": "┬", "t_up": "┴", "t_right": "├", "t_left": "┤", "cross": "┼"
+    },
+    "double": {
+        "tl": "╔", "tr": "╗", "bl": "╚", "br": "╝",
+        "h": "═", "v": "║", "t_down": "╦", "t_up": "╩", "t_right": "╠", "t_left": "╣", "cross": "╬"
+    }
+}
+
+ACTIVE_THEME = "unicode"
+
+def set_theme(theme_name: str):
+    global ACTIVE_THEME
+    if theme_name in THEMES:
+        ACTIVE_THEME = theme_name
+    else:
+        raise ValueError(f"Theme '{theme_name}' not found. Available themes: {', '.join(THEMES.keys())}")
+
+def get_theme() -> dict:
+    return THEMES[ACTIVE_THEME]

termcraft/tables.py

@@ -0,0 +1,70 @@
+from .styles import get_theme
+from .colors import colorize
+
+def dict_ui(data: dict, title: str = "", color: str = "cyan", key_color: str = "white", val_color: str = "yellow"):
+    theme = get_theme()
+    if not data:
+        return
+        
+    max_key_len = max(len(str(k)) for k in data.keys())
+    max_val_len = max(len(str(v)) for v in data.values())
+    
+    width = max_key_len + max_val_len + 7
+    if title:
+        width = max(width, len(title) + 6)
+        
+    top = theme["tl"] + theme["h"] * (width - 2) + theme["tr"]
+    if title:
+        title_str = f" {title} "
+        top = theme["tl"] + theme["h"] + title_str + theme["h"] * (width - 3 - len(title_str)) + theme["tr"]
+
+    bottom = theme["bl"] + theme["h"] * (width - 2) + theme["br"]
+    
+    print(colorize(top, color))
+    for k, v in data.items():
+        k_str = str(k).ljust(max_key_len)
+        v_str = str(v).ljust(max_val_len)
+        # Construct border with main color, content with respective colors
+        line_start = colorize(f"{theme['v']} ", color)
+        line_mid = f"{colorize(k_str, key_color)} : {colorize(v_str, val_color)}"
+        line_end = colorize(f" {theme['v']}", color)
+        print(line_start + line_mid + line_end)
+    print(colorize(bottom, color))
+    
+def table(headers: list, rows: list, color: str = "cyan"):
+    theme = get_theme()
+    
+    col_widths = [len(str(h)) for h in headers]
+    for row in rows:
+        for i, val in enumerate(row):
+            if i < len(col_widths):
+                col_widths[i] = max(col_widths[i], len(str(val)))
+            else:
+                col_widths.append(len(str(val)))
+                
+    def make_separator(left, middle, right):
+        parts = [theme["h"] * (w + 2) for w in col_widths]
+        return left + middle.join(parts) + right
+        
+    top = make_separator(theme["tl"], theme["t_down"], theme["tr"])
+    mid = make_separator(theme["t_right"], theme["cross"], theme["t_left"])
+    bot = make_separator(theme["bl"], theme["t_up"], theme["br"])
+    
+    def print_row(data, is_header=False):
+        parts = []
+        for i, val in enumerate(data):
+            width = col_widths[i] if i < len(col_widths) else len(str(val))
+            content = str(val).ljust(width)
+            if is_header:
+                content = colorize(content, bold=True)
+            parts.append(f" {content} ")
+        
+        v_bar = colorize(theme["v"], color)
+        print(v_bar + v_bar.join(parts) + v_bar)
+        
+    print(colorize(top, color))
+    print_row(headers, True)
+    print(colorize(mid, color))
+    for row in rows:
+        print_row(row)
+    print(colorize(bot, color))

termcraft/trees.py

@@ -0,0 +1,18 @@
+from .colors import colorize
+
+def tree(data: dict, prefix: str = ""):
+    """
+    Recursively renders a dictionary as a tree.
+    """
+    keys = list(data.keys())
+    for i, key in enumerate(keys):
+        is_last = (i == len(keys) - 1)
+        connector = "└── " if is_last else "├── "
+        
+        value = data[key]
+        if isinstance(value, dict):
+            print(f"{prefix}{colorize(connector, 'cyan')}{colorize(str(key), 'blue', bold=True)}")
+            extension = "    " if is_last else "│   "
+            tree(value, prefix + colorize(extension, 'cyan'))
+        else:
+            print(f"{prefix}{colorize(connector, 'cyan')}{key}: {value}")

termcraft-0.1.0.dist-info/METADATA

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: termcraft
+Version: 0.1.0
+Summary: A lightweight Python library for creating beautiful, consistent terminal output for CLI applications.
+Home-page: https://github.com/yourusername/termcraft
+Author: Engr. Aamir Jamil
+Author-email: author@example.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: colorama>=0.4.6
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TermCraft
+
+**TermCraft** is a lightweight Python library designed to craft beautiful, professional, and consistent terminal user interfaces for CLI applications.
+
+*Created by **Engr. Aamir Jamil**.*
+
+## Features
+- **Colors & Styles:** Easily apply ANSI colors and styles, completely cross-platform.
+- **Banners & Boxes:** Draw beautiful headers, message boxes, and separators.
+- **Tables & Lists:** Format dictionaries and list data dynamically.
+- **Emoji System:** Extensive built-in emoji lookup, presets, and spinners.
+- **Progress:** Progress bars and animated loaders.
+
+## Installation
+
+```bash
+pip install termcraft
+```
+
+## Quick Start
+
+```python
+from termcraft import *
+
+title("My AI Project")
+success("Model Trained Successfully")
+dict_ui({"Accuracy": "98%", "Loss": "0.02"})
+progress(75)
+```
+
+## Requirements
+- Python 3.10+
+- `colorama` (installed automatically)
+
+## License
+MIT License

termcraft-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+termcraft/__init__.py,sha256=k3FWBRPopAHmo8RaGDYRHdyq-oAXZiOQW_JZGYLIX7k,681
+termcraft/banners.py,sha256=XW7epiT_vjr452Z5847GHjJllhtO5n_WVrqKgUWoGic,999
+termcraft/borders.py,sha256=s5bIPyZOq-h6_Hcnf_Q4bkOyPqu-5s4uVXH2me75Ozo,450
+termcraft/boxes.py,sha256=aMZc2qGrvL32p8RE4rbTFA9QPqu4nBXJimoCTodRQ7k,774
+termcraft/colors.py,sha256=yqkhBJgTRuMKmdqWC5JNpHeHGAySeZ-16XGvJv7roaI,1121
+termcraft/icons.py,sha256=07QczqNVg1lagIxRQpuiYLQHsFzkdJcjVmTB67fNb0A,317
+termcraft/jsonview.py,sha256=InbpIILCqpGjhc8mOwQr3ZIAIuytcEvg6kxYgZX7bkQ,672
+termcraft/lists.py,sha256=oMHOhPZYkpfzVKkIo35HqiRX-GTMQZciagHgKWOLsUw,327
+termcraft/progress.py,sha256=dy18vzHox5l6pfJJrvGKvE5bNqBEUzHya0JrMNfklww,903
+termcraft/styles.py,sha256=1GeEdvtXFAIMSSR9Ww5Qg5SdgfAtiPxo0s2V1SCJZ60,1099
+termcraft/tables.py,sha256=Q46df6pnTeR9ldF_xSzdzWFCUiUm18Jh0Wb52IjTlVo,2638
+termcraft/trees.py,sha256=XQFReIfgHEjJLVvs-iN-Qrcv9rx6DZMkm2B7j_Jx1vs,675
+termcraft/emoji/__init__.py,sha256=VlTiHYZ2z0d0xrzMwCSF9zKj1wyniiR2kOxrCoYo0zY,590
+termcraft/emoji/banner.py,sha256=oB-8jhR_9aAPae-TrC9T9IuwgBQB2WNYM19RMLJIbi4,254
+termcraft/emoji/emoji.py,sha256=WWI-jLo0kNbIiO-XAcg7-HEuRx7IuGFf4z9ZxFAXZBk,520
+termcraft/emoji/loader.py,sha256=wx3lcD-SBXz9ZLx4F-QYWKCkCNh_ioy6We1jifPtSu4,516
+termcraft/emoji/react.py,sha256=tG7tt9dgvJ85USy4FEj6WWIUFNxozlNa_5x785C_Ljk,196
+termcraft/emoji/sets.py,sha256=rDVag5uaQOLnf9mzAvoko3nZZQq0C-jKRAdxpQF7-C0,341
+termcraft/emoji/status.py,sha256=k00ff43tAPaLsJUWHx-OLtAZXSR4CL_TgnW2Z9SRg10,262
+termcraft/emoji/weather.py,sha256=Igpu7W2fZpCM5I2szjh-rjEC5p2XdIKuAGWuajFtoV8,186
+termcraft-0.1.0.dist-info/METADATA,sha256=6kZtmYocUBAlYB4kPvslPA7F4fsDdh8GzySnB4KyoGI,1864
+termcraft-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+termcraft-0.1.0.dist-info/top_level.txt,sha256=DplsfqdCzmEzGDmB1vINrrvca7jNmjhLVUQc8EXtmqc,10
+termcraft-0.1.0.dist-info/RECORD,,

termcraft-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

termcraft-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+termcraft