syscheck-cli 0.2.0__py3-none-any.whl

syscheck/__init__.py

@@ -0,0 +1,2 @@
+"""syscheck — CLI-утилита диагностики системы."""
+__version__ = "0.2.0"

syscheck/__main__.py

@@ -0,0 +1,4 @@
+"""Allow running as: python -m syscheck"""
+from syscheck.cli import main
+
+main()

syscheck/cli.py

@@ -0,0 +1,134 @@
+"""Главный entry point для syscheck CLI."""
+import sys
+import typer
+from rich.console import Console
+
+# Windows console encoding fix (support emoji/unicode)
+if sys.platform == "win32":
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+
+from syscheck import __version__
+from syscheck.plugin import get_plugins
+
+app = typer.Typer(
+    name="syscheck",
+    help="syscheck — CLI-утилита диагностики системы",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+console = Console()
+
+
+def version_callback(value: bool):
+    if value:
+        console.print(f"syscheck v{__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main_cb(
+    version: bool = typer.Option(
+        False, "--version", "-v", callback=version_callback, is_eager=True,
+        help="Показать версию",
+    ),
+):
+    """syscheck — диагностика системы из терминала.
+
+    Запуск без аргументов открывает интерактивную оболочку (TUI).
+    syscheck <команда> — одиночная проверка. --help по командам.
+    """
+
+
+# Импорт и регистрация команд
+from syscheck.commands.cpu import cpu_cmd
+from syscheck.commands.ram import ram_cmd
+from syscheck.commands.disk import disk_cmd
+from syscheck.commands.net import net_cmd
+from syscheck.commands.proc import proc_cmd
+from syscheck.commands.temp import temp_cmd
+from syscheck.commands.sys import sys_cmd
+from syscheck.commands.watch import watch_cmd
+
+app.command("cpu")(cpu_cmd)
+app.command("ram")(ram_cmd)
+app.command("disk")(disk_cmd)
+app.command("net")(net_cmd)
+app.command("proc")(proc_cmd)
+app.command("temp")(temp_cmd)
+app.command("sys")(sys_cmd)
+app.command("watch")(watch_cmd)
+
+
+@app.command("all")
+def all_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Показать все метрики системы."""
+    from syscheck.commands.cpu import show_cpu
+    from syscheck.commands.ram import show_ram
+    from syscheck.commands.disk import show_disk
+    from syscheck.commands.net import show_net
+    from syscheck.commands.temp import show_temp
+    from syscheck.commands.sys import show_sys
+
+    console.rule("syscheck — Полная диагностика")
+    console.print()
+    show_cpu()
+    console.print()
+    show_ram()
+    console.print()
+    show_disk()
+    console.print()
+    show_net()
+    console.print()
+    show_temp()
+    console.print()
+    show_sys()
+
+
+@app.command("plugins")
+def plugins_cmd(
+    list_plugins: bool = typer.Option(False, "--list", "-l", help="Список плагинов"),
+    plugin_name: str = typer.Option(None, "--run", "-r", help="Запустить плагин"),
+):
+    """Управление плагинами."""
+    plugins = get_plugins()
+
+    if not plugins:
+        console.print("[dim]Плагины не найдены. Добавьте .py файлы в syscheck/plugins/[/]")
+        return
+
+    if list_plugins or (not plugin_name):
+        from rich.table import Table
+        table = Table(title="Доступные плагины", show_header=True, header_style="bold cyan")
+        table.add_column("Имя", style="green")
+        table.add_column("Описание")
+        table.add_column("Версия", style="dim")
+        for name, p in plugins.items():
+            table.add_row(name, p.description, p.version)
+        console.print(table)
+        return
+
+    if plugin_name:
+        plugin = plugins.get(plugin_name)
+        if plugin:
+            plugin.execute()
+        else:
+            console.print(f"[red]Плагин '{plugin_name}' не найден.[/]")
+            console.print(f"Доступные: {', '.join(plugins.keys())}")
+
+
+def main():
+    """Точка входа: без аргументов → TUI, с аргументами → CLI."""
+    enable_shell = False
+    args = list(sys.argv[1:])
+    if "--enable-shell" in args:
+        enable_shell = True
+        args.remove("--enable-shell")
+        sys.argv = [sys.argv[0]] + args
+    if len(args) <= 0:
+        from syscheck.tui import run as run_tui
+        run_tui(enable_shell=enable_shell)
+    else:
+        app()

syscheck/cmdlang.py

@@ -0,0 +1,109 @@
+"""Командный язык syscheck.
+
+Грамматика разделена на группы:
+
+    Info       cpu, ram, gpu, disk, battery, temp
+    Processes  process list/find/kill/stop/resume/restart/details/sort
+    Network    network (speeds/interfaces/connections/ping)
+    Display    watch, refresh
+    System     system, all, help, clear, exit
+
+Список COMMANDS — единый источник: он же питает Command Palette (Ctrl+P)
+и справку `help`. Обработчики реализованы в TUI как методы `_cmd_*`;
+этот модуль только описывает команды и генерирует текст справки/палитры.
+"""
+from __future__ import annotations
+
+CATEGORIES = ["Info", "Processes", "Network", "Battery", "Display", "System"]
+
+# (команда, категория, описание, нужен ли фоновый поток)
+COMMANDS = [
+    ("cpu", "Info", "CPU information", True),
+    ("ram", "Info", "Memory information", True),
+    ("gpu", "Info", "GPU information", True),
+    ("disk", "Info", "disk list | info X: | io", True),
+    ("battery", "Battery", "Battery status", True),
+    ("temp", "Info", "Temperatures", True),
+    ("network", "Network", "network | connections | interfaces | speeds | ping", True),
+    ("net", "Network", "alias: net [host]", True),
+    ("process", "Processes", "process list | find | kill | stop | resume | restart | details | sort", True),
+    ("proc", "Processes", "top processes by cpu|ram|name", True),
+    ("system", "System", "System information", True),
+    ("all", "System", "everything at once", True),
+    ("watch", "Display", "watch cpu | network | process [name] | off", False),
+    ("settings", "Display", "show settings & config path", False),
+    ("refresh", "Display", "refresh dashboard now", False),
+    ("help", "System", "show this help", False),
+    ("clear", "System", "clear terminal output", False),
+    ("exit", "System", "quit (alias: quit)", False),
+]
+
+# скрытые алиасы (не показываются в справке/палитре)
+_ALIASES = {
+    "quit": ("exit", ""),
+}
+
+
+def command_list() -> list:
+    """Полный список команд палитры (без алиасов)."""
+    out = []
+    for cmd, cat, desc, thread in COMMANDS:
+        out.append({"cmd": cmd, "cat": cat, "desc": desc, "thread": thread})
+    return out
+
+
+def lookup(words: list) -> dict | None:
+    """Находит запись команды по первым словам (с учётом алиасов)."""
+    first = (words[0] if words else "").lower()
+    if first in _ALIASES:
+        cmd, _ = _ALIASES[first]
+    else:
+        cmd = first
+    for c, cat, desc, thread in COMMANDS:
+        if c == cmd:
+            return {"cmd": c, "cat": cat, "desc": desc, "thread": thread}
+    return None
+
+
+def expected_args(cmd: str) -> str:
+    """Подсказка по аргументам команды (для справки по одной команде)."""
+    guide = {
+        "disk": "disk list | disk info C: | disk io",
+        "network": "network | network connections | network interfaces | network speeds | network ping <host>",
+        "net": "net [host]",
+        "process": "process list [name] | process find <name|pid> | process sort cpu|ram|name |"
+                   " process details <name|pid> | process kill|stop|resume|restart <name|pid>",
+        "proc": "proc cpu | proc ram | proc name",
+        "watch": "watch cpu | watch network | watch process [name] | watch off",
+        "cpu": "cpu",
+        "ram": "ram",
+        "gpu": "gpu",
+        "battery": "battery",
+        "temp": "temp",
+        "system": "system",
+        "all": "all",
+        "settings": "settings",
+        "refresh": "refresh",
+    }
+    return guide.get(cmd, "")
+
+
+def help_text() -> str:
+    """Полная справка по группам."""
+    lines = ["[bold]syscheck commands[/]"]
+    for cat in CATEGORIES:
+        items = [(c, d, t) for c, cc, d, t in COMMANDS if cc == cat]
+        if not items:
+            continue
+        lines.append(f"  [dim]{cat}[/]")
+        for c, d, t in items:
+            lines.append(f"    [cyan]{c:<10}[/] {d}")
+    lines.append("")
+    lines.append("[dim]ctrl+p  command palette     ↑↓ history      · in processes table:[/]")
+    lines.append("[dim]  Enter details, K kill, S stop, R restart, / search[/]")
+    return "\n".join(lines)
+
+
+def help_for(cmd: str) -> str:
+    args = expected_args(cmd)
+    return f"[cyan]{cmd}[/] {args}" if args else f"[dim]nothing more about '{cmd}'[/]"

syscheck/commands/__init__.py

@@ -0,0 +1,8 @@
+from syscheck.commands.cpu import cpu_cmd
+from syscheck.commands.ram import ram_cmd
+from syscheck.commands.disk import disk_cmd
+from syscheck.commands.net import net_cmd
+from syscheck.commands.proc import proc_cmd
+from syscheck.commands.temp import temp_cmd
+from syscheck.commands.sys import sys_cmd
+from syscheck.commands.watch import watch_cmd

syscheck/commands/cpu.py

@@ -0,0 +1,45 @@
+"""Команда syscheck cpu — диагностика процессора."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import console, make_bar, print_value, print_header, get_color_for_percent
+
+
+def show_cpu() -> None:
+    data = providers.cpu_info()
+    per_cpu = data["per_cpu"] or []
+
+    print_header("cpu")
+
+    colour = get_color_for_percent(data["percent"])
+    console.print(
+        f"load        [{colour}]{data['percent']}%[/] {make_bar(data['percent'])}"
+    )
+    print_value("cores", f"{data['count_physical'] or '?'} physical / {data['count_logical']} logical")
+    if data["freq_current"]:
+        freq = f"{data['freq_current']:.0f} MHz"
+        if data["freq_max"]:
+            freq += f" (max {data['freq_max']:.0f} MHz)"
+        print_value("freq", freq)
+    if per_cpu:
+        parts = "  ".join(
+            f"[{get_color_for_percent(p)}]{i}: {p:.0f}[/]" for i, p in enumerate(per_cpu)
+        )
+        console.print(f"per-core    {parts}")
+
+    if data["percent"] >= 90:
+        console.print("  [red][!] CPU сильно нагружен[/]")
+    elif data["percent"] >= 75:
+        console.print("  [yellow][!] CPU заметно нагружен[/]")
+
+
+def cpu_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Диагностика процессора (нагрузка, ядра, частота)."""
+    if output_json:
+        console.print_json(json.dumps(providers.cpu_info(), indent=2))
+    else:
+        show_cpu()

syscheck/commands/disk.py

@@ -0,0 +1,61 @@
+"""Команда syscheck disk — диагностика дисков."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import (
+    console, make_bar, print_value, print_header, get_color_for_percent, bytes_to_human,
+    print_error, print_warning,
+)
+
+
+def show_disk() -> None:
+    data = providers.disk_info()
+
+    print_header("disks")
+
+    if not data["disks"]:
+        console.print("[dim]диски не найдены[/]")
+        return
+
+    for d in data["disks"]:
+        colour = get_color_for_percent(d["percent"])
+        console.print(
+            f"{d['device'].ljust(8)} [{colour}]{d['percent']:4.1f}%[/] {make_bar(d['percent'])}  "
+            f"{bytes_to_human(d['used'])} / {bytes_to_human(d['total'])}  "
+            f"(free {bytes_to_human(d['free'])})"
+        )
+
+    io = data["io"]
+    if io:
+        console.print()
+        print_header("io")
+        print_value("read", bytes_to_human(io.read_bytes))
+        print_value("write", bytes_to_human(io.write_bytes))
+
+    for d in data["disks"]:
+        if d["percent"] > 95:
+            print_error(f"{d['device']}: критически мало места!")
+        elif d["percent"] > 85:
+            print_warning(f"{d['device']}: мало свободного места")
+
+
+def disk_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Диагностика дисков (место, состояние, I/O)."""
+    if output_json:
+        out = []
+        for d in providers.disk_info()["disks"]:
+            out.append({
+                "device": d["device"],
+                "mountpoint": d["mountpoint"],
+                "total": d["total"],
+                "used": d["used"],
+                "free": d["free"],
+                "percent": d["percent"],
+            })
+        console.print_json(json.dumps(out, indent=2))
+    else:
+        show_disk()

syscheck/commands/net.py

@@ -0,0 +1,59 @@
+"""Команда syscheck net — диагностика сети."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import (
+    console, print_value, print_header, bytes_to_human, print_ok, print_warning, print_error,
+)
+
+
+def show_net(ping_host: str = "8.8.8.8") -> None:
+    data = providers.net_info()
+
+    print_header("network")
+
+    for i in data["interfaces"]:
+        status = "[green]up[/]" if i["up"] else "[dim]down[/]"
+        ip = ", ".join(i["ipv4"]) if i["ipv4"] else "[dim]N/A[/]"
+        speed = f"{i['speed']} Mbps" if i["speed"] else "-"
+        console.print(f"  {status}  {i['name'].ljust(28)} {ip.ljust(18)} {speed}")
+        if i["mac"]:
+            console.print(f"{'':2}      mac: {', '.join(i['mac'])}")
+
+    io = data["io"]
+    if io:
+        console.print()
+        print_value("sent", bytes_to_human(io["bytes_sent"]))
+        print_value("recv", bytes_to_human(io["bytes_recv"]))
+        print_value("packets", f"{io['packets_sent']} / {io['packets_recv']}")
+
+    console.print()
+    print_header(f"ping {ping_host}")
+    result = providers.ping(ping_host)
+    if result["success"]:
+        if result["avg_ms"] is not None:
+            print_ok(f"{result['host']}: {result['avg_ms']:.1f} ms "
+                     f"(min {result['min_ms']:.1f}, max {result['max_ms']:.1f})")
+        else:
+            print_ok(f"{result['host']}: пинг прошёл (время не определено)")
+        if result["lost"] > 0:
+            print_warning(f"потеряно {result['lost']}/{result['total']} пакетов")
+        if result["avg_ms"] and result["avg_ms"] > 100:
+            print_warning("высокий пинг")
+    else:
+        print_error(f"{ping_host}: недоступен")
+
+
+def net_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+    ping_host: str = typer.Option("8.8.8.8", "--ping", "-p", help="Хост для пинга"),
+):
+    """Диагностика сети (интерфейсы, трафик, пинг)."""
+    if output_json:
+        data = providers.net_info()
+        data["ping"] = providers.ping(ping_host)
+        console.print_json(json.dumps(data, indent=2))
+    else:
+        show_net(ping_host)

syscheck/commands/proc.py

@@ -0,0 +1,35 @@
+"""Команда syscheck proc — топ процессов."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import console, print_header, get_color_for_percent
+
+
+def show_proc(sort_by: str = "cpu", limit: int = 15) -> None:
+    data = providers.processes(sort_by=sort_by, limit=limit)
+
+    print_header(f"processes by {sort_by}")
+
+    for p in data:
+        cpu = p.get("cpu_percent") or 0
+        ram = p.get("memory_percent") or 0
+        status = p.get("status", "?")
+        console.print(
+            f"  {p['pid']:<8} {(p['name'] or '?')[:28]:<28} "
+            f"cpu[{get_color_for_percent(cpu)}]{cpu:5.1f}[/]  "
+            f"ram[{get_color_for_percent(ram)}]{ram:5.1f}[/]  {status}"
+        )
+
+
+def proc_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+    sort_by: str = typer.Option("cpu", "--sort", "-s", help="Сортировка: cpu, ram, name"),
+    limit: int = typer.Option(15, "--limit", "-n", help="Количество процессов"),
+):
+    """Топ процессов по CPU/RAM."""
+    if output_json:
+        console.print_json(json.dumps(providers.processes(sort_by=sort_by, limit=limit), indent=2))
+    else:
+        show_proc(sort_by, limit)

syscheck/commands/ram.py

@@ -0,0 +1,49 @@
+"""Команда syscheck ram — диагностика оперативной памяти."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import (
+    console, make_bar, print_value, print_header, get_color_for_percent, bytes_to_human,
+)
+
+
+def show_ram() -> None:
+    data = providers.ram_info()
+
+    print_header("ram")
+
+    colour = get_color_for_percent(data["percent"])
+    console.print(
+        f"usage       [{colour}]{data['percent']}%[/] {make_bar(data['percent'])}"
+    )
+    print_value("used", f"{bytes_to_human(data['used'])} / {bytes_to_human(data['total'])}")
+    print_value("free", bytes_to_human(data["available"]))
+    if data["swap_total"] > 0:
+        print_value("swap", f"{data['swap_percent']}% ({bytes_to_human(data['swap_total'])})")
+
+    if data["top_procs"]:
+        console.print()
+        print_header("top by ram")
+        for p in data["top_procs"]:
+            pct = p["memory_percent"] or 0
+            pc = get_color_for_percent(pct)
+            console.print(
+                f"  {p['pid']:<8} {(p['name'] or '?')[:28]:<28} [{pc}]{pct:5.1f}%[/]"
+            )
+
+    if data["percent"] >= 90:
+        console.print("  [red][!] память почти исчерпана[/]")
+    elif data["percent"] >= 85:
+        console.print("  [yellow][!] много памяти используется[/]")
+
+
+def ram_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Диагностика оперативной памяти."""
+    if output_json:
+        console.print_json(json.dumps(providers.ram_info(), indent=2))
+    else:
+        show_ram()

syscheck/commands/sys.py

@@ -0,0 +1,43 @@
+"""Команда syscheck sys — информация о системе."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import (
+    console, print_header, print_value, seconds_to_human, get_color_for_percent, bytes_to_human,
+)
+
+
+def show_sys() -> None:
+    data = providers.system_info()
+
+    print_header("system")
+
+    print_value("os", f"{data['os']} ({data['machine']})")
+    print_value("hostname", data["node"])
+    print_value("processor", data["processor"])
+    print_value("uptime", f"{seconds_to_human(data['uptime_seconds'])} (since {data['boot_datetime']})")
+    print_value("python", data["python"])
+    if data["users"]:
+        print_value("users", ", ".join(data["users"]))
+
+    console.print()
+    quick = providers.system_quick()
+    print_header("summary")
+    console.print(f"cpu         [{get_color_for_percent(quick['cpu_percent'])}]{quick['cpu_percent']}%[/]")
+    console.print(f"ram         [{get_color_for_percent(quick['ram_percent'])}]{quick['ram_percent']}%[/]  (free {bytes_to_human(quick['ram_available'])})")
+    if quick.get("main_percent") is not None:
+        console.print(f"disk        [{get_color_for_percent(quick['main_percent'])}]{quick['main_percent']}%[/]  (free {bytes_to_human(quick['main_free'])})")
+    if quick.get("net_sent") is not None:
+        console.print(f"network     sent {bytes_to_human(quick['net_sent'])}  recv {bytes_to_human(quick['net_recv'])}")
+
+
+def sys_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Информация о системе (ОС, uptime, hostname)."""
+    if output_json:
+        console.print_json(json.dumps(providers.system_info(), indent=2))
+    else:
+        show_sys()

syscheck/commands/temp.py

@@ -0,0 +1,50 @@
+"""Команда syscheck temp — температура сенсоров."""
+import json
+
+import typer
+
+from syscheck import providers
+from syscheck.utils import console, print_header, print_value, print_warning, print_error
+
+
+def show_temp() -> None:
+    data = providers.temperatures()
+
+    print_header("temperatures")
+
+    if not data["available"]:
+        console.print("[dim]температуры не поддерживаются на этой системе через psutil[/]")
+        console.print("[dim](hwinfo / coretemp на windows)[/]")
+        return
+
+    printed = False
+    for name, entries in data["temps"].items():
+        for e in entries:
+            current = e.current
+            high = e.high
+            critical = e.critical
+            printed = True
+            print_value(name, f"{current:.0f}°C")
+            if high and current >= high:
+                print_warning(f"{name}: выше нормы ({current}°C >= {high}°C)")
+            if critical and current >= critical:
+                print_error(f"{name}: критическая! ({current}°C >= {critical}°C)")
+    if not printed:
+        console.print("[dim]датчиков температуры нет[/]")
+
+
+def temp_cmd(
+    output_json: bool = typer.Option(False, "--json", "-j", help="Вывод в JSON"),
+):
+    """Температура сенсоров (CPU, GPU, SSD)."""
+    if output_json:
+        data = providers.temperatures()
+        out = {}
+        for name, entries in data["temps"].items():
+            out[name] = [
+                {"current": e.current, "high": e.high, "critical": e.critical}
+                for e in entries
+            ]
+        console.print_json(json.dumps(out, indent=2))
+    else:
+        show_temp()