syscheck-cli 0.2.0__tar.gz

syscheck_cli-0.2.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: syscheck-cli
+Version: 0.2.0
+Summary: CLI utility for system diagnostics
+Requires-Python: >=3.10
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: textual>=0.80.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: pyinstaller>=6.0.0; extra == "dev"

syscheck_cli-0.2.0/README.md

@@ -0,0 +1,138 @@
+# syscheck
+
+CLI-утилита диагностики системы, как btop/htop, но с рабочими командами.
+Минималистичный ASCII-вывод: без рамок и emoji, только суть.
+
+## Установка
+
+### Быстро (нужен Python 3.10+)
+
+```bash
+pipx install syscheck-cli        # или: pip install syscheck-cli
+syscheck                          # живой дашборд
+```
+
+Без PyPI — прямо из GitHub:
+
+```bash
+pip install git+https://github.com/avofe/syscheck-cli
+```
+
+### Без Python (Windows): готовый .exe одной строкой
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/avofe/syscheck-cli/main/scripts/install.ps1 | iex"
+```
+
+Скрипт скачивает `syscheck-windows-x86_64.exe` с GitHub Releases, кладёт в
+`%LOCALAPPDATA%\syscheck` и добавляет в PATH. Python на машине не нужен.
+
+### Без Python (macOS/Linux)
+
+```bash
+curl -sSL https://raw.githubusercontent.com/avofe/syscheck-cli/main/scripts/install.sh | bash
+```
+
+### Из исходников
+
+```bash
+pip install -e .        # запуск: python -m syscheck
+```
+
+### Сборка exe (без Python у пользователя)
+
+```powershell
+.\scripts\build_exe.ps1     # → dist\syscheck-windows-x86_64.exe
+```
+
+### Публикация на PyPI (для автора)
+
+```bash
+pip install -e .[dev]
+python -m build                       # wheel + sdist в dist/
+twine upload dist/*                   # нужен аккаунт на pypi.org, токен
+```
+
+## Команды
+
+| Команда | Описание |
+|---------|----------|
+| `syscheck cpu` | Нагрузка CPU, ядра, частота |
+| `syscheck ram` | Оперативная память, топ процессов по RAM |
+| `syscheck disk` | Диски: место, состояние, I/O |
+| `syscheck net --ping 8.8.8.8` | Сеть: интерфейсы, трафик, пинг |
+| `syscheck proc --sort cpu` | Топ процессов (cpu/ram) |
+| `syscheck temp` | Температуры (если поддерживается) |
+| `syscheck sys` | ОС, uptime, hostname |
+| `syscheck all` | Вся диагностика сразу |
+| `syscheck watch` | Live-дашборд (обновление каждые N сек) |
+
+Каждая команда поддерживает `--json` для машинного вывода.
+
+## Интерактивный режим (TUI)
+
+Запуск `syscheck` без аргументов открывает интерактивную оболочку:
+живой дашборд сверху (обновляется каждые 2 с) и строка ввода:
+
+```
+> cpu          # нагрузка процессора
+> ram          # память
+> disk         # диски
+> net 8.8.8.8  # сеть и пинг
+> proc         # топ процессов
+> temp         # температуры
+> sys          # система
+> all          # всё сразу
+> help         # помощь
+> clear        # очистить
+> exit / ctrl+c # выйти
+```
+
+## Безопасность `!shell`
+
+Команда `!shell <cmd>` выполняет произвольные команды ОС прямо из TUI.
+По умолчанию она **ВЫКЛЮЧЕНА** и включается только явным флагом:
+
+```bash
+syscheck --enable-shell
+```
+
+- При первом включении показывается предупреждение — нужно набрать `yes`.
+- На **каждую** команду требуется подтверждение (повторить команду или `confirm`).
+- Каждое выполнение записывается в audit-лог:
+  `~/.syscheck/shell_audit.log`.
+- Настройки хранятся в `~/.syscheck/config.json`.
+
+## Плагины
+
+Свои команды добавляются через плагины:
+
+1. Создай файл `syscheck/plugins/мой_плагин.py`
+2. Наследуй класс `PluginBase` из `syscheck.plugin`
+3. Реализуй `execute()`
+4. Плагин подхватится автоматически
+
+```python
+from syscheck.plugin import PluginBase, register_plugin
+from syscheck.utils import console, print_value
+
+class MyPlugin(PluginBase):
+    name = "mycmd"
+    description = "Моя команда"
+    version = "0.1.0"
+
+    def execute(self, **kwargs):
+        print_value("hello", "syscheck!")
+
+register_plugin(MyPlugin())
+```
+
+Запуск: `syscheck plugins --list` и `syscheck plugins --run mycmd`
+
+## Пример использования
+
+```bash
+syscheck sys          # общее состояние системы
+syscheck watch        # живой дашборд
+syscheck proc --sort ram   # кто ест память
+```

syscheck_cli-0.2.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "syscheck-cli"
+version = "0.2.0"
+description = "CLI utility for system diagnostics"
+requires-python = ">=3.10"
+dependencies = [
+    "psutil>=5.9.0",
+    "rich>=13.0.0",
+    "typer>=0.9.0",
+    "textual>=0.80.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "build>=1.0.0",
+    "twine>=4.0.0",
+    "pyinstaller>=6.0.0",
+]
+
+[project.scripts]
+syscheck = "syscheck.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["syscheck*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

syscheck_cli-0.2.0/setup.cfg

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

syscheck_cli-0.2.0/syscheck/__init__.py

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

syscheck_cli-0.2.0/syscheck/__main__.py

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

syscheck_cli-0.2.0/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_cli-0.2.0/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_cli-0.2.0/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_cli-0.2.0/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_cli-0.2.0/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_cli-0.2.0/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_cli-0.2.0/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)