persian-devkit 1.0.0__py3-none-any.whl

persian_devkit/commands/hash_cmd.py

@@ -0,0 +1,71 @@
+"""دستور pdev hash — محاسبهٔ هش متن یا فایل."""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.crypto_utils import HASH_ALGOS, hash_file, hash_text
+
+app = typer.Typer(help="محاسبهٔ هش متن یا فایل.", no_args_is_help=True)
+console = Console()
+
+
+def _read(value: Optional[str]) -> str:
+    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("text")
+def text_cmd(
+    text: Optional[str] = typer.Argument(None, help="متن ورودی (یا از stdin)."),
+    algo: str = typer.Option(
+        "sha256", "--algo", "-a", help=f"الگوریتم: {'/'.join(HASH_ALGOS)}"
+    ),
+) -> None:
+    """محاسبهٔ هش یک متن."""
+    if algo not in HASH_ALGOS:
+        console.print(f"[red]✗ خطا:[/red] الگوریتم ناشناخته: {algo}")
+        raise typer.Exit(1)
+    console.print(hash_text(_read(text), algo=algo))
+
+
+@app.command("file")
+def file_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل."),
+    algo: str = typer.Option(
+        "sha256", "--algo", "-a", help=f"الگوریتم: {'/'.join(HASH_ALGOS)}"
+    ),
+) -> None:
+    """محاسبهٔ هش یک فایل."""
+    if not path.exists():
+        console.print(f"[red]✗ خطا:[/red] فایل یافت نشد: {path}")
+        raise typer.Exit(1)
+    if algo not in HASH_ALGOS:
+        console.print(f"[red]✗ خطا:[/red] الگوریتم ناشناخته: {algo}")
+        raise typer.Exit(1)
+    console.print(hash_file(path, algo=algo))
+
+
+@app.command("all")
+def all_cmd(
+    text: Optional[str] = typer.Argument(None, help="متن ورودی (یا از stdin)."),
+) -> None:
+    """محاسبهٔ همهٔ الگوریتم‌ها روی یک متن."""
+    value = _read(text)
+    table = Table(title=" هش‌ها", title_style="bold cyan")
+    table.add_column("الگوریتم", style="bold")
+    table.add_column("مقدار", overflow="fold")
+    for algo in HASH_ALGOS:
+        table.add_row(algo, hash_text(value, algo=algo))
+    console.print(table)

persian_devkit/commands/image_cmd.py

@@ -0,0 +1,88 @@
+"""دستور pdev image — اطلاعات و تبدیل تصاویر."""
+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.image_utils import convert_image, image_info, resize_image
+
+app = typer.Typer(help="اطلاعات و تبدیل تصاویر.", no_args_is_help=True)
+console = Console()
+
+
+def _human_size(n: int) -> str:
+    """اندازهٔ خوانا برای بایت."""
+    value = float(n)
+    for unit in ("B", "KB", "MB", "GB"):
+        if value < 1024:
+            return f"{value:.1f} {unit}"
+        value /= 1024
+    return f"{value:.1f} TB"
+
+
+@app.command("info")
+def info_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل تصویری."),
+) -> None:
+    """نمایش اطلاعات تصویر."""
+    if not path.exists():
+        console.print(f"[red]✗ خطا:[/red] فایل یافت نشد: {path}")
+        raise typer.Exit(1)
+    try:
+        info = image_info(path)
+    except Exception as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+
+    table = Table(title=f"🖼  {path.name}", title_style="bold cyan", show_header=False)
+    table.add_column("شاخص", style="bold")
+    table.add_column("مقدار")
+    table.add_row("فرمت", info["format"])
+    table.add_row("حالت رنگی", info["mode"])
+    table.add_row("ابعاد", f"{info['width']} × {info['height']}")
+    table.add_row("اندازه", _human_size(info["size_bytes"]))
+    console.print(table)
+
+
+@app.command("resize")
+def resize_cmd(
+    src: Path = typer.Argument(..., help="تصویر ورودی."),
+    width: int = typer.Argument(..., help="عرض جدید."),
+    height: Optional[int] = typer.Argument(None, help="ارتفاع جدید (اختیاری)."),
+    output: Optional[Path] = typer.Option(None, "--output", "-o", help="مسیر خروجی."),
+) -> None:
+    """تغییر اندازهٔ تصویر (اگر ارتفاع ندهی، نسبت حفظ می‌شود)."""
+    if not src.exists():
+        console.print(f"[red]✗ خطا:[/red] فایل یافت نشد: {src}")
+        raise typer.Exit(1)
+    dst = output or src.with_stem(f"{src.stem}_resized")
+    try:
+        resize_image(src, dst, width, height)
+    except Exception as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+    console.print(f"[green]✓ ذخیره شد:[/green] {dst}")
+
+
+@app.command("convert")
+def convert_cmd(
+    src: Path = typer.Argument(..., help="تصویر ورودی."),
+    output: Path = typer.Argument(..., help="مسیر خروجی (فرمت از پسوند)."),
+    quality: int = typer.Option(
+        90, "--quality", "-q", min=1, max=100, help="کیفیت JPEG."
+    ),
+) -> None:
+    """تبدیل فرمت تصویر (مثلاً PNG → JPEG)."""
+    if not src.exists():
+        console.print(f"[red]✗ خطا:[/red] فایل یافت نشد: {src}")
+        raise typer.Exit(1)
+    try:
+        convert_image(src, output, quality=quality)
+    except Exception as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+    console.print(f"[green]✓ ذخیره شد:[/green] {output}")

persian_devkit/commands/jq_cmd.py

@@ -0,0 +1,92 @@
+"""دستور pdev jq — کوئری JSON با JSONPath ساده."""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.syntax import Syntax
+
+from persian_devkit.utils.jsonpath_utils import JSONPathError, query
+
+console = Console()
+
+
+def jq_command(
+    path: str = typer.Argument(
+        ..., help="مسیر JSONPath (مثل .user.name یا .items[0])."
+    ),
+    file: Optional[Path] = typer.Option(
+        None, "--file", "-f", help="فایل JSON ورودی (یا از stdin)."
+    ),
+    raw: bool = typer.Option(
+        False, "--raw", "-r", help="خروجی خام (بدون رنگ و بدون JSON encoding)."
+    ),
+    compact: bool = typer.Option(False, "--compact", "-c", help="خروجی فشرده."),
+) -> None:
+    """کوئری روی JSON با JSONPath.
+
+    مسیرها:
+      .key                → دسترسی به کلید
+      .a.b.c              → تودرتو
+      .items[0]           → اندیس آرایه
+      .items[*].name      → همهٔ نام‌ها
+      ["key with space"]  → کلید با فاصله
+    """
+    # خواندن داده
+    if file is not None:
+        if not file.exists():
+            console.print(f"[red]✗ خطا:[/red] فایل یافت نشد: {file}")
+            raise typer.Exit(1)
+        text = file.read_text(encoding="utf-8")
+    else:
+        if sys.stdin.isatty():
+            console.print(
+                "[red]✗ خطا:[/red] فایل JSON بده یا از stdin استفاده کن."
+            )
+            raise typer.Exit(1)
+        text = sys.stdin.read()
+
+    try:
+        data = json.loads(text)
+    except json.JSONDecodeError as e:
+        console.print(f"[red]✗ خطا:[/red] JSON نامعتبر: {e}")
+        raise typer.Exit(1)
+
+    try:
+        result = query(data, path)
+    except JSONPathError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+
+    # خروجی
+    if raw:
+        if isinstance(result, str):
+            console.print(result, highlight=False)
+        elif isinstance(result, (int, float, bool)) or result is None:
+            console.print(str(result), highlight=False)
+        else:
+            console.print(
+                json.dumps(result, ensure_ascii=False), highlight=False
+            )
+        return
+
+    if compact:
+        console.print(
+            json.dumps(result, ensure_ascii=False, separators=(",", ":")),
+            highlight=False,
+        )
+        return
+
+    if isinstance(result, str):
+        console.print(result)
+    elif isinstance(result, (int, float, bool)) or result is None:
+        console.print(str(result))
+    else:
+        text_out = json.dumps(result, ensure_ascii=False, indent=2)
+        console.print(
+            Syntax(text_out, "json", word_wrap=True, background_color="default")
+        )

persian_devkit/commands/json_cmd.py

@@ -0,0 +1,135 @@
+"""دستور `pdev json` — کار با فایل‌های JSON."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any, Optional
+
+import typer
+from rich.console import Console
+
+app = typer.Typer(help="کار با فایل‌های JSON.", no_args_is_help=True)
+console = Console()
+
+
+def _fail(message: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {message}")
+    raise typer.Exit(1)
+
+
+def _load(path: Path) -> Any:
+    """فایل JSON را می‌خواند و پارس می‌کند."""
+    try:
+        raw = path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        _fail(f"فایل یافت نشد: {path}")
+    except OSError as e:
+        _fail(f"خطا در خواندن فایل: {e}")
+    try:
+        return json.loads(raw)
+    except json.JSONDecodeError as e:
+        _fail(f"JSON نامعتبر: {e}")
+
+
+def _is_quiet(ctx: typer.Context) -> bool:
+    """آیا حالت quiet فعال است؟"""
+    try:
+        return bool(ctx.obj and ctx.obj.get("quiet"))
+    except Exception:
+        return False
+
+
+@app.command("pretty")
+def pretty_cmd(
+    ctx: typer.Context,
+    path: Path = typer.Argument(..., help="مسیر فایل JSON."),
+    indent: int = typer.Option(2, "--indent", "-i", min=0, max=10, help="تعداد فاصله."),
+    output: Optional[Path] = typer.Option(
+        None, "--output", "-o", help="ذخیره در فایل خروجی."
+    ),
+) -> None:
+    """زیباسازی JSON."""
+    data = _load(path)
+    text = json.dumps(data, ensure_ascii=False, indent=indent)
+    if output is not None:
+        output.write_text(text, encoding="utf-8")
+        if not _is_quiet(ctx):
+            console.print(f"[green]✓ ذخیره شد:[/green] {output}")
+    else:
+        console.print(text, highlight=False)
+
+
+@app.command("minify")
+def minify_cmd(
+    ctx: typer.Context,
+    path: Path = typer.Argument(..., help="مسیر فایل JSON."),
+    output: Optional[Path] = typer.Option(
+        None, "--output", "-o", help="ذخیره در فایل خروجی."
+    ),
+) -> None:
+    """فشرده‌سازی JSON."""
+    data = _load(path)
+    text = json.dumps(data, ensure_ascii=False, separators=(",", ":"))
+    if output is not None:
+        output.write_text(text, encoding="utf-8")
+        if not _is_quiet(ctx):
+            console.print(f"[green]✓ ذخیره شد:[/green] {output}")
+    else:
+        console.print(text, highlight=False)
+
+
+@app.command("validate")
+def validate_cmd(
+    ctx: typer.Context,
+    path: Path = typer.Argument(..., help="مسیر فایل JSON."),
+) -> None:
+    """بررسی صحت ساختار JSON."""
+    try:
+        raw = path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        _fail(f"فایل یافت نشد: {path}")
+    try:
+        json.loads(raw)
+    except json.JSONDecodeError as e:
+        _fail(f"JSON نامعتبر است: {e}")
+    if not _is_quiet(ctx):
+        console.print("[green]✓ JSON معتبر است.[/green]")
+
+
+@app.command("keys")
+def keys_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل JSON."),
+) -> None:
+    """نمایش کلیدهای سطح اول."""
+    data = _load(path)
+    if not isinstance(data, dict):
+        console.print("[yellow]⚠ هشدار:[/yellow] ساختار سطح اول شیء (object) نیست.")
+        raise typer.Exit(1)
+    for key in data.keys():
+        console.print(f"• {key}")
+
+
+def _flatten(obj: Any, prefix: str = "") -> dict[str, Any]:
+    """مسطح‌سازی JSON تودرتو به کلیدهای نقطه‌ای."""
+    result: dict[str, Any] = {}
+    if isinstance(obj, dict):
+        for key, value in obj.items():
+            new_key = f"{prefix}.{key}" if prefix else str(key)
+            result.update(_flatten(value, new_key))
+    elif isinstance(obj, list):
+        for idx, value in enumerate(obj):
+            new_key = f"{prefix}[{idx}]"
+            result.update(_flatten(value, new_key))
+    else:
+        result[prefix] = obj
+    return result
+
+
+@app.command("flatten")
+def flatten_cmd(
+    path: Path = typer.Argument(..., help="مسیر فایل JSON."),
+) -> None:
+    """مسطح‌سازی JSON تودرتو به کلیدهای نقطه‌ای."""
+    data = _load(path)
+    flat = _flatten(data)
+    console.print(json.dumps(flat, ensure_ascii=False, indent=2), highlight=False)

persian_devkit/commands/license_cmd.py

@@ -0,0 +1,67 @@
+"""دستور pdev license — تولید فایل لایسنس."""
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.license_data import LICENSES, list_licenses, render_license
+
+app = typer.Typer(help="تولید فایل لایسنس.", no_args_is_help=True)
+console = Console()
+
+
+@app.command("list")
+def list_cmd() -> None:
+    """نمایش لایسنس‌های موجود."""
+    table = Table(title="📜 لایسنس‌ها", title_style="bold cyan")
+    table.add_column("SPDX", style="bold")
+    table.add_column("نام")
+    for item in list_licenses():
+        table.add_row(item["spdx"], item["name"])
+    console.print(table)
+
+
+@app.command("show")
+def show_cmd(
+    spdx: str = typer.Argument(..., help="نام SPDX (مثل MIT، Apache-2.0)."),
+    author: str = typer.Option("Your Name", "--author", "-a", help="نام نویسنده."),
+    year: Optional[int] = typer.Option(None, "--year", "-y", help="سال (پیش‌فرض: الان)."),
+) -> None:
+    """نمایش متن لایسنس."""
+    if year is None:
+        year = datetime.now().year
+    try:
+        console.print(render_license(spdx, author, year), highlight=False)
+    except ValueError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+
+
+@app.command("new")
+def new_cmd(
+    spdx: str = typer.Argument(..., help="نام SPDX."),
+    author: str = typer.Option("Your Name", "--author", "-a", help="نام نویسنده."),
+    year: Optional[int] = typer.Option(None, "--year", "-y"),
+    output: Path = typer.Option(
+        Path("LICENSE"), "--output", "-o", help="مسیر فایل خروجی."
+    ),
+    force: bool = typer.Option(False, "--force", "-f", help="بازنویسی فایل موجود."),
+) -> None:
+    """ذخیرهٔ لایسنس در فایل."""
+    if year is None:
+        year = datetime.now().year
+    if output.exists() and not force:
+        console.print(f"[red]✗ خطا:[/red] فایل موجود است: {output} (از --force استفاده کن)")
+        raise typer.Exit(1)
+    try:
+        text = render_license(spdx, author, year)
+    except ValueError as e:
+        console.print(f"[red]✗ خطا:[/red] {e}")
+        raise typer.Exit(1)
+    output.write_text(text, encoding="utf-8")
+    console.print(f"[green]✓ ذخیره شد:[/green] {output}")

persian_devkit/commands/lorem_cmd.py

@@ -0,0 +1,53 @@
+"""دستور pdev lorem — تولید متن نمونهٔ فارسی."""
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from persian_devkit.utils.fake_utils import (
+    lorem_ipsum,
+    random_paragraph,
+    random_sentence,
+    random_words,
+)
+
+app = typer.Typer(help="تولید متن نمونهٔ فارسی.", no_args_is_help=True)
+console = Console()
+
+
+@app.command("paragraph")
+def paragraph_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=100),
+    sentences: int = typer.Option(4, "--sentences", "-s", min=1, max=20),
+) -> None:
+    """تولید پاراگراف متن نمونه."""
+    for i in range(count):
+        if i > 0:
+            console.print()
+        console.print(random_paragraph(sentences))
+
+
+@app.command("sentence")
+def sentence_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=100),
+) -> None:
+    """تولید جملهٔ تصادفی."""
+    for _ in range(count):
+        console.print(random_sentence())
+
+
+@app.command("words")
+def words_cmd(
+    count: int = typer.Option(5, "--count", "-c", min=1, max=200),
+) -> None:
+    """تولید چند کلمهٔ تصادفی فارسی."""
+    console.print(random_words(count))
+
+
+@app.command("all")
+def all_cmd(
+    paragraphs: int = typer.Option(3, "--paragraphs", "-p", min=1, max=20),
+    sentences: int = typer.Option(4, "--sentences", "-s", min=1, max=20),
+) -> None:
+    """تولید چند پاراگراف متن کامل."""
+    console.print(lorem_ipsum(paragraphs=paragraphs, sentences_per_paragraph=sentences))

persian_devkit/commands/name_cmd.py

@@ -0,0 +1,98 @@
+"""دستور pdev name — تولید نام، ایمیل و داده‌های نمونهٔ فارسی."""
+from __future__ import annotations
+
+import json
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from persian_devkit.utils.fake_utils import (
+    random_city,
+    random_email,
+    random_first_name,
+    random_full_name,
+    random_last_name,
+)
+
+app = typer.Typer(help="تولید نام و داده‌های نمونهٔ فارسی.", no_args_is_help=True)
+console = Console()
+
+
+@app.command("full")
+def full_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=200),
+    gender: str = typer.Option("any", "--gender", "-g", help="any|male|female"),
+) -> None:
+    """تولید نام و نام خانوادگی."""
+    if gender not in ("any", "male", "female"):
+        console.print(f"[red]✗ خطا:[/red] gender نامعتبر: {gender}")
+        raise typer.Exit(1)
+    for _ in range(count):
+        console.print(random_full_name(gender))
+
+
+@app.command("first")
+def first_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=200),
+    gender: str = typer.Option("any", "--gender", "-g"),
+) -> None:
+    """تولید نام کوچک."""
+    for _ in range(count):
+        console.print(random_first_name(gender))
+
+
+@app.command("last")
+def last_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=200),
+) -> None:
+    """تولید نام خانوادگی."""
+    for _ in range(count):
+        console.print(random_last_name())
+
+
+@app.command("city")
+def city_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=200),
+) -> None:
+    """تولید نام شهر ایرانی."""
+    for _ in range(count):
+        console.print(random_city())
+
+
+@app.command("email")
+def email_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=200),
+) -> None:
+    """تولید ایمیل نمونه."""
+    for _ in range(count):
+        console.print(random_email())
+
+
+@app.command("profile")
+def profile_cmd(
+    count: int = typer.Option(1, "--count", "-c", min=1, max=100),
+    output_json: bool = typer.Option(False, "--json", "-j", help="خروجی JSON."),
+) -> None:
+    """پروفایل کامل نمونه (نام، ایمیل، شهر)."""
+    profiles = [
+        {
+            "name": random_full_name(),
+            "email": random_email(),
+            "city": random_city(),
+        }
+        for _ in range(count)
+    ]
+
+    if output_json:
+        console.print(json.dumps(profiles, ensure_ascii=False, indent=2), highlight=False)
+        return
+
+    table = Table(title="👤 پروفایل‌های نمونه", title_style="bold cyan")
+    table.add_column("#", style="dim")
+    table.add_column("نام", style="bold")
+    table.add_column("ایمیل")
+    table.add_column("شهر")
+    for i, p in enumerate(profiles, 1):
+        table.add_row(str(i), p["name"], p["email"], p["city"])
+    console.print(table)

persian_devkit/commands/number_cmd.py

@@ -0,0 +1,65 @@
+"""دستور `pdev number` — تبدیل و قالب‌بندی اعداد."""
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from persian_devkit.utils.number_utils import (
+    format_thousands,
+    number_to_words,
+    to_english_digits,
+    to_persian_digits,
+)
+
+app = typer.Typer(help="تبدیل و قالب‌بندی اعداد.", no_args_is_help=True)
+console = Console()
+
+
+def _fail(message: str) -> None:
+    console.print(f"[red]✗ خطا:[/red] {message}")
+    raise typer.Exit(1)
+
+
+@app.command("to-persian")
+def to_persian(
+    value: str = typer.Argument(..., help="عدد یا رشته با ارقام لاتین."),
+) -> None:
+    """تبدیل ارقام لاتین/عربی به ارقام فارسی."""
+    console.print(to_persian_digits(value))
+
+
+@app.command("to-english")
+def to_english(
+    value: str = typer.Argument(..., help="عدد یا رشته با ارقام فارسی/عربی."),
+) -> None:
+    """تبدیل ارقام فارسی/عربی به ارقام لاتین."""
+    console.print(to_english_digits(value))
+
+
+@app.command("format")
+def format_cmd(
+    value: str = typer.Argument(..., help="عدد برای قالب‌بندی با جداکنندهٔ هزارگان."),
+) -> None:
+    """قالب‌بندی عدد با جداکنندهٔ هزارگان."""
+    cleaned = to_english_digits(value).replace(",", "").replace("٫", ".").strip()
+    try:
+        if "." in cleaned:
+            n_float = float(cleaned)
+            console.print(f"{n_float:,.2f}")
+        else:
+            n_int = int(cleaned)
+            console.print(format_thousands(n_int))
+    except ValueError:
+        _fail(f"عدد نامعتبر: {value}")
+
+
+@app.command("words")
+def words_cmd(
+    value: str = typer.Argument(..., help="عدد صحیح برای تبدیل به حروف فارسی."),
+) -> None:
+    """تبدیل عدد صحیح به معادل نوشتاری فارسی."""
+    try:
+        n = int(to_english_digits(value).strip())
+    except ValueError:
+        _fail(f"عدد نامعتبر: {value}")
+    console.print(number_to_words(n))