persian-devkit 1.0.0__py3-none-any.whl

persian_devkit/__init__.py

@@ -0,0 +1,4 @@
+"""persian-devkit — جعبه‌ابزار خط فرمان برای توسعه‌دهندگان فارسی‌زبان."""
+
+__version__ = "1.0.0"
+__all__ = ["__version__"]

persian_devkit/__main__.py

@@ -0,0 +1,5 @@
+"""اجرای پکیج با `python -m persian_devkit`."""
+from persian_devkit.main import app
+
+if __name__ == "__main__":
+    app()

persian_devkit/cli.py

@@ -0,0 +1,55 @@
+"""ثبت تمام زیرفرمان‌ها روی اپ اصلی Typer."""
+from __future__ import annotations
+
+import typer
+
+from persian_devkit.commands import (
+    base64_cmd, color_cmd, csv_cmd, date_cmd, env_cmd, gitignore_cmd,
+    hash_cmd, image_cmd, jq_cmd, json_cmd, license_cmd, lorem_cmd,
+    name_cmd, number_cmd, password_cmd, qrcode_cmd, random_cmd,
+    scaffold_cmd, template_cmd, text_cmd, time_cmd, toml_cmd,
+    url_cmd, uuid_cmd, yaml_cmd,
+)
+from persian_devkit.commands.jq_cmd import jq_command
+from persian_devkit.commands.scaffold_cmd import scaffold_command
+from persian_devkit.commands.template_cmd import template_command
+
+
+def register_commands(app: typer.Typer) -> None:
+    """همهٔ زیرفرمان‌ها را به اپ اضافه می‌کند."""
+    # فارسی و عمومی (Batch 1-2)
+    app.add_typer(date_cmd.app, name="date", help="📅 تاریخ.")
+    app.add_typer(number_cmd.app, name="number", help="🔢 اعداد.")
+    app.add_typer(text_cmd.app, name="text", help="✍️  متن.")
+    app.add_typer(uuid_cmd.app, name="uuid", help="🆔 UUID.")
+    app.add_typer(json_cmd.app, name="json", help="🗂️  JSON.")
+    app.add_typer(base64_cmd.app, name="base64", help="🔐 Base64.")
+    app.add_typer(hash_cmd.app, name="hash", help="🧮 هش.")
+    app.add_typer(password_cmd.app, name="password", help="🔑 رمز.")
+    app.add_typer(random_cmd.app, name="random", help="🎲 تصادفی.")
+
+    # شبکه و وب (Batch 3)
+    app.add_typer(url_cmd.app, name="url", help="🔗 URL.")
+    app.add_typer(time_cmd.app, name="time", help="⏱  زمان.")
+
+    # بصری (Batch 3)
+    app.add_typer(color_cmd.app, name="color", help="🎨 رنگ.")
+    app.add_typer(image_cmd.app, name="image", help="🖼  تصویر.")
+    app.command(name="qrcode", help="📱 QR Code.")(qrcode_cmd.qrcode_command)
+
+    # داده (Batch 4-5)
+    app.add_typer(yaml_cmd.app, name="yaml", help="📄 YAML.")
+    app.add_typer(toml_cmd.app, name="toml", help="⚙️  TOML.")
+    app.add_typer(csv_cmd.app, name="csv", help="📊 CSV.")
+    app.add_typer(env_cmd.app, name="env", help="🔐 .env.")
+    app.command(name="jq", help="🔍 کوئری JSON.")(jq_command)
+
+    # دادهٔ نمونه (Batch 5)
+    app.add_typer(lorem_cmd.app, name="lorem", help="📝 متن نمونهٔ فارسی.")
+    app.add_typer(name_cmd.app, name="name", help="👤 نام نمونهٔ فارسی.")
+
+    # ابزار پروژه (Batch 6)
+    app.add_typer(license_cmd.app, name="license", help="📜 لایسنس.")
+    app.add_typer(gitignore_cmd.app, name="gitignore", help="🚫 .gitignore.")
+    app.command(name="scaffold", help="🏗  ساخت پروژه از قالب.")(scaffold_command)
+    app.command(name="template", help="📋 رندر قالب متنی.")(template_command)

persian_devkit/commands/__init__.py

@@ -0,0 +1,16 @@
+"""زیرفرمان‌های pdev."""
+from persian_devkit.commands import (
+    base64_cmd, color_cmd, csv_cmd, date_cmd, env_cmd, gitignore_cmd,
+    hash_cmd, image_cmd, jq_cmd, json_cmd, license_cmd, lorem_cmd,
+    name_cmd, number_cmd, password_cmd, qrcode_cmd, random_cmd,
+    scaffold_cmd, template_cmd, text_cmd, time_cmd, toml_cmd,
+    url_cmd, uuid_cmd, yaml_cmd,
+)
+
+__all__ = [
+    "base64_cmd", "color_cmd", "csv_cmd", "date_cmd", "env_cmd",
+    "gitignore_cmd", "hash_cmd", "image_cmd", "jq_cmd", "json_cmd",
+    "license_cmd", "lorem_cmd", "name_cmd", "number_cmd", "password_cmd",
+    "qrcode_cmd", "random_cmd", "scaffold_cmd", "template_cmd",
+    "text_cmd", "time_cmd", "toml_cmd", "url_cmd", "uuid_cmd", "yaml_cmd",
+]

persian_devkit/commands/base64_cmd.py

@@ -0,0 +1,51 @@
+"""دستور pdev base64 — رمزگذاری و رمزگشایی Base64."""
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from persian_devkit.utils.crypto_utils import b64_decode, b64_encode
+
+app = typer.Typer(help="رمزگذاری و رمزگشایی Base64.", no_args_is_help=True)
+console = Console()
+
+
+def _read(value: Optional[str]) -> str:
+    """متن را از آرگومان یا stdin می‌خواند."""
+    if value is not None and value != "":
+        return value
+    if not sys.stdin.isatty():
+        data = sys.stdin.read()
+        if data.strip():
+            return data.rstrip("\n")
+    console.print("[red]✗ خطا:[/red] متنی وارد نشده.")
+    raise typer.Exit(1)
+
+
+@app.command("encode")
+def encode_cmd(
+    text: Optional[str] = typer.Argument(None, help="متن ورودی (یا از stdin)."),
+    url_safe: bool = typer.Option(
+        False, "--url-safe", "-u", help="استفاده از الفبای URL-safe."
+    ),
+) -> None:
+    """رمزگذاری متن به Base64."""
+    console.print(b64_encode(_read(text), url_safe=url_safe))
+
+
+@app.command("decode")
+def decode_cmd(
+    text: Optional[str] = typer.Argument(None, help="رشتهٔ Base64 (یا از stdin)."),
+    url_safe: bool = typer.Option(
+        False, "--url-safe", "-u", help="ورودی با الفبای URL-safe."
+    ),
+) -> None:
+    """رمزگشایی Base64 به متن."""
+    try:
+        console.print(b64_decode(_read(text), url_safe=url_safe))
+    except ValueError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)

persian_devkit/commands/color_cmd.py

@@ -0,0 +1,143 @@
+"""دستور pdev color — کار با رنگ‌ها (HEX, RGB, HSL)."""
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+
+from persian_devkit.utils.color_utils import (
+    best_text_color,
+    complementary,
+    contrast_ratio,
+    generate_palette,
+    parse_color,
+    pleasant_color,
+    random_color,
+    rgb_to_hex,
+    rgb_to_hsl,
+)
+
+app = typer.Typer(help="کار با رنگ‌ها (HEX, RGB, HSL).", no_args_is_help=True)
+console = Console()
+
+
+def _fail(message: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {message}")
+    raise typer.Exit(1)
+
+
+def _swatch(rgb: tuple[int, int, int], text: str = "  ") -> Text:
+    """نمایش یک بلوک رنگی در ترمینال."""
+    r, g, b = rgb
+    fg = best_text_color(rgb)
+    return Text(text, style=f"{fg} on rgb({r},{g},{b})")
+
+
+@app.command("convert")
+def convert_cmd(
+    color: str = typer.Argument(
+        ..., help="رنگ: #fff، #ffffff، rgb(255,0,0) یا 255,0,0"
+    ),
+) -> None:
+    """تبدیل رنگ بین فرمت‌های HEX، RGB و HSL."""
+    try:
+        rgb = parse_color(color)
+    except ValueError as e:
+        _fail(str(e))
+
+    h, s, l = rgb_to_hsl(rgb)
+
+    table = Table(title=f"🎨 {color}", title_style="bold cyan", show_header=False)
+    table.add_column("فرمت", style="bold")
+    table.add_column("مقدار")
+    table.add_row("HEX", rgb_to_hex(rgb))
+    table.add_row("RGB", f"rgb({rgb[0]}, {rgb[1]}, {rgb[2]})")
+    table.add_row("HSL", f"hsl({h:.0f}, {s * 100:.0f}%, {l * 100:.0f}%)")
+    table.add_row("روشنایی", f"{l * 100:.1f}%")
+    table.add_row("نمایش", _swatch(rgb, "            "))
+    console.print(table)
+
+
+@app.command("palette")
+def palette_cmd(
+    color: str = typer.Argument(..., help="رنگ پایه."),
+    count: int = typer.Option(5, "--count", "-c", min=2, max=12, help="تعداد."),
+) -> None:
+    """تولید پالت رنگی از یک رنگ پایه."""
+    try:
+        base = parse_color(color)
+    except ValueError as e:
+        _fail(str(e))
+
+    palette = generate_palette(base, count=count)
+
+    table = Table(title="🎨 پالت رنگ", title_style="bold cyan")
+    table.add_column("نمونه", justify="center")
+    table.add_column("HEX")
+    table.add_column("RGB")
+
+    for c in palette:
+        table.add_row(
+            _swatch(c, "        "),
+            rgb_to_hex(c),
+            f"{c[0]:3d}, {c[1]:3d}, {c[2]:3d}",
+        )
+    console.print(table)
+
+
+@app.command("random")
+def random_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=20, help="تعداد."),
+    pleasant: bool = typer.Option(
+        False, "--pleasant", "-p", help="رنگ‌های دلپذیر (اشباع کنترل‌شده)."
+    ),
+) -> None:
+    """تولید رنگ تصادفی."""
+    for _ in range(count):
+        rgb = pleasant_color() if pleasant else random_color()
+        console.print(f"{_swatch(rgb, '      ')}  {rgb_to_hex(rgb)}  rgb{rgb}")
+
+
+@app.command("contrast")
+def contrast_cmd(
+    a: str = typer.Argument(..., help="رنگ اول."),
+    b: str = typer.Argument(..., help="رنگ دوم."),
+) -> None:
+    """محاسبهٔ نسبت کنتراست بین دو رنگ (استاندارد WCAG)."""
+    try:
+        ca = parse_color(a)
+        cb = parse_color(b)
+    except ValueError as e:
+        _fail(str(e))
+
+    ratio = contrast_ratio(ca, cb)
+
+    if ratio >= 7:
+        level = "[green]AAA ✓[/green]"
+    elif ratio >= 4.5:
+        level = "[green]AA ✓[/green]"
+    elif ratio >= 3:
+        level = "[yellow]A (فقط متن بزرگ)[/yellow]"
+    else:
+        level = "[red]قابل قبول نیست[/red]"
+
+    console.print(f"نسبت کنتراست: [bold]{ratio:.2f}:1[/bold]")
+    console.print(f"سطح WCAG: {level}")
+
+
+@app.command("complement")
+def complement_cmd(
+    color: str = typer.Argument(..., help="رنگ پایه."),
+) -> None:
+    """نمایش رنگ مکمل."""
+    try:
+        rgb = parse_color(color)
+    except ValueError as e:
+        _fail(str(e))
+
+    comp = complementary(rgb)
+    console.print(
+        f"پایه: {_swatch(rgb, '      ')}  {rgb_to_hex(rgb)}\n"
+        f"مکمل: {_swatch(comp, '      ')}  {rgb_to_hex(comp)}"
+    )

persian_devkit/commands/csv_cmd.py

@@ -0,0 +1,121 @@
+"""دستور pdev csv — خواندن و تبدیل فایل‌های CSV."""
+from __future__ import annotations
+
+import re
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.data_utils import dump_json, read_csv, write_csv
+
+app = typer.Typer(help="خواندن و تبدیل فایل‌های CSV.", no_args_is_help=True)
+console = Console()
+
+
+def _fail(msg: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {msg}")
+    raise typer.Exit(1)
+
+
+def _load(path: Path, delimiter: str):
+    if not path.exists():
+        _fail(f"فایل یافت نشد: {path}")
+    try:
+        return read_csv(path, delimiter=delimiter)
+    except Exception as e:
+        _fail(str(e))
+
+
+@app.command("show")
+def show_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل CSV."),
+    delimiter: str = typer.Option(",", "--delimiter", "-d"),
+    limit: int = typer.Option(20, "--limit", "-n", min=1, help="حداکثر ردیف."),
+) -> None:
+    """نمایش جدولی محتوای CSV."""
+    headers, rows = _load(path, delimiter)
+    if not headers:
+        console.print("[yellow]⚠ فایل خالی است.[/yellow]")
+        return
+
+    table = Table(title=f" {path.name}", title_style="bold cyan")
+    for h in headers:
+        table.add_column(h)
+    for row in rows[:limit]:
+        table.add_row(*[str(row.get(h, "")) for h in headers])
+    console.print(table)
+
+    if len(rows) > limit:
+        console.print(f"[dim]... و {len(rows) - limit} ردیف دیگر[/dim]")
+
+
+@app.command("to-json")
+def to_json_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل CSV."),
+    delimiter: str = typer.Option(",", "--delimiter", "-d"),
+    output: Optional[Path] = typer.Option(None, "--output", "-o"),
+    indent: int = typer.Option(2, "--indent", "-i", min=0, max=10),
+) -> None:
+    """تبدیل CSV به آرایه‌ای از اشیاء JSON."""
+    _, rows = _load(path, delimiter)
+    text = dump_json(rows, indent=indent)
+    if output:
+        output.write_text(text, encoding="utf-8")
+        console.print(f"[green]✓ ذخیره شد:[/green] {output}")
+    else:
+        console.print(text, highlight=False)
+
+
+@app.command("columns")
+def columns_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل CSV."),
+    delimiter: str = typer.Option(",", "--delimiter", "-d"),
+) -> None:
+    """نمایش نام ستون‌ها و تعداد ردیف‌ها."""
+    headers, rows = _load(path, delimiter)
+    table = Table(title=" ستون‌ها", title_style="bold cyan")
+    table.add_column("ستون", style="bold")
+    table.add_column("نمونه", style="dim")
+    for h in headers:
+        sample = str(rows[0].get(h, "")) if rows else ""
+        table.add_row(h, sample[:40])
+    console.print(table)
+    console.print(f"تعداد ردیف: [bold]{len(rows)}[/bold]")
+
+
+@app.command("filter")
+def filter_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل CSV."),
+    column: str = typer.Argument(..., help="نام ستون."),
+    pattern: str = typer.Argument(..., help="الگوی regex برای فیلتر."),
+    delimiter: str = typer.Option(",", "--delimiter", "-d"),
+    ignore_case: bool = typer.Option(False, "--ignore-case", "-i"),
+    output: Optional[Path] = typer.Option(None, "--output", "-o"),
+) -> None:
+    """فیلتر ردیف‌ها بر اساس regex روی یک ستون."""
+    headers, rows = _load(path, delimiter)
+    if column not in headers:
+        _fail(f"ستون یافت نشد: {column}")
+
+    flags = re.IGNORECASE if ignore_case else 0
+    try:
+        rx = re.compile(pattern, flags)
+    except re.error as e:
+        _fail(f"regex نامعتبر: {e}")
+
+    kept = [r for r in rows if rx.search(str(r.get(column, "")))]
+    console.print(f"ردیف‌های مطابق: [bold]{len(kept)}[/bold] از {len(rows)}")
+
+    if output:
+        write_csv(output, headers, kept, delimiter=delimiter)
+        console.print(f"[green] ذخیره شد:[/green] {output}")
+    else:
+        table = Table(title=f" {column} ~ {pattern}", title_style="bold cyan")
+        for h in headers:
+            table.add_column(h)
+        for r in kept[:50]:
+            table.add_row(*[str(r.get(h, "")) for h in headers])
+        console.print(table)

persian_devkit/commands/date_cmd.py

@@ -0,0 +1,98 @@
+"""دستور pdev date — تبدیل و محاسبهٔ تاریخ شمسی و میلادی."""
+from __future__ import annotations
+
+from datetime import date, datetime
+
+import jdatetime
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.date_utils import (
+    DateParseError,
+    diff_days,
+    format_gregorian,
+    format_jalali,
+    gregorian_to_jalali,
+    jalali_to_gregorian,
+    parse_gregorian,
+    parse_jalali,
+)
+
+app = typer.Typer(help="تبدیل و محاسبهٔ تاریخ شمسی/میلادی.", no_args_is_help=True)
+console = Console()
+
+_WEEKDAYS_FA = ["شنبه", "یکشنبه", "دوشنبه", "سه‌شنبه", "چهارشنبه", "پنجشنبه", "جمعه"]
+
+
+def _fail(message: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {message}")
+    raise typer.Exit(1)
+
+
+@app.command("to-jalali")
+def to_jalali(
+    value: str = typer.Argument(..., help="تاریخ میلادی به شکل YYYY-MM-DD."),
+) -> None:
+    """تبدیل تاریخ میلادی به شمسی."""
+    try:
+        g = parse_gregorian(value)
+    except DateParseError as e:
+        _fail(str(e))
+    j = gregorian_to_jalali(g)
+    console.print(f"[green]{format_jalali(j)}[/green]")
+
+
+@app.command("to-gregorian")
+def to_gregorian(
+    value: str = typer.Argument(..., help="تاریخ شمسی به شکل YYYY/MM/DD یا YYYY-MM-DD."),
+) -> None:
+    """تبدیل تاریخ شمسی به میلادی."""
+    try:
+        j = parse_jalali(value)
+    except DateParseError as e:
+        _fail(str(e))
+    g = jalali_to_gregorian(j)
+    console.print(f"[green]{format_gregorian(g)}[/green]")
+
+
+@app.command("now")
+def now_cmd() -> None:
+    """نمایش تاریخ و ساعت فعلی به هر دو تقویم."""
+    now = datetime.now()
+    j = jdatetime.datetime.fromgregorian(datetime=now)
+
+    table = Table(title=" اکنون", show_header=False, title_style="bold cyan")
+    table.add_column("تقویم", style="bold")
+    table.add_column("مقدار")
+    table.add_row("میلادی", now.strftime("%Y-%m-%d %H:%M:%S"))
+    table.add_row("شمسی", j.strftime("%Y/%m/%d %H:%M:%S"))
+    table.add_row("روز هفته", _WEEKDAYS_FA[j.weekday()])
+    console.print(table)
+
+
+def _auto_parse(value: str) -> date:
+    """تشخیص خودکار نوع تاریخ: اگر / داشت شمسی، وگرنه میلادی."""
+    if "/" in value:
+        return jalali_to_gregorian(parse_jalali(value))
+    return parse_gregorian(value)
+
+
+@app.command("diff")
+def diff_cmd(
+    a: str = typer.Argument(..., help="تاریخ اول (شمسی یا میلادی)."),
+    b: str = typer.Argument(..., help="تاریخ دوم (شمسی یا میلادی)."),
+) -> None:
+    """محاسبهٔ اختلاف بین دو تاریخ (به روز)."""
+    try:
+        da = _auto_parse(a)
+        db = _auto_parse(b)
+    except DateParseError as e:
+        _fail(str(e))
+
+    days = diff_days(da, db)
+    sign = "بعد" if days >= 0 else "قبل"
+    console.print(
+        f"[cyan]اختلاف:[/cyan] [bold]{abs(days)}[/bold] روز "
+        f"({b} {sign} از {a})"
+    )

persian_devkit/commands/env_cmd.py

@@ -0,0 +1,100 @@
+"""دستور pdev env — کار با فایل‌های .env."""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.data_utils import dump_env, parse_env, write_text
+
+app = typer.Typer(help="کار با فایل‌های .env.", no_args_is_help=True)
+console = Console()
+
+
+def _fail(msg: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {msg}")
+    raise typer.Exit(1)
+
+
+def _load(path: Path) -> dict[str, str]:
+    if not path.exists():
+        _fail(f"فایل یافت نشد: {path}")
+    return parse_env(path.read_text(encoding="utf-8"))
+
+
+@app.command("show")
+def show_cmd(
+    path: Path = typer.Argument(Path(".env"), help="مسیر فایل env."),
+    reveal: bool = typer.Option(
+        False, "--reveal", "-r", help="نمایش مقادیر (پیش‌فرض مخفی)."
+    ),
+) -> None:
+    """نمایش متغیرهای .env (مقادیر به‌صورت پیش‌فرض مخفی)."""
+    data = _load(path)
+    if not data:
+        console.print("[yellow] فایل خالی است.[/yellow]")
+        return
+
+    table = Table(title=f" {path.name}", title_style="bold cyan")
+    table.add_column("کلید", style="bold")
+    table.add_column("مقدار")
+    for k, v in data.items():
+        if not reveal and any(s in k.upper() for s in ("PASS", "TOKEN", "SECRET", "KEY")):
+            v = "***"
+        table.add_row(k, v)
+    console.print(table)
+
+
+@app.command("get")
+def get_cmd(
+    key: str = typer.Argument(..., help="نام متغیر."),
+    path: Path = typer.Option(Path(".env"), "--file", "-f", help="مسیر فایل env."),
+) -> None:
+    """خواندن یک متغیر خاص."""
+    data = _load(path)
+    if key not in data:
+        console.print(f"[red]✗ خطا:[/red] متغیر یافت نشد: {key}")
+        raise typer.Exit(1)
+    console.print(data[key])
+
+
+@app.command("to-json")
+def to_json_cmd(
+    path: Path = typer.Argument(Path(".env"), help="مسیر فایل env."),
+) -> None:
+    """تبدیل .env به JSON."""
+    import json
+
+    data = _load(path)
+    console.print(json.dumps(data, ensure_ascii=False, indent=2), highlight=False)
+
+
+@app.command("to-shell")
+def to_shell_cmd(
+    path: Path = typer.Argument(Path(".env"), help="مسیر فایل env."),
+    export: bool = typer.Option(True, "--export/--no-export"),
+) -> None:
+    """تبدیل .env به دستورات export برای bash/zsh."""
+    data = _load(path)
+    prefix = "export " if export else ""
+    for k, v in data.items():
+        console.print(f"{prefix}{k}={v!r}")
+
+
+@app.command("sort")
+def sort_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل env."),
+    output: Optional[Path] = typer.Option(None, "--output", "-o"),
+) -> None:
+    """مرتب‌سازی کلیدهای .env به ترتیب الفبا."""
+    data = _load(path)
+    sorted_data = dict(sorted(data.items()))
+    text = dump_env(sorted_data)
+    if output:
+        write_text(output, text)
+        console.print(f"[green] ذخیره شد:[/green] {output}")
+    else:
+        console.print(text, highlight=False)

persian_devkit/commands/gitignore_cmd.py

@@ -0,0 +1,68 @@
+"""دستور pdev gitignore — تولید فایل .gitignore."""
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from persian_devkit.utils.gitignore_data import (
+    combine_gitignores,
+    list_gitignores,
+)
+
+app = typer.Typer(help="تولید فایل .gitignore.", no_args_is_help=True)
+console = Console()
+
+
+@app.command("list")
+def list_cmd() -> None:
+    """نمایش زبان‌ها و ابزارهای موجود."""
+    langs = list_gitignores()
+    console.print("زبان‌ها و ابزارهای پشتیبانی‌شده:")
+    for lang in langs:
+        console.print(f"  • {lang}")
+
+
+@app.command("show")
+def show_cmd(
+    langs: list[str] = typer.Argument(..., help="نام یک یا چند زبان/ابزار."),
+) -> None:
+    """نمایش محتوای .gitignore برای زبان‌های داده‌شده."""
+    try:
+        console.print(combine_gitignores(langs), highlight=False)
+    except ValueError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+
+
+@app.command("new")
+def new_cmd(
+    langs: list[str] = typer.Argument(..., help="نام یک یا چند زبان/ابزار."),
+    output: Path = typer.Option(
+        Path(".gitignore"), "--output", "-o", help="مسیر فایل خروجی."
+    ),
+    append: bool = typer.Option(
+        False, "--append", "-a", help="افزودن به فایل موجود."
+    ),
+) -> None:
+    """ساخت فایل .gitignore با ترکیب چند زبان."""
+    try:
+        text = combine_gitignores(langs)
+    except ValueError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+
+    if output.exists() and not append:
+        console.print(
+            f"[yellow]⚠ فایل موجود است:[/yellow] {output} (با --append ادغام می‌شود)"
+        )
+        raise typer.Exit(1)
+
+    if append and output.exists():
+        with output.open("a", encoding="utf-8") as f:
+            f.write("\n" + text)
+    else:
+        output.write_text(text, encoding="utf-8")
+
+    console.print(f"[green]✓ ذخیره شد:[/green] {output}")