+ - 0:00:00
Notes for current slide
Notes for next slide

Contribuindo através da interface gráfica do RStudio

R-Ladies São Paulo

Atualizado em 16/10/2020

1 / 25

Interface gráfica do RStudio

2 / 25

Interface Gráfica RStudio

  • O RStudio oferece um cliente Git simples, na aba "Git" (em inglês, é chamado de Git Pane).

  • Esse painel somente aparecerá em projetos que estejam versionados com Git.

3 / 25

Equivalência dos principais comandos

Linha de comando vs RStudio

  • git status

  • git add [arquivo]

  • git commit -m "[mensagem descritiva]"

  • git diff

  • git pull

  • git push

  • ...

4 / 25

Git pane - Staged ✅

5 / 25

Git pane - Commit

6 / 25

Git pane - Commit

7 / 25

Botão Diff -> Review changes

8 / 25

Botão 🕒 (history) -> Review changes

9 / 25

Branch

10 / 25

Interface Gráfica RStudio

Fonte: RStudio Cheatsheet

11 / 25

Trabalhando com projetos no RStudio + GitHub

12 / 25

Trabalhando com projetos no RStudio + GitHub

👩‍💻 No computador

12 / 25

Clonando um repositório do GitHub

  • Criando um repositório no GitHub:

Se o repositório não for "seu", faça um fork primeiro, e clone o seu fork.

13 / 25
  • No RStudio, crie um novo projeto: File > New Project
    • Na aba "Create Project", selecione a opção Version Control.

  • Na aba "Create Project from Version Control", selecione a opção Git.
14 / 25
  • Na aba "Clone Git Repository":

    • Repository URL: Cole o link para o repositório
    • Project directory name: Após inserir o repository URL, esse campo será preenchido automaticamente.
    • Create project as subdirectory of: Selecione o diretório onde você deseja manter sua cópia local do repositório.
  • O RStudio irá fazer o clone do repositório, e abrirá um RProj para ele (caso não exista um ainda, será criado).

15 / 25

Função para criar um arquivo README:

  • Em Markdown: README.md
usethis::use_readme_md()
  • Em R Markdown: README.Rmd - precisa sempre ser compilado ao .md
usethis::use_readme_rmd()
  • O arquivo será criado e aberto, para ser editado e salvo.

16 / 25

Exemplo:

Caso você esteja vendo a versão em PDF, o video acima não irá funcionar. Veja clicando neste link.

17 / 25

Crie uma branch

  • Antes de fazer qualquer modificação, crie uma branch, usando a função usethis::pr_init(branch = "nome_da_branch").
  • Argumento importante: branch = indica o nome da branch que você quer criar.
usethis::pr_init(branch = "teste")
# ✔ Checking that local branch 'master' has the changes in 'origin/master'
# ✔ Creating local PR branch 'teste'
# ✔ Switching to branch 'teste'
# ● Use `pr_push()` to create PR
18 / 25

Faça alterações e commits

  • Faça suas contribuições, e sempre faça commits com mensagens que deixem claro as mudanças.

  • Quando terminar as contribuições necessárias, utilizar a função pr_push():

pr_push()
# ✔ Pushing local 'teste' branch to 'origin:teste'
# ✔ Setting upstream tracking branch for 'teste' to 'origin/teste'
# ✔ Create PR at link given below
# ✔ Opening URL 'https://github.com/beatrizmilz/RLadies-Git-RStudio-2019/compare/teste'
  • A página do GitHub será aberta, para que possa completar o Pull Request.
19 / 25

Crie um Pull Request:

20 / 25

Open a Pull Request:

21 / 25

Exemplo: PR foi aberto

  • Depois dessa etapa, você deve esperar a pessoa que mantém o repositório responder fazendo sugestões para melhorias, aceitando seu PR, etc.
22 / 25

Modificar o PR

  • Alguém fez uma sugestão, como alterar o PR enviado? Ex:

  • No mesmo projeto e na mesma branch que você usou para enviar o PR, faça as alterações.

  • Selecione o arquivo modificado para deixá-lo disponível para criar um Commit. Faça o commit.

  • Para enviar o novo commit, use o Git Push (aperte a seta verde para cima no painel do Git do RStudio).

23 / 25

Depois que o PR é aceito: Merged

24 / 25

Última etapa: APÓS o PR ter sido aceito (merged)

  • A função pr_finish():
    • Retorna para master
    • Atualiza (usando o pull) o conteúdo
    • Deleta a branch criada para enviar o PR
pr_finish()
# ✔ Switching back to 'master' branch
# ✔ Pulling changes from GitHub source repo 'origin/master'
# ✔ Deleting local 'teste' branch
  • Pronto!
25 / 25

Interface gráfica do RStudio

2 / 25
Paused

Help

Keyboard shortcuts

, , Pg Up, k Go to previous slide
, , Pg Dn, Space, j Go to next slide
Home Go to first slide
End Go to last slide
Number + Return Go to specific slide
b / m / f Toggle blackout / mirrored / fullscreen mode
c Clone slideshow
p Toggle presenter mode
t Restart the presentation timer
?, h Toggle this help
oTile View: Overview of Slides
Alt + fFit Slides to Screen
Esc Back to slideshow