git

🌿 Git

O Codis possui integração Git nativa completa através do GitPanel (src/ui/git_panel.py). Nenhuma extensão adicional é necessária.

---

Requisitos

• Git instalado e disponível no PATH.
• Um workspace aberto que seja (ou contenha) um repositório Git.

O Codis detecta automaticamente se o workspace é um repositório Git. Se não for, o painel exibe um botão para inicializar (git init).

---

Abrindo o Painel Git

Existem três formas:

1. Activity Bar → ícone 🌿 (Source Control)
2. Barra de Status → clique no nome da branch (ex: 🌿 main · 3↑)
3. Menu Exibir → Git

O ícone 🌿 na Activity Bar exibe o rótulo "Ctrl+Shift+G", mas esse atalho de teclado não tem keybind funcional vinculado no código atual (mesma situação de Problemas e SSH Remoto - o rótulo da Activity Bar nem sempre reflete um bind real). Use o menu ou clique no ícone diretamente.

O painel Git existe em dois lugares:

• Sidebar - painel principal de controle de versão.
• Painel Inferior → aba Git - instância adicional (útil quando a sidebar está com o Explorer aberto).

---

Seções do Painel

Staged Changes (Mudanças em Stage)

Arquivos adicionados à área de staging (git add). Para cada arquivo:

• Unstage - remove do staging (⊖)
• Discard - descarta as mudanças (⊘)
• Ver diff - clique no arquivo para abrir o diff no painel Diff

Changes (Mudanças)

Arquivos modificados mas não staged. Para cada arquivo:

• Stage - adiciona ao staging (⊕)
• Discard - reverte ao estado do último commit (⊘)
• Ver diff - clique no arquivo

Untracked (Novos Arquivos)

Arquivos novos não rastreados pelo Git. Para cada arquivo:

• Stage - adiciona ao tracking e staging (⊕)
• Ignorar - adiciona ao .gitignore

---

Operações Disponíveis

Commit

1. Preencha a mensagem de commit no campo de texto.
2. Clique em ✓ Commit ou pressione Ctrl+Enter dentro do campo.

O Codis valida que a mensagem não está vazia antes de commitar.

Stage / Unstage em Massa

• Stage All - adiciona todos os arquivos modificados ao staging.
• Unstage All - remove todos os arquivos do staging.

Push / Pull / Fetch

Botões na barra superior do painel. Executados em thread separada para não bloquear a UI. Um indicador de progresso é exibido durante a operação.

• Fetch - atualiza as informações do remote sem mesclar.
• Pull - git pull com o remote configurado.
• Push - git push para o remote e branch configurados.

Stash

O botão Stash abre o Gerenciador de Stash, um painel completo com:

• Campo de mensagem - descreva o stash antes de guardar (opcional).
• Guardar - executa git stash push com a mensagem informada.
• Lista de stashes - exibe todos os stashes do repositório com referência (stash@{N}) e mensagem.
• Pop (aplicar + remover) - restaura o stash selecionado e o remove da pilha (git stash pop).
• Aplicar - aplica o stash selecionado sem removê-lo da pilha (git stash apply).
• Ver Diff - exibe o diff do stash selecionado no painel de diff integrado.
• Remover - descarta o stash selecionado com confirmação (git stash drop).

Branch

O seletor de branch na parte superior do painel permite:

• Trocar de branch - selecione uma branch existente.
• Criar nova branch - insira um nome e pressione Enter.
• Deletar branch - clique com botão direito em uma branch.

Git Log

Uma seção de log compacto exibe os commits mais recentes com:

• Hash curto (7 chars)
• Mensagem do commit
• Autor e data

Clicar em um commit mostra os detalhes no painel de Output.

---

Diff Inline

Ao clicar em um arquivo modificado (staged ou unstaged), o diff é exibido no Painel Inferior → aba Diff.

O diff mostra lado a lado:

• Original - conteúdo salvo no disco (ou HEAD)
• Modificado - conteúdo atual

Navegação por hunks: F7 (próximo) e Shift+F7 (anterior).

Diff entre Dois Arquivos

Via Ferramentas → Diff: Dois Arquivos ou Paleta de Comandos, selecione dois arquivos quaisquer para compará-los lado a lado.

Diff: Arquivo vs. Salvo

Via Ferramentas → Diff: Arquivo vs. Versão Salva mostra a diferença entre o conteúdo atual do editor (com modificações não salvas) e a última versão salva em disco.

---

Indicadores na Árvore de Arquivos

Quando um workspace Git está aberto, a árvore de arquivos (Explorer) exibe indicadores visuais:

Indicador	Significado
M	Modificado
U	Não rastreado (Untracked)
A	Adicionado ao staging
D	Deletado
R	Renomeado
C	Copiado

---

Badge na Activity Bar

O ícone de Git na Activity Bar exibe um badge com o número de arquivos com mudanças (staged + unstaged + untracked). O badge é atualizado automaticamente após cada operação.

---

Autenticação Git

Para repositórios remotos que requerem autenticação (HTTPS), o painel exibe um diálogo de autenticação quando detecta erros de credenciais (AuthManager).

Suporta:

• Usuário + senha
• Tokens de acesso pessoal (PAT)

As credenciais são armazenadas de forma segura no arquivo de configuração do Codis (em Base64) e associadas ao host do repositório.

Gerenciar Credenciais

As credenciais podem ser gerenciadas diretamente em Configurações → Git, na seção Credenciais Git (HTTPS):

• Lista de hosts - exibe os hosts para os quais há credenciais salvas.
• ＋ Adicionar / Atualizar credenciais - abre um diálogo para informar o host (ex: github.com), usuário e token/senha.
• Remover - apaga as credenciais de um host específico.

As credenciais são gerenciadas exclusivamente na janela de Configurações, categoria Git.

---

Clone de Repositório

Na Tela de Boas-Vindas, há um campo para clonar repositórios diretamente:

1. Cole a URL do repositório (HTTPS ou SSH).
2. Selecione o diretório de destino.
3. Clique em Clone.

O progresso do clone é exibido no Painel de Saída → canal "Git Clone". Ao concluir, o workspace é automaticamente aberto na pasta clonada.

---

Fetch Automático

Com git_auto_fetch: true, o Codis executa git fetch automaticamente a cada git_fetch_interval segundos (padrão: 180).

---

Dependência: Comando git

Todas as operações Git são feitas via chamadas ao executável git em subprocessos. O Codis não usa nenhuma biblioteca Python para Git. Isso garante compatibilidade com qualquer versão do Git e respeita as configurações locais do usuário (.gitconfig, credencial store, etc.).

---

Segurança

O GIT_ASKPASS (src/ui/git_auth.py) usa um script Python estático, sem credenciais embutidas, que lê usuário e token de variáveis de ambiente do subprocesso Git. A credencial nunca passa por um parser de shell (aspas, `, $() e & são tratados como texto literal) e o helper é gerado uma única vez e reaproveitado, sem acumular arquivos com senha em disco.

git_credentials (dentro de config.json) é salvo com permissão 0600 (Linux/macOS).