clickhouse-users-cli 0.1.6__tar.gz → 0.1.7__tar.gz

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clickhouse-users-cli
-Version: 0.1.6
+Version: 0.1.7
 Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
 License-Expression: MIT
 Keywords: clickhouse,cli,users,access-control,least-privilege
@@ -59,8 +59,8 @@ ch-users
 |---|---|
 | Instalar / atualizar | `pip install -U clickhouse-users-cli` |
 | Rodar | `ch-users` |
-| Do código-fonte | `pip install -r requirements.txt` + `python main.py` |
-| Requisitos | Python `>= 3.10` + conta admin no ClickHouse (ex.: `default`) |
+| Do código-fonte | `uv sync` + `uv run ch-users` |
+| Requisitos | Python `>= 3.10` ([UV](https://docs.astral.sh/uv/) gerencia tudo via `uv.lock`) + conta admin no ClickHouse (ex.: `default`) |
 | Idioma | Automático pelo sistema operacional: PT em sistemas em português, EN nos demais. Force com `CH_USERS_LANG=pt` ou `CH_USERS_LANG=en` |
 
 ---
@@ -164,11 +164,13 @@ Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (back
 ## 🧑‍💻 Desenvolvimento
 
 ```powershell
-pip install -r requirements.txt
-python main.py            # roda do fonte
-python -m build           # gera sdist + wheel em dist/
-python -m twine check dist/*   # valida (inclusive este README)
-python -m twine upload dist/*  # publica (precisa de token PyPI)
+uv sync                  # instala tudo (usa uv.lock)
+uv run ch-users          # roda o CLI do fonte
+uv run python main.py    # alternativa direta
+uv run pytest -q         # suíte de testes (44 testes, sem banco)
+uv build                 # gera sdist + wheel em dist/
+uvx twine check dist/*   # valida (inclusive este README)
+uv publish               # publica (UV_PUBLISH_TOKEN)
 ```
 
 Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
@@ -177,8 +179,9 @@ Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
 
 ```
 main.py                  # entrypoint (dev local)
-requirements.txt
 pyproject.toml           # build + metadados PyPI (comando: ch-users)
+uv.lock                  # dependências travadas
+.python-version          # Python do projeto (uv)
 clickhouse_users_cli/
   __init__.py            # __version__
   app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/README.md

@@ -35,8 +35,8 @@ ch-users
 |---|---|
 | Instalar / atualizar | `pip install -U clickhouse-users-cli` |
 | Rodar | `ch-users` |
-| Do código-fonte | `pip install -r requirements.txt` + `python main.py` |
-| Requisitos | Python `>= 3.10` + conta admin no ClickHouse (ex.: `default`) |
+| Do código-fonte | `uv sync` + `uv run ch-users` |
+| Requisitos | Python `>= 3.10` ([UV](https://docs.astral.sh/uv/) gerencia tudo via `uv.lock`) + conta admin no ClickHouse (ex.: `default`) |
 | Idioma | Automático pelo sistema operacional: PT em sistemas em português, EN nos demais. Force com `CH_USERS_LANG=pt` ou `CH_USERS_LANG=en` |
 
 ---
@@ -140,11 +140,13 @@ Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (back
 ## 🧑‍💻 Desenvolvimento
 
 ```powershell
-pip install -r requirements.txt
-python main.py            # roda do fonte
-python -m build           # gera sdist + wheel em dist/
-python -m twine check dist/*   # valida (inclusive este README)
-python -m twine upload dist/*  # publica (precisa de token PyPI)
+uv sync                  # instala tudo (usa uv.lock)
+uv run ch-users          # roda o CLI do fonte
+uv run python main.py    # alternativa direta
+uv run pytest -q         # suíte de testes (44 testes, sem banco)
+uv build                 # gera sdist + wheel em dist/
+uvx twine check dist/*   # valida (inclusive este README)
+uv publish               # publica (UV_PUBLISH_TOKEN)
 ```
 
 Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
@@ -153,8 +155,9 @@ Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
 
 ```
 main.py                  # entrypoint (dev local)
-requirements.txt
 pyproject.toml           # build + metadados PyPI (comando: ch-users)
+uv.lock                  # dependências travadas
+.python-version          # Python do projeto (uv)
 clickhouse_users_cli/
   __init__.py            # __version__
   app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/clickhouse_users_cli/__init__.py

@@ -1,5 +1,5 @@
 """ClickHouse Users CLI — crie usuários com escopo mínimo (least privilege)."""
 
-__version__ = "0.1.6"
+__version__ = "0.1.7"
 
 __all__ = ["__version__"]

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/clickhouse_users_cli/i18n.py

@@ -215,11 +215,11 @@ STRINGS: dict[str, dict[str, str]] = {
         "v_pass_long": "Máximo 128 caracteres.",
         "v_pick_one": "Selecione pelo menos 1 item (espaço marca, enter confirma).",
         # Camada de banco
-        "db_no_dep": "Dependência 'clickhouse-connect' não instalada. Rode: pip install -r requirements.txt",
+        "db_no_dep": "Dependência 'clickhouse-connect' ausente. Rode: uv sync",
         "db_connect_fail": "Falha ao conectar em {proto}://{host}:{port}: {e}",
         "db_not_connected": "Não conectado. Chame .connect() primeiro.",
         # Sessão YAML
-        "sess_no_yaml": "Dependência 'pyyaml' não instalada. Rode: pip install pyyaml",
+        "sess_no_yaml": "Dependência 'pyyaml' ausente. Rode: uv sync",
         "sess_incomplete": "Arquivo de sessão incompleto (falta {e}). Apague e salve de novo.",
         "sess_read_fail": "Não foi possível ler a sessão salva: {e}",
         # SQL builder
@@ -428,11 +428,11 @@ STRINGS: dict[str, dict[str, str]] = {
         "v_pass_long": "Maximum 128 characters.",
         "v_pick_one": "Select at least 1 item (space toggles, enter confirms).",
         # DB layer
-        "db_no_dep": "Missing 'clickhouse-connect' dependency. Run: pip install -r requirements.txt",
+        "db_no_dep": "Missing 'clickhouse-connect' dependency. Run: uv sync",
         "db_connect_fail": "Failed to connect to {proto}://{host}:{port}: {e}",
         "db_not_connected": "Not connected. Call .connect() first.",
         # YAML session
-        "sess_no_yaml": "Missing 'pyyaml' dependency. Run: pip install pyyaml",
+        "sess_no_yaml": "Missing 'pyyaml' dependency. Run: uv sync",
         "sess_incomplete": "Saved session file is incomplete (missing {e}). Delete it and save again.",
         "sess_read_fail": "Could not read the saved session: {e}",
         # SQL builder
@@ -457,12 +457,6 @@ def detect_language() -> str:
             candidates.append(loc[0])
     except Exception:
         pass
-    try:
-        dloc = locale.getdefaultlocale()
-        if dloc and dloc[0]:
-            candidates.append(dloc[0])
-    except Exception:
-        pass
     for var in ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LANG"):
         candidates.append(os.environ.get(var, ""))
     for raw in candidates:

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/clickhouse_users_cli/session.py

@@ -63,7 +63,9 @@ def load_session() -> ConnectionInfo:
         )
     except KeyError as e:
         raise RuntimeError(t("sess_incomplete", e=e)) from e
-    except (OSError, ValueError, TypeError) as e:
+    except Exception as e:
+        # OSError, ValueError, TypeError, yaml.YAMLError… — qualquer falha de
+        # leitura/parse vira mensagem amigável em vez de stack trace.
         raise RuntimeError(t("sess_read_fail", e=e)) from e
 
 

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/clickhouse_users_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clickhouse-users-cli
-Version: 0.1.6
+Version: 0.1.7
 Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
 License-Expression: MIT
 Keywords: clickhouse,cli,users,access-control,least-privilege
@@ -59,8 +59,8 @@ ch-users
 |---|---|
 | Instalar / atualizar | `pip install -U clickhouse-users-cli` |
 | Rodar | `ch-users` |
-| Do código-fonte | `pip install -r requirements.txt` + `python main.py` |
-| Requisitos | Python `>= 3.10` + conta admin no ClickHouse (ex.: `default`) |
+| Do código-fonte | `uv sync` + `uv run ch-users` |
+| Requisitos | Python `>= 3.10` ([UV](https://docs.astral.sh/uv/) gerencia tudo via `uv.lock`) + conta admin no ClickHouse (ex.: `default`) |
 | Idioma | Automático pelo sistema operacional: PT em sistemas em português, EN nos demais. Force com `CH_USERS_LANG=pt` ou `CH_USERS_LANG=en` |
 
 ---
@@ -164,11 +164,13 @@ Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (back
 ## 🧑‍💻 Desenvolvimento
 
 ```powershell
-pip install -r requirements.txt
-python main.py            # roda do fonte
-python -m build           # gera sdist + wheel em dist/
-python -m twine check dist/*   # valida (inclusive este README)
-python -m twine upload dist/*  # publica (precisa de token PyPI)
+uv sync                  # instala tudo (usa uv.lock)
+uv run ch-users          # roda o CLI do fonte
+uv run python main.py    # alternativa direta
+uv run pytest -q         # suíte de testes (44 testes, sem banco)
+uv build                 # gera sdist + wheel em dist/
+uvx twine check dist/*   # valida (inclusive este README)
+uv publish               # publica (UV_PUBLISH_TOKEN)
 ```
 
 Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
@@ -177,8 +179,9 @@ Versão em fonte única: `clickhouse_users_cli/__init__.py` (`__version__`).
 
 ```
 main.py                  # entrypoint (dev local)
-requirements.txt
 pyproject.toml           # build + metadados PyPI (comando: ch-users)
+uv.lock                  # dependências travadas
+.python-version          # Python do projeto (uv)
 clickhouse_users_cli/
   __init__.py            # __version__
   app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/clickhouse_users_cli.egg-info/SOURCES.txt

@@ -14,4 +14,11 @@ clickhouse_users_cli.egg-info/SOURCES.txt
 clickhouse_users_cli.egg-info/dependency_links.txt
 clickhouse_users_cli.egg-info/entry_points.txt
 clickhouse_users_cli.egg-info/requires.txt
-clickhouse_users_cli.egg-info/top_level.txt
+clickhouse_users_cli.egg-info/top_level.txt
+tests/test_app.py
+tests/test_db.py
+tests/test_i18n.py
+tests/test_session.py
+tests/test_sql_builder.py
+tests/test_style.py
+tests/test_validators.py

{clickhouse_users_cli-0.1.6 → clickhouse_users_cli-0.1.7}/pyproject.toml

@@ -36,3 +36,11 @@ include = ["clickhouse_users_cli*"]
 
 [tool.setuptools.dynamic]
 version = { attr = "clickhouse_users_cli.__version__" }
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+]

clickhouse_users_cli-0.1.7/tests/test_app.py

@@ -0,0 +1,154 @@
+"""Testes dos fluxos interativos com prompts simulados (sem console real)."""
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from clickhouse_users_cli import app
+from clickhouse_users_cli.i18n import set_language
+from clickhouse_users_cli.sql_builder import GrantScope
+
+
+@pytest.fixture(autouse=True)
+def _lang():
+    set_language("pt")
+    yield
+    set_language("pt")
+
+
+def _patch_factories(monkeypatch, **answers):
+    """Substitui os factories do questionary por retornos fixos."""
+    for name, value in answers.items():
+        monkeypatch.setattr(app.Q, name, MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", MagicMock(side_effect=lambda prompt: answers.get("__ask__")))
+
+
+def test_ask_profile_questions_by_mode(monkeypatch):
+    asked = {}
+
+    def fake_select(msg, **kw):
+        asked["q"] = msg
+        return MagicMock()
+
+    monkeypatch.setattr(app.Q, "select", fake_select)
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: "readonly")
+    app.ask_profile()
+    assert asked["q"] == "Que tipo de usuário criar?"
+    app.ask_profile(mode="edit")
+    assert asked["q"] == "Qual o novo tipo de acesso?"
+
+
+def test_ask_profile_question_english(monkeypatch):
+    set_language("en")
+    monkeypatch.setattr(app.Q, "select", lambda msg, **kw: MagicMock())
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: "readonly")
+    with patch.object(app, "step") as step:
+        app.ask_profile()
+        assert "User type" in step.call_args[0][0]
+
+
+def test_ask_databases_all_and_partial(monkeypatch):
+    admin = MagicMock()
+    admin.list_databases.return_value = ["vendas", "system"]
+    captured = {}
+
+    def fake_checkbox(msg, choices, validate, style, qmark, instruction):
+        captured["values"] = [c.value for c in choices]
+        captured["checked"] = [c.checked for c in choices]
+        return MagicMock()
+
+    monkeypatch.setattr(app.Q, "checkbox", fake_checkbox)
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: ["__ALL__"])
+    assert app.ask_databases(admin) == ["vendas", "system"]
+    assert captured["values"][0] == "__ALL__"
+    assert captured["checked"] == [False] * len(captured["values"])
+
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: ["vendas"])
+    assert app.ask_databases(admin) == ["vendas"]
+
+
+def test_ask_tables_all_and_specific(monkeypatch):
+    admin = MagicMock()
+    admin.list_tables.return_value = ["pedidos", "clientes"]
+    monkeypatch.setattr(app.Q, "checkbox", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: ["__ALL__"])
+    scopes = app.ask_tables(admin, ["vendas"])
+    assert scopes == [GrantScope(database="vendas", table=None)]
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: ["pedidos"])
+    scopes = app.ask_tables(admin, ["vendas"])
+    assert scopes == [GrantScope(database="vendas", table="pedidos")]
+
+
+def test_ask_privileges_profiles():
+    assert app.ask_privileges("readonly") == (["SHOW", "SELECT"], False)
+    assert app.ask_privileges("admin") == (["ALL"], True)
+
+
+def test_ask_privileges_custom(monkeypatch):
+    monkeypatch.setattr(app.Q, "checkbox", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app.Q, "confirm", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", MagicMock(side_effect=[["SELECT"], False]))
+    assert app.ask_privileges("custom") == (["SELECT"], False)
+
+
+def test_flow_edit_grants_revokes_first(monkeypatch):
+    admin = MagicMock()
+    admin.conn.username = "default"
+    monkeypatch.setattr(app, "ask_profile", lambda mode="create": "readwrite")
+    monkeypatch.setattr(app, "ask_privileges", lambda profile, mode="create": (["SHOW", "SELECT"], False))
+    monkeypatch.setattr(app, "ask_databases", lambda admin, mode="create": ["vendas"])
+    monkeypatch.setattr(app, "ask_tables",
+                         lambda admin, dbs, mode="create": [GrantScope(database="vendas", table="pedidos")])
+    monkeypatch.setattr(app.Q, "confirm", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: True)
+    app.flow_edit_grants(admin, "ana")
+    stmts = admin.execute_statements.call_args[0][0]
+    assert stmts[0] == "REVOKE ALL ON *.* FROM `ana`"
+    assert stmts[1] == "GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `ana`"
+
+
+def test_flow_edit_grants_cancelled_runs_nothing(monkeypatch):
+    admin = MagicMock()
+    admin.conn.username = "default"
+    monkeypatch.setattr(app, "ask_profile", lambda mode="create": "readonly")
+    monkeypatch.setattr(app, "ask_privileges", lambda profile, mode="create": (["SHOW"], False))
+    monkeypatch.setattr(app, "ask_databases", lambda admin, mode="create": ["vendas"])
+    monkeypatch.setattr(app, "ask_tables",
+                         lambda admin, dbs, mode="create": [GrantScope(database="vendas", table=None)])
+    monkeypatch.setattr(app.Q, "confirm", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: False)
+    app.flow_edit_grants(admin, "ana")
+    admin.execute_statements.assert_not_called()
+
+
+def test_maybe_load_without_file_returns_none(monkeypatch):
+    monkeypatch.setattr("clickhouse_users_cli.session.has_saved_session", lambda: False)
+    ask = MagicMock(side_effect=AssertionError("nao deveria perguntar"))
+    monkeypatch.setattr(app, "_ask_or_abort", ask)
+    assert app.maybe_load_saved_session() is None
+
+
+def test_maybe_load_use_saved(monkeypatch):
+    from clickhouse_users_cli.db import ConnectionInfo
+
+    conn = ConnectionInfo(host="h", port=8123, secure=False, username="u", password="p")
+    monkeypatch.setattr("clickhouse_users_cli.session.has_saved_session", lambda: True)
+    monkeypatch.setattr("clickhouse_users_cli.session.load_session", lambda: conn)
+    monkeypatch.setattr(app.Q, "select", MagicMock(return_value=MagicMock()))
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: "use")
+    assert app.maybe_load_saved_session() is conn
+
+
+def test_main_menu_forget_flag(monkeypatch):
+    seen = {}
+
+    def fake_select(msg, choices, default, style, qmark, instruction):
+        seen["values"] = [c.value for c in choices]
+        return MagicMock()
+
+    monkeypatch.setattr(app.Q, "select", fake_select)
+    monkeypatch.setattr(app, "_ask_or_abort", lambda prompt: "exit")
+    app.ask_main_action(show_forget=False)
+    assert "forget" not in seen["values"]
+    app.ask_main_action(show_forget=True)
+    assert "forget" in seen["values"]

clickhouse_users_cli-0.1.7/tests/test_db.py

@@ -0,0 +1,128 @@
+"""Testes da camada ClickHouse com cliente falso (sem rede)."""
+
+import sys
+import types
+from types import SimpleNamespace
+
+import pytest
+
+from clickhouse_users_cli.db import SYSTEM_DATABASES, ClickHouseAdmin, ConnectionInfo
+from clickhouse_users_cli.i18n import set_language
+
+
+@pytest.fixture(autouse=True)
+def _lang():
+    set_language("pt")
+    yield
+
+
+class FakeClient:
+    def __init__(self):
+        self.queries = []
+        self.commands = []
+
+    def query(self, sql):
+        self.queries.append(sql)
+
+        class R:
+            pass
+
+        r = R()
+        if sql == "SHOW USERS":
+            r.result_rows = [("default",), ("ana",)]
+        elif sql.startswith("SHOW GRANTS FOR"):
+            r.result_rows = [("GRANT SELECT ON db.t TO ana",)]
+        elif sql.startswith("SHOW CREATE USER"):
+            r.result_rows = [("CREATE USER ana HOST ANY",)]
+        elif sql == "SHOW DATABASES":
+            r.result_rows = [("vendas",), ("system",)]
+        elif sql.startswith("SHOW TABLES FROM"):
+            r.result_rows = [("pedidos",), ("clientes",)]
+        else:
+            r.result_rows = [("1",)]
+        return r
+
+    def command(self, sql):
+        self.commands.append(sql)
+
+
+def _admin():
+    a = ClickHouseAdmin(ConnectionInfo(host="h", port=8123, secure=False,
+                                       username="default", password=""))
+    a._client = FakeClient()
+    return a
+
+
+def test_client_requires_connect():
+    a = ClickHouseAdmin(ConnectionInfo(host="h", port=1, secure=False, username="u", password=""))
+    with pytest.raises(RuntimeError):
+        _ = a.client
+
+
+def test_list_users_sorted():
+    assert _admin().list_users() == ["ana", "default"]
+
+
+def test_show_grants_escapes_ident():
+    a = _admin()
+    assert a.show_grants("ana") == ["GRANT SELECT ON db.t TO ana"]
+    assert a.show_create_user("ana") == "CREATE USER ana HOST ANY"
+    assert a.client.queries[-2].startswith("SHOW GRANTS FOR `ana`")
+
+
+def test_databases_system_last():
+    assert _admin().list_databases() == ["vendas", "system"]
+    assert "system" in SYSTEM_DATABASES
+
+
+def test_manage_commands():
+    a = _admin()
+    a.deactivate_user("ana")
+    a.activate_user("ana")
+    a.drop_user("ana")
+    assert a.client.commands == [
+        "ALTER USER `ana` HOST NONE",
+        "ALTER USER `ana` HOST ANY",
+        "DROP USER IF EXISTS `ana`",
+    ]
+
+
+def test_execute_statements_runs_all():
+    a = _admin()
+    a.execute_statements(["A", "B"])
+    assert a.client.commands == ["A", "B"]
+
+
+def test_connect_missing_dependency():
+    monkeypatch_target = sys.modules.get("clickhouse_connect")
+    sys.modules["clickhouse_connect"] = None  # força ImportError no import interno
+    try:
+        a = ClickHouseAdmin(ConnectionInfo(host="h", port=1, secure=False, username="u", password=""))
+        with pytest.raises(RuntimeError, match="clickhouse-connect"):
+            a.connect()
+    finally:
+        if monkeypatch_target is None:
+            sys.modules.pop("clickhouse_connect", None)
+        else:
+            sys.modules["clickhouse_connect"] = monkeypatch_target
+
+
+def test_connect_success_and_failure_wrap():
+    mod = types.ModuleType("clickhouse_connect")
+
+    def ok_client(**kw):
+        return FakeClient()
+
+    def boom_client(**kw):
+        raise ConnectionError("refused")
+
+    sys.modules["clickhouse_connect"] = mod
+    try:
+        mod.get_client = ok_client
+        a = ClickHouseAdmin(ConnectionInfo(host="h", port=8123, secure=False, username="u", password=""))
+        assert a.connect() is a
+        mod.get_client = boom_client
+        with pytest.raises(RuntimeError, match="Falha ao conectar"):
+            a.connect()
+    finally:
+        sys.modules.pop("clickhouse_connect", None)

clickhouse_users_cli-0.1.7/tests/test_i18n.py

@@ -0,0 +1,47 @@
+"""Testes do i18n — paridade PT/EN, detecção e interpolação."""
+
+import locale
+
+from clickhouse_users_cli.i18n import STRINGS, detect_language, get_language, set_language, t
+
+
+def test_key_parity():
+    assert set(STRINGS["pt"]) == set(STRINGS["en"])
+    assert len(STRINGS["pt"]) > 100
+
+
+def test_interpolation_and_fallback():
+    set_language("pt")
+    assert t("q_port", port="8123") == "Porta HTTP(S) [8123]:"
+    assert t("connected", username="u", host="h", port=1) == "Conectado como 'u' em h:1"
+    assert t("chave_que_nao_existe") == "chave_que_nao_existe"
+    set_language("en")
+    assert t("q_port", port="8123") == "HTTP(S) port [8123]:"
+    assert get_language() == "en"
+    set_language("pt")
+
+
+def _detect_with(env: dict, loc=(None, None)):
+    import os
+    from unittest.mock import patch
+
+    with patch.dict(os.environ, env, clear=False):
+        with patch.object(locale, "getlocale", return_value=loc), patch.object(
+            locale, "getdefaultlocale", return_value=(None, None)
+        ):
+            # limpa variáveis que poderiam interferir
+            for var in ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LANG"):
+                os.environ.pop(var, None)
+            for k, v in env.items():
+                os.environ[k] = v
+            return detect_language()
+
+
+def test_detect_language():
+    assert _detect_with({"LANG": "pt_BR.UTF-8"}) == "pt"
+    assert _detect_with({"LANG": "Portuguese_Brazil"}) == "pt"
+    assert _detect_with({"LANG": "en_US.UTF-8"}) == "en"
+    assert _detect_with({"LANG": "C"}) == "en"
+    assert _detect_with({}) == "en"
+    assert _detect_with({"CH_USERS_LANG": "pt", "LANG": "en_US.UTF-8"}) == "pt"
+    assert _detect_with({"CH_USERS_LANG": "en", "LANG": "pt_BR.UTF-8"}) == "en"

clickhouse_users_cli-0.1.7/tests/test_session.py

@@ -0,0 +1,54 @@
+"""Testes da sessão YAML — roundtrip em diretório temporário."""
+
+import pytest
+
+from clickhouse_users_cli import session as s
+from clickhouse_users_cli.db import ConnectionInfo
+from clickhouse_users_cli.i18n import set_language
+
+
+@pytest.fixture(autouse=True)
+def _tmp_session(tmp_path, monkeypatch):
+    monkeypatch.setattr(s, "SESSION_DIR", tmp_path)
+    monkeypatch.setattr(s, "SESSION_FILE", tmp_path / "connection.yaml")
+    set_language("pt")
+    yield
+
+
+def _conn():
+    return ConnectionInfo(host="db.empresa.com", port=8443, secure=True,
+                          username="default", password="s3cr3t!")
+
+
+def test_roundtrip():
+    assert not s.has_saved_session()
+    path = s.save_session(_conn())
+    assert path.is_file()
+    assert s.has_saved_session()
+    back = s.load_session()
+    assert (back.host, back.port, back.secure, back.username, back.password) == \
+        ("db.empresa.com", 8443, True, "default", "s3cr3t!")
+
+
+def test_delete():
+    s.save_session(_conn())
+    assert s.delete_session() is True
+    assert not s.has_saved_session()
+    assert s.delete_session() is False
+
+
+def test_load_missing_is_friendly():
+    with pytest.raises(RuntimeError):
+        s.load_session()
+
+
+def test_load_corrupt_is_friendly():
+    s.SESSION_FILE.write_text("{{{ nao: [yaml valido", encoding="utf-8")
+    with pytest.raises(RuntimeError):
+        s.load_session()
+
+
+def test_load_incomplete_points_missing_key():
+    s.SESSION_FILE.write_text("host: x\n", encoding="utf-8")
+    with pytest.raises(RuntimeError, match="incompleto"):
+        s.load_session()

clickhouse_users_cli-0.1.7/tests/test_sql_builder.py

@@ -0,0 +1,93 @@
+"""Testes do construtor de SQL — puros, sem banco."""
+
+import pytest
+
+from clickhouse_users_cli.sql_builder import (
+    GrantScope,
+    UserSpec,
+    build_activate_user_sql,
+    build_all_statements,
+    build_create_user_sql,
+    build_deactivate_user_sql,
+    build_drop_user_sql,
+    build_edit_grants_statements,
+    build_grant_sql,
+    build_revoke_all_sql,
+    build_show_create_user_sql,
+    build_show_grants_sql,
+    escape_host,
+    escape_ident,
+    escape_string,
+)
+
+
+def test_escape_ident():
+    assert escape_ident("vendas") == "`vendas`"
+    assert escape_ident("a`b") == "`a``b`"
+
+
+def test_escape_string():
+    assert escape_string("abc") == "'abc'"
+    assert escape_string("o'b") == "'o\\'b'"
+    assert escape_string("a\\b") == "'a\\\\b'"
+    assert escape_host("10.0.0.5") == "'10.0.0.5'"
+
+
+def test_on_clause():
+    assert GrantScope(database="*").on_clause() == "*.*"
+    assert GrantScope(database="vendas", table=None).on_clause() == "`vendas`.*"
+    assert GrantScope(database="vendas", table="*").on_clause() == "`vendas`.*"
+    assert GrantScope(database="vendas", table="pedidos").on_clause() == "`vendas`.`pedidos`"
+
+
+def _spec(**kw):
+    base = dict(username="ana", password="s3cret!!", privileges=["SHOW", "SELECT"],
+                scopes=[GrantScope(database="vendas", table="pedidos")])
+    base.update(kw)
+    return UserSpec(**base)
+
+
+def test_create_user_any_host():
+    sql = build_create_user_sql(_spec())
+    assert sql == ("CREATE USER IF NOT EXISTS `ana` IDENTIFIED WITH plaintext_password"
+                   " BY 's3cret!!' HOST ANY")
+
+
+def test_create_user_custom_hosts_and_no_ine():
+    sql = build_create_user_sql(_spec(hosts=["LOCALHOST", "10.0.0.5"], if_not_exists=False))
+    assert "IF NOT EXISTS" not in sql
+    assert "HOST 'LOCALHOST', HOST '10.0.0.5'" in sql
+
+
+def test_grant_sql_and_grant_option():
+    stmts = build_grant_sql(_spec(scopes=[GrantScope(database="v", table=None)], grant_option=True))
+    assert stmts == ["GRANT SHOW, SELECT ON `v`.* TO `ana` WITH GRANT OPTION"]
+
+
+def test_grant_sql_validates():
+    with pytest.raises(ValueError):
+        build_grant_sql(_spec(scopes=[]))
+    with pytest.raises(ValueError):
+        build_grant_sql(_spec(privileges=[]))
+
+
+def test_all_statements_order():
+    stmts = build_all_statements(_spec())
+    assert stmts[0].startswith("CREATE USER")
+    assert stmts[1].startswith("GRANT")
+
+
+def test_manage_statements():
+    assert build_show_grants_sql("ana") == "SHOW GRANTS FOR `ana`"
+    assert build_show_create_user_sql("ana") == "SHOW CREATE USER `ana`"
+    assert build_deactivate_user_sql("ana") == "ALTER USER `ana` HOST NONE"
+    assert build_activate_user_sql("ana") == "ALTER USER `ana` HOST ANY"
+    assert build_drop_user_sql("ana") == "DROP USER IF EXISTS `ana`"
+    assert build_drop_user_sql("ana", if_exists=False) == "DROP USER `ana`"
+    assert build_revoke_all_sql("ana") == "REVOKE ALL ON *.* FROM `ana`"
+
+
+def test_edit_grants_statements_revoke_first():
+    stmts = build_edit_grants_statements("ana", ["SELECT"], [GrantScope(database="v", table="t")], False)
+    assert stmts[0] == "REVOKE ALL ON *.* FROM `ana`"
+    assert stmts[1] == "GRANT SELECT ON `v`.`t` TO `ana`"

clickhouse_users_cli-0.1.7/tests/test_style.py

@@ -0,0 +1,22 @@
+"""Smoke tests visuais — nada pode quebrar ao renderizar."""
+
+from clickhouse_users_cli import style
+from clickhouse_users_cli.i18n import set_language
+
+
+def test_render_pt_and_en(capfd):
+    for lang in ("pt", "en"):
+        set_language(lang)
+        style.banner()
+        style.step("4/6 · Teste", "subtítulo")
+        style.success("ok")
+        style.error("falhou")
+        style.warn("atenção")
+        style.info("dica")
+        table = style.make_table("Título")
+        table.add_column("A")
+        table.add_row("1")
+        style.console.print(table)
+    set_language("pt")
+    out, _ = capfd.readouterr()
+    assert "ClickHouse Users CLI" in out

clickhouse_users_cli-0.1.7/tests/test_validators.py

@@ -0,0 +1,53 @@
+"""Testes dos validadores (mensagens em PT e EN)."""
+
+from clickhouse_users_cli.i18n import set_language
+from clickhouse_users_cli.validators import (
+    validate_at_least_one,
+    validate_host,
+    validate_new_password,
+    validate_port,
+    validate_required,
+    validate_username,
+)
+
+
+def test_required():
+    set_language("pt")
+    assert validate_required(" x ") is True
+    assert validate_required("  ") != True
+
+
+def test_host():
+    set_language("pt")
+    assert validate_host("localhost") is True
+    assert validate_host("10.0.0.5") is True
+    assert validate_host("db.empresa.com") is True
+    assert validate_host("") == "Informe o host (ex.: localhost ou 10.0.0.5)."
+    assert "inválido" in validate_host("??").lower()
+
+
+def test_port():
+    set_language("pt")
+    assert validate_port("8123") is True
+    assert "numérica" in validate_port("abc")
+    assert "65535" in validate_port("99999")
+
+
+def test_username():
+    set_language("pt")
+    assert validate_username("analyst_julho") is True
+    assert "reservado" in validate_username("default")
+    assert validate_username("1abc") != True
+
+
+def test_password():
+    set_language("en")
+    assert validate_new_password("12345678") is True
+    assert "Minimum 8" in validate_new_password("abc")
+    assert "Maximum 128" in validate_new_password("x" * 129)
+    set_language("pt")
+
+
+def test_at_least_one():
+    assert validate_at_least_one(["a"]) is True
+    assert validate_at_least_one([]) != True