bx-ui 1.0.0__tar.gz

bx_ui-1.0.0/LICENSE

@@ -0,0 +1,11 @@
+MIT License
+
+Copyright (c) 2026 BXCode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files, to deal in the Software
+without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the
+Software, and to permit persons to whom the Software is furnished to do so.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

bx_ui-1.0.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: bx-ui
+Version: 1.0.0
+Summary: Modern Arabic and English terminal UI toolkit for Python
+Author: BXCode
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# bx-ui
+
+Modern Arabic and English terminal UI toolkit for Python.
+
+## Install
+
+```bash
+pip install bx-ui
+```
+
+## Example
+
+```python
+from bx_ui import (
+    عرض,
+    نجاح,
+    قائمة,
+    جدول,
+    تقدم,
+)
+
+عرض("لوحة التحكم")
+
+اختيار = قائمة(
+    "اختر العملية:",
+    [
+        "إضافة مستخدم",
+        "عرض المستخدمين",
+        "خروج",
+    ],
+)
+
+if اختيار == 1:
+    نجاح("تمت إضافة المستخدم")
+
+elif اختيار == 2:
+    جدول(
+        ["ID", "الاسم", "العمر"],
+        [
+            [1, "حسين", 20],
+            [2, "علي", 19],
+        ],
+    )
+
+تقدم(total=20, delay=0.03)
+```
+
+## English API
+
+```python
+from bx_ui import title, success, menu, table, progress
+
+title("Dashboard")
+
+choice = menu(
+    "Choose an action:",
+    ["Add user", "Users", "Exit"],
+)
+
+success("Done")
+```
+
+## Features
+
+- Arabic API aliases
+- English API
+- Menus
+- Tables
+- Success, info, warning and error messages
+- Confirm prompts
+- Progress bars
+- Spinners
+- Boxes and sections
+- Terminal clearing
+- Works with Python 3.9+
+- No third-party runtime dependencies
+
+## Arabic API
+
+| Arabic | English |
+|---|---|
+| عرض | title |
+| قسم | section |
+| معلومة | info |
+| نجاح | success |
+| تحذير | warning |
+| خطأ | error |
+| قائمة | menu |
+| تأكيد | confirm |
+| جدول | table |
+| تقدم | progress |
+| تحميل | spinner |
+| صندوق | box |
+| مسح | clear |
+| توقف | pause |
+| اسأل | ask |
+| لغة | set_language |
+
+## License
+
+MIT

bx_ui-1.0.0/README.md

@@ -0,0 +1,101 @@
+# bx-ui
+
+Modern Arabic and English terminal UI toolkit for Python.
+
+## Install
+
+```bash
+pip install bx-ui
+```
+
+## Example
+
+```python
+from bx_ui import (
+    عرض,
+    نجاح,
+    قائمة,
+    جدول,
+    تقدم,
+)
+
+عرض("لوحة التحكم")
+
+اختيار = قائمة(
+    "اختر العملية:",
+    [
+        "إضافة مستخدم",
+        "عرض المستخدمين",
+        "خروج",
+    ],
+)
+
+if اختيار == 1:
+    نجاح("تمت إضافة المستخدم")
+
+elif اختيار == 2:
+    جدول(
+        ["ID", "الاسم", "العمر"],
+        [
+            [1, "حسين", 20],
+            [2, "علي", 19],
+        ],
+    )
+
+تقدم(total=20, delay=0.03)
+```
+
+## English API
+
+```python
+from bx_ui import title, success, menu, table, progress
+
+title("Dashboard")
+
+choice = menu(
+    "Choose an action:",
+    ["Add user", "Users", "Exit"],
+)
+
+success("Done")
+```
+
+## Features
+
+- Arabic API aliases
+- English API
+- Menus
+- Tables
+- Success, info, warning and error messages
+- Confirm prompts
+- Progress bars
+- Spinners
+- Boxes and sections
+- Terminal clearing
+- Works with Python 3.9+
+- No third-party runtime dependencies
+
+## Arabic API
+
+| Arabic | English |
+|---|---|
+| عرض | title |
+| قسم | section |
+| معلومة | info |
+| نجاح | success |
+| تحذير | warning |
+| خطأ | error |
+| قائمة | menu |
+| تأكيد | confirm |
+| جدول | table |
+| تقدم | progress |
+| تحميل | spinner |
+| صندوق | box |
+| مسح | clear |
+| توقف | pause |
+| اسأل | ask |
+| لغة | set_language |
+
+## License
+
+MIT

bx_ui-1.0.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bx-ui"
+version = "1.0.0"
+description = "Modern Arabic and English terminal UI toolkit for Python"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    {name = "BXCode"}
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

bx_ui-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bx_ui-1.0.0/src/bx_ui/__init__.py

@@ -0,0 +1,38 @@
+from .core import (
+    title,
+    section,
+    info,
+    success,
+    warning,
+    error,
+    menu,
+    confirm,
+    table,
+    progress,
+    spinner,
+    box,
+    clear,
+    pause,
+    ask,
+    set_language,
+)
+
+__version__ = "1.0.0"
+
+# Arabic API
+عرض = title
+قسم = section
+معلومة = info
+نجاح = success
+تحذير = warning
+خطأ = error
+قائمة = menu
+تأكيد = confirm
+جدول = table
+تقدم = progress
+تحميل = spinner
+صندوق = box
+مسح = clear
+توقف = pause
+اسأل = ask
+لغة = set_language

bx_ui-1.0.0/src/bx_ui/core.py

@@ -0,0 +1,178 @@
+import os
+import sys
+import time
+from shutil import get_terminal_size
+
+_LANG = "ar"
+
+
+def set_language(language="ar"):
+    global _LANG
+    language = str(language).lower()
+    if language not in ("ar", "en"):
+        raise ValueError("language must be 'ar' or 'en'")
+    _LANG = language
+
+
+def _t(ar, en):
+    return ar if _LANG == "ar" else en
+
+
+def _width():
+    return max(40, get_terminal_size((80, 20)).columns)
+
+
+def _line(char="─"):
+    return char * min(_width(), 80)
+
+
+def clear():
+    os.system("cls" if os.name == "nt" else "clear")
+
+
+def title(text, icon="✦"):
+    width = min(_width(), 80)
+    inner = max(10, width - 4)
+    text = str(text)
+    print("╔" + "═" * (inner + 2) + "╗")
+    print(f"║ {icon} {text[:inner - 2]:<{inner - 2}} ║")
+    print("╚" + "═" * (inner + 2) + "╝")
+
+
+def section(text):
+    print()
+    print(f"── {text} " + "─" * max(0, min(_width() - len(str(text)) - 5, 60)))
+
+
+def _message(icon, label, text):
+    print(f"{icon} {label}: {text}")
+
+
+def info(text):
+    _message("ℹ", _t("معلومة", "Info"), text)
+
+
+def success(text):
+    _message("✓", _t("نجاح", "Success"), text)
+
+
+def warning(text):
+    _message("⚠", _t("تحذير", "Warning"), text)
+
+
+def error(text):
+    _message("✗", _t("خطأ", "Error"), text)
+
+
+def ask(prompt, default=None):
+    suffix = f" [{default}]" if default is not None else ""
+    value = input(f"? {prompt}{suffix}: ")
+    if not value and default is not None:
+        return default
+    return value
+
+
+def confirm(prompt, default=False):
+    hint = "Y/n" if default else "y/N"
+    value = input(f"? {prompt} ({hint}): ").strip().lower()
+    if not value:
+        return default
+    return value in ("y", "yes", "نعم", "ن")
+
+
+def menu(prompt, options, start=1):
+    options = list(options)
+    print()
+    print(f"╭─ {prompt}")
+    for index, option in enumerate(options, start):
+        print(f"│ {index}. {option}")
+    print("╰" + "─" * min(max(len(str(prompt)) + 3, 20), _width() - 1))
+
+    while True:
+        raw = input("> ").strip()
+        try:
+            choice = int(raw)
+            if start <= choice < start + len(options):
+                return choice
+        except ValueError:
+            pass
+        error(_t("اختيار غير صحيح، حاول مرة ثانية.", "Invalid choice, try again."))
+
+
+def box(text, title_text=None, padding=1):
+    lines = str(text).splitlines() or [""]
+    longest = max(len(line) for line in lines)
+    width = min(max(longest + padding * 2, 20), min(_width(), 80) - 2)
+    if title_text:
+        print(f"╭─ {title_text} " + "─" * max(0, width - len(str(title_text)) - 4) + "╮")
+    else:
+        print("╭" + "─" * width + "╮")
+    for line in lines:
+        print("│" + " " * padding + line[:width - padding * 2].ljust(width - padding * 2) + " " * padding + "│")
+    print("╰" + "─" * width + "╯")
+
+
+def table(headers, rows):
+    headers = [str(x) for x in headers]
+    rows = [[str(x) for x in row] for row in rows]
+    columns = len(headers)
+    if any(len(row) != columns for row in rows):
+        raise ValueError("Each row must have the same number of columns as headers.")
+
+    widths = [len(headers[i]) for i in range(columns)]
+    for row in rows:
+        for i, value in enumerate(row):
+            widths[i] = max(widths[i], len(value))
+
+    def sep(left, middle, right):
+        return left + middle.join("─" * (w + 2) for w in widths) + right
+
+    def row(values):
+        return "│" + "│".join(f" {values[i]:<{widths[i]}} " for i in range(columns)) + "│"
+
+    print(sep("┌", "┬", "┐"))
+    print(row(headers))
+    print(sep("├", "┼", "┤"))
+    for item in rows:
+        print(row(item))
+    print(sep("└", "┴", "┘"))
+
+
+def progress(total=100, width=30, prefix=None, show_percent=True, delay=0):
+    total = max(1, int(total))
+    width = max(5, int(width))
+    prefix = prefix if prefix is not None else _t("التقدم", "Progress")
+
+    for current in range(total + 1):
+        ratio = current / total
+        filled = int(width * ratio)
+        bar = "█" * filled + "░" * (width - filled)
+        percent = f" {int(ratio * 100):3d}%" if show_percent else ""
+        print(f"\r{prefix}: [{bar}]{percent}", end="", flush=True)
+        if delay:
+            time.sleep(delay)
+
+    print()
+
+
+def spinner(seconds=2, text_value=None, interval=0.1):
+    text_value = text_value or _t("جاري التحميل", "Loading")
+    frames = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+    end = time.time() + max(0, seconds)
+
+    if seconds <= 0:
+        print(f"{text_value} ✓")
+        return
+
+    index = 0
+    while time.time() < end:
+        print(f"\r{frames[index % len(frames)]} {text_value}", end="", flush=True)
+        time.sleep(interval)
+        index += 1
+
+    print(f"\r✓ {text_value}" + " " * 10)
+
+
+def pause(text=None):
+    text = text or _t("اضغط Enter للمتابعة...", "Press Enter to continue...")
+    input(text)

bx_ui-1.0.0/src/bx_ui.egg-info/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: bx-ui
+Version: 1.0.0
+Summary: Modern Arabic and English terminal UI toolkit for Python
+Author: BXCode
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# bx-ui
+
+Modern Arabic and English terminal UI toolkit for Python.
+
+## Install
+
+```bash
+pip install bx-ui
+```
+
+## Example
+
+```python
+from bx_ui import (
+    عرض,
+    نجاح,
+    قائمة,
+    جدول,
+    تقدم,
+)
+
+عرض("لوحة التحكم")
+
+اختيار = قائمة(
+    "اختر العملية:",
+    [
+        "إضافة مستخدم",
+        "عرض المستخدمين",
+        "خروج",
+    ],
+)
+
+if اختيار == 1:
+    نجاح("تمت إضافة المستخدم")
+
+elif اختيار == 2:
+    جدول(
+        ["ID", "الاسم", "العمر"],
+        [
+            [1, "حسين", 20],
+            [2, "علي", 19],
+        ],
+    )
+
+تقدم(total=20, delay=0.03)
+```
+
+## English API
+
+```python
+from bx_ui import title, success, menu, table, progress
+
+title("Dashboard")
+
+choice = menu(
+    "Choose an action:",
+    ["Add user", "Users", "Exit"],
+)
+
+success("Done")
+```
+
+## Features
+
+- Arabic API aliases
+- English API
+- Menus
+- Tables
+- Success, info, warning and error messages
+- Confirm prompts
+- Progress bars
+- Spinners
+- Boxes and sections
+- Terminal clearing
+- Works with Python 3.9+
+- No third-party runtime dependencies
+
+## Arabic API
+
+| Arabic | English |
+|---|---|
+| عرض | title |
+| قسم | section |
+| معلومة | info |
+| نجاح | success |
+| تحذير | warning |
+| خطأ | error |
+| قائمة | menu |
+| تأكيد | confirm |
+| جدول | table |
+| تقدم | progress |
+| تحميل | spinner |
+| صندوق | box |
+| مسح | clear |
+| توقف | pause |
+| اسأل | ask |
+| لغة | set_language |
+
+## License
+
+MIT

bx_ui-1.0.0/src/bx_ui.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/bx_ui/__init__.py
+src/bx_ui/core.py
+src/bx_ui.egg-info/PKG-INFO
+src/bx_ui.egg-info/SOURCES.txt
+src/bx_ui.egg-info/dependency_links.txt
+src/bx_ui.egg-info/top_level.txt

bx_ui-1.0.0/src/bx_ui.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bx_ui-1.0.0/src/bx_ui.egg-info/top_level.txt

@@ -0,0 +1 @@
+bx_ui