Clonar un repositorio de GitHub en R

1. Tres caminos para clonar/descargar un repositorio de GitHub

Para replicar las clases del curso “Taller de R: Estadística y programación” (ver repositorio del curso en GitHub aquí) o cualquier otro repositorio libre en GitHub, usted puede seguir cualquiera de estos tres caminos. Sin embargo, en cualquiera de los tres casos, es necesario que usted se registre y cree una cuenta en GitHub previamente.

1.1. Descargar el repositorio manualmente

La forma más sencilla de descargar un repositorio de GitHub para replicar la clase es descargar manualmente la carpeta completa del repositorio. Para ello, usted debe ir al repositorio y hacer clic en el botón Code y después hacer clic en Download ZIP.

Esto generará en su carpeta de descargas un archivo de extensión .zip que debe descomprimir. Al descomprimir el archivo, usted obtiene una carpeta con todos los archivos del repositorio. Para propósitos de la clase, es importante que usted lea los archivos README.html y el otro archivo .html que está en la carpeta help.

1.2. Usando la URL del repositorio

Podemos descargar el repositorio usando la URL del archivo .zip. Para ello, primero vamos a ir a la consola de RStudio y generamos un script. Después seleccionamos el directorio de trabajo en el que deseamos descargar la carpeta.

Imagen de setwd

Copiamos el código que se genera en la consola setwd("~/Downloads") y lo pegamos en el script.

# By: Eduard Martinez
# Date: 16-08-2020

# Vamos a establecer el directorio de trabajo
setwd("~/Downloads")

Ahora vamos al repositorio en GitHub y hacemos clic en el botón Botón Code , y después hacemos clic derecho sobre el botón Botón Download ZIP para que se despliegue el siguiente menú:

$Menú contextual$

Menú contextual

Luego, debe hacer clic sobre Copiar enlace . Esto copiará la URL que contiene el archivo .zip del repositorio.

Ahora vamos a descargar el repositorio usando la función download.file del paquete utils (este paquete viene por defecto en la instalación de R, así que no debería tener problemas). Pegamos la URL que copiamos en el argumento url y en el argumento destfile escribimos el nombre que le queremos asignar a nuestra carpeta.

# Descargar el repositorio
download.file(url = "https://github.com/taller-R/Clase_1/archive/master.zip", 
              destfile = "clase_1.zip")

Después de correr estas lineas, se genera en nuestro directorio de trabajo un archivo llamdo “clase_1.zip” en formato .zip con el contenido del repositorio.

Ahora vamos a descomprimir este archivo usando la función unzip del paquete utils.

# Descomprimir el archivo
unzip(zipfile = "clase_1.zip")

Debemos tener en un nuestro directorio de trabajo una carpeta llamda “clase_1-master” con el contenido del repositorio.

Ya podemos fijar nuestro nuevo directorio de trabajo hasta la carpeta que descomprimimos setwd("~/Downloads/clase_1-master") e inspeccionamos los archivos que contiene list.files()

# Cambiar el directorio de trabajo
setwd("~/Downloads/clase_1-master")

# Inspeccionar archivos en el directorio 
list.files()

Listo ya puedes replicar este repositorio, solo debes ir a la carpeta codes y a la carpeta help para que abras el archivo Clase 1.R y el archivo Clase 1.html.

Crear un proyecto de versión de control.

Otra forma de replicar un repositorio en GitHub, es crear un proyecto de versión de control en R. Para ello, primero tenemos que istalar git, un sistema de control de versiones. Debemos ir al siguiente en enlace y elegir el instalador que sea compatible con el sistema operativo de nuestro equipo.

Qries

3.1.1 Instalación de Git en Windows.

Si usted usa Windows, debe descargar el instalador de git bash (Git for Windows Setup de 32-bit o 64-bit), hacer clic sobre el y seguirle las instrucciones de instalación.

Qries

3.1.2 Instalación de Git en Mac.

Si usted tiene un equipo Mac, primero debe ir a la terminal de su equipo (puede hacerlo desde Rstudio) e instalar Homebrew. “Homebrew instala todo aquello que necesitas que Apple no instala de serie”. Las instrucciones de instalación puede encontrarlas en este enlace o puede copiar este codígo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" y pegarlo en la terminal de su equipo.

Qries

Después que termina de instalarse Homebrew, usted puede instalar Git copiando y pegando esta linea de código en la terminal brew install git.

Qries

3.2 Configuración inicial de Git.

Ahora vamos a configurar nuestra cuenta de GitHub desde la terminal. Esto aplica tanto para usuarios de Windows como usuarios de MAC, sin embargo, este proceso solo se debe realizar una vez, ya que la información queda guardada en la configuración de nuestro equipo.

Primero vamos a abrir la terminal del equipo (puedes usar la de R) y escribimos: git config --global user.name "Escribe tu usuario de GitHub". Luego como una forma verificar si lo hiciste bien, puedes escribir git config user.name sobre la terminal y deberías obtener el nombre del usuario que habías escrito anteriormente.

Qries

Ahora debes escribir la siguiente linea de código: git config --global user.email "Escribe tu correo de GitHub" luego escribes git config user.email para verificar que lo hiciste bien.

Qries

Finalmente debes escribir la siguiente linea de código: git config --global user.password "Escribe tu contraseña de GitHub". Con esto quedó configurado nuestra cuenta de Git en el equipo y no es necesario que hagas esto cada vez que vas a clonar un repositorio en GitHub.

3.3 Clonar el repositorio.

Ya podemos ir al repositorio de GitHub que queremos clonar. Primero vamos a hacer una bifurcación del repositorio original. Para ello, debemos ir al repositorio y hacer clic en Qries . Esto debe crear un nuevo brazo del repositorio así:

Qries

Ahora debemos ir al repositorio que clonamos (el que se crea en tu bodega de repositorios de GitHub) y hacemos clic en Qries y después hacemos clic sobre Qries para copiar la url del repositorio.

Qries

3.4 Crear una versión de control en R.

Ya que tenemos la URL del repositorio, vamos a Rstudio y creamos un proyecto de versión de control. Primero hacemos clic en Qries para que se despliegue el siguente menu:

Qries

depués hacemos clic en Version Control para que se despliegue el siguente menu:

Qries

ahora seleccionamos la opci’on Git para que se despliegue el siguente menu:

Qries

Ahora, en el espacio de Repository URL: vamos a pegar la URL del repositorio que habiamos copiado en el paso anterior. En Project directory name: escribimos el nombre que queremos ponerle al proyecto, es decir a la carpeta que va a contener el repositorio. Finalmente, en Create project as subdirectory of: seleccionamos la ubicación que queremos asignarle a la carpeta en nuestro equipo. Después de esto, en la parte superior de la “memoria activa” de Rstudio se debe observar un incono con el nombre del proyecto Qries y se fija como directorio de trabajo, la carpeta que contiene el proyecto que acabamos de crear. Usted debería observar el contenido de la carpeta así:

Qries

3.5 Guardar los cambios en nuestro repositorio.

Finalmente, para guardar en nuestro repositorio los comentarios y los cambios que vamos haciendo sobre la clase, debemos escribir las siguientes lineas de código sobre la terminal de R.

Para subir los cambios que hemos realizado, primero debemos escribir git add -A para marcar todos los archivos que queremos subir a GitHub. Después debemos escribir git commit -m "Escribir comentario", en Escribir comentarios debe escribir el comentario que usted quiere asignarle a los cambios que realizó. Finalmente, para subir los cambios, usted debe escribir git push y listo, ya puede ir a su repositorio en la página de GitHub para revisar los cambios realizó.