clickhouse-users-cli 0.1.4__tar.gz → 0.1.5__tar.gz

clickhouse_users_cli-0.1.5/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: clickhouse-users-cli
+Version: 0.1.5
+Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
+License-Expression: MIT
+Keywords: clickhouse,cli,users,access-control,least-privilege
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Database
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+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
+
+[![PyPI version](https://img.shields.io/pypi/v/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-00d7ff.svg)](https://opensource.org/licenses/MIT)
+
+> Crie e gerencie usuários no ClickHouse com **privilégio mínimo** (*least privilege*) — sem decorar sintaxe de `GRANT`, sem acesso amplo por acidente.
+
+CLI interativa em Python ([`questionary`](https://questionary.readthedocs.io/) + [`rich`](https://github.com/Textualize/rich)): ela pergunta, você marca com `espaço`, confere o **SQL exato com preview** e só então executa. Nada roda sem confirmação.
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║                                 ╭──────────╮                                 ║
+║                                 │ ▓▓▓▓▓▓▓▓ │                                 ║
+║                                 │          │                                 ║
+║                                 ╰──────────╯                                 ║
+║                            ⬢ ClickHouse Users CLI                            ║
+║                  Crie usuários com escopo mínimo necessário                  ║
+║               criar   ◆   listar   ◆   desativar   ◆   auditar                ║
+║                                                                              ║
+╚═════════════════════════ least privilege por padrão ═════════════════════════╝
+```
+
+---
+
+## 🚀 Instalação
+
+```powershell
+pip install clickhouse-users-cli
+ch-users
+```
+
+| Cenário | Comando |
+|---|---|
+| 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`) |
+
+---
+
+## ⚡ Comece em 60 segundos
+
+1. Rode `ch-users` e conecte com sua conta admin (host, protocolo, porta, usuário/senha — testado com `SELECT 1`).
+2. Escolha **Criar usuário** → perfil `readonly` → nome + senha → marque os bancos/tabelas → confira o preview.
+3. Confirme. Pronto — o SQL abaixo foi executado:
+
+```sql
+CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
+GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
+GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
+```
+
+---
+
+## 🧭 Menu principal
+
+Após conectar, o menu fica em loop — dá para fazer várias operações sem reconectar:
+
+| Opção | O que faz |
+|---|---|
+| 🌱 **Criar usuário** | Fluxo guiado em 6 etapas (perfil → credenciais → escopo → hosts → revisão) |
+| 📋 **Listar usuários** | Tabela via `SHOW USERS` + detalhe opcional (`SHOW CREATE USER` e `SHOW GRANTS FOR`) |
+| 🛠️ **Gerenciar usuário** | Editar permissões · desativar · reativar · excluir |
+| 🧹 **Esquecer sessão** | Apaga o YAML de conexão salva *(aparece só se existir)* |
+| 👋 **Sair** | Encerra (Ctrl+C também sai limpo, sem executar nada) |
+
+### Criar — as 6 etapas
+
+1. 🔌 **Conexão** — host, protocolo (`http:8123` / `https:8443`), porta, usuário/senha admin. Falhou? Tentar de novo / editar / sair.
+2. 🎭 **Tipo de usuário** — perfil com descrição (`readonly`, `readwrite`, `admin`, `custom`).
+3. 🪪 **Novo usuário** — nome validado (letras, números, `_`; bloqueia `default`, `root`…) + senha com confirmação.
+4. 🗂️ **Escopo** — `SHOW DATABASES` → marque bancos (nada vem marcado; há a opção `✓ Todos os bancos`) → por banco, marque tabelas ou `banco.*` (vale para tabelas futuras).
+5. 🔑 **Privilégios + origem** — no `custom`, marque só o necessário (`DROP`/`TRUNCATE` pedem confirmação extra); depois `HOST ANY | LOCALHOST | IPs`.
+6. 👀 **Revisão** — tabela-resumo + SQL com syntax highlight + confirmação final.
+
+### Gerenciar — os 4 poderes
+
+Escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants atuais, depois:
+
+| Ação | SQL executado | Reversível? |
+|---|---|---|
+| ✏️ **Editar permissões** | `REVOKE ALL ON *.*` + novos `GRANTs` (perfil + escopo perguntados de novo, com frases próprias de edição) | ✅ ( reaplicando) |
+| 🚫 **Desativar** | `ALTER USER \`nome\` HOST NONE` (bloqueia login, mantém grants) | ✅ via Reativar |
+| ✅ **Reativar** | `ALTER USER \`nome\` HOST ANY` | — |
+| 🗑️ **Excluir** | `DROP USER IF EXISTS \`nome\`` | ❌ definitivo |
+
+> Todo DDL tem preview + confirmação com default **não**. Mexer no próprio usuário logado gera alerta extra. 👻
+
+### 💾 Sessão salva (manter conectado)
+
+- Após conectar, o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` (host, porta, protocolo, usuário, senha).
+- Na próxima execução: **usar a salva · nova conexão · apagar a salva** (a senha nunca é exibida).
+- ⚠️ A senha fica em **texto puro** no arquivo (`0600` no Linux/mac; no Windows vale o aviso em tela). Use só em máquina confiável — nunca compartilhe o arquivo.
+
+---
+
+## 🔐 Permissões que sua conta admin precisa
+
+| Para… | Privilégio ClickHouse |
+|---|---|
+| Criar + conceder | `CREATE USER` + `GRANT` (nos escopos) |
+| Listar / auditar | `SHOW USERS` (+ acesso aos grants) |
+| Desativar / reativar / editar acessos | `ALTER USER` + `GRANT`/`REVOKE` nos escopos |
+| Excluir | `DROP USER` |
+
+Sem a permissão, o comando falha com mensagem amigável + dica — nada quebra pela metade sem aviso (na edição, se o `GRANT` falhar após o `REVOKE`, o CLI avisa para conferir em **Listar**).
+
+---
+
+## 🎭 Perfis (tipo de acesso)
+
+| Perfil | Privilégios | Feito para |
+|---|---|---|
+| `readonly` | `SHOW, SELECT` | BI, analistas |
+| `readwrite` | `SHOW, SELECT, INSERT` | Engenheiros, ingestão |
+| `admin` | `ALL ... WITH GRANT OPTION` | ⚠️ Acesso total — cuidado! |
+| `custom` | Você marca: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` | Casos especiais |
+
+---
+
+## 🧠 Por que cada tela é do jeito que é
+
+| Dado | Widget | Motivo |
+|---|---|---|
+| Host, porta, nomes, IPs | `text` + validação + `default` | Entrada livre com exemplo; `default` acelera localhost:8123 |
+| Senhas | `password` mascarado | Não ecoa segredo; novo usuário pede confirmação |
+| Protocolo / perfil / ação | `select` com descrição | Escolha única; descrição explica o impacto |
+| Bancos, tabelas, privilégios | `checkbox` (espaço marca) | Multi-seleção; `banco.*` evita marcar 100 tabelas |
+| Confirmações destrutivas | `confirm` com default seguro | O "não" é sempre o padrão |
+| Progresso | spinner + cabeçalho de etapa | Você sempre sabe "onde estou" e o que está carregando |
+| Revisão | tabela + SQL destacado | Sem caixa-preta: o SQL exato antes de executar |
+
+Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (backticks em identificadores, aspas simples em strings), **SQL separado da UI** (`sql_builder.py` é puro e testável sem banco).
+
+---
+
+## 🧑‍💻 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)
+```
+
+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)
+clickhouse_users_cli/
+  __init__.py            # __version__
+  app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)
+  db.py                  # clickhouse-connect: connect, SHOWs, DDL
+  session.py             # sessão YAML local (salvar/carregar/apagar)
+  sql_builder.py         # CREATE/ALTER/DROP/GRANT/REVOKE puros (testável)
+  validators.py          # validações por tipo de input
+  style.py               # banner, etapas, tabelas e mensagens (Rich)
+```
+
+---
+
+## 📝 Changelog
+
+| Versão | Novidade |
+|---|---|
+| `0.1.4` | Frases próprias no modo edição (sem `2/6`, `4/6` da criação) |
+| `0.1.3` | Editar permissões (`REVOKE ALL` + novos `GRANTs`) |
+| `0.1.2` | Sessão salva em YAML + visual profissional (banner, badges, tabelas) |
+| `0.1.1` | Lista sem pré-seleção + opção `✓ Todos os bancos` |
+| `0.1.0` | Criar, listar e gerenciar (desativar/reativar/excluir) |
+
+---
+
+## 📄 Licença
+
+MIT — veja [LICENSE](LICENSE).

clickhouse_users_cli-0.1.5/README.md

@@ -0,0 +1,181 @@
+# ⬢ ClickHouse Users CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-00d7ff.svg)](https://opensource.org/licenses/MIT)
+
+> Crie e gerencie usuários no ClickHouse com **privilégio mínimo** (*least privilege*) — sem decorar sintaxe de `GRANT`, sem acesso amplo por acidente.
+
+CLI interativa em Python ([`questionary`](https://questionary.readthedocs.io/) + [`rich`](https://github.com/Textualize/rich)): ela pergunta, você marca com `espaço`, confere o **SQL exato com preview** e só então executa. Nada roda sem confirmação.
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║                                 ╭──────────╮                                 ║
+║                                 │ ▓▓▓▓▓▓▓▓ │                                 ║
+║                                 │          │                                 ║
+║                                 ╰──────────╯                                 ║
+║                            ⬢ ClickHouse Users CLI                            ║
+║                  Crie usuários com escopo mínimo necessário                  ║
+║               criar   ◆   listar   ◆   desativar   ◆   auditar                ║
+║                                                                              ║
+╚═════════════════════════ least privilege por padrão ═════════════════════════╝
+```
+
+---
+
+## 🚀 Instalação
+
+```powershell
+pip install clickhouse-users-cli
+ch-users
+```
+
+| Cenário | Comando |
+|---|---|
+| 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`) |
+
+---
+
+## ⚡ Comece em 60 segundos
+
+1. Rode `ch-users` e conecte com sua conta admin (host, protocolo, porta, usuário/senha — testado com `SELECT 1`).
+2. Escolha **Criar usuário** → perfil `readonly` → nome + senha → marque os bancos/tabelas → confira o preview.
+3. Confirme. Pronto — o SQL abaixo foi executado:
+
+```sql
+CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
+GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
+GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
+```
+
+---
+
+## 🧭 Menu principal
+
+Após conectar, o menu fica em loop — dá para fazer várias operações sem reconectar:
+
+| Opção | O que faz |
+|---|---|
+| 🌱 **Criar usuário** | Fluxo guiado em 6 etapas (perfil → credenciais → escopo → hosts → revisão) |
+| 📋 **Listar usuários** | Tabela via `SHOW USERS` + detalhe opcional (`SHOW CREATE USER` e `SHOW GRANTS FOR`) |
+| 🛠️ **Gerenciar usuário** | Editar permissões · desativar · reativar · excluir |
+| 🧹 **Esquecer sessão** | Apaga o YAML de conexão salva *(aparece só se existir)* |
+| 👋 **Sair** | Encerra (Ctrl+C também sai limpo, sem executar nada) |
+
+### Criar — as 6 etapas
+
+1. 🔌 **Conexão** — host, protocolo (`http:8123` / `https:8443`), porta, usuário/senha admin. Falhou? Tentar de novo / editar / sair.
+2. 🎭 **Tipo de usuário** — perfil com descrição (`readonly`, `readwrite`, `admin`, `custom`).
+3. 🪪 **Novo usuário** — nome validado (letras, números, `_`; bloqueia `default`, `root`…) + senha com confirmação.
+4. 🗂️ **Escopo** — `SHOW DATABASES` → marque bancos (nada vem marcado; há a opção `✓ Todos os bancos`) → por banco, marque tabelas ou `banco.*` (vale para tabelas futuras).
+5. 🔑 **Privilégios + origem** — no `custom`, marque só o necessário (`DROP`/`TRUNCATE` pedem confirmação extra); depois `HOST ANY | LOCALHOST | IPs`.
+6. 👀 **Revisão** — tabela-resumo + SQL com syntax highlight + confirmação final.
+
+### Gerenciar — os 4 poderes
+
+Escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants atuais, depois:
+
+| Ação | SQL executado | Reversível? |
+|---|---|---|
+| ✏️ **Editar permissões** | `REVOKE ALL ON *.*` + novos `GRANTs` (perfil + escopo perguntados de novo, com frases próprias de edição) | ✅ ( reaplicando) |
+| 🚫 **Desativar** | `ALTER USER \`nome\` HOST NONE` (bloqueia login, mantém grants) | ✅ via Reativar |
+| ✅ **Reativar** | `ALTER USER \`nome\` HOST ANY` | — |
+| 🗑️ **Excluir** | `DROP USER IF EXISTS \`nome\`` | ❌ definitivo |
+
+> Todo DDL tem preview + confirmação com default **não**. Mexer no próprio usuário logado gera alerta extra. 👻
+
+### 💾 Sessão salva (manter conectado)
+
+- Após conectar, o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` (host, porta, protocolo, usuário, senha).
+- Na próxima execução: **usar a salva · nova conexão · apagar a salva** (a senha nunca é exibida).
+- ⚠️ A senha fica em **texto puro** no arquivo (`0600` no Linux/mac; no Windows vale o aviso em tela). Use só em máquina confiável — nunca compartilhe o arquivo.
+
+---
+
+## 🔐 Permissões que sua conta admin precisa
+
+| Para… | Privilégio ClickHouse |
+|---|---|
+| Criar + conceder | `CREATE USER` + `GRANT` (nos escopos) |
+| Listar / auditar | `SHOW USERS` (+ acesso aos grants) |
+| Desativar / reativar / editar acessos | `ALTER USER` + `GRANT`/`REVOKE` nos escopos |
+| Excluir | `DROP USER` |
+
+Sem a permissão, o comando falha com mensagem amigável + dica — nada quebra pela metade sem aviso (na edição, se o `GRANT` falhar após o `REVOKE`, o CLI avisa para conferir em **Listar**).
+
+---
+
+## 🎭 Perfis (tipo de acesso)
+
+| Perfil | Privilégios | Feito para |
+|---|---|---|
+| `readonly` | `SHOW, SELECT` | BI, analistas |
+| `readwrite` | `SHOW, SELECT, INSERT` | Engenheiros, ingestão |
+| `admin` | `ALL ... WITH GRANT OPTION` | ⚠️ Acesso total — cuidado! |
+| `custom` | Você marca: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` | Casos especiais |
+
+---
+
+## 🧠 Por que cada tela é do jeito que é
+
+| Dado | Widget | Motivo |
+|---|---|---|
+| Host, porta, nomes, IPs | `text` + validação + `default` | Entrada livre com exemplo; `default` acelera localhost:8123 |
+| Senhas | `password` mascarado | Não ecoa segredo; novo usuário pede confirmação |
+| Protocolo / perfil / ação | `select` com descrição | Escolha única; descrição explica o impacto |
+| Bancos, tabelas, privilégios | `checkbox` (espaço marca) | Multi-seleção; `banco.*` evita marcar 100 tabelas |
+| Confirmações destrutivas | `confirm` com default seguro | O "não" é sempre o padrão |
+| Progresso | spinner + cabeçalho de etapa | Você sempre sabe "onde estou" e o que está carregando |
+| Revisão | tabela + SQL destacado | Sem caixa-preta: o SQL exato antes de executar |
+
+Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (backticks em identificadores, aspas simples em strings), **SQL separado da UI** (`sql_builder.py` é puro e testável sem banco).
+
+---
+
+## 🧑‍💻 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)
+```
+
+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)
+clickhouse_users_cli/
+  __init__.py            # __version__
+  app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)
+  db.py                  # clickhouse-connect: connect, SHOWs, DDL
+  session.py             # sessão YAML local (salvar/carregar/apagar)
+  sql_builder.py         # CREATE/ALTER/DROP/GRANT/REVOKE puros (testável)
+  validators.py          # validações por tipo de input
+  style.py               # banner, etapas, tabelas e mensagens (Rich)
+```
+
+---
+
+## 📝 Changelog
+
+| Versão | Novidade |
+|---|---|
+| `0.1.4` | Frases próprias no modo edição (sem `2/6`, `4/6` da criação) |
+| `0.1.3` | Editar permissões (`REVOKE ALL` + novos `GRANTs`) |
+| `0.1.2` | Sessão salva em YAML + visual profissional (banner, badges, tabelas) |
+| `0.1.1` | Lista sem pré-seleção + opção `✓ Todos os bancos` |
+| `0.1.0` | Criar, listar e gerenciar (desativar/reativar/excluir) |
+
+---
+
+## 📄 Licença
+
+MIT — veja [LICENSE](LICENSE).

{clickhouse_users_cli-0.1.4 → clickhouse_users_cli-0.1.5}/clickhouse_users_cli/__init__.py

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

clickhouse_users_cli-0.1.5/clickhouse_users_cli.egg-info/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: clickhouse-users-cli
+Version: 0.1.5
+Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
+License-Expression: MIT
+Keywords: clickhouse,cli,users,access-control,least-privilege
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Database
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+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
+
+[![PyPI version](https://img.shields.io/pypi/v/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/clickhouse-users-cli.svg)](https://pypi.org/project/clickhouse-users-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-00d7ff.svg)](https://opensource.org/licenses/MIT)
+
+> Crie e gerencie usuários no ClickHouse com **privilégio mínimo** (*least privilege*) — sem decorar sintaxe de `GRANT`, sem acesso amplo por acidente.
+
+CLI interativa em Python ([`questionary`](https://questionary.readthedocs.io/) + [`rich`](https://github.com/Textualize/rich)): ela pergunta, você marca com `espaço`, confere o **SQL exato com preview** e só então executa. Nada roda sem confirmação.
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║                                 ╭──────────╮                                 ║
+║                                 │ ▓▓▓▓▓▓▓▓ │                                 ║
+║                                 │          │                                 ║
+║                                 ╰──────────╯                                 ║
+║                            ⬢ ClickHouse Users CLI                            ║
+║                  Crie usuários com escopo mínimo necessário                  ║
+║               criar   ◆   listar   ◆   desativar   ◆   auditar                ║
+║                                                                              ║
+╚═════════════════════════ least privilege por padrão ═════════════════════════╝
+```
+
+---
+
+## 🚀 Instalação
+
+```powershell
+pip install clickhouse-users-cli
+ch-users
+```
+
+| Cenário | Comando |
+|---|---|
+| 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`) |
+
+---
+
+## ⚡ Comece em 60 segundos
+
+1. Rode `ch-users` e conecte com sua conta admin (host, protocolo, porta, usuário/senha — testado com `SELECT 1`).
+2. Escolha **Criar usuário** → perfil `readonly` → nome + senha → marque os bancos/tabelas → confira o preview.
+3. Confirme. Pronto — o SQL abaixo foi executado:
+
+```sql
+CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
+GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
+GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
+```
+
+---
+
+## 🧭 Menu principal
+
+Após conectar, o menu fica em loop — dá para fazer várias operações sem reconectar:
+
+| Opção | O que faz |
+|---|---|
+| 🌱 **Criar usuário** | Fluxo guiado em 6 etapas (perfil → credenciais → escopo → hosts → revisão) |
+| 📋 **Listar usuários** | Tabela via `SHOW USERS` + detalhe opcional (`SHOW CREATE USER` e `SHOW GRANTS FOR`) |
+| 🛠️ **Gerenciar usuário** | Editar permissões · desativar · reativar · excluir |
+| 🧹 **Esquecer sessão** | Apaga o YAML de conexão salva *(aparece só se existir)* |
+| 👋 **Sair** | Encerra (Ctrl+C também sai limpo, sem executar nada) |
+
+### Criar — as 6 etapas
+
+1. 🔌 **Conexão** — host, protocolo (`http:8123` / `https:8443`), porta, usuário/senha admin. Falhou? Tentar de novo / editar / sair.
+2. 🎭 **Tipo de usuário** — perfil com descrição (`readonly`, `readwrite`, `admin`, `custom`).
+3. 🪪 **Novo usuário** — nome validado (letras, números, `_`; bloqueia `default`, `root`…) + senha com confirmação.
+4. 🗂️ **Escopo** — `SHOW DATABASES` → marque bancos (nada vem marcado; há a opção `✓ Todos os bancos`) → por banco, marque tabelas ou `banco.*` (vale para tabelas futuras).
+5. 🔑 **Privilégios + origem** — no `custom`, marque só o necessário (`DROP`/`TRUNCATE` pedem confirmação extra); depois `HOST ANY | LOCALHOST | IPs`.
+6. 👀 **Revisão** — tabela-resumo + SQL com syntax highlight + confirmação final.
+
+### Gerenciar — os 4 poderes
+
+Escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants atuais, depois:
+
+| Ação | SQL executado | Reversível? |
+|---|---|---|
+| ✏️ **Editar permissões** | `REVOKE ALL ON *.*` + novos `GRANTs` (perfil + escopo perguntados de novo, com frases próprias de edição) | ✅ ( reaplicando) |
+| 🚫 **Desativar** | `ALTER USER \`nome\` HOST NONE` (bloqueia login, mantém grants) | ✅ via Reativar |
+| ✅ **Reativar** | `ALTER USER \`nome\` HOST ANY` | — |
+| 🗑️ **Excluir** | `DROP USER IF EXISTS \`nome\`` | ❌ definitivo |
+
+> Todo DDL tem preview + confirmação com default **não**. Mexer no próprio usuário logado gera alerta extra. 👻
+
+### 💾 Sessão salva (manter conectado)
+
+- Após conectar, o CLI pergunta se quer **manter conectado**: salva `~/.ch-users/connection.yaml` (host, porta, protocolo, usuário, senha).
+- Na próxima execução: **usar a salva · nova conexão · apagar a salva** (a senha nunca é exibida).
+- ⚠️ A senha fica em **texto puro** no arquivo (`0600` no Linux/mac; no Windows vale o aviso em tela). Use só em máquina confiável — nunca compartilhe o arquivo.
+
+---
+
+## 🔐 Permissões que sua conta admin precisa
+
+| Para… | Privilégio ClickHouse |
+|---|---|
+| Criar + conceder | `CREATE USER` + `GRANT` (nos escopos) |
+| Listar / auditar | `SHOW USERS` (+ acesso aos grants) |
+| Desativar / reativar / editar acessos | `ALTER USER` + `GRANT`/`REVOKE` nos escopos |
+| Excluir | `DROP USER` |
+
+Sem a permissão, o comando falha com mensagem amigável + dica — nada quebra pela metade sem aviso (na edição, se o `GRANT` falhar após o `REVOKE`, o CLI avisa para conferir em **Listar**).
+
+---
+
+## 🎭 Perfis (tipo de acesso)
+
+| Perfil | Privilégios | Feito para |
+|---|---|---|
+| `readonly` | `SHOW, SELECT` | BI, analistas |
+| `readwrite` | `SHOW, SELECT, INSERT` | Engenheiros, ingestão |
+| `admin` | `ALL ... WITH GRANT OPTION` | ⚠️ Acesso total — cuidado! |
+| `custom` | Você marca: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` | Casos especiais |
+
+---
+
+## 🧠 Por que cada tela é do jeito que é
+
+| Dado | Widget | Motivo |
+|---|---|---|
+| Host, porta, nomes, IPs | `text` + validação + `default` | Entrada livre com exemplo; `default` acelera localhost:8123 |
+| Senhas | `password` mascarado | Não ecoa segredo; novo usuário pede confirmação |
+| Protocolo / perfil / ação | `select` com descrição | Escolha única; descrição explica o impacto |
+| Bancos, tabelas, privilégios | `checkbox` (espaço marca) | Multi-seleção; `banco.*` evita marcar 100 tabelas |
+| Confirmações destrutivas | `confirm` com default seguro | O "não" é sempre o padrão |
+| Progresso | spinner + cabeçalho de etapa | Você sempre sabe "onde estou" e o que está carregando |
+| Revisão | tabela + SQL destacado | Sem caixa-preta: o SQL exato antes de executar |
+
+Princípios: **opt-in explícito** (nada pré-marcado), **escape correto** (backticks em identificadores, aspas simples em strings), **SQL separado da UI** (`sql_builder.py` é puro e testável sem banco).
+
+---
+
+## 🧑‍💻 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)
+```
+
+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)
+clickhouse_users_cli/
+  __init__.py            # __version__
+  app.py                 # fluxos interativos (criar, listar, gerenciar, sessão)
+  db.py                  # clickhouse-connect: connect, SHOWs, DDL
+  session.py             # sessão YAML local (salvar/carregar/apagar)
+  sql_builder.py         # CREATE/ALTER/DROP/GRANT/REVOKE puros (testável)
+  validators.py          # validações por tipo de input
+  style.py               # banner, etapas, tabelas e mensagens (Rich)
+```
+
+---
+
+## 📝 Changelog
+
+| Versão | Novidade |
+|---|---|
+| `0.1.4` | Frases próprias no modo edição (sem `2/6`, `4/6` da criação) |
+| `0.1.3` | Editar permissões (`REVOKE ALL` + novos `GRANTs`) |
+| `0.1.2` | Sessão salva em YAML + visual profissional (banner, badges, tabelas) |
+| `0.1.1` | Lista sem pré-seleção + opção `✓ Todos os bancos` |
+| `0.1.0` | Criar, listar e gerenciar (desativar/reativar/excluir) |
+
+---
+
+## 📄 Licença
+
+MIT — veja [LICENSE](LICENSE).

clickhouse_users_cli-0.1.4/PKG-INFO

@@ -1,126 +0,0 @@
-Metadata-Version: 2.4
-Name: clickhouse-users-cli
-Version: 0.1.4
-Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
-License-Expression: MIT
-Keywords: clickhouse,cli,users,access-control,least-privilege
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Environment :: Console
-Classifier: Intended Audience :: System Administrators
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Database
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-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
-
-CLI interativa em Python com [`questionary`](https://questionary.readthedocs.io/) para criar usuários no ClickHouse com **privilégio mínimo** (least privilege): pergunta credenciais, lista bancos, lista tabelas, define perfil e gera `CREATE USER` + `GRANT`s com preview antes de executar.
-
-## Instalar
-
-```powershell
-pip install clickhouse-users-cli
-ch-users
-```
-
-## Rodar do código-fonte
-
-```powershell
-pip install -r requirements.txt
-python main.py
-```
-
-Requer uma conta admin (ex.: `default`) com permissão `CREATE USER` + `GRANT`.
-Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USER`.
-
-## Menu
-
-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.
-2. **Tipo de usuário** — perfil (`readonly`, `readwrite`, `admin`, `custom`).
-3. **Novo usuário** — nome validado + senha com confirmação.
-4. **Escopo** — `SHOW DATABASES` → checkbox de bancos → `SHOW TABLES FROM` por banco → checkbox de tabelas (com opção `banco.*`).
-5. **Privilégios + origem** — se `custom`, checkbox de privilégios; depois `HOST ANY | LOCALHOST | IPs`.
-6. **Revisão** — tabela resumo (Rich) + SQL com syntax highlight + confirmação final.
-
-Exemplo do SQL gerado:
-
-```sql
-CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
-GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
-GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
-```
-
-## Fluxo — listar / gerenciar
-
-- **Listar** — `SHOW USERS` em tabela + opção de ver `SHOW CREATE USER` e `SHOW GRANTS FOR` de um usuário.
-- **Gerenciar** — escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants, depois:
-  - **Editar permissões** → pergunta perfil (tipo de acesso) + bancos/tabelas e aplica `REVOKE ALL ON *.*` + novos `GRANTs` (com preview e confirmação);
-  - **Desativar** → `ALTER USER \`nome\` HOST NONE` (reversível, bloqueia login);
-  - **Reativar** → `ALTER USER \`nome\` HOST ANY`;
-  - **Excluir** → `DROP USER IF EXISTS \`nome\`` (definitivo).
-- Todo DDL mostra preview + confirmação com default `não`. Mexer no próprio usuário logado gera alerta extra.
-
-## Por que cada widget?
-
-| Dado | Widget | Motivo semântico / UX |
-|---|---|---|
-| Host, porta, nomes, IPs | `text` + `validate` + `default` | Entrada livre com validação imediata e exemplo; `default` acelera o caminho feliz (localhost:8123) |
-| Senhas (admin e nova) | `password` (mascarado) | Não ecoa segredo; com validação de tamanho e dupla confirmação no novo usuário |
-| Protocolo (http/https) | `select` | Escolha única em lista pequena; descrição já indica a porta padrão |
-| Perfil | `select` com descrição | 4 opções mutuamente exclusivas; descrição diz o privilégio e o público (analista, engenheiro…) |
-| Bancos, tabelas, privilégios custom | `checkbox` + validação mín. 1 | Multi-seleção com `espaço`; instrução de teclado visível; `banco.*` evita marcar 100 tabelas |
-| Confirmações (IF NOT EXISTS, GRANT OPTION, DROP, executar) | `confirm` com default seguro | Yes/No explícito; default é sempre a opção menos destrutiva |
-| Progresso e erros | `rich.status` (spinner) + `Rule` por etapa | Feedback durante `SHOW DATABASES` / DDL; cabeçalho `1/6…6/6` orienta "onde estou" |
-| Revisão | `rich.table` + `rich.syntax` | Resumo legível + SQL exato que será executado — sem "caixa-preta" |
-
-Decisões de UX:
-
-- **Nada pré-marcado + opção `✓ Todos os bancos`** (least privilege: acesso só via opt-in explícito; sistemas vão por último com tag `(sistema)`).
-- **Ctrl+C = saída limpa**, nada executa sem confirmação final.
-- **SQL separado da UI** (`clickhouse_users_cli/sql_builder.py`) — dá para testar sem banco.
-- **Escape correto** de identificadores (backticks) e strings (aspas simples).
-- **Perfis com defaults seguros**: `readonly → SHOW+SELECT`, `readwrite → +INSERT`, `admin → ALL + GRANT OPTION`, `custom → você escolhe` (com confirmação extra para `DROP`/`TRUNCATE`).
-
-## Estrutura
-
-```
-main.py                  # entrypoint (dev local)
-requirements.txt
-pyproject.toml           # build + metadados PyPI (comando: ch-users)
-clickhouse_users_cli/
-  __init__.py            # __version__ (fonte única da versão)
-  app.py                 # fluxo questionary (6 etapas)
-  db.py                  # clickhouse-connect: connect, list_databases/tables, execute
-  sql_builder.py         # CREATE USER / GRANT puros (testável)
-  validators.py          # validações por tipo de input
-  style.py               # Style questionary + banner/tabela Rich
-```
-
-## Perfis
-
-- `readonly`: `SHOW, SELECT` — BI, analistas.
-- `readwrite`: `SHOW, SELECT, INSERT` — engenheiros, ingestão.
-- `admin`: `ALL ... WITH GRANT OPTION` em `*.*` — cuidado!
-- `custom`: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` à escolha.

clickhouse_users_cli-0.1.4/README.md

@@ -1,102 +0,0 @@
-# ClickHouse Users CLI
-
-CLI interativa em Python com [`questionary`](https://questionary.readthedocs.io/) para criar usuários no ClickHouse com **privilégio mínimo** (least privilege): pergunta credenciais, lista bancos, lista tabelas, define perfil e gera `CREATE USER` + `GRANT`s com preview antes de executar.
-
-## Instalar
-
-```powershell
-pip install clickhouse-users-cli
-ch-users
-```
-
-## Rodar do código-fonte
-
-```powershell
-pip install -r requirements.txt
-python main.py
-```
-
-Requer uma conta admin (ex.: `default`) com permissão `CREATE USER` + `GRANT`.
-Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USER`.
-
-## Menu
-
-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.
-2. **Tipo de usuário** — perfil (`readonly`, `readwrite`, `admin`, `custom`).
-3. **Novo usuário** — nome validado + senha com confirmação.
-4. **Escopo** — `SHOW DATABASES` → checkbox de bancos → `SHOW TABLES FROM` por banco → checkbox de tabelas (com opção `banco.*`).
-5. **Privilégios + origem** — se `custom`, checkbox de privilégios; depois `HOST ANY | LOCALHOST | IPs`.
-6. **Revisão** — tabela resumo (Rich) + SQL com syntax highlight + confirmação final.
-
-Exemplo do SQL gerado:
-
-```sql
-CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
-GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
-GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
-```
-
-## Fluxo — listar / gerenciar
-
-- **Listar** — `SHOW USERS` em tabela + opção de ver `SHOW CREATE USER` e `SHOW GRANTS FOR` de um usuário.
-- **Gerenciar** — escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants, depois:
-  - **Editar permissões** → pergunta perfil (tipo de acesso) + bancos/tabelas e aplica `REVOKE ALL ON *.*` + novos `GRANTs` (com preview e confirmação);
-  - **Desativar** → `ALTER USER \`nome\` HOST NONE` (reversível, bloqueia login);
-  - **Reativar** → `ALTER USER \`nome\` HOST ANY`;
-  - **Excluir** → `DROP USER IF EXISTS \`nome\`` (definitivo).
-- Todo DDL mostra preview + confirmação com default `não`. Mexer no próprio usuário logado gera alerta extra.
-
-## Por que cada widget?
-
-| Dado | Widget | Motivo semântico / UX |
-|---|---|---|
-| Host, porta, nomes, IPs | `text` + `validate` + `default` | Entrada livre com validação imediata e exemplo; `default` acelera o caminho feliz (localhost:8123) |
-| Senhas (admin e nova) | `password` (mascarado) | Não ecoa segredo; com validação de tamanho e dupla confirmação no novo usuário |
-| Protocolo (http/https) | `select` | Escolha única em lista pequena; descrição já indica a porta padrão |
-| Perfil | `select` com descrição | 4 opções mutuamente exclusivas; descrição diz o privilégio e o público (analista, engenheiro…) |
-| Bancos, tabelas, privilégios custom | `checkbox` + validação mín. 1 | Multi-seleção com `espaço`; instrução de teclado visível; `banco.*` evita marcar 100 tabelas |
-| Confirmações (IF NOT EXISTS, GRANT OPTION, DROP, executar) | `confirm` com default seguro | Yes/No explícito; default é sempre a opção menos destrutiva |
-| Progresso e erros | `rich.status` (spinner) + `Rule` por etapa | Feedback durante `SHOW DATABASES` / DDL; cabeçalho `1/6…6/6` orienta "onde estou" |
-| Revisão | `rich.table` + `rich.syntax` | Resumo legível + SQL exato que será executado — sem "caixa-preta" |
-
-Decisões de UX:
-
-- **Nada pré-marcado + opção `✓ Todos os bancos`** (least privilege: acesso só via opt-in explícito; sistemas vão por último com tag `(sistema)`).
-- **Ctrl+C = saída limpa**, nada executa sem confirmação final.
-- **SQL separado da UI** (`clickhouse_users_cli/sql_builder.py`) — dá para testar sem banco.
-- **Escape correto** de identificadores (backticks) e strings (aspas simples).
-- **Perfis com defaults seguros**: `readonly → SHOW+SELECT`, `readwrite → +INSERT`, `admin → ALL + GRANT OPTION`, `custom → você escolhe` (com confirmação extra para `DROP`/`TRUNCATE`).
-
-## Estrutura
-
-```
-main.py                  # entrypoint (dev local)
-requirements.txt
-pyproject.toml           # build + metadados PyPI (comando: ch-users)
-clickhouse_users_cli/
-  __init__.py            # __version__ (fonte única da versão)
-  app.py                 # fluxo questionary (6 etapas)
-  db.py                  # clickhouse-connect: connect, list_databases/tables, execute
-  sql_builder.py         # CREATE USER / GRANT puros (testável)
-  validators.py          # validações por tipo de input
-  style.py               # Style questionary + banner/tabela Rich
-```
-
-## Perfis
-
-- `readonly`: `SHOW, SELECT` — BI, analistas.
-- `readwrite`: `SHOW, SELECT, INSERT` — engenheiros, ingestão.
-- `admin`: `ALL ... WITH GRANT OPTION` em `*.*` — cuidado!
-- `custom`: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` à escolha.

clickhouse_users_cli-0.1.4/clickhouse_users_cli.egg-info/PKG-INFO

@@ -1,126 +0,0 @@
-Metadata-Version: 2.4
-Name: clickhouse-users-cli
-Version: 0.1.4
-Summary: CLI interativa para criar usuarios ClickHouse com privilegio minimo (least privilege)
-License-Expression: MIT
-Keywords: clickhouse,cli,users,access-control,least-privilege
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Environment :: Console
-Classifier: Intended Audience :: System Administrators
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Database
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-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
-
-CLI interativa em Python com [`questionary`](https://questionary.readthedocs.io/) para criar usuários no ClickHouse com **privilégio mínimo** (least privilege): pergunta credenciais, lista bancos, lista tabelas, define perfil e gera `CREATE USER` + `GRANT`s com preview antes de executar.
-
-## Instalar
-
-```powershell
-pip install clickhouse-users-cli
-ch-users
-```
-
-## Rodar do código-fonte
-
-```powershell
-pip install -r requirements.txt
-python main.py
-```
-
-Requer uma conta admin (ex.: `default`) com permissão `CREATE USER` + `GRANT`.
-Para listar/gerenciar também precisa de `SHOW USERS` + `ALTER USER` / `DROP USER`.
-
-## Menu
-
-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.
-2. **Tipo de usuário** — perfil (`readonly`, `readwrite`, `admin`, `custom`).
-3. **Novo usuário** — nome validado + senha com confirmação.
-4. **Escopo** — `SHOW DATABASES` → checkbox de bancos → `SHOW TABLES FROM` por banco → checkbox de tabelas (com opção `banco.*`).
-5. **Privilégios + origem** — se `custom`, checkbox de privilégios; depois `HOST ANY | LOCALHOST | IPs`.
-6. **Revisão** — tabela resumo (Rich) + SQL com syntax highlight + confirmação final.
-
-Exemplo do SQL gerado:
-
-```sql
-CREATE USER IF NOT EXISTS `analyst_julho` IDENTIFIED WITH plaintext_password BY '***' HOST ANY;
-GRANT SHOW, SELECT ON `vendas`.`pedidos` TO `analyst_julho`;
-GRANT SHOW, SELECT ON `vendas`.`clientes` TO `analyst_julho`;
-```
-
-## Fluxo — listar / gerenciar
-
-- **Listar** — `SHOW USERS` em tabela + opção de ver `SHOW CREATE USER` e `SHOW GRANTS FOR` de um usuário.
-- **Gerenciar** — escolhe 1 usuário, vê status (`HOST NONE` = inativo) + grants, depois:
-  - **Editar permissões** → pergunta perfil (tipo de acesso) + bancos/tabelas e aplica `REVOKE ALL ON *.*` + novos `GRANTs` (com preview e confirmação);
-  - **Desativar** → `ALTER USER \`nome\` HOST NONE` (reversível, bloqueia login);
-  - **Reativar** → `ALTER USER \`nome\` HOST ANY`;
-  - **Excluir** → `DROP USER IF EXISTS \`nome\`` (definitivo).
-- Todo DDL mostra preview + confirmação com default `não`. Mexer no próprio usuário logado gera alerta extra.
-
-## Por que cada widget?
-
-| Dado | Widget | Motivo semântico / UX |
-|---|---|---|
-| Host, porta, nomes, IPs | `text` + `validate` + `default` | Entrada livre com validação imediata e exemplo; `default` acelera o caminho feliz (localhost:8123) |
-| Senhas (admin e nova) | `password` (mascarado) | Não ecoa segredo; com validação de tamanho e dupla confirmação no novo usuário |
-| Protocolo (http/https) | `select` | Escolha única em lista pequena; descrição já indica a porta padrão |
-| Perfil | `select` com descrição | 4 opções mutuamente exclusivas; descrição diz o privilégio e o público (analista, engenheiro…) |
-| Bancos, tabelas, privilégios custom | `checkbox` + validação mín. 1 | Multi-seleção com `espaço`; instrução de teclado visível; `banco.*` evita marcar 100 tabelas |
-| Confirmações (IF NOT EXISTS, GRANT OPTION, DROP, executar) | `confirm` com default seguro | Yes/No explícito; default é sempre a opção menos destrutiva |
-| Progresso e erros | `rich.status` (spinner) + `Rule` por etapa | Feedback durante `SHOW DATABASES` / DDL; cabeçalho `1/6…6/6` orienta "onde estou" |
-| Revisão | `rich.table` + `rich.syntax` | Resumo legível + SQL exato que será executado — sem "caixa-preta" |
-
-Decisões de UX:
-
-- **Nada pré-marcado + opção `✓ Todos os bancos`** (least privilege: acesso só via opt-in explícito; sistemas vão por último com tag `(sistema)`).
-- **Ctrl+C = saída limpa**, nada executa sem confirmação final.
-- **SQL separado da UI** (`clickhouse_users_cli/sql_builder.py`) — dá para testar sem banco.
-- **Escape correto** de identificadores (backticks) e strings (aspas simples).
-- **Perfis com defaults seguros**: `readonly → SHOW+SELECT`, `readwrite → +INSERT`, `admin → ALL + GRANT OPTION`, `custom → você escolhe` (com confirmação extra para `DROP`/`TRUNCATE`).
-
-## Estrutura
-
-```
-main.py                  # entrypoint (dev local)
-requirements.txt
-pyproject.toml           # build + metadados PyPI (comando: ch-users)
-clickhouse_users_cli/
-  __init__.py            # __version__ (fonte única da versão)
-  app.py                 # fluxo questionary (6 etapas)
-  db.py                  # clickhouse-connect: connect, list_databases/tables, execute
-  sql_builder.py         # CREATE USER / GRANT puros (testável)
-  validators.py          # validações por tipo de input
-  style.py               # Style questionary + banner/tabela Rich
-```
-
-## Perfis
-
-- `readonly`: `SHOW, SELECT` — BI, analistas.
-- `readwrite`: `SHOW, SELECT, INSERT` — engenheiros, ingestão.
-- `admin`: `ALL ... WITH GRANT OPTION` em `*.*` — cuidado!
-- `custom`: `SELECT/SHOW/INSERT/CREATE/ALTER/DROP/TRUNCATE/OPTIMIZE/KILL QUERY` à escolha.