🛠️ Formatador, Variáveis de Ambiente e Grafo de Dependências#

Esta página cobre três utilitários de desenvolvimento que ficam na categoria Ferramentas → Utilitários de Desenvolvimento: o Formatador/Validador de dados estruturados, o Gerenciador de Variáveis de Ambiente e o Visualizador de Grafo de Dependências.

Os demais utilitários dessa mesma categoria - Color Picker, Regex Playground, SQL Studio, REST Client, Diff Viewer, Code Stats e Flowchart - já estão documentados em Recursos Avançados.

{ } Formatador de Dados (src/ui/formatter_panel.py)#

Atalho: Ctrl+Alt+F ou Ferramentas → Utilitários de Desenvolvimento → Formatador.

Formatos suportados#

JSON, YAML, TOML e XML.

Funcionalidades#

Ação O que faz
Formatar Reindenta e organiza o conteúdo no formato escolhido, com indentação consistente
Minificar Remove espaços e quebras de linha desnecessárias, gerando a versão mais compacta
Validar Verifica a sintaxe e exibe erros com número de linha e coluna exatos
Converter Converte entre formatos: JSON ↔ YAML ↔ TOML
Comparar Abre o conteúdo formatado em duas versões no Diff Viewer

Fluxo típico#

  1. Cole ou digite o conteúdo no painel de entrada
  2. Escolha o formato de origem (detectado automaticamente quando possível)
  3. Use Validar antes de formatar, se quiser garantir que a sintaxe está correta
  4. Formatar/Minificar processa o conteúdo no painel de saída
  5. Copiar resultado ou Salvar arquivo para persistir o resultado

A árvore de estrutura (painel lateral) permite explorar o documento de forma hierárquica, útil para JSON/YAML profundamente aninhados.

⚙ Gerenciador de Variáveis de Ambiente (src/ui/env_manager.py)#

Atalho: Ferramentas → Utilitários de Desenvolvimento → Variáveis de Env.

A janela tem três abas:

Aba Conteúdo
Env Atual Todas as variáveis de ambiente do processo Codis em execução
Perfis .env Arquivos .env salvos, importáveis/exportáveis
Snippets Trechos prontos para exportar variáveis em diferentes shells

Funcionalidades#

  • Visualizar todas as variáveis do processo atual (os.environ)
  • Adicionar, editar ou remover variáveis para a sessão corrente (afeta apenas o processo do Codis, não o sistema)
  • Perfis .env: criar, importar e exportar arquivos .env completos, e aplicá-los à sessão atual
  • Pesquisa e filtro por nome de variável
  • Geração de snippets prontos em export VAR=valor (bash), setx VAR valor (cmd) e $env:VAR = "valor" (PowerShell)
  • Diff entre o env atual e um perfil salvo - útil para descobrir rapidamente o que mudou entre ambientes (ex.: comparar .env.production com o ambiente local)

Parsing de .env#

O parser interno (_parse_env_file) lê o formato .env simples (CHAVE=valor por linha, com suporte a comentários # e linhas vazias ignoradas).

🔗 Dependency Graph (src/ui/dependency_graph.py)#

Atalho: Ferramentas → Utilitários de Desenvolvimento → Grafo de Deps.

Analisa os imports de arquivos Python no workspace e renderiza um grafo interativo de dependências, desenhado inteiramente em Canvas Tkinter - sem nenhuma biblioteca de grafos externa.

Como funciona#

  1. Faz o parse de import X e from X import Y em todos os arquivos .py do workspace, usando ast (com fallback para regex se o parse falhar)
  2. Classifica cada módulo encontrado em três categorias coloridas:
Categoria Cor Critério
stdlib Verde Está em sys.stdlib_module_names
local - Faz parte do próprio workspace
third-party - Pacote externo instalado (não é stdlib nem local)
  1. Aplica um layout força-dirigida (force-directed) implementado nativamente para posicionar os nós de forma legível
  2. Renderiza o grafo com zoom e pan via mouse

Funcionalidades adicionais#

  • Clique em um nó para abrir o arquivo correspondente diretamente no editor
  • Filtro por nome de módulo
  • Checkbox para mostrar/ocultar módulos stdlib (reduz ruído visual em projetos grandes)
  • Ciclos de dependência são destacados em vermelho - útil para identificar imports circulares antes que causem erro em runtime
  • Exportação como DOT (formato Graphviz), permitindo renderizar o grafo externamente com dot -Tpng grafo.dot -o grafo.png ou importar em outras ferramentas de visualização