output

📤 Painel de Saída

O Output Panel (src/ui/output_panel.py) é o painel de log centralizado do Codis. Ele exibe mensagens de todos os subsistemas em canais separados, com filtragem por nível.

---

Abrindo o Output Panel

• Painel inferior → aba Output
• Menu Exibir → Output

---

Canais

O Output Panel usa um sistema de canais para separar mensagens por origem:

Canal	O que registra
Codis	Mensagens internas do editor (ações do usuário, eventos importantes)
Python	Resultados do lint Python (pyflakes, pylint, mypy, flake8)
ESLint	Resultados do lint JavaScript/TypeScript
LSP	Mensagens do servidor LSP ativo
Extensions	Logs do sistema de plugins (carregamento, erros)
Git Clone	Progresso e resultado de operações de clone
<nome do plugin>	Canal exclusivo criado por cada plugin via api.create_output_channel()

Plugins podem criar canais adicionais arbitrários.

---

Níveis de Mensagem

Cada mensagem tem um nível que determina sua cor de exibição:

Nível	Cor	Uso
info	Texto padrão do tema	Informações gerais
warn	Amarelo	Avisos não críticos
error	Vermelho	Erros e falhas
ok	Verde	Operações concluídas com sucesso

---

Bridge com o Sistema de Logging Python

O Codis instala dois handlers no sistema de logging padrão do Python (logging) que encaminham mensagens para o Output Panel:

1. Handler do logger Codis (nível WARNING e acima) → canal Codis
2. Handler do logger raiz (nível ERROR e acima) → canal Codis

Isso significa que qualquer chamada a logger.warning(...) ou logger.error(...) em qualquer módulo do Codis aparece automaticamente no Output Panel.

Plugins que usam api.get_logger() obtêm um logger prefixado com o ID do plugin, e suas mensagens aparecem no canal do próprio plugin.

---

Adicionando Mensagens ao Output

Via código Python (por exemplo, em um plugin):

# Via OutputChannel (preferido para plugins)
canal = api.create_output_channel("Meu Plugin")
canal.append("Operação concluída.")
canal.appendLine("Outra mensagem.")

# Via logger padrão (aparece no canal "Codis")
import logging
logger = logging.getLogger("Codis.MeuModulo")
logger.warning("Algo inesperado aconteceu.")
logger.error("Falha crítica: %s", str(exc))

---

Mensagens Automáticas

O Codis escreve automaticamente no Output Panel nas seguintes situações:

Evento	Canal	Mensagem
Arquivo aberto	Codis	📂 Aberto: <caminho>
Workspace aberto	Codis	Workspace: <caminho>
Lint completado (com diagnósticos)	Python / ESLint	Lista de erros e avisos
Diagnósticos LSP recebidos	LSP	Contagem de diagnósticos
Plugin carregado	Extensions	Plugins carregados: N
Erro de carregamento de plugin	Extensions	Plugins com falha: N
Mensagem de log do servidor LSP	LSP	Mensagem do servidor

---

Formato das Mensagens de Lint

Para cada arquivo analisado, o Output Panel exibe:

── nome_do_arquivo.py ──────────────────────────────────
  ✖ L42:8  Undefined variable 'foo'  [undefined-variable]
  ⚠ L55:1  Line too long (82 > 79)   [line-too-long]
  2 problema(s) - 1 erro(s), 1 aviso(s)

---

Timestamp

Mensagens podem incluir timestamp (timestamp=True). O formato é [HH:MM:SS]. A maioria das mensagens automáticas inclui timestamp; mensagens de lint não incluem para economizar espaço.

---

Filtragem

O Output Panel permite filtrar mensagens por canal (dropdown) e por nível mínimo. Mensagens de canais não selecionados são ocultadas da visualização mas não descartadas.