Uso do Git pelo editor

Uso do Git pelo editor

Introdução

O que é o Git?

Git (pronuncia-se "guit") é um sistema de versionamento de código muito usado em projetos de software. Ele permite, entre outras coisas:

• ter um histórico do código, no qual é possível voltar atrás;
• sincronizar vários aparelhos e trabalhar em equipe nos mesmos arquivos limitando os conflitos;
• manter várias versões do mesmo código, para desenvolver e experimentar sem quebrar a versão funcional;
• fazer backup do projeto facilmente.

Uma pasta versionada pelo Git é chamada de repositório (_repository_ ou _repo_ em inglês).

O que é uma forja?

Se o Git é um software utilizável localmente (na sua máquina ou no editor do Leek Wars), ele também pode interagir com uma forja de software: um servidor que hospeda repositórios Git.

O Leek Wars suporta várias forjas; o mais simples é escolher uma entre estas:

• GitHub, serviço proprietário da Microsoft (EUA). Hospeda também o código do Leek Wars.
• GitLab.com, instância oficial do GitLab (EUA), um software livre auto-hospedável.
• Bitbucket, serviço proprietário da Atlassian (EUA).
• Codeberg, instância oficial do Forgejo, software livre comunitário auto-hospedável, mantida por uma organização alemã sem fins lucrativos.

Também é possível usar outras forjas baseadas em GitLab, Bitbucket, Forgejo, Gitea ou Gogs, por exemplo framagit.org ou gitea.com.

Usar o Git para uma IA existente

Antes de tudo, a IA deve estar em uma pasta, e não na raiz. Crie uma pasta, clique com o botão direito na pasta e escolha "Inicializar um repositório Git". Ela conterá todos os arquivos a integrar ao Git.

Uma aba Git com um pictograma de ramificação aparece no topo da lista de arquivos (menu da esquerda). Vá até ela.

Fazer commits

(um commit é uma "validação", um registro no histórico)

No topo da aba Git, verifique no seletor suspenso se o repositório desejado está selecionado (caso você tenha vários).

Quando os arquivos do repositório são modificados, as alterações aparecem na aba Git. Elas estão, por enquanto, fora do stage: é como um rascunho, que ainda não foi gravado no mármore do histórico.

Quando você quiser registrar alterações no histórico, clique no botão ➕ para adicioná-las ao stage. Resuma as alterações em poucas palavras no campo "Mensagem do commit" e confirme.

Nota: para ver bem todos os botões da aba Git, pode ser necessário alargá-la para a direita arrastando sua borda direita!

O histórico é uma lista de commits, cada commit sendo um conjunto de alterações, com uma data e uma mensagem. A ideia é poder descobrir de quando data determinada alteração, voltar atrás, agrupar as alterações para evitar ter um código que funciona pela metade...

Conectar-se a uma forja

Configuração na forja

Crie uma conta em uma forja Git e crie nela um repositório vazio. Encontre o endereço do seu repositório, que deve se parecer com https://exemple.net/mon-pseudo/mon-depot.git. É o endereço da página principal do seu repositório, com .git a mais no final.

Em seguida, é preciso autorizar o Leek Wars a acessar o repositório. O procedimento depende da forja.

• GitHub: o mais simples é instalar a GitHub App do Leek Wars, diretamente pelo editor (veja abaixo). Como alternativa, você pode criar um token: clique no seu perfil, Settings, Developer Settings (bem embaixo). Na página que se abre, escolha Personal access tokens, Tokens (classic). Escolha uma expiração (90 dias, por exemplo) e dê apenas as permissões necessárias para participar do repositório.
• Forgejo: Configurações da conta, Aplicações, Novo token de acesso. Autorize o acesso de leitura e escrita a "repository".

Se você criou um token, guarde-o bem para não perdê-lo!

Configuração no Leek Wars

Na parte de baixo da aba Git, clique no botão de nuvem "Definições do remote".

É aqui que se declara o repositório remoto (o remote): indique um nome (por exemplo origin), cole a URL do repositório e clique no botão "Add". Essa etapa é indispensável antes de poder enviar qualquer coisa.

Para a autenticação, escolha a sua forja: GitHub, GitLab, Bitbucket ou Forgejo.

• GitHub: o caminho principal é o botão "Install GitHub App". Durante a instalação, escolha os repositórios aos quais dar acesso; de volta ao Leek Wars, você poderá selecionar diretamente um desses repositórios para o remote. Como alternativa, cole um Personal Access Token no campo "Access token".
• GitLab e Bitbucket: cole o token no campo "Access token". Se você usa uma instância auto-hospedada em vez de gitlab.com ou bitbucket.org, marque "Self-hosted instance" e indique o endereço da forja (essa opção também existe para o GitHub).
• Forgejo: a opção "Self-hosted instance" não existe para essa forja; o campo de endereço da instância é sempre exibido (pré-preenchido com codeberg.org). Indique o endereço da sua instância se necessário e cole o token no campo "Access token".

Enviar seus commits para o servidor

Por enquanto, o histórico de commits está registrado apenas no Leek Wars. Para enviá-lo à forja, faz-se um push com o botão ⬆ bem embaixo na aba Git.

Toda vez que você quiser enviar novos commits, faça um push.

Outras funções

O editor e a aba Git também oferecem:

• Clonar um repositório: menu Arquivo → "Clonar um repositório git", indicando a URL do repositório e a pasta de destino.
• Pull: botão "Pull" para buscar os commits do remote, com a escolha entre uma estratégia merge ou rebase ("Estratégia de pull").
• Branches: o seletor de branch permite trocar de branch, criar novas ("Nova branch...") e ver as branches remotas.
• Histórico e diff: o botão "Histórico" lista os commits, e um clique em um arquivo modificado exibe suas diferenças.
• Resolução de conflitos: em caso de conflito durante um merge ou um rebase, o editor permite resolvê-los e depois continuar.
• Desfazer o último commit: as alterações do commit desfeito permanecem no índice.
• Compactar o repositório: reduz o espaço ocupado pelo repositório (útil para a quota).
• Terminal Git integrado: exibe o registro dos comandos Git executados pelo editor.