🚀 Recursos Avançados#

Esta página documenta funcionalidades avançadas do Codis que vão além do editor básico.

LSP - Language Server Protocol#

O LSP integra servidores de linguagem externos para fornecer inteligência de código avançada. Gerenciado pela classe LSPManager (src/lsp/client.py).

Servidores Suportados (Auto-detectados)#

Legenda: ✅ Testado e funcional · ⚠️ Funcional com limitações conhecidas

Funcionalidades LSP#

Configuração#

"lsp_enabled": true

O LSP é ativado automaticamente ao abrir um arquivo de uma linguagem suportada. Cada linguagem tem seu próprio processo de servidor LSP independente.

Code Outline#

O painel Code Outline (Activity Bar → 📚) exibe a estrutura hierárquica do arquivo ativo: funções, classes, variáveis, imports e outros símbolos. Atualiza automaticamente quando o arquivo é modificado.

Clicar em qualquer símbolo no outline navega diretamente para a definição no editor.

Bookmarks#

O sistema de bookmarks permite marcar posições específicas nos arquivos para navegação rápida.

Criando Bookmarks#

• Ctrl+F2 ou Ferramentas → Adicionar Bookmark
• Ao criar, um diálogo solicita uma nota opcional para identificar o marcador.

Navegando por Bookmarks#

Painel de Bookmarks#

O painel de Bookmarks (sidebar → 🔖) lista todos os marcadores de todos os arquivos, com:

• Arquivo, linha, coluna e snippet da linha
• Nota associada ao bookmark
• Clique para navegar diretamente

Snippets#

Painel de Snippets#

O painel de Snippets (Ctrl+Shift+J) exibe todos os snippets disponíveis, filtrados pela linguagem do arquivo ativo.

Estrutura de um Snippet#

Snippets são arquivos JSON em ~/.codis/snippets/:

{
  "name": "função Python",
  "prefix": "def",
  "language": "python",
  "body": "def ${1:nome}(${2:parâmetros}):\n    ${3:pass}",
  "description": "Criar uma nova função Python"
}

Campos:

• prefix - gatilho de expansão (digitar + Tab)
• body - corpo do snippet com ${N:placeholder} para campos de edição
• language - linguagem específica ou "*" para todas

Inserindo Snippets#

• Digite o prefixo e pressione Tab para expandir.
• Navegue entre campos com Tab / Shift+Tab.
• O painel de Snippets também permite inserção por clique duplo.

Diff Engine#

Diff: Arquivo vs. Versão Salva#

Ferramentas → Diff: Arquivo vs. Versão Salva compara o conteúdo atual (com modificações não salvas) com a última versão em disco.

Diff: Dois Arquivos#

Ferramentas → Diff: Dois Arquivos abre um seletor de arquivo duplo e exibe o diff lado a lado.

Navegação no Diff#

O diff engine (src/diff/engine.py) usa o algoritmo de Myers para gerar diffs com linha de contexto.

Find in Files (Busca em Arquivos)#

A busca em arquivos (Ctrl+Shift+F) pesquisa texto em todo o workspace.

Funcionalidades:

• Suporte a expressões regulares
• Filtros de inclusão: *.py, src/**
• Filtros de exclusão: !node_modules, !*.min.js
• Respeita .gitignore quando respect_ignore_files: true
• Máximo de search_max_results resultados (padrão: 2000)

Atalho no resultado: clique em qualquer resultado para abrir o arquivo na linha correspondente.

Debug Panel#

O Painel de Debug (painel inferior → aba Debug) oferece depuração real de Python via DAP/debugpy: breakpoints (clique na margem do editor), step into/over/out, inspeção de variáveis e call stack, e um console com avaliação de expressões no frame parado.

Guia completo, configurações e resolução de problemas (incluindo conflitos de porta com VS Code): Debug.

Para outras linguagens além de Python, o painel executa o arquivo de forma simples (captura de saída), sem breakpoints/stepping reais por enquanto.

Regex Playground#

Ctrl+Shift+R ou painel inferior → aba Regex abre um playground interativo para testar expressões regulares:

• Campo de padrão regex com syntax highlighting
• Flags: i (case-insensitive), m (multiline), s (dotall)
• Resultado em tempo real: matches destacados no texto de teste
• Botão Aplicar no Editor - substitui no arquivo ativo via _regex_replace()

Color Picker#

Ctrl+Shift+C abre o seletor de cores. Detecta automaticamente a cor sob o cursor (valores #rrggbb, rgb(), etc.) e inicializa o picker com ela.

Ao confirmar:

1. A cor selecionada é inserida no cursor.
2. A cor é copiada para o clipboard.

Scratchpad#

O Scratchpad (Ctrl+Shift+N) é um editor de texto temporário persistente - ideal para notas rápidas, código de rascunho ou qualquer texto que não precisa de um arquivo.

O conteúdo é salvo automaticamente e sobrevive ao reinício do Codis.

Code Stats#

O painel 📊 Code Stats (Activity Bar → 📊) exibe estatísticas do workspace:

• Contagem de arquivos por linguagem
• Total de linhas de código
• Tamanho total dos arquivos
• Distribuição por tipo de arquivo (gráfico de barras)

Todo Tree#

O painel ✅ Todo Tree (Activity Bar → ✅) varre todos os arquivos do workspace em busca de comentários TODO, FIXME, HACK, NOTE e exibe uma lista navegável. Clicar em um item abre o arquivo na linha correspondente.

REST Client#

O painel 🌍 REST Client (Activity Bar → 🌍) permite fazer requisições HTTP diretamente do editor:

• Métodos: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
• Headers customizáveis
• Body (JSON, form-data, raw)
• Exibição formatada da resposta

Preview / Render Panel#

O painel 🌐 Preview (Activity Bar → 🌐) renderiza o arquivo ativo:

• HTML - renderiza como página web com suporte a CSS e JavaScript local
• Markdown - converte e exibe com formatação rica (detecta tema claro/escuro pelo brilho do tema ativo)
• SVG - renderiza o gráfico diretamente

Atualiza automaticamente ao salvar o arquivo.

Flowchart Panel#

O painel 🔀 Flowchart (Activity Bar → 🔀) gera um fluxograma visual do código ativo automaticamente, usando análise de fluxo de controle.

Pomodoro Timer#

O painel ⏱ Pomodoro (Ctrl+Alt+P) implementa a técnica Pomodoro:

• Temporizadores configuráveis para sessão de trabalho e pausa
• Notificações na barra de status ao fim de cada intervalo

Notas de Sessão#

Ferramentas → Notas de Sessão abre uma janela flutuante de notas persistentes vinculadas ao workspace atual. O conteúdo é salvo automaticamente em ~/.codis/notes_<hash>.txt a cada 600 ms de inatividade.

Histórico de Colagem#

Ctrl+Shift+V abre o histórico das últimas 50 entradas do clipboard. Clique duplo ou pressione Enter para colar o item selecionado no editor ativo.

Ferramentas de Texto#

Via menu Ferramentas:

SQL Studio#

O SQL Studio é um ambiente completo de banco de dados integrado ao Codis, disponível na Activity Bar (🗄), na aba inferior (🗄 SQL) e pelo atalho Ctrl+Shift+Q.

Drivers suportados#

Gerenciamento de Conexões#

Conexões são salvas em ~/.codis/sql_connections.json. Cada perfil inclui:

• Nome, driver, caminho (SQLite/DuckDB) ou host/porta/database/usuário/senha (outros)
• Flag somente leitura para conexões SQLite/DuckDB em modo seguro
• Botão 🔗 Testar antes de salvar verifica se a conexão funciona

Editor SQL#

• Syntax highlighting: palavras-chave em azul, strings, números e comentários -- / /* */
• Números de linha integrados
• Autocomplete Ctrl+Space - keywords SQL + tabelas + colunas do esquema ativo
• F5 ou Ctrl+Enter - executa a query completa
• Botão ▶ Seleção - executa apenas o texto selecionado
• Botão 📊 EXPLAIN - exibe o plano de execução sem rodar a query
• Botão ⬛ Formatar - UPPER-CASE em keywords e quebras de linha semânticas
• Salvar / abrir arquivos .sql diretamente

Browser de Esquema#

A coluna lateral esquerda exibe a árvore de tabelas do banco conectado:

• 📋 nome_tabela - nó expansível
• 🔑 coluna - chave primária
• coluna TIPO! - ! indica NOT NULL
• Duplo clique em tabela → insere SELECT * FROM "tabela" LIMIT 100; no editor
• Duplo clique em coluna → insere o nome da coluna no cursor
• Botão direito → menu de contexto com SELECT *, COUNT(*), DROP TABLE, Ver Esquema DDL
• Campo de busca no topo para filtrar tabelas por nome

Grid de Resultados#

• Clique no cabeçalho de qualquer coluna para ordenar
• 📤 CSV - exporta os resultados para arquivo .csv
• 📤 JSON - exporta para arquivo .json com objetos por linha
• Máximo de 5.000 linhas exibidas por query (configurável em src/ui/sql_studio.py)

Histórico#

Até 500 queries salvas automaticamente em ~/.codis/sql_history.json, acessíveis pelo botão ⏱ Histórico. A janela de histórico mostra timestamp, prévia da query e permite inserção por duplo clique.

Gerenciador de Tarefas#

O Gerenciador de Tarefas (Activity Bar → ✅, sem atalho de teclado dedicado) oferece três visões:

Kanban#

Quadro visual com quatro colunas configuráveis:

Backlog  →  Em Andamento  →  Revisão  →  Concluído

Cada cartão exibe:

• Faixa de cor por prioridade (🔴 Crítico · 🟠 Alto · 🟡 Médio · 🟢 Baixo)
• Título, preview da descrição
• Badge de vencimento com cores por urgência (atraso em vermelho, hoje em amarelo, próximo em laranja)
• Tags coloridas (cor calculada automaticamente por hash do nome)

Duplo clique em qualquer cartão abre o editor. Botão direito → mover para coluna, arquivar, deletar.

Lista#

Tabela com todas as tarefas filtráveis por texto e prioridade, com opção de mostrar tarefas arquivadas.

Agendador de Comandos#

Aba ⏰ Agendador para execução automática de comandos shell:

O Scheduler é um thread daemon que verifica as tarefas a cada 10 segundos. Suporta comandos simples (python backup.py) e shell complexos com pipes e redirecionamentos (echo hi | tee log.txt). O botão ▶ Executar Agora força execução imediata da tarefa selecionada.

Agendamentos salvos em ~/.codis/scheduled_tasks.json. O log de execuções exibe saída real com cores verde (sucesso) / vermelho (erro).