GitGud

Gitgud

Introducción

Gitgud es un repositorio de código abierto diseñado para proporcionar a los principiantes y desarrolladores experimentados una plataforma para aprender y mejorar sus habilidades GIT. El repositorio está construido con el objetivo de proporcionar una experiencia de aprendizaje interactiva para los desarrolladores de todos los niveles de habilidad. Ya sea que esté comenzando con Git o buscando mejorar sus habilidades existentes, Gitgud proporciona un amplio conjunto de recursos y herramientas que pueden ayudarlo a dominar GIT. Gitgud le permite visualizar y utilizar fácilmente GIT a lo largo de sus proyectos. Se crea usando tinta que proporciona la misma experiencia de construcción de interfaces de interfaz de usuario que React ofrece, pero en una interfaz de línea de comandos (CLI).

Requisitos

• Tener al menos Git versión 2.24.3 instalado
• Tener NPM instalado
• No recomendamos usar ITERM2 para GITgud debido a problemas de representación. Hyper o el terminal predeterminado son buenas alternativas.

---

Instalación

 $ npm install --global gitgud

---

Esto instalará el paquete a nivel mundial

Uso

 $ GitGud

• Navegue a cualquier proyecto que tenga un directorio GIT y ejecute el comando 'gitgud'. Esto cargará la interfaz de usuario de Gitgud en la ventana de su terminal

• La interfaz de usuario de Gitgud consta de: cambios sin estadegos, cambios escenificados, vista de árbol de rama GIT y botones de funcionalidad

• Navegue a través de la interfaz de usuario con el botón 'Tab' o las teclas de flecha izquierda/derecha

• Presione el botón 'ENTER/RETURN' para seleccionar/hacer clic en una opción

• A lo largo de la aplicación, puede presionar el botón 'ESC' (Escape) para regresar

• Puede salir de la aplicación ejecutando Ctrl + C

---

Funcionalidad

• Cambios en la etapa

  • Puede seleccionar STAGE/UNSTAGE (all files) para mover todos los archivos entre los cambios en la etapa y los cambios inesperados.
  • Si hace clic en él una vez que moverá todos los archivos de la sección 'Cambios no escenificados' de la interfaz de usuario a 'cambios en la etapa'. Si hace clic nuevamente, deshacerá los 'cambios escenizados' y moverá los archivos a 'cambios sin estadegos', etc.
  • También tiene la opción de organizar/desico de archivos individuales navegando a través de ellos con las teclas Up/Down.
  • Presione 'ESC' para salir del menú de cambios fuera del escenario.

• Confirmar cambios

  • Le pedirá que ingrese un 'mensaje de confirmación' que no requiere que envuelva la entrada en comillas. Después de ingresar y enviar el mensaje de confirmación, ejecuta la confirmación y lo trae de regreso al menú principal.
  • Presione 'ESC' para salir de los cambios de confirmación.

• Empuje los cambios escenificados

  • Esto impulsará los cambios escenificados a la rama actual en la que se encuentra.
  • Puedes ver en qué rama se encuentra en la parte superior de la GUI.

• Rama de pago

  • Mostrará la lista de todas las ramas en el proyecto. Las ramas no son seleccionables, están allí para ayudarlo a ver a qué sucursales locales están disponibles para cambiar.
  • Se le solicita que ingrese una sucursal para pagar. Si ingresa a una rama que no existe, creará una nueva.
  • Si tiene cambios no destacados, se mostrará un error y abortará la operación de pago, diciéndole que tiene cambios no estados y que comprometa o guarda los cambios antes de cambiar las ramas. Puede presionar 'ESC' para regresar y esconder/cometer los cambios antes de intentar pagar nuevamente

• Eliminar la rama

  • Mostrará una lista de ramas que no son seleccionables, están allí para ayudarlo a ver qué ramas locales están disponibles.
  • Se le solicita que ingrese un nombre de rama, y ​​si la rama existe, la eliminará/eliminará y lo traerá de regreso al menú principal. Si la rama no existe, entonces arrojará un error.
  • Presione 'ESC' para salir de Delete Branch

• Acceda a un árbol de registro completo

  • Hará todo el árbol de troncos que superpone la Gui Gitgud.
  • Presione 'ESC' para salir del árbol de troncos

---

Estilo

Gitgud permite a los usuarios personalizar tanto el aspecto como la sensación de la aplicación editando el 'stylefile'.

Para acceder al 'archivo de estilo' de un GITgud instalado a nivel mundial, primero deberá averiguar dónde está guardando NPM sus archivos instalados a nivel mundial. Para hacerlo, ejecute el siguiente comando:

 npm root -g

Esto devolverá la ubicación de sus paquetes NPM instalados a nivel mundial.

En Mac debería ver algo como esto: /usr/local/lib/node_modules

En Windows, puede obtener esto: *c: users you appData roaming npm node_modules

Navegue a donde se almacenan sus paquetes globales, abra la carpeta Gitgud y luego abra el archivo de estilo en un editor (el comando: nano styleFile.js lo abrirá en la mayoría de los sistemas Mac/Linux).

Cuando abra el archivo, se verá así:

• showLogo :

  • Por defecto, esto se establece en false , pero si desea tener el logotipo de Gitgud sobre su GUI, puede cambiar esto a true .

• defaultColor :

  • Este es el color para los bloques de texto principales en toda la aplicación.

• accentColor :

  • Este es el color para los bordes de la aplicación, así como algunos encabezados de texto en toda la aplicación.

• gitTreeColor :

  • Este es el color para la fuente Git Tree en toda la aplicación.

• appResize :

  • Esto permite que la aplicación responda, lo que permite a los usuarios cambiar el tamaño de las ventanas de su consola sin tener que reiniciar la aplicación. Esto puede disminuir el rendimiento para algunos usuarios.

• showFlag :

  • Permite al usuario elegir si los archivos escenificados/sin verificar para mostrar o no.
  • Establecer en false por defecto.
  • Vea aquí para obtener más información sobre las etiquetas de salida de Git

---

Preguntas frecuentes

---

Que contribuye

¡Gitgud es un proyecto de código abierto y las contribuciones son bienvenidas!

Al enviar una solicitud de extracción, explique claramente la función que agregó o el error que solucionó.

¡Los contribuyentes por primera vez también son bienvenidos! Hay algunos problemas marcados con la good first issue . ¡Este podría ser un buen lugar para que los principiantes comiencen!

Gracias a Joseph Garrone por darnos el nombre del paquete NPM.