Esse workshop foi apresentado no grupo de pesquisa GATE em 15 de outubro de 2021. Ele aborda uma introdução ao Git e GitHub, sua integração com o RStudio e uma atividade prática introdutória. A gravação está disponível no YouTube.
SUMÁRIO
O Git é um sistema de controle de versão distribuída de código aberto, muito utilizado no desenvolvimento de software, mas também adotado em outros campos, principalmente por facilitar a reprodutibilidade científica.
-
Sistema de controle: o Git pode ser utilizado para armazenar conteúdo - principalmente códigos devido aos outros recursos que oferece.
-
Sistema de controle de versão: o código armazenado no Git muda continuamente à medida que mais código é adicionado. Além disso, várias pessoas diferentes podem adicionar códigos em paralelo. Um sistema de controle de versão mantém um histórico das mudanças, permitindo consultar ou retornar à uma versão anterior do código.
-
Sistema de controle de versão distribuída: o Git possui um repositório remoto, que fica armazenado em um servidor, e um repositório local, no computador de cada pessoa envolvida (analista, desenvolvedor, gestor). Ou seja, o código não fica centralizado apenas em um servidor central, qualquer pessoa autorizada pode ter acesso a uma cópia completa do código, modificá-la e propor alterações no repositório remoto.
Portanto, o Git permite: armazenar códigos; que várias pessoas trabalhem em um projeto ao mesmo tempo; voltar à uma versão antiga dos códigos caso o projeto mude ou um erro seja introduzido; que várias versões do projeto corram em paralelo; e que diferentes pessoas tenham acesso a uma cópia do repositório remoto.
O Git possui diversos comandos que apoiam a manipulação dos repositórios e arquivos ali guardados. A figura acima apresenta um workflow básico, com alguns comandos essenciais:
-
git clone: copia um repositório remoto (armazenado em um servidor) para o seu computador.
-
git add: adiciona um conjunto de arquivos/alterações da "área de trabalho" para o índice (index/staging area).
-
git commit: confirma os arquivos/alterações no repositório local.
-
git push: atualiza o repositório remoto com base nas alterações realizadas no repositório local.
-
git pull: atualiza o repositório local com base na última versão do repositório remoto.
O GitHub é um provedor de hospedagem na internet para arquivos e códigos (repositório remoto) com sistema de controle de versão distribuída usando o Git. Ele é o maior provedor de hospedagem de código-fonte desde abril de 2020, sendo muito comumente usado para hospedar projetos de código aberto.
Além das funcionalidades do Git, o website também oferece outros recursos e serviços, dentre eles:
-
Controle de acesso.
-
Colaboração através de issues, wikis, discussions e outros.
-
Documentação, incluindo renderização automática de arquivos README em uma variedade de formatos de arquivo semelhantes ao Markdown. Ver sintaxe básica de escrita e formatação no GitHub.
-
Visualização de arquivos e dados, como dados geoespaciais, PDF e outros.
-
Recursos de redes sociais.
-
GitHub Actions, que permite o teste, lançamento e implementação de softwares em uma única plataforma.
-
GitHub Pages, para hospedagem de blogs, livros, documentação de softwares, e outros tipos de páginas web.
-
GitHub Enterprise, uma versão autogerenciada para empresas.
Projetos no GitHub podem ser acessados e gerenciados através da interface web, interface de linha de comando Git padrão, clientes desktop, dentre outros plug-ins e IDEs (Ambientes de Desenvolvimento Integrado, por exemplo o RStudio).
A figura abaixo apresenta alguns recursos da interface web:
-
Code: página inicial, contém as principais funções de Git. Aqui você pode gerenciar arquivos e códigos, acessar e alterar a documentação, revisar commits etc.
-
Issues: clique aqui para descobrir o que são issues.
-
Pull requests: trata-se de uma solicitação para incluir alterações/arquivos no projeto, que pode ter sido iniciada por uma issue, por exemplo. Depois de aberta, é possível discutir e revisar as possíveis alterações com colaboradores.
-
Discussions: é um fórum de comunicação colaborativo para a comunidade sobre um projeto de código aberto. Os integrantes da comunidade podem perguntar e responder a perguntas, compartilhar atualizações, ter conversas abertas e acompanhar decisões que afetam o modo de trabalho da comunidade.
-
Actions: ajuda a automatizar tarefas dentro do ciclo de vida de desenvolvimento de software.
-
Projects: é uma ferramenta personalizável e flexível para planejamento e acompanhamentos de trabalhos no GitHub.
-
Wiki: permite a hospedagem da documentação de um projeto de forma que outras pessoas possam usar e contribuir.
-
Security: permite controlar recursos que protegem e analisam o código em um projeto.
-
Insights: fornece dados sobre o projeto e organização.
-
Settings: configurações do projeto.
Existem diversos tutoriais disponíveis na internet sobre como baixar e configurar o Git/GitHub. Segue algumas sugestões abaixo:
2 - Configuração do nome de usuário
3 - Configuração do endereço de e-mail do commit
Após o download e configuração inicial do Git/GitHub, é possível acessar e gerenciar projetos pelo RStudio.
Para copiar (git clone) um projeto, fazendo download de todos os arquivos hospedados em um repositório remoto, você deve:
-
Copiar o endereço único do projeto no GitHub.
-
Criar um novo projeto no RStudio do tipo "Version Control" > "Git".
-
Colar o endereço único do projeto.
-
Pronto! Após clicar em "Create Project", todos os arquivos do repositório remoto serão copiados para o seu computador.
Projetos do tipo Git no RStudio possuem em sua interface opções adicionais, que permitem acessar alguns comandos sem a necessidade de utilizar linha de comando Git padrão ou outro software.
Se você já conseguiu fazer o download e configuração do Git/GitHub e a integração desse projeto com o RStudio, está na hora de colocar os novos conhecimentos em prática.
A atividade proposta assume que você já tenha conhecimento básico de R/RStudio ou Python, que são os dois softwares suportados atualmente pelo pacote geobr. Se você nunca usou o R/RStudio, mas tem interesse em aprender, você pode consultar as aulas de MTI.
Para acessar a atividade clique aqui.