Git y GitHub con R
Manejo de Rstudio en GitHub
Autor: Ronaldo Anticona Guillen
GitHub in R
More: https://rfortherestofus.com/2021/02/how-to-use-git-github-with-r/
Conociendo
Usar Git y GitHub junto con RStudio tiene el poder de revolucionar la forma en que trabaja en R.
Git es un software de código abierto para el control de versiones . Con Git, puede hacer cosas como ver todas las versiones anteriores del código que haya creado en un proyecto.
GitHub es el servicio más popular (otros incluyen GitLab y BitBucket ) para colaborar en código usando Git.
Es posible usar Git sin usar GitHub, aunque la mayoría de las personas combinan los dos.
¿Por qué debería usar Git y GitHub?
He visto tres motivaciones principales para que las personas adopten un flujo de trabajo Git / GitHub:
Sirve como respaldo . Debido a que GitHub tiene una copia de todo el código que tiene localmente, si algo le sucediera a su computadora, aún tendría acceso a su código.
Permite usar el control de versiones. En lugar de hacer copias de archivos por temor a perder el trabajo, el control de versiones le permite ver lo que hizo en el pasado, todo mientras conserva versiones únicas de los documentos.
Permite trabajar en el mismo proyecto al mismo tiempo que los colaboradores. Git y GitHub tienen herramientas integradas que permiten el trabajo asincrónico simultáneo, un beneficio importante para quienes trabajan en equipo.
Configurar Git
More: Happy Git and GitHub for the useR / https://happygitwithr.com/
Instalar Git
Instale Git para Windows10 (https://git-scm.com/downloads)
Tenga en cuenta que RStudio para Windows prefiere que Git se instale a continuación C:/Program Files y este parece ser el predeterminado. Esto implica, por ejemplo, que el ejecutable de Git en mi sistema Windows se encuentra en C:/Program Files/Git/bin/git.exe. A menos que tenga razones específicas para lo contrario, siga esta convención.
RStudio debería detectar automáticamente la presencia de Git Bash. Puede inspeccionar e influir en esto directamente a través de Herramientas> Opciones globales> Terminal. Debe reiniciar todas las instancias de RStudio después de instalar Git para Windows (+ Git Bash), para que RStudio detecte automáticamente Git Bash.
Configurar Git
Usar la función edit_git_config() del paquete, que abrirá su archivo gitconfig. Agregue su nombre y correo electrónico y cierre esto.
Se abrirá .giconfig
Inicializar un repositorio de Git
Ahora que ha instalado y configurado Git, puede usarlo localmente. La función use_git() agregará un repositorio de Git (a menudo denominado “repositorio”) a un proyecto de RStudio existente. Aquí crearé un nuevo proyecto y luego inicializaré un repositorio de Git.
A través de File > New Project / marker Create a git repository
Ahora que se tiene un repositorio de Git asociado, veré una pestaña adicional en la parte superior derecha: la pestaña Git. Desde aquí, puedo ver el historial completo de cambios en mi código a lo largo del tiempo.
Pestaña de Git
Hacer un compromiso y ver más historial
Debes decirle a Git: Hice cambios y quiero que mantengas un registro de ellos. Decirle a Git esto se llama hacer una confirmación, cada uno tiene un mensaje de confirmación, que es útil porque, cuando miras tu historial de código, ves lo que hiciste en cada momento. RStudio tiene una herramienta incorporada para ver su historial de código. Puede hacer clic en cualquier confirmación para ver qué cambió, en relación con la confirmación anterior. Se agregaron líneas en verde, consiguiente se eliminarán las líneas en rojo.
Por ejemplo, crear archivos y hacer modificaciones dentro de ellos, mediante el commit message.
Historial
RStudio y GitHub
Crea un token de acceso personal (PAT) en GitHub usando la función create_github_token() de usethis. Esto le redireccionará al sitio web de GitHub, donde le dará un nombre a su token y lo copiará, ¡No lo pierda porque nunca volverá a aparecer!.
Insertar PAT:
debemos almacenarlo para que RStudio pueda acceder a él y conectarse a su cuenta de GitHub. Mediante la función gitcreds_set().
Hay otras funciones disponibles si necesita más control, como credentials::git_credential_forget() para borrar una credencial.
More: gitcreds https://github.com/r-lib/gitcreds
Conectar con repositorio
La idea básica es que configure los proyectos que cree en RStudio con repositorios GitHub asociados. Cada proyecto de RStudio vive en un solo repositorio de GitHub.
A veces, ya tiene un proyecto localmente y desea obtenerlo en GitHub. Para hacer esto, primero deberá usar la función use_git() de usethis, como hicimos anteriormente. Luego, puede usar la función use_github(), que creará un repositorio de GitHub y lo conectará a su proyecto RStudio actual.
use_github()
Activación
GitHub
Activación
Integrando
La forma más sencilla de usar RStudio y GitHub juntos es crear primero un repositorio en GitHub. Luego, cuando inicie un nuevo proyecto en RStudio, use la opción de control de versiones, ingrese la URL del repositorio y estará listo para comenzar.
Repositorio
Crear repositorio
HTTP GitHub
Copiar HTTP
New Project
Versión Control
Clone Git Repository
Clone
Flujo de trabajo general
Ahora que hemos conectado RStudio y GitHub, podemos empujar y tirar de nuestro trabajo entre los dos.
Diagrama de flujo
Empujar (Push)
Significa enviar cualquier cambio en su código desde RStudio a GitHub. Para hacer esto, primero tenemos que comprometernos. Después de confirmar, ahora tenemos un botón (la flecha hacia arriba) en RStudio que podemos usar para enviar nuestro código a GitHub.
El procedimiento sería check en stagged, insertar commit y presionar flecha verde PUSH.
Jalar (Pull)
Usando el botón de flecha hacia abajo en la pestaña Git, RStudio va al repositorio de GitHub, toma el código más reciente y lo trae a su editor local. ( Extraer con regularidad es extremadamente importante si está colaborando , aunque si es el único que trabaja en un proyecto de RStudio y un repositorio de GitHub asociado, sabe que su código local coincide con el de GitHub, por lo que es menos importante).
Editar mediante la opción (edit this file), seguidamente commit changes (visualizar los cambios en GitHub).
Conclusión
Usar Git y GitHub junto con RStudio tiene el poder de revolucionar la forma en que trabaja en R.
Comentarios, correcciones y sugerencias son bienvenidas (ronaldoag1007@gmail.com).