small-software 0.6.0__py3-none-any.whl

small_cli/commands/env.py

@@ -0,0 +1,151 @@
+"""small env: переменные приложения. set/unset меняют их сразу в Railway и в small.json — иначе следующий
+small deploy вернул бы старые значения из small.json."""
+
+import argparse
+import json
+
+from ..common import CliError, app_dir, is_linked, require_token, say
+from ..config import CONFIG_FILE, ENV_NAME_RE, STATE_FILE, load_config, load_state
+from ..i18n import tr
+from ..railway import Railway, token_from_env
+
+
+def register(sub):
+    e = sub.add_parser("env", help=tr("app environment variables: list, set, unset",
+                                      "переменные приложения: список, задать, удалить"),
+                       description=tr("App environment variables. set/unset change them in both Railway and %s "
+                                      "at once (otherwise the next small deploy would bring back the old values), "
+                                      "then Railway restarts the app. With no subcommand, lists them.",
+                                      "Переменные приложения. set/unset меняют их сразу и в Railway, и в %s "
+                                      "(иначе следующий small deploy вернул бы старые значения), затем Railway "
+                                      "перезапускает приложение. Без подкоманды — список.") % CONFIG_FILE)
+    e.add_argument("-C", "--path", default=".", help=tr("app folder (default: current folder)",
+                                                        "папка приложения (по умолчанию текущая)"))
+    e.set_defaults(func=cmd_env_list, values=False)
+    env_sub = e.add_subparsers(dest="env_command", metavar="<list|set|unset>")
+    el = env_sub.add_parser("list", help=tr("list variables (values hidden)", "показать переменные (значения скрыты)"))
+    el.add_argument("--values", action="store_true", help=tr("show values", "показать значения"))
+    el.set_defaults(func=cmd_env_list)
+    es = env_sub.add_parser("set", help=tr("set variables: small env set KEY=VALUE ...",
+                                           "задать переменные: small env set KEY=VALUE ..."))
+    es.add_argument("pairs", nargs="+", metavar="KEY=VALUE")
+    es.set_defaults(func=cmd_env_set)
+    eu = env_sub.add_parser("unset", help=tr("remove variables: small env unset KEY ...",
+                                             "удалить переменные: small env unset KEY ..."))
+    eu.add_argument("names", nargs="+", metavar="KEY")
+    eu.set_defaults(func=cmd_env_unset)
+    for parser in (el, es, eu):
+        parser.add_argument("-C", "--path", default=argparse.SUPPRESS, help=tr("app folder", "папка приложения"))
+    for parser in (es, eu):
+        add_no_deploy(parser)
+
+
+def add_no_deploy(parser):
+    parser.add_argument("--no-deploy", action="store_true",
+                        help=tr("don't restart the app (changes take effect on the next deploy)",
+                                "не перезапускать приложение (изменения вступят в силу при следующем деплое)"))
+
+
+def change_env(root, set_vars=None, unset=(), deploy=True, railway_only=None):
+    """Меняет переменные в Railway (если приложение задеплоено) и в small.json — чтобы они не расходились.
+
+    Сначала Railway: если он откажет, small.json остаётся прежним. railway_only — переменные, которые small ведёт
+    сам и в small.json не пишет (например, PUBLIC_URL). Возвращает True, если трогали Railway.
+    """
+    set_vars, unset = dict(set_vars or {}), list(unset)
+    config_path, state = root / CONFIG_FILE, load_state(root / STATE_FILE)
+    load_config(config_path)  # битый small.json — ошибка до любых изменений
+    raw = json.loads(config_path.read_text(encoding="utf-8-sig")) if config_path.is_file() else {}
+
+    if is_linked(state):
+        api = Railway(require_token())
+        ids = (state["projectId"], state["environmentId"], state["serviceId"])
+        existing = api.service_variables(*ids)
+        upsert = dict(set_vars, **(railway_only or {}))
+        if upsert:
+            api.upsert_variables(*ids, upsert)
+        for name in unset:
+            if name in existing:
+                api.delete_variable(*ids, name)
+        if deploy:
+            api.redeploy(state["serviceId"], state["environmentId"])
+
+    env = raw.setdefault("env", {})
+    env.update(set_vars)
+    for name in unset:
+        env.pop(name, None)
+    config_path.write_text(json.dumps(raw, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    return is_linked(state)
+
+
+def report_env_change(linked, deploy, what):
+    if not linked:
+        say(tr("%s. Saved to %s; the app is not deployed yet, Railway gets it on small deploy.",
+               "%s. Записано в %s; приложение ещё не задеплоено — в Railway попадёт при small deploy.")
+            % (what, CONFIG_FILE))
+    elif deploy:
+        say(tr("%s. Updated in Railway and %s; Railway is restarting the app (follow with small logs -f).",
+               "%s. Обновлено в Railway и %s, Railway перезапускает приложение (small logs -f — следить).")
+            % (what, CONFIG_FILE))
+    else:
+        say(tr("%s. Updated in Railway and %s; takes effect on the next deploy.",
+               "%s. Обновлено в Railway и %s, вступит в силу при следующем деплое.") % (what, CONFIG_FILE))
+
+
+def cmd_env_list(args):
+    root = app_dir(args.path)
+    config_env = load_config(root / CONFIG_FILE)["env"]
+    state = load_state(root / STATE_FILE)
+    railway_env = None
+    if is_linked(state):
+        if token_from_env():
+            # unrendered: ссылка ${{Postgres.DATABASE_URL}} из small.json совпадёт с записанной в Railway,
+            # а пароль базы не попадёт в терминал даже с --values.
+            railway_env = {k: v for k, v in Railway(token_from_env()).service_variables(
+                state["projectId"], state["environmentId"], state["serviceId"], unrendered=True).items()
+                if not k.startswith("RAILWAY_")}
+        else:
+            say(tr("No RAILWAY_API_TOKEN, showing %s only", "Нет RAILWAY_API_TOKEN — показываю только %s")
+                % CONFIG_FILE)
+    names = sorted(set(config_env) | set(railway_env or {}))
+    if not names:
+        say(tr("No variables. Set one: small env set KEY=VALUE", "Переменных нет. Задать: small env set KEY=VALUE"))
+        return 0
+    width = max(len(n) for n in names) + 2
+    for name in names:
+        in_config, in_railway = name in config_env, railway_env is not None and name in railway_env
+        value = railway_env[name] if in_railway else config_env[name]
+        if in_config and in_railway:
+            where = CONFIG_FILE + " + Railway" if config_env[name] == railway_env[name] else "Railway ≠ " + CONFIG_FILE
+        elif in_railway:
+            where = tr("Railway only", "только Railway")
+        else:
+            where = CONFIG_FILE + (tr(" (in Railway after small deploy)", " (в Railway — после small deploy)")
+                                   if railway_env is not None else "")
+        shown = value if getattr(args, "values", False) else "•" * min(len(value), 8) + " (%d)" % len(value)
+        print("%-*s%-24s %s" % (width, name, shown, where))
+    if not getattr(args, "values", False):
+        say(tr("Values hidden: small env list --values", "Значения скрыты: small env list --values"))
+    return 0
+
+
+def cmd_env_set(args):
+    root = app_dir(args.path)
+    pairs = {}
+    for pair in args.pairs:
+        name, sep, value = pair.partition("=")
+        if not sep or not ENV_NAME_RE.match(name):
+            raise CliError(tr("expected KEY=VALUE (KEY: Latin letters, digits, _; must not start with a digit), "
+                              "got: %s",
+                              "ожидается KEY=VALUE (KEY — латиница, цифры, _; не с цифры), получено: %s") % pair)
+        pairs[name] = value
+    linked = change_env(root, set_vars=pairs, deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Set: ", "Заданы: ") + ", ".join(sorted(pairs)))
+    return 0
+
+
+def cmd_env_unset(args):
+    root = app_dir(args.path)
+    linked = change_env(root, unset=args.names, deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Removed: ", "Удалены: ") + ", ".join(args.names))
+    return 0

small_cli/commands/init.py

@@ -0,0 +1,86 @@
+"""small init: заготовка приложения из шаблона — сервер с защитой по ссылке-приглашению,
+small.json с уникальным именем и ACCESS_TOKEN, .gitignore и .railwayignore."""
+
+import argparse
+import json
+import secrets
+from pathlib import Path
+
+from .. import scaffold
+from ..common import CliError, confirm, say, slugify
+from ..config import CONFIG_FILE
+from ..i18n import tr
+
+
+def register(sub):
+    templates = "\n".join("  %-12s %s" % (k, scaffold.description(k)) for k in scaffold.TEMPLATES)
+    i = sub.add_parser("init", help=tr("create a micro-app skeleton", "создать заготовку микро-приложения"),
+                       description=tr("Create a micro-app skeleton: a server protected by an invite link, "
+                                      "%s, .gitignore and .railwayignore. Existing files are not overwritten "
+                                      "without confirmation.",
+                                      "Создать заготовку микро-приложения: сервер с защитой по ссылке-приглашению, "
+                                      "%s, .gitignore и .railwayignore. Существующие файлы не перезаписываются "
+                                      "без подтверждения.") % CONFIG_FILE,
+                       epilog=tr("Templates:\n", "Шаблоны:\n") + templates,
+                       formatter_class=argparse.RawDescriptionHelpFormatter)
+    i.add_argument("path", nargs="?", default=".",
+                   help=tr("app folder (default: current folder)", "папка приложения (по умолчанию текущая)"))
+    i.add_argument("-t", "--template", choices=list(scaffold.TEMPLATES), default=scaffold.DEFAULT_TEMPLATE,
+                   help=tr("template (default: %s)", "шаблон (по умолчанию %s)") % scaffold.DEFAULT_TEMPLATE)
+    i.add_argument("--name", help=tr("project name (default: folder name with a random suffix)",
+                                     "имя проекта (по умолчанию — имя папки со случайным суффиксом)"))
+    i.add_argument("--force", action="store_true",
+                   help=tr("overwrite existing files without asking", "перезаписать существующие файлы без вопросов"))
+    i.set_defaults(func=cmd_init)
+
+
+def cmd_init(args):
+    root = Path(args.path).resolve()
+    if root.exists() and not root.is_dir():
+        raise CliError(tr("%s is a file, not a folder", "%s — это файл, а не папка") % root)
+    name = slugify(args.name) if args.name else unique_name(root.name)
+    config = {"name": name, "env": {"ACCESS_TOKEN": secrets.token_urlsafe(32)}}
+    files = scaffold.template_files(args.template)
+    files[CONFIG_FILE] = (json.dumps(config, indent=2, ensure_ascii=False) + "\n").encode("utf-8")
+
+    # Ignore-файлы не перезаписываются, а дополняются, поэтому конфликтом не считаются.
+    conflicts = [rel for rel in files if (root / rel).exists()]
+    if conflicts and not args.force:
+        listing = ", ".join(conflicts)
+        if not confirm(tr("%s already contains: %s. Overwrite? [y/N] ",
+                          "В %s уже есть: %s. Перезаписать? [y/N] ") % (root, listing)):
+            raise CliError(tr("%s already contains: %s. Nothing was changed. To overwrite, add --force",
+                              "в %s уже есть: %s. Ничего не изменено. Чтобы перезаписать, добавьте --force")
+                           % (root, listing))
+
+    root.mkdir(parents=True, exist_ok=True)
+    for rel, content in files.items():
+        (root / rel).write_bytes(content)
+    merged = {rel: scaffold.merge_ignore(root / rel, lines)
+              for rel, lines in scaffold.ignore_rules(args.template).items()}
+
+    labels = {"created": tr("created", "создан"), "updated": tr("updated", "дополнен"),
+              "unchanged": tr("unchanged", "без изменений")}
+    say(tr("Template %s in %s:", "Шаблон %s в %s:") % (args.template, root))
+    width = max(len(rel) for rel in list(files) + list(merged)) + 2
+    for rel in files:
+        say("  %-*s%s" % (width, rel, tr("overwritten", "перезаписан") if rel in conflicts
+                          else tr("created", "создан")))
+    for rel, result in merged.items():
+        say("  %-*s%s" % (width, rel, labels[result]))
+    say("")
+    say(tr("Project name: %s. ACCESS_TOKEN generated in %s; the file is in .gitignore, do not publish it.",
+           "Имя проекта: %s. В %s сгенерирован ACCESS_TOKEN; файл добавлен в .gitignore, не публикуйте его.")
+        % (name, CONFIG_FILE))
+    say(tr("Next:", "Дальше:"))
+    if root != Path.cwd().resolve():
+        say("  cd \"%s\"" % root)
+    say("  small deploy")
+    say(tr("  small open        # open with the invite link", "  small open        # открыть по ссылке-приглашению"))
+    return 0
+
+
+def unique_name(folder_name):
+    """Имя папки + случайный суффикс: явное имя из small.json привязывает деплой к одноимённому проекту,
+    поэтому оно не должно совпасть с чужим проектом, а поддомен <name>.up.railway.app — с занятым."""
+    return "%s-%s" % (slugify(folder_name)[:35].strip("-") or "app", secrets.token_hex(2))

small_cli/commands/link.py

@@ -0,0 +1,53 @@
+"""small link / small open: ссылка-приглашение задеплоенного приложения (общая или личная, --as ИМЯ)."""
+
+import webbrowser
+
+from .. import access
+from ..common import CliError, app_dir, linked_state, say
+from ..config import CONFIG_FILE
+from ..i18n import tr
+
+
+def register(sub):
+    for name, opens, text in (("open", True, tr("open the deployed app via its invite link",
+                                                "открыть задеплоенное приложение по ссылке-приглашению")),
+                              ("link", False, tr("print the invite link of the deployed app",
+                                                 "напечатать ссылку-приглашение задеплоенного приложения"))):
+        k = sub.add_parser(name, help=text, description=text.capitalize() + tr(
+            ". ACCESS_TOKEN is taken from %s or, if it's not there, from the service variables in Railway "
+            "(requires RAILWAY_API_TOKEN).",
+            ". ACCESS_TOKEN берётся из %s, "
+            "а если его там нет — из переменных сервиса в Railway (нужен RAILWAY_API_TOKEN).")
+            % CONFIG_FILE)
+        k.add_argument("path", nargs="?", default=".", help=tr("app folder (default: current folder)",
+                                                               "папка приложения (по умолчанию текущая)"))
+        k.add_argument("--as", dest="person", metavar=tr("NAME", "ИМЯ"),
+                       help=tr("personal link of a person from small access", "личная ссылка человека из small access"))
+        k.set_defaults(func=cmd_link, open=opens)
+
+
+def cmd_link(args):
+    root = app_dir(args.path)
+    state = linked_state(root)
+    if not state.get("domain"):
+        raise CliError(tr("the service has no public domain; run small deploy",
+                          "у сервиса нет публичного домена — выполните small deploy"))
+    entries, source = access.current(root, state, warn=say)
+    token = access.pick(entries, args.person)
+    if args.person is not None and token is None:
+        raise CliError(tr("%s has no personal link. Existing links: %s. Grant one: small access add %s",
+                          "у %s нет личной ссылки. Есть: %s. Выдать: small access add %s")
+                       % (args.person, ", ".join(n or tr("(shared)", "(общая)") for n, _ in entries) or "—",
+                          args.person))
+    link = access.invite_link(state["domain"], token)
+    if token:
+        say(tr("Invite link%s (ACCESS_TOKEN from %s). Anyone who gets it can sign in:",
+               "Ссылка-приглашение%s (ACCESS_TOKEN из %s). Кто её получит, тот войдёт:")
+            % (tr(" for ", " для ") + args.person if args.person else "", source))
+    else:
+        say(tr("ACCESS_TOKEN not found in %s or in Railway; URL without a token:",
+               "ACCESS_TOKEN не найден ни в %s, ни в Railway — адрес без токена:") % CONFIG_FILE)
+    print(link, flush=True)
+    if args.open:
+        webbrowser.open(link)
+    return 0

small_cli/commands/logs.py

@@ -0,0 +1,59 @@
+"""small logs: лог последнего деплоя — приложения или сборки, с режимом слежения -f."""
+
+import argparse
+import time
+
+from ..common import CliError, app_dir, linked_state, log_time, require_token, say
+from ..i18n import tr
+from ..railway import Railway, RailwayError
+
+
+def register(sub):
+    g = sub.add_parser("logs", help=tr("app logs from Railway", "логи приложения из Railway"),
+                       description=tr("Show the log of the latest deploy: the app log (default) or the build log.",
+                                      "Показать лог последнего деплоя: приложения (по умолчанию) или сборки."))
+    g.add_argument("path", nargs="?", default=".", help=tr("app folder (default: current folder)",
+                                                           "папка приложения (по умолчанию текущая)"))
+    g.add_argument("--build", action="store_true", help=tr("build log instead of the app log",
+                                                           "лог сборки вместо лога приложения"))
+    g.add_argument("-n", "--lines", type=int, default=100, help=tr("number of lines (default 100)",
+                                                                   "сколько строк (по умолчанию 100)"))
+    g.add_argument("-f", "--follow", action="store_true", help=tr("follow new lines (Ctrl+C to exit)",
+                                                                  "следить за новыми строками (Ctrl+C — выход)"))
+    g.add_argument("--interval", type=float, default=2.0, help=argparse.SUPPRESS)
+    g.set_defaults(func=cmd_logs)
+
+
+def cmd_logs(args):
+    root = app_dir(args.path)
+    state = linked_state(root)
+    api = Railway(require_token())
+    deployment = api.latest_deployment(state["serviceId"], state["environmentId"])
+    if not deployment:
+        raise CliError(tr("service %s has no deploys yet", "у сервиса %s ещё нет деплоев") % state.get("name", ""))
+    say(tr("%s log · deploy %s · %s", "Лог %s · деплой %s · %s")
+        % (tr("Build", "сборки") if args.build else tr("App", "приложения"), deployment["id"], deployment["status"]))
+
+    seen, last = set(), {"ts": None}
+
+    def show(entries):
+        for entry in entries:
+            key = (entry["timestamp"], entry["message"])
+            if key not in seen:
+                seen.add(key)
+                print("%s  %s" % (log_time(entry["timestamp"]), entry["message"]), flush=True)
+                last["ts"] = max(last["ts"] or "", entry["timestamp"])
+
+    show(api.log_entries(deployment["id"], build=args.build, limit=args.lines))
+    if not args.follow:
+        return 0
+    say(tr("Following new lines, Ctrl+C to exit", "Слежу за новыми строками, Ctrl+C — выход"))
+    try:
+        while True:
+            time.sleep(args.interval)
+            try:
+                show(api.log_entries(deployment["id"], build=args.build, limit=args.lines, start_date=last["ts"]))
+            except RailwayError as e:
+                say(tr("  retrying: %s", "  повторяю запрос: %s") % e)
+    except KeyboardInterrupt:
+        return 0

small_cli/commands/mail.py

@@ -0,0 +1,203 @@
+"""small mail: чем приложение отправляет письма для входа по почте (small access add ivan@company.com).
+
+resend — Resend по HTTPS (работает на Railway Hobby); smtp — свой почтовый сервер (на Railway SMTP открыт только
+с тарифа Pro); log — ссылки для входа пишутся в лог приложения (для проверки); off — выключить.
+Перед сохранением resend и smtp отправляют пробное письмо тем же кодом, что и приложение.
+"""
+
+import argparse
+import getpass
+import importlib.util
+import os
+import sys
+from contextlib import contextmanager
+from urllib.parse import urlsplit
+
+from .. import access as tokens
+from ..common import CliError, app_dir, ask, say
+from ..config import CONFIG_FILE, STATE_FILE, load_config, load_state
+from ..i18n import lang, tr
+from ..scaffold import TEMPLATES_DIR
+from .env import add_no_deploy, change_env, report_env_change
+
+ALL_VARS = ("RESEND_API_KEY", "SMTP_URL", "LOGIN_LINKS_TO_LOG", "MAIL_FROM")
+
+
+def register(sub):
+    m = sub.add_parser("mail", help=tr("sign-in emails: resend, smtp, log, off",
+                                       "письма для входа по почте: resend, smtp, log, off"),
+                       description=tr("How to send emails with sign-in links. resend: key from RESEND_API_KEY "
+                                      "or hidden input; smtp: server URL from SMTP_URL or hidden input; "
+                                      "log: write links to the log (for testing); off: turn off; "
+                                      "with no subcommand, shows the status.",
+                                      "Чем отправлять письма со ссылкой для входа. resend — ключ из RESEND_API_KEY "
+                                      "или ввод без эха; smtp — адрес сервера из SMTP_URL или ввод без эха; "
+                                      "log — писать ссылки в лог (для проверки); off — выключить; "
+                                      "без подкоманды — статус."))
+    m.add_argument("-C", "--path", default=".", help=tr("app folder (default: current folder)",
+                                                        "папка приложения (по умолчанию текущая)"))
+    m.set_defaults(func=cmd_mail_status)
+    mail_sub = m.add_subparsers(dest="mail_command", metavar="<resend|smtp|log|off>")
+    mr = mail_sub.add_parser("resend", help=tr("send via Resend (HTTPS)", "отправлять через Resend (HTTPS)"))
+    ms = mail_sub.add_parser("smtp", help=tr("send via your own SMTP server", "отправлять через свой SMTP-сервер"))
+    for parser in (mr, ms):
+        parser.add_argument("--from", dest="sender", help=tr('sender: "Reports <noreply@company.com>"',
+                                                             'отправитель: "Отчёты <noreply@company.com>"'))
+        parser.add_argument("--to", help=tr("where to send the test email (for Resend without your own domain, "
+                                            "use your Resend account email)",
+                                            "куда отправить пробное письмо (для Resend без своего домена — "
+                                            "адрес вашего аккаунта Resend)"))
+    mr.set_defaults(func=cmd_mail_resend)
+    ms.set_defaults(func=cmd_mail_smtp)
+    ml = mail_sub.add_parser("log", help=tr("write sign-in links to the app log (for testing only)",
+                                            "писать ссылки для входа в лог приложения (только для проверки)"))
+    ml.set_defaults(func=cmd_mail_log)
+    mo = mail_sub.add_parser("off", help=tr("stop sending emails", "выключить отправку писем"))
+    mo.set_defaults(func=cmd_mail_off)
+    for parser in (mr, ms, ml, mo):
+        parser.add_argument("-C", "--path", default=argparse.SUPPRESS, help=tr("app folder", "папка приложения"))
+        add_no_deploy(parser)
+
+
+def secret_input(name, prompt):
+    value = os.environ.get(name, "").strip()
+    if value:
+        return value
+    if not sys.stdin or not sys.stdin.isatty():
+        raise CliError(tr("set %s or run the command in a terminal",
+                          "задайте %s или запустите команду в терминале") % name)
+    say(prompt + tr(" Input is hidden.", " Ввод не отображается."))
+    value = getpass.getpass("%s: " % name).strip()
+    if not value:
+        raise CliError(tr("%s not entered", "%s не введён") % name)
+    return value
+
+
+def mailer():
+    """magic_link.py из шаблона: письмо уходит тем же кодом, что и из приложения."""
+    path = TEMPLATES_DIR / "python-http" / "magic_link.py"
+    spec = importlib.util.spec_from_file_location("small_magic_link", path)
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+@contextmanager
+def mail_env(values):
+    saved = {name: os.environ.get(name) for name in (*ALL_VARS, *values)}
+    try:
+        for name in ALL_VARS:
+            os.environ.pop(name, None)
+        os.environ.update({k: v for k, v in values.items() if v})
+        yield
+    finally:
+        for name, value in saved.items():
+            if value is None:
+                os.environ.pop(name, None)
+            else:
+                os.environ[name] = value
+
+
+def test_letter(root, values, to):
+    to = (to or ask(tr("Send the test email to: ", "Куда отправить пробное письмо: ")) or "").strip()
+    if not tokens.EMAIL_RE.match(to):
+        raise CliError(tr("specify an address for the test email: --to ivan@company.com",
+                          "укажите адрес для пробного письма: --to ivan@company.com"))
+    app = load_config(root / CONFIG_FILE)["name"] or load_state(root / STATE_FILE).get("name") or root.name
+    module = mailer()
+    with mail_env(dict(values, OWNER_LANG=lang())):  # ошибки magic_link — на языке small
+        try:
+            module.send_mail(to, tr("small: email check for %s", "small: проверка почты для %s") % app,
+                             tr("Sign-in emails for %s will arrive just like this one.\n",
+                                "Письма для входа в %s будут приходить так же, как это.\n") % app,
+                             tr("<p>Sign-in emails for <b>%s</b> will arrive just like this one.</p>",
+                                "<p>Письма для входа в <b>%s</b> будут приходить так же, как это.</p>") % app)
+        except Exception as e:  # noqa: BLE001 — показываем причину, но не ключ
+            hint = ""
+            if "RESEND_API_KEY" in values and "403" in str(getattr(e, "code", "")):
+                hint = tr(" Without a verified domain, Resend only sends to your account email; "
+                          "verify a domain in Resend and pass --from.",
+                          " Без подтверждённого домена Resend шлёт только на адрес вашего аккаунта; "
+                          "подтвердите домен в Resend и укажите --from.")
+            raise CliError(tr("test email was not sent: %s.%s", "пробное письмо не ушло: %s.%s")
+                           % (module._describe(e), hint)) from None
+    say(tr("Test email sent to %s. Check your inbox (and the Spam folder).",
+           "Пробное письмо отправлено на %s — проверьте почту (и папку «Спам»).") % to)
+
+
+def cmd_mail_resend(args):
+    root = app_dir(args.path)
+    key = secret_input("RESEND_API_KEY", tr("API key from resend.com → API Keys.",
+                                            "Ключ API из resend.com → API Keys."))
+    values = {"RESEND_API_KEY": key, "MAIL_FROM": args.sender or ""}
+    test_letter(root, values, args.to)
+    linked = change_env(root, {k: v for k, v in values.items() if v},
+                        unset=["SMTP_URL", "LOGIN_LINKS_TO_LOG"] + ([] if args.sender else ["MAIL_FROM"]),
+                        deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Sign-in emails are sent via Resend",
+                                                     "Письма для входа отправляются через Resend"))
+    return 0
+
+
+def cmd_mail_smtp(args):
+    root = app_dir(args.path)
+    url = secret_input("SMTP_URL", tr("Server URL: smtp://user:password@host:587 or smtps://…:465.",
+                                      "Адрес сервера: smtp://логин:пароль@сервер:587 или smtps://…:465."))
+    parts = urlsplit(url)
+    if parts.scheme not in ("smtp", "smtps") or not parts.hostname:
+        raise CliError(tr("SMTP_URL must look like smtp://user:password@host:587 (or smtps://…:465)",
+                          "SMTP_URL должен выглядеть так: smtp://логин:пароль@сервер:587 (или smtps://…:465)"))
+    values = {"SMTP_URL": url, "MAIL_FROM": args.sender or ""}
+    test_letter(root, values, args.to)
+    linked = change_env(root, {k: v for k, v in values.items() if v},
+                        unset=["RESEND_API_KEY", "LOGIN_LINKS_TO_LOG"] + ([] if args.sender else ["MAIL_FROM"]),
+                        deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Sign-in emails are sent via %s",
+                                                     "Письма для входа отправляются через %s") % parts.hostname)
+    say(tr("On Railway, SMTP is open only on the Pro plan; on Hobby, use small mail resend.",
+           "На Railway SMTP открыт только с тарифа Pro; на Hobby используйте small mail resend."))
+    return 0
+
+
+def cmd_mail_log(args):
+    root = app_dir(args.path)
+    linked = change_env(root, {"LOGIN_LINKS_TO_LOG": "1"}, deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Sign-in links are written to the app log instead of emails",
+                                                     "Ссылки для входа пишутся в лог приложения вместо писем"))
+    # Ищем строку middleware на языке владельца (OWNER_LANG = язык small при деплое).
+    search = ('Select-String "%s"' if sys.platform == "win32" else 'grep "%s"') % tr("sign-in link", "ссылка для входа")
+    say(tr("For testing only: a link from the log lets anyone into the app. View: small logs | %s",
+           "Только для проверки: ссылка из лога пускает в приложение. Смотреть: small logs | %s") % search)
+    return 0
+
+
+def cmd_mail_off(args):
+    root = app_dir(args.path)
+    linked = change_env(root, unset=list(ALL_VARS), deploy=not args.no_deploy)
+    report_env_change(linked, not args.no_deploy, tr("Sign-in emails are turned off",
+                                                     "Отправка писем для входа выключена"))
+    return 0
+
+
+def cmd_mail_status(args):
+    root = app_dir(args.path)
+    env, _ = tokens.app_env(root, load_state(root / STATE_FILE), warn=say)
+    sender = env.get("MAIL_FROM") or ""
+    if env.get("LOGIN_LINKS_TO_LOG"):
+        say(tr("Emails are not sent: sign-in links are written to the app log (test mode).",
+               "Письма не отправляются: ссылки для входа пишутся в лог приложения (режим проверки)."))
+        print("log")
+    elif env.get("RESEND_API_KEY"):
+        say(tr("Sign-in emails: Resend, sender %s", "Письма для входа: Resend, отправитель %s")
+            % (sender or tr("onboarding@resend.dev (only to your account email)",
+                            "onboarding@resend.dev (только на адрес аккаунта)")))
+        print("resend")
+    elif env.get("SMTP_URL"):
+        say(tr("Sign-in emails: SMTP %s%s", "Письма для входа: SMTP %s%s")
+            % (urlsplit(env["SMTP_URL"]).hostname, tr(", sender ", ", отправитель ") + sender if sender else ""))
+        print("smtp")
+    else:
+        say(tr("Email is not set up: sign-in by email does not work. Set it up: small mail resend",
+               "Почта не настроена: вход по почте не работает. Подключить: small mail resend"))
+        print("off")
+    return 0