⚙️ Configurações#

As configurações do Codis são armazenadas em ~/.codis/config.json e gerenciadas pela classe ConfigManager (src/config.py). A janela de Configurações (src/ui/settings_window.py) organiza todas as opções em 24 categorias na sidebar lateral, cada uma documentada nesta página.

Como Acessar as Configurações#

O menu Configurações foi reorganizado para não duplicar itens que já existem em outros menus: Tema vive em Exibir → Tema (ver Temas) e Acessibilidade tem entrada própria aqui, mas seu conteúdo completo está em Acessibilidade.

Alterações feitas na janela de Configurações aplicam-se imediatamente à sessão atual, sem reiniciar o Codis - cada categoria é renderizada sob demanda e mantida em cache, então alternar entre elas é instantâneo mesmo em janelas com muitas opções.

As 24 Categorias#

✏ Editor#

Opções fundamentais de edição de texto.

− Editor Avançado#

Recursos de produtividade documentados em profundidade em Inteligência do Editor.

💬 Autocomplete#

A Aparência#

🖱 Cursor#

Categoria especial: em vez de uma lista simples de chaves, embute diretamente o CursorPickerPanel (src/ui/cursor_manager.py) - o seletor visual de cursor customizado (emoji, texto ou imagem). Ver Cursor Customizável para os detalhes completos de implementação.

🖥 Interface / Layout#

💾 Salvamento#

🔍 Lint#

🔤 LSP (Language Server Protocol)#

Categoria própria, antes ausente da documentação - controla a integração com servidores de linguagem usados por Go to Definition, Find References, rename simbólico e mais (ver Editor e Arquitetura).

🌿 Git#

💻 Terminal#

📁 Árvore de Arquivos (FileTree)#

Categoria própria, antes sem cobertura na wiki.

🌐 Render#

Categoria própria, antes sem cobertura na wiki.

🕒 Timeline#

Controla o sistema de snapshots automáticos - ver File Timeline.

🔀 Flowchart#

⏱ Pomodoro#

P Performance#

🔒 Security#

⚙ Avançado#

O Editor JSON Diretamente (edição bruta do config.json) é acessado pelo menu Configurações → Avançado, não por esta categoria - ela trata apenas dos limites de zoom de fonte e do depurador.

Ver também: Debug

♿ Acessibilidade#

Ver também: Acessibilidade

🖧 SSH Remoto#

O Túnel de Debug SSH (botão Abrir Túnel Debug no painel remoto) usa as portas informadas diretamente no próprio diálogo, não as chaves debug_dap_* - essas pertencem ao Painel de Debug local (categoria Avançado). São mecanismos independentes; veja Debug Remoto e Debug.

Ver também: SSH Remoto

👥 Colaboração#

Ver também: Colaboração

🔌 Plugins#

Ver também: Plugins - Processo Isolado

🎨 Sintaxe Customizada#

Esta categoria abre o CustomKeywordsPanel em vez de uma lista de chaves simples. Permite definir palavras-chave adicionais por linguagem com cor de destaque personalizada, expandindo o highlight de sintaxe além dos padrões embutidos.

As keywords são persistidas em config.json na chave custom_keywords como lista de objetos:

"custom_keywords": [
  { "keyword": "minha_funcao", "color": "#ff79c6", "lang": "python" },
  { "keyword": "CONSTANTE",    "color": "#f1fa8c", "lang": "javascript" }
]

As keywords customizadas são aplicadas pelo highlighter de sintaxe com prioridade após os padrões embutidos, podendo sobrescrever a cor de termos já definidos. Alterações são aplicadas imediatamente ao arquivo ativo sem reiniciar o Codis.

Chaves Complementares do DEFAULT_CONFIG#

Chaves presentes em DEFAULT_CONFIG (src/constants.py) que complementam as categorias acima.

Chaves Avançadas e de Estado#

Estas chaves são lidas pelo código (com valor padrão no ponto de uso), mas não aparecem na janela de Configurações; várias são gravadas automaticamente pela interface. Edite config.json só se souber o que está fazendo.

Os padrões acima refletem os .get(chave, padrão) do código na versão 1.0.1; se divergirem, o código é a fonte da verdade.

Idiomas#

A interface do Codis é internacionalizada via src/i18n.py:

A troca de idioma reconstrói os menus imediatamente, sem reiniciar o Codis. Toda chave de tradução ausente em um idioma cai automaticamente para o texto em pt-BR (idioma base do sistema de i18n).

Comportamento do ConfigManager#

• Escrita atômica: salva primeiro em .json.tmp e depois renomeia para config.json, evitando corrupção em caso de falha durante a escrita.
• Modo degradado: se ~/.codis/ não puder ser criado (permissões), o ConfigManager opera em memória, sem persistência entre sessões.
• Backup automático: se config.json estiver corrompido, é renomeado para .json.bak e os padrões são usados.
• Coerção de tipos: valores numéricos lidos como string são convertidos automaticamente.
• Callbacks de mudança: componentes podem se registrar para receber notificações quando uma chave específica muda, via cfg.on_change("theme", callback).