4u-cli 1.0.0__py3-none-any.whl

4u_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: 4u-cli
+Version: 1.0.0
+Summary: 4u - A modern CLI package manager for Python tools
+Author: 4u Team
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: requests>=2.28
+Requires-Dist: supabase>=2.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 4u CLI
+
+> A modern CLI package manager for Python tools ⚡
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+```bash
+# Show help and banner
+4u
+
+# Search for tools
+4u search <query>
+
+# Install a tool
+4u install <tool_name>
+
+# List installed tools
+4u list
+
+# Update tools
+4u update           # Update all
+4u update <tool>    # Update specific tool
+
+# Uninstall a tool
+4u uninstall <tool_name>
+
+# Run an installed tool directly
+4u <tool_name> [args...]
+```
+
+## Configuration
+
+Set environment variables for Supabase connection:
+
+```bash
+export FOURU_SUPABASE_URL="https://your-project.supabase.co"
+export FOURU_SUPABASE_KEY="your-anon-key"
+```
+
+## License
+
+MIT

4u_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+fourutil/__init__.py,sha256=9a55rVNAYnHytSKRfRDF96l2by3Q8j4X6ab0aFoFjJY,81
+fourutil/config.py,sha256=UaPqNqiarK6tHaHPwLRcS9Rgyk0AFZa1oNA_NkrJdSQ,954
+fourutil/main.py,sha256=H9zbZ_Tkw4WrToppIXvCMA3oqLk9wbhYt0_fQDhb070,2753
+fourutil/supabase_client.py,sha256=PDd2AV-b1v3mYWtuXmisEoIh2HDoh39V0G2o5RdAZZ8,465
+fourutil/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fourutil/commands/install.py,sha256=y-4PQvxBrYUW49mJFBD-jM7H17e4HDtQ1C30qOduRJI,2543
+fourutil/commands/list_tools.py,sha256=GTBG9b11mi0PG2DtzzVhm3LQBXvIlqiQwmxcMuBCuqk,1796
+fourutil/commands/run.py,sha256=j1dPYmp3dCvtH50lhwXxQ4qcpXDpO3AVmF5MEUGsXF8,1079
+fourutil/commands/search.py,sha256=QGMIWoHnc9ELnJ0WilEgY9NkOYvZR55lW9L1C2yrMJI,2086
+fourutil/commands/uninstall.py,sha256=XdTEOM9Ya32_wkaCuNdQEwGbRb2SuD36xmMeIulrm_4,1081
+fourutil/commands/update.py,sha256=IQzm2R0_B1uYRLo-O9PQ46iOQToBNEPFyFMx33ETHWY,3392
+fourutil/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fourutil/utils/downloader.py,sha256=kgO4Snilrg9WU0Ez9K6cSeeLUgaYf7ppSCaz58A4WSY,1924
+fourutil/utils/manifest.py,sha256=S9-ix4A029inRjWV2SF-in_a_Z3w-0CBQO4rrVqznYI,1905
+fourutil/utils/printer.py,sha256=8JiCXb7srvevgSopHbNP56XMtBqZrewQR9xQmUUn6bY,2093
+4u_cli-1.0.0.dist-info/METADATA,sha256=OOumaitucieuCPOBOavP_WYU7VMH0Ro2qHbCPdHBO0M,1409
+4u_cli-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+4u_cli-1.0.0.dist-info/entry_points.txt,sha256=J6qjD48VtxVGpix0AazD1eDzHDSCNoTv-glUGAcrXl0,41
+4u_cli-1.0.0.dist-info/top_level.txt,sha256=BQg2B1X3b4fkmyvhCsTnZpOLlKkxaWvBrWThTD--9hs,9
+4u_cli-1.0.0.dist-info/RECORD,,

4u_cli-1.0.0.dist-info/WHEEL

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

4u_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+4u = fourutil.main:cli

4u_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fourutil

fourutil/__init__.py

@@ -0,0 +1,3 @@
+"""4u CLI - A modern package manager for Python tools."""
+
+__version__ = "1.0.0"

fourutil/commands/install.py

@@ -0,0 +1,80 @@
+"""
+أمر التثبيت: 4u install <slug>
+Install command – downloads a tool from Supabase and registers it locally.
+"""
+
+import click
+from rich.panel import Panel
+
+from fourutil.supabase_client import get_client
+from fourutil.config import TOOLS_DIR, TOOLS_TABLE
+from fourutil.utils.printer import console, print_success, print_error, print_info, print_warning
+from fourutil.utils.manifest import add_tool, get_tool
+from fourutil.utils.downloader import download_file
+
+
+@click.command("install")
+@click.argument("slug")
+def install(slug: str) -> None:
+    """Install a tool by its slug name. ⬇️"""
+    console.print()
+    console.print(f"  🔍 Looking up [bold cyan]{slug}[/bold cyan] …")
+
+    # --- استعلام Supabase ---
+    try:
+        client = get_client()
+        result = (
+            client.table(TOOLS_TABLE)
+            .select("*")
+            .eq("slug", slug)
+            .execute()
+        )
+    except Exception as exc:
+        print_error(f"Failed to query Supabase: {exc}")
+        return
+
+    if not result.data:
+        print_error(f"Tool [bold]{slug}[/bold] not found in the registry.")
+        console.print("  💡 Try [bold]4u search <query>[/bold] to find tools.", style="dim")
+        return
+
+    tool = result.data[0]
+    remote_version = tool.get("version", "0.0.0")
+    file_url = tool.get("file_url", "")
+    tool_name = tool.get("name", slug)
+    description = tool.get("description", "")
+
+    # --- هل الأداة مثبتة بالفعل؟ ---
+    local = get_tool(slug)
+    if local and local.get("version") == remote_version:
+        print_info(f"[bold]{tool_name}[/bold] v{remote_version} is already installed and up to date.")
+        return
+
+    if not file_url:
+        print_error("No download URL found for this tool.")
+        return
+
+    # --- تحميل الملف ---
+    filename = f"{slug}.py"
+    dest = TOOLS_DIR / filename
+
+    console.print(f"  ⬇️  Downloading [bold]{tool_name}[/bold] v{remote_version} …")
+    ok = download_file(file_url, dest)
+    if not ok:
+        return
+
+    # --- تسجيل في manifest ---
+    add_tool(slug, remote_version, filename)
+
+    # --- رسالة نجاح ---
+    console.print()
+    console.print(
+        Panel(
+            f"[bold green]{tool_name}[/bold green] v{remote_version} installed successfully!\n"
+            f"[dim]{description}[/dim]\n\n"
+            f"Run it with: [bold cyan]4u {slug}[/bold cyan]",
+            title="✅ Installed",
+            border_style="green",
+            padding=(1, 2),
+        )
+    )

fourutil/commands/list_tools.py

@@ -0,0 +1,54 @@
+"""
+أمر العرض: 4u list
+List command – shows all locally installed tools in a rich table.
+"""
+
+import click
+from rich.table import Table
+from rich.panel import Panel
+
+from fourutil.utils.printer import console, print_info
+from fourutil.utils.manifest import get_all_tools
+
+
+@click.command("list")
+def list_tools() -> None:
+    """List all installed tools. 📦"""
+    console.print()
+
+    tools = get_all_tools()
+
+    if not tools:
+        print_info("No tools installed yet.")
+        console.print("  💡 Use [bold cyan]4u search <query>[/bold cyan] to find tools.", style="dim")
+        console.print("  💡 Use [bold cyan]4u install <name>[/bold cyan] to install one.", style="dim")
+        return
+
+    table = Table(
+        title="📦 Installed Tools",
+        title_style="bold cyan",
+        border_style="bright_blue",
+        show_lines=True,
+        padding=(0, 1),
+    )
+    table.add_column("#", style="dim", justify="right", width=4)
+    table.add_column("Name", style="bold white", min_width=15)
+    table.add_column("Version", style="green", justify="center", min_width=10)
+    table.add_column("Installed At", style="yellow", min_width=20)
+    table.add_column("File", style="dim", min_width=15)
+
+    for idx, (slug, info) in enumerate(tools.items(), start=1):
+        installed_at = info.get("installed_at", "—")
+        # تنسيق التاريخ لعرض أجمل
+        if "T" in installed_at:
+            installed_at = installed_at.replace("T", " ").split(".")[0]
+        table.add_row(
+            str(idx),
+            slug,
+            info.get("version", "?"),
+            installed_at,
+            info.get("file", "—"),
+        )
+
+    console.print(table)
+    console.print(f"\n  Total: [bold]{len(tools)}[/bold] tool(s) installed.\n", style="dim")

fourutil/commands/run.py

@@ -0,0 +1,37 @@
+"""
+المشغّل الديناميكي للأدوات المثبتة
+Dynamic tool runner – executes an installed tool as a subprocess.
+"""
+
+import sys
+import subprocess
+from pathlib import Path
+
+from fourutil.config import TOOLS_DIR
+from fourutil.utils.printer import print_error, console
+
+
+def run_tool(name: str, args: tuple) -> None:
+    """
+    تشغيل أداة مثبتة باسمها.
+    Runs ~/.4u/commands/<name>.py with the remaining CLI arguments.
+    """
+    tool_path = TOOLS_DIR / f"{name}.py"
+
+    if not tool_path.exists():
+        print_error(f"Tool [bold]{name}[/bold] is not installed.")
+        console.print(
+            f"  💡 Use [bold cyan]4u install {name}[/bold cyan] to install it.",
+            style="dim",
+        )
+        sys.exit(1)
+
+    cmd = [sys.executable, str(tool_path)] + list(args)
+    try:
+        result = subprocess.run(cmd)
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        sys.exit(130)
+    except Exception as exc:
+        print_error(f"Failed to run [bold]{name}[/bold]: {exc}")
+        sys.exit(1)

fourutil/commands/search.py

@@ -0,0 +1,66 @@
+"""
+أمر البحث: 4u search <query>
+Search command – queries Supabase for tools matching a keyword.
+"""
+
+import click
+from rich.table import Table
+from rich.panel import Panel
+
+from fourutil.supabase_client import get_client
+from fourutil.config import TOOLS_TABLE
+from fourutil.utils.printer import console, print_error, print_info
+
+
+@click.command("search")
+@click.argument("query")
+def search(query: str) -> None:
+    """Search for tools in the registry. 🔎"""
+    console.print()
+    console.print(f"  🔎 Searching for [bold cyan]{query}[/bold cyan] …\n")
+
+    try:
+        client = get_client()
+        # بحث في الاسم أو الوصف باستخدام ilike
+        result = (
+            client.table(TOOLS_TABLE)
+            .select("*")
+            .or_(f"name.ilike.%{query}%,description.ilike.%{query}%,slug.ilike.%{query}%")
+            .execute()
+        )
+    except Exception as exc:
+        print_error(f"Search failed: {exc}")
+        return
+
+    if not result.data:
+        print_info(f"No tools found matching [bold]{query}[/bold].")
+        return
+
+    table = Table(
+        title=f"🔎 Search Results for \"{query}\"",
+        title_style="bold cyan",
+        border_style="bright_blue",
+        show_lines=True,
+        padding=(0, 1),
+    )
+    table.add_column("#", style="dim", justify="right", width=4)
+    table.add_column("Slug", style="bold white", min_width=12)
+    table.add_column("Name", style="cyan", min_width=15)
+    table.add_column("Version", style="green", justify="center", min_width=8)
+    table.add_column("Description", style="white", min_width=30)
+
+    for idx, tool in enumerate(result.data, start=1):
+        table.add_row(
+            str(idx),
+            tool.get("slug", "—"),
+            tool.get("name", "—"),
+            tool.get("version", "—"),
+            tool.get("description", "—"),
+        )
+
+    console.print(table)
+    console.print(
+        f"\n  Found [bold]{len(result.data)}[/bold] tool(s). "
+        f"Install with [bold cyan]4u install <slug>[/bold cyan]\n",
+        style="dim",
+    )

fourutil/commands/uninstall.py

@@ -0,0 +1,42 @@
+"""
+أمر الحذف: 4u uninstall <slug>
+Uninstall command – removes a tool's file and manifest entry.
+"""
+
+import click
+from rich.panel import Panel
+
+from fourutil.config import TOOLS_DIR
+from fourutil.utils.printer import console, print_success, print_error
+from fourutil.utils.manifest import remove_tool, get_tool
+
+
+@click.command("uninstall")
+@click.argument("slug")
+def uninstall(slug: str) -> None:
+    """Uninstall a tool by its slug name. 🗑️"""
+    console.print()
+
+    local = get_tool(slug)
+    if not local:
+        print_error(f"[bold]{slug}[/bold] is not installed.")
+        return
+
+    # --- حذف الملف ---
+    filename = local.get("file", f"{slug}.py")
+    file_path = TOOLS_DIR / filename
+    if file_path.exists():
+        file_path.unlink()
+
+    # --- حذف من manifest ---
+    remove_tool(slug)
+
+    # --- رسالة نجاح ---
+    console.print(
+        Panel(
+            f"[bold]{slug}[/bold] has been uninstalled. 👋",
+            title="🗑️  Removed",
+            border_style="red",
+            padding=(0, 2),
+        )
+    )

fourutil/commands/update.py

@@ -0,0 +1,110 @@
+"""
+أمر التحديث: 4u update [slug]
+Update command – checks for newer versions and updates tools.
+"""
+
+import click
+from rich.panel import Panel
+
+from fourutil.supabase_client import get_client
+from fourutil.config import TOOLS_DIR, TOOLS_TABLE
+from fourutil.utils.printer import console, print_success, print_error, print_info, print_warning
+from fourutil.utils.manifest import add_tool, get_tool, get_all_tools
+from fourutil.utils.downloader import download_file
+
+
+def _update_single(slug: str) -> bool:
+    """
+    تحديث أداة واحدة.
+    Returns True if an update was applied, False otherwise.
+    """
+    local = get_tool(slug)
+    if not local:
+        print_error(f"[bold]{slug}[/bold] is not installed.")
+        return False
+
+    local_version = local.get("version", "0.0.0")
+
+    # --- جلب الإصدار البعيد ---
+    try:
+        client = get_client()
+        result = (
+            client.table(TOOLS_TABLE)
+            .select("*")
+            .eq("slug", slug)
+            .execute()
+        )
+    except Exception as exc:
+        print_error(f"Failed to query Supabase for {slug}: {exc}")
+        return False
+
+    if not result.data:
+        print_warning(f"[bold]{slug}[/bold] no longer exists in the registry.")
+        return False
+
+    tool = result.data[0]
+    remote_version = tool.get("version", "0.0.0")
+    file_url = tool.get("file_url", "")
+    tool_name = tool.get("name", slug)
+
+    if remote_version == local_version:
+        print_info(f"[bold]{tool_name}[/bold] v{local_version} is already up to date.")
+        return False
+
+    if not file_url:
+        print_error(f"No download URL found for [bold]{slug}[/bold].")
+        return False
+
+    console.print(f"  ⬆️  Updating [bold]{tool_name}[/bold] {local_version} → {remote_version} …")
+    filename = f"{slug}.py"
+    dest = TOOLS_DIR / filename
+
+    ok = download_file(file_url, dest)
+    if not ok:
+        return False
+
+    add_tool(slug, remote_version, filename)
+    print_success(f"[bold]{tool_name}[/bold] updated to v{remote_version}")
+    return True
+
+
+@click.command("update")
+@click.argument("slug", required=False, default=None)
+def update(slug: str | None) -> None:
+    """Update one or all installed tools. 🔄"""
+    console.print()
+
+    if slug:
+        # --- تحديث أداة واحدة ---
+        _update_single(slug)
+    else:
+        # --- تحديث جميع الأدوات ---
+        tools = get_all_tools()
+        if not tools:
+            print_info("No tools installed yet. Use [bold]4u install <name>[/bold].")
+            return
+
+        console.print("  🔄 Checking updates for all installed tools …\n")
+        updated_count = 0
+        for tool_slug in tools:
+            if _update_single(tool_slug):
+                updated_count += 1
+            console.print()
+
+        if updated_count == 0:
+            console.print(
+                Panel(
+                    "All tools are already up to date! 🎉",
+                    border_style="green",
+                    padding=(0, 2),
+                )
+            )
+        else:
+            console.print(
+                Panel(
+                    f"Updated [bold]{updated_count}[/bold] tool(s) successfully!",
+                    title="✅ Update Complete",
+                    border_style="green",
+                    padding=(0, 2),
+                )
+            )

fourutil/config.py

@@ -0,0 +1,30 @@
+"""
+تكوين الإعدادات الأساسية لأداة 4u
+Configuration constants for the 4u CLI tool.
+"""
+
+import os
+from pathlib import Path
+
+# --- المسارات المحلية (Local Paths) ---
+HOME_DIR = Path.home()
+FOURU_DIR = HOME_DIR / ".4u"
+TOOLS_DIR = FOURU_DIR / "commands"
+MANIFEST_FILE = FOURU_DIR / "manifest.json"
+
+# --- إعدادات Supabase ---
+SUPABASE_URL = os.environ.get(
+    "FOURU_SUPABASE_URL",
+    "https://nvdmkhehhelulfasmpob.supabase.co",
+)
+SUPABASE_KEY = os.environ.get(
+    "FOURU_SUPABASE_KEY",
+    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Im52ZG1raGVoaGVsdWxmYXNtcG9iIiwicm9sZSI6InNlcnZpY2Vfcm9sZSIsImlhdCI6MTc5MzYzNTM2NiwiZXhwIjoyMTA5MjExMzY2fQ.ZNq5iLFMGMFdBgKmF_jujnEu1LRY-CIRf5548og44uM",
+)
+
+# --- أسماء الجداول والتخزين (Table & Bucket Names) ---
+TOOLS_TABLE = "tools"
+TOOLS_BUCKET = "tools-bucket"
+
+# --- إصدار التطبيق ---
+APP_VERSION = "1.0.0"

fourutil/main.py

@@ -0,0 +1,80 @@
+"""
+نقطة الدخول الرئيسية لـ 4u CLI
+Main entry point – CLI router with dynamic tool dispatch.
+"""
+
+import sys
+import os
+
+# ضبط دعم UTF-8 في ويندوز لتفادي UnicodeEncodeError مع الرموز التعبيرية
+if sys.platform == "win32":
+    try:
+        if sys.stdout.encoding.lower() not in ("utf-8", "utf8"):
+            sys.stdout.reconfigure(encoding="utf-8")
+        if sys.stderr.encoding.lower() not in ("utf-8", "utf8"):
+            sys.stderr.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+
+import click
+
+from fourutil import __version__
+from fourutil.utils.printer import print_banner, console
+from fourutil.commands.install import install
+from fourutil.commands.update import update
+from fourutil.commands.uninstall import uninstall
+from fourutil.commands.list_tools import list_tools
+from fourutil.commands.search import search
+from fourutil.commands.run import run_tool
+
+
+# --- الأوامر المدمجة ---
+BUILTIN_COMMANDS = {"install", "update", "uninstall", "list", "search", "--help", "--version", "-h"}
+
+
+class FourUCLI(click.Group):
+    """
+    مجموعة أوامر مخصصة تدعم التوجيه الديناميكي.
+    Custom click Group that falls back to running installed tools
+    when the sub-command is not a built-in.
+    """
+
+    def parse_args(self, ctx: click.Context, args: list[str]) -> list[str]:
+        """Override to intercept unknown commands before click raises an error."""
+        # إذا لم تكن هناك وسائط، اعرض الشعار
+        if not args:
+            print_banner()
+            ctx.exit(0)
+            return []  # لن يصل إلى هنا لكن مطلوب للتوقيع
+
+        # تحقق مما إذا كان الأمر الأول مدمجاً
+        first = args[0]
+        if first not in BUILTIN_COMMANDS and not first.startswith("-"):
+            # أمر غير مدمج → حاول تشغيله كأداة مثبتة
+            run_tool(first, tuple(args[1:]))
+            ctx.exit(0)
+            return []
+
+        return super().parse_args(ctx, args)
+
+
+@click.group(cls=FourUCLI, invoke_without_command=True)
+@click.version_option(version=__version__, prog_name="4u", message="%(prog)s v%(version)s")
+@click.pass_context
+def cli(ctx: click.Context) -> None:
+    """4u — A modern package manager for Python tools."""
+    # إذا لم يتم استدعاء أمر فرعي، اعرض الشعار
+    if ctx.invoked_subcommand is None:
+        print_banner()
+
+
+# --- تسجيل الأوامر المدمجة ---
+cli.add_command(install)
+cli.add_command(update)
+cli.add_command(uninstall)
+cli.add_command(list_tools, name="list")
+cli.add_command(search)
+
+
+if __name__ == "__main__":
+    cli()

fourutil/supabase_client.py

@@ -0,0 +1,17 @@
+"""
+مساعد الاتصال بـ Supabase
+Supabase connection helper – creates a singleton client.
+"""
+
+from supabase import create_client, Client
+from fourutil.config import SUPABASE_URL, SUPABASE_KEY
+
+_client: Client | None = None
+
+
+def get_client() -> Client:
+    """إرجاع عميل Supabase (Return a Supabase client instance)."""
+    global _client
+    if _client is None:
+        _client = create_client(SUPABASE_URL, SUPABASE_KEY)
+    return _client

fourutil/utils/downloader.py

@@ -0,0 +1,64 @@
+"""
+مساعد تحميل الملفات
+File download helper – downloads tool scripts from remote URLs.
+"""
+
+import requests
+from pathlib import Path
+
+from rich.progress import (
+    Progress,
+    SpinnerColumn,
+    TextColumn,
+    BarColumn,
+    DownloadColumn,
+    TransferSpeedColumn,
+)
+
+from fourutil.utils.printer import console, print_error
+
+
+def download_file(url: str, dest: Path) -> bool:
+    """
+    تحميل ملف من URL وحفظه في المسار المحدد.
+    Download a file from *url* and save it to *dest*.
+    Returns True on success, False on failure.
+    """
+    try:
+        response = requests.get(url, stream=True, timeout=30)
+        response.raise_for_status()
+
+        total = int(response.headers.get("content-length", 0))
+
+        # تأكد من وجود المجلد الأب
+        dest.parent.mkdir(parents=True, exist_ok=True)
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[bold blue]Downloading…"),
+            BarColumn(bar_width=30),
+            DownloadColumn(),
+            TransferSpeedColumn(),
+            console=console,
+            transient=True,
+        ) as progress:
+            task = progress.add_task("download", total=total or None)
+            with open(dest, "wb") as f:
+                for chunk in response.iter_content(chunk_size=8192):
+                    f.write(chunk)
+                    progress.update(task, advance=len(chunk))
+
+        return True
+
+    except requests.ConnectionError:
+        print_error("Connection error – check your internet connection.")
+        return False
+    except requests.Timeout:
+        print_error("Download timed out. Please try again.")
+        return False
+    except requests.HTTPError as exc:
+        print_error(f"HTTP error: {exc.response.status_code}")
+        return False
+    except Exception as exc:
+        print_error(f"Download failed: {exc}")
+        return False

fourutil/utils/manifest.py

@@ -0,0 +1,65 @@
+"""
+مدير ملف manifest.json
+Handles reading / writing the local manifest that tracks installed tools.
+"""
+
+import json
+from datetime import datetime
+from pathlib import Path
+
+from fourutil.config import MANIFEST_FILE, FOURU_DIR, TOOLS_DIR
+
+
+def _ensure_dirs() -> None:
+    """تأكد من وجود المجلدات الضرورية"""
+    FOURU_DIR.mkdir(parents=True, exist_ok=True)
+    TOOLS_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def load_manifest() -> dict:
+    """تحميل ملف manifest.json أو إرجاع قالب فارغ"""
+    _ensure_dirs()
+    if MANIFEST_FILE.exists():
+        with open(MANIFEST_FILE, "r", encoding="utf-8") as f:
+            return json.load(f)
+    return {"installed": {}}
+
+
+def save_manifest(data: dict) -> None:
+    """حفظ البيانات في manifest.json"""
+    _ensure_dirs()
+    with open(MANIFEST_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+
+
+def add_tool(slug: str, version: str, filename: str) -> None:
+    """إضافة أداة إلى manifest"""
+    manifest = load_manifest()
+    manifest["installed"][slug] = {
+        "version": version,
+        "installed_at": datetime.now().isoformat(),
+        "file": filename,
+    }
+    save_manifest(manifest)
+
+
+def remove_tool(slug: str) -> bool:
+    """حذف أداة من manifest — يُرجع True إذا كانت موجودة"""
+    manifest = load_manifest()
+    if slug in manifest["installed"]:
+        del manifest["installed"][slug]
+        save_manifest(manifest)
+        return True
+    return False
+
+
+def get_tool(slug: str) -> dict | None:
+    """إرجاع بيانات أداة معينة أو None"""
+    manifest = load_manifest()
+    return manifest["installed"].get(slug)
+
+
+def get_all_tools() -> dict:
+    """إرجاع جميع الأدوات المثبتة"""
+    manifest = load_manifest()
+    return manifest["installed"]

fourutil/utils/printer.py

@@ -0,0 +1,65 @@
+"""
+مساعد الطباعة الملونة في الطرفية
+Colored terminal output helper using rich.
+"""
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+# --- ثوابت الألوان ---
+SUCCESS = "bold green"
+ERROR = "bold red"
+WARNING = "bold yellow"
+INFO = "bold cyan"
+MUTED = "dim"
+
+
+def print_success(message: str) -> None:
+    """طباعة رسالة نجاح"""
+    console.print(f"  ✅ {message}", style=SUCCESS)
+
+
+def print_error(message: str) -> None:
+    """طباعة رسالة خطأ"""
+    console.print(f"  ❌ {message}", style=ERROR)
+
+
+def print_warning(message: str) -> None:
+    """طباعة رسالة تحذير"""
+    console.print(f"  ⚠️  {message}", style=WARNING)
+
+
+def print_info(message: str) -> None:
+    """طباعة رسالة معلومات"""
+    console.print(f"  ℹ️  {message}", style=INFO)
+
+
+def print_banner() -> None:
+    """عرض شعار 4u عند تشغيله بدون أوامر"""
+    logo = Text()
+    logo.append("  ██╗  ██╗", style="bold cyan")
+    logo.append("██╗   ██╗\n", style="bold magenta")
+    logo.append("  ██║  ██║", style="bold cyan")
+    logo.append("██║   ██║\n", style="bold magenta")
+    logo.append("  ███████║", style="bold cyan")
+    logo.append("██║   ██║\n", style="bold magenta")
+    logo.append("       ██║", style="bold cyan")
+    logo.append("██║   ██║\n", style="bold magenta")
+    logo.append("       ██║", style="bold cyan")
+    logo.append("╚██████╔╝\n", style="bold magenta")
+    logo.append("       ╚═╝", style="bold cyan")
+    logo.append(" ╚═════╝ ", style="bold magenta")
+
+    panel = Panel(
+        logo,
+        title="[bold white]⚡ 4u Package Manager ⚡[/bold white]",
+        subtitle="[dim]v1.0.0 • Type [bold]4u --help[/bold] for commands[/dim]",
+        border_style="bright_blue",
+        padding=(1, 4),
+    )
+    console.print()
+    console.print(panel)
+    console.print()