clickhouse-users-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clickhouse-users-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
 License-Expression: MIT
 Keywords: clickhouse,cli,users,access-control,least-privilege
@@ -19,6 +19,7 @@ License-File: LICENSE
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: clickhouse-connect>=0.8.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: pyyaml>=6.0
 Dynamic: license-file
 
 # ClickHouse Users CLI
@@ -47,6 +48,13 @@ Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USE
 Após conectar, escolha: **Criar usuário** · **Listar usuários** · **Gerenciar usuário** · **Sair**.
 O menu fica em loop — dá para criar, auditar e desativar vários sem reconectar.
 
+## Sessão salva (manter conectado)
+
+- Na primeira conexão o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` com host, porta, protocolo, usuário e senha.
+- Na próxima execução, oferece **usar a salva / nova conexão / apagar a salva**.
+- No menu há **Esquecer sessão** (apaga o YAML, com confirmação).
+- Segurança: a senha fica em **texto puro** no arquivo (permissão `0600` no Linux/mac; no Windows vale o aviso em tela). Só use em máquina confiável — nunca compartilhe o arquivo.
+
 ## Fluxo — criar (6 etapas)
 
 1. **Conexão** — host, protocolo, porta, usuário/senha admin. Testa com `SELECT 1` e permite tentar de novo / editar / sair.

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/README.md

@@ -24,6 +24,13 @@ Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USE
 Após conectar, escolha: **Criar usuário** · **Listar usuários** · **Gerenciar usuário** · **Sair**.
 O menu fica em loop — dá para criar, auditar e desativar vários sem reconectar.
 
+## Sessão salva (manter conectado)
+
+- Na primeira conexão o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` com host, porta, protocolo, usuário e senha.
+- Na próxima execução, oferece **usar a salva / nova conexão / apagar a salva**.
+- No menu há **Esquecer sessão** (apaga o YAML, com confirmação).
+- Segurança: a senha fica em **texto puro** no arquivo (permissão `0600` no Linux/mac; no Windows vale o aviso em tela). Só use em máquina confiável — nunca compartilhe o arquivo.
+
 ## Fluxo — criar (6 etapas)
 
 1. **Conexão** — host, protocolo, porta, usuário/senha admin. Testa com `SELECT 1` e permite tentar de novo / editar / sair.

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/clickhouse_users_cli/__init__.py

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

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/clickhouse_users_cli/app.py

@@ -6,7 +6,6 @@ import sys
 
 import questionary
 from rich.syntax import Syntax
-from rich.table import Table
 
 from clickhouse_users_cli.db import SYSTEM_DATABASES, ClickHouseAdmin, ConnectionInfo
 from clickhouse_users_cli.sql_builder import (
@@ -19,7 +18,8 @@ from clickhouse_users_cli.sql_builder import (
     build_deactivate_user_sql,
     build_drop_user_sql,
 )
-from clickhouse_users_cli.style import APP_STYLE, banner, console, error, info, step, success
+from clickhouse_users_cli.style import APP_STYLE, banner, console, error, info, make_table, step, success, warn
+from clickhouse_users_cli.session import SESSION_FILE
 from clickhouse_users_cli.validators import (
     validate_at_least_one,
     validate_host,
@@ -288,7 +288,7 @@ def ask_create_options() -> bool:
 
 def show_review(spec: UserSpec) -> None:
     step("6/6 · Revisão", "Confira o resumo e o SQL exato que será executado.")
-    table = Table(title="Resumo do novo usuário", show_header=True, header_style="bold cyan")
+    table = make_table("Resumo do novo usuário")
     table.add_column("Campo", style="dim")
     table.add_column("Valor", style="bold")
     table.add_row("Usuário", spec.username)
@@ -326,18 +326,107 @@ def confirm_and_execute(admin: ClickHouseAdmin, spec: UserSpec) -> None:
 
 
 
+# ── Sessão salva (YAML local, opt-in) ────────────────────────────────────────────
+
+def maybe_load_saved_session() -> ConnectionInfo | None:
+    """Se há YAML salvo, oferece usar / nova conexão / apagar. None = digitar."""
+    from clickhouse_users_cli.session import delete_session, has_saved_session, load_session
+
+    if not has_saved_session():
+        return None
+    step("Sessão salva", f"Arquivo: {SESSION_FILE} (senha em texto puro — nunca compartilhe)")
+    try:
+        saved = load_session()
+    except RuntimeError as e:
+        error(str(e))
+        fix = _ask_or_abort(
+            Q.select(
+                "A sessão salva está inválida. O que fazer?",
+                choices=[
+                    Q.Choice("Apagar e digitar nova conexão", value="delete"),
+                    Q.Choice("Digitar nova conexão (manter arquivo)", value="new"),
+                ],
+                style=APP_STYLE, qmark="›",
+            )
+        )
+        if fix == "delete":
+            delete_session()
+            success("Sessão apagada.")
+        return None
+
+    info(f"Conexão guardada: {saved.protocol}://{saved.host}:{saved.port} · usuário '{saved.username}'.")
+    choice = _ask_or_abort(
+        Q.select(
+            "Usar a conexão salva?",
+            choices=[
+                Q.Choice("Usar conexão salva", value="use"),
+                Q.Choice("Nova conexão (digitar de novo)", value="new"),
+                Q.Choice("Apagar conexão salva", value="delete"),
+            ],
+            default="use",
+            style=APP_STYLE, qmark="›",
+            instruction="(↑↓ navega · enter confirma)",
+        )
+    )
+    if choice == "delete":
+        delete_session()
+        success("Sessão apagada.")
+        return None
+    if choice == "new":
+        return None
+    return saved
+
+
+def ask_remember(conn: ConnectionInfo) -> None:
+    """Opt-in: salva a conexão em YAML local (senha em texto puro)."""
+    from clickhouse_users_cli.session import save_session
+
+    warn("A senha será gravada em texto puro no arquivo — só use em máquina confiável.")
+    keep = _ask_or_abort(
+        Q.confirm("Manter conectado neste computador (salvar sessão)?", default=False, style=APP_STYLE, qmark="›")
+    )
+    if not keep:
+        return
+    try:
+        path = save_session(conn)
+    except RuntimeError as e:
+        error(str(e))
+        return
+    success(f"Sessão salva em {path}")
+
+
+def flow_forget_session() -> None:
+    from clickhouse_users_cli.session import delete_session, has_saved_session
+
+    if not has_saved_session():
+        info("Nenhuma sessão salva.")
+        return
+    step("Esquecer sessão", f"Arquivo: {SESSION_FILE}")
+    go = _ask_or_abort(
+        Q.confirm("Apagar a sessão salva (vai pedir credenciais na próxima vez)?", default=False, style=APP_STYLE, qmark="›")
+    )
+    if not go:
+        console.print("[dim]Nada foi apagado.[/]")
+        return
+    delete_session()
+    success("Sessão apagada.")
+
+
 # ── Menu principal + listar/gerenciar ────────────────────────────────────────────
 
-def ask_main_action() -> str:
+def ask_main_action(show_forget: bool = False) -> str:
+    choices = [
+        Q.Choice("Criar usuário — com privilégio mínimo", value="create"),
+        Q.Choice("Listar usuários — SHOW USERS + grants", value="list"),
+        Q.Choice("Gerenciar usuário — desativar / reativar / excluir", value="manage"),
+    ]
+    if show_forget:
+        choices.append(Q.Choice("Esquecer sessão — apagar YAML salvo", value="forget"))
+    choices.append(Q.Choice("Sair", value="exit"))
     return _ask_or_abort(
         Q.select(
             "O que deseja fazer?",
-            choices=[
-                Q.Choice("Criar usuário — com privilégio mínimo", value="create"),
-                Q.Choice("Listar usuários — SHOW USERS + grants", value="list"),
-                Q.Choice("Gerenciar usuário — desativar / reativar / excluir", value="manage"),
-                Q.Choice("Sair", value="exit"),
-            ],
+            choices=choices,
             default="create",
             style=APP_STYLE, qmark="›",
             instruction="(↑↓ navega · enter confirma)",
@@ -362,7 +451,7 @@ def show_user_details(admin: ClickHouseAdmin, username: str) -> tuple[str, list[
         error(f"Falha ao ver grants de '{username}': {e}")
         grants = []
 
-    table = Table(title=f"Usuário {username}", show_header=True, header_style="bold cyan")
+    table = make_table(f"Usuário {username}")
     table.add_column("Campo", style="dim")
     table.add_column("Valor", style="bold")
     status = "inativo (HOST NONE)" if _is_inactive(create_sql) else "ativo"
@@ -392,7 +481,7 @@ def flow_list_users(admin: ClickHouseAdmin) -> None:
         info("Nenhum usuário encontrado.")
         return
 
-    table = Table(title=f"{len(users)} usuário(s)", show_header=True, header_style="bold cyan")
+    table = make_table(f"{len(users)} usuário(s)")
     table.add_column("#", style="dim")
     table.add_column("Usuário", style="bold")
     for i, u in enumerate(users, 1):
@@ -440,7 +529,7 @@ def flow_manage_users(admin: ClickHouseAdmin) -> None:
     inactive = _is_inactive(create_sql)
 
     if target == admin.conn.username:
-        error(f" Atenção: '{target}' é o usuário conectado agora. Desativar/excluir pode te derrubar.")
+        warn(f"'{target}' é o usuário conectado agora. Desativar/excluir pode te derrubar.")
 
     options = []
     if inactive:
@@ -518,17 +607,24 @@ def flow_create_user(admin: ClickHouseAdmin) -> None:
 def main() -> None:
     try:
         banner()
-        conn = ask_connection()
+        from clickhouse_users_cli.session import has_saved_session
+
+        saved_conn = maybe_load_saved_session()
+        conn = saved_conn or ask_connection()
         admin = connect_with_retry(conn)
+        if saved_conn is None:
+            ask_remember(conn)
 
         while True:
-            action = ask_main_action()
+            action = ask_main_action(show_forget=has_saved_session())
             if action == "create":
                 flow_create_user(admin)
             elif action == "list":
                 flow_list_users(admin)
             elif action == "manage":
                 flow_manage_users(admin)
+            elif action == "forget":
+                flow_forget_session()
             else:
                 console.print("[dim]Até logo![/]")
                 return

clickhouse_users_cli-0.1.2/clickhouse_users_cli/session.py

@@ -0,0 +1,80 @@
+"""Sessão local opcional — salva a conexão admin em YAML para reutilizar.
+
+Segurança: a senha fica em texto puro no arquivo. O arquivo é criado com
+permissão restrita (0600 no POSIX) e o salvamento é sempre opt-in explícito.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+from clickhouse_users_cli.db import ConnectionInfo
+
+SESSION_DIR = Path.home() / ".ch-users"
+SESSION_FILE = SESSION_DIR / "connection.yaml"
+
+
+def has_saved_session() -> bool:
+    return SESSION_FILE.is_file()
+
+
+def describe_session(data: dict) -> str:
+    proto = "https" if data.get("secure") else "http"
+    return f"{proto}://{data.get('host')}:{data.get('port')} · usuário '{data.get('username')}'"
+
+
+def save_session(conn: ConnectionInfo) -> Path:
+    """Grava a conexão em YAML com permissão restrita. Retorna o caminho."""
+    try:
+        import yaml
+    except ImportError as e:  # pragma: no cover
+        raise RuntimeError("Dependência 'pyyaml' não instalada. Rode: pip install pyyaml") from e
+
+    SESSION_DIR.mkdir(parents=True, exist_ok=True)
+    payload = {
+        "host": conn.host,
+        "port": conn.port,
+        "secure": conn.secure,
+        "username": conn.username,
+        "password": conn.password,
+    }
+    with open(SESSION_FILE, "w", encoding="utf-8") as f:
+        yaml.safe_dump(payload, f, allow_unicode=True, sort_keys=False)
+    try:
+        os.chmod(SESSION_FILE, 0o600)
+    except OSError:
+        pass  # Windows: melhor esforço; o aviso em tela cobre o risco
+    return SESSION_FILE
+
+
+def load_session() -> ConnectionInfo:
+    """Lê o YAML e devolve ConnectionInfo. Erro amigável se ausente/corrompido."""
+    try:
+        import yaml
+    except ImportError as e:  # pragma: no cover
+        raise RuntimeError("Dependência 'pyyaml' não instalada. Rode: pip install pyyaml") from e
+
+    try:
+        with open(SESSION_FILE, encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+        return ConnectionInfo(
+            host=str(data["host"]),
+            port=int(data["port"]),
+            secure=bool(data["secure"]),
+            username=str(data["username"]),
+            password=str(data.get("password") or ""),
+        )
+    except KeyError as e:
+        raise RuntimeError(f"Arquivo de sessão incompleto (falta {e}). Apague e salve de novo.") from e
+    except (OSError, ValueError, TypeError) as e:
+        raise RuntimeError(f"Não foi possível ler a sessão salva: {e}") from e
+
+
+def delete_session() -> bool:
+    """Apaga o YAML. Retorna True se algo foi removido."""
+    try:
+        SESSION_FILE.unlink()
+        return True
+    except FileNotFoundError:
+        return False

clickhouse_users_cli-0.1.2/clickhouse_users_cli/style.py

@@ -0,0 +1,114 @@
+"""Estilo centralizado (UI) + helpers de apresentação com Rich."""
+
+from questionary import Style
+from rich.align import Align
+from rich.box import DOUBLE, ROUNDED
+from rich.console import Console, Group
+from rich.panel import Panel
+from rich.rule import Rule
+from rich.table import Table
+from rich.text import Text
+
+from clickhouse_users_cli import __version__
+
+console = Console()
+
+CYAN = "#00d7ff"
+MAGENTA = "#c792ea"
+GREEN = "#00ff87"
+RED = "#ff5555"
+AMBER = "#ffcb6b"
+MUTED = "#6c7086"
+BORDER = "#3a3f4b"
+
+# Estilo questionary: alto contraste, foco visível, perigo em vermelho.
+# Mantém a navegação por teclado óbvia (setas + espaço + enter).
+APP_STYLE = Style(
+    [
+        ("qmark", "fg:#00d7ff bold"),       # "?" das perguntas
+        ("question", "fg:#ffffff bold"),     # texto da pergunta
+        ("answer", "fg:#00ff87 bold"),       # resposta escolhida
+        ("pointer", "fg:#00d7ff bold"),      # "»" do item focado
+        ("highlighted", "fg:#00d7ff bold"), # item focado
+        ("selected", "fg:#00ff87"),          # checkbox marcado "●"
+        ("separator", "fg:#6c7086"),
+        ("instruction", "fg:#a6adc8 italic"),
+        ("text", "fg:#ffffff"),
+        ("disabled", "fg:#6c7086 italic"),
+    ]
+)
+
+
+def _logo_title() -> Text:
+    """Título em degradê ciano → magenta."""
+    t = Text(no_wrap=True)
+    t.append("⬢ ", style=f"bold {CYAN}")
+    t.append("ClickHouse", style=f"bold {CYAN}")
+    t.append(" ", style="bold")
+    t.append("Users CLI", style=f"bold {MAGENTA}")
+    return t
+
+
+def banner() -> None:
+    mark = Text("╭──────────╮\n│ ▓▓▓▓▓▓▓▓ │\n│          │\n╰──────────╯", style=f"bold {CYAN}", justify="center")
+    body = Group(
+        Align.center(mark),
+        Align.center(_logo_title()),
+        Align.center(Text("Crie usuários com escopo mínimo necessário", style="dim")),
+        Align.center(Text("criar   ◆   listar   ◆   desativar   ◆   auditar", style=f"bold {CYAN}")),
+    )
+    console.print(
+        Panel(
+            body,
+            box=DOUBLE,
+            border_style=CYAN,
+            title=f"[black on {CYAN}] v{__version__} ",
+            subtitle="[dim]least privilege por padrão[/]",
+            padding=(1, 4),
+        )
+    )
+
+
+def step(title: str, subtitle: str = "") -> None:
+    """Cabeçalho de etapa — orienta o usuário sobre 'onde estou' no fluxo."""
+    console.print()
+    console.print(Rule(f"[black on {CYAN}] {title} [/]", style=CYAN))
+    if subtitle:
+        console.print(f"  [dim]{subtitle}[/]")
+
+
+def make_table(title: str) -> Table:
+    """Tabela padrão: bordas arredondadas, cabeçalho ciano."""
+    return Table(
+        title=f"[bold white]{title}[/]",
+        show_header=True,
+        header_style=f"bold {CYAN}",
+        border_style=BORDER,
+        box=ROUNDED,
+        show_lines=False,
+        padding=(0, 1),
+    )
+
+
+def success(msg: str) -> None:
+    console.print(f"[black on {GREEN}] ✔ [/] [bold {GREEN}]{msg}[/]")
+
+
+def error(msg: str) -> None:
+    console.print(
+        Panel(
+            f"[bold {RED}]{msg}[/]",
+            title=f"[bold {RED}]✘ Erro[/]",
+            border_style=RED,
+            box=ROUNDED,
+            padding=(0, 1),
+        )
+    )
+
+
+def warn(msg: str) -> None:
+    console.print(f"[black on {AMBER}] ! [/] [{AMBER}]{msg}[/]")
+
+
+def info(msg: str) -> None:
+    console.print(f"[dim]▸ {msg}[/]")

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/clickhouse_users_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clickhouse-users-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
 License-Expression: MIT
 Keywords: clickhouse,cli,users,access-control,least-privilege
@@ -19,6 +19,7 @@ License-File: LICENSE
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: clickhouse-connect>=0.8.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: pyyaml>=6.0
 Dynamic: license-file
 
 # ClickHouse Users CLI
@@ -47,6 +48,13 @@ Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USE
 Após conectar, escolha: **Criar usuário** · **Listar usuários** · **Gerenciar usuário** · **Sair**.
 O menu fica em loop — dá para criar, auditar e desativar vários sem reconectar.
 
+## Sessão salva (manter conectado)
+
+- Na primeira conexão o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` com host, porta, protocolo, usuário e senha.
+- Na próxima execução, oferece **usar a salva / nova conexão / apagar a salva**.
+- No menu há **Esquecer sessão** (apaga o YAML, com confirmação).
+- Segurança: a senha fica em **texto puro** no arquivo (permissão `0600` no Linux/mac; no Windows vale o aviso em tela). Só use em máquina confiável — nunca compartilhe o arquivo.
+
 ## Fluxo — criar (6 etapas)
 
 1. **Conexão** — host, protocolo, porta, usuário/senha admin. Testa com `SELECT 1` e permite tentar de novo / editar / sair.

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/clickhouse_users_cli.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ pyproject.toml
 clickhouse_users_cli/__init__.py
 clickhouse_users_cli/app.py
 clickhouse_users_cli/db.py
+clickhouse_users_cli/session.py
 clickhouse_users_cli/sql_builder.py
 clickhouse_users_cli/style.py
 clickhouse_users_cli/validators.py

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/clickhouse_users_cli.egg-info/requires.txt

@@ -1,3 +1,4 @@
 questionary>=2.0.0
 clickhouse-connect>=0.8.0
 rich>=13.0.0
+pyyaml>=6.0

{clickhouse_users_cli-0.1.1 → clickhouse_users_cli-0.1.2}/pyproject.toml

@@ -25,6 +25,7 @@ dependencies = [
     "questionary>=2.0.0",
     "clickhouse-connect>=0.8.0",
     "rich>=13.0.0",
+    "pyyaml>=6.0",
 ]
 
 [project.scripts]

clickhouse_users_cli-0.1.1/clickhouse_users_cli/style.py

@@ -1,55 +0,0 @@
-"""Estilo centralizado (UI) + helpers de apresentação com Rich."""
-
-from questionary import Style
-from rich.console import Console
-from rich.panel import Panel
-from rich.rule import Rule
-
-console = Console()
-
-# Estilo questionary: alto contraste, foco visível, perigo em vermelho.
-# Mantém a navegação por teclado óbvia (setas + espaço + enter).
-APP_STYLE = Style(
-    [
-        ("qmark", "fg:#00d7ff bold"),       # "?" das perguntas
-        ("question", "fg:#ffffff bold"),     # texto da pergunta
-        ("answer", "fg:#00ff87 bold"),       # resposta escolhida
-        ("pointer", "fg:#00d7ff bold"),      # "»" do item focado
-        ("highlighted", "fg:#00d7ff bold"), # item focado
-        ("selected", "fg:#00ff87"),          # checkbox marcado "●"
-        ("separator", "fg:#6c7086"),
-        ("instruction", "fg:#a6adc8 italic"),
-        ("text", "fg:#ffffff"),
-        ("disabled", "fg:#6c7086 italic"),
-    ]
-)
-
-
-def banner() -> None:
-    console.print(
-        Panel.fit(
-            "[bold cyan]ClickHouse Users CLI[/]\n"
-            "[dim]Crie usuários com escopo mínimo necessário (least privilege)[/dim]",
-            border_style="cyan",
-        )
-    )
-
-
-def step(title: str, subtitle: str = "") -> None:
-    """Cabeçalho de etapa — orienta o usuário sobre 'onde estou' no fluxo."""
-    console.print()
-    console.print(Rule(f"[bold cyan]{title}[/]", style="cyan"))
-    if subtitle:
-        console.print(f"[dim]{subtitle}[/]")
-
-
-def success(msg: str) -> None:
-    console.print(f"[bold green]✔ {msg}[/]")
-
-
-def error(msg: str) -> None:
-    console.print(f"[bold red]✘ {msg}[/]")
-
-
-def info(msg: str) -> None:
-    console.print(f"[dim]{msg}[/]")