utilitarios dev

🛠️ 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)

3. Aplica um layout força-dirigida (force-directed) implementado nativamente para posicionar os nós de forma legível
4. 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