Criando projetos! Como integrar Git, Github e RStudio (Iniciante).
Bem-vindo! 👋 Nessa postagem eu falo sobre como integrar o Git, Github e o Rstudio. Trabalhar com essa integração apresenta algumas vantagens… e é isso que veremos.
Visão geral
É comum, principalmente para nós que não somos programadores, realizarmos projetos pequenos no RStudio e não utilizarmos o Git e Github. Em outras palavras, abrimos não de ferramentas que podem facilitar nossas vidas, organizando versões e armazenando em local seguro, por exemplo. Não é incomum errar um código, por mais que pequeno, e não conseguir voltar para a versão anterior que estava funcionando, ou mesmo não encontrar os seus arquivos.
Portanto, vamos começar sobre o que é e o que faz cada um.
Git?
É um Sistema de Controle de Versões. Estes sistemas de controle possuem a função de registrar quaisquer alterações feitas em cima de um código, armazenando essas informações e permitindo que, caso seja necessário, um(a) programador(a) possa recuperar as versões anteriores de uma aplicação de modo simples e rápido.
Github?
É uma plataforma totalmente online onde você pode criar repositórios, hospedar neles seus projetos (determinados tipos de jogos, site estático, etc.) e colaborar com softwares open source. O GitHub armazena todos estes dados em uma nuvem e você pode acessá-los de onde estiver. O que significa que você poderá alterá-los mesmo sem estar com os arquivos no seu computador, precisando somente executar um pull.
Existem alguns termos que são familiares aos usuários desses sistemas e que são interessantes saber!
Branch: É uma versão ramificada do projeto. Possibilita o desenvolvimento simultâneo (equipe) de algum projeto, o qual poderá ser unificado futuramente ao código original.
Merge: Comando para unir a versão ramificada de interesse.
Fork: Faz uma cópia do repositório selecionado para seu perfil, o qual poderá ser baixado em sua máquina.
Pull: Comando utilizado para trazer um arquivo do repositório para sua máquina.
Push: Envia os arquivos de sua máquina para um repositório remoto (Guithub, por exemplo).
💬 Vamos começar
1. Inscreva-se em GitHub.com
Se você não tem uma conta GitHub, inscreva-se aqui:
2. Instale git
Se você não tiver o git instalado, faça-o:
3. Configurar git com Rstudio
💡 Digite seu nome de usuário e e-mail (utilizados no Github):
usethis::use_git_config(user.name = "SeuNome", user.email = "seu@mail.com")
💡 Crie um token de acesso pessoal para autenticação:
usethis::create_github_token()
💡 Definir token de acesso pessoal:
credentials::set_github_pat("SeuPAT")
⬆️ outra possibilidade é armazenar manualmente em .Renviron
:
usethis::edit_r_environ()
armazene seu token de acesso pessoal com: GITHUB_PAT=xxxyyyzzz e certifique-se de que .Renviron
termina com uma nova linha
4. Verificar configurações
usethis::git_sitrep()
Seu nome de usuário e e-mail devem ser indicados corretamente na saída. Além disso, o relatório deve conter algo como:
`Personal access token: `<found in env var>``
5. Erro no PAT 🚨
Se você não costuma atualizar o seu sistema e os pacotes o seguinte erro pode acontecer:
√ Checking that current branch is default branch ('master')
Error in validate_gh_pat(new_gh_pat(x)) :
A GitHub PAT must consist of 40 hexadecimal digits
Nesse caso, Tente atualizar o pacote gh
. Recentemente, ele adicionou suporte para o novo formato de token do GitHub, que você provavelmente está utilizando. Os novos tokens começam com *ghp_*, o que pode estar gerando o erro.
📚 Referências
License
Copyright 2021-present Natanael Soares.