Gittyup

Gittyup

Gittyup es un cliente gráfico Git diseñado para ayudarlo a comprender y administrar el historial de su código fuente. El último lanzamiento estable está disponible como plano pre-construido para Linux, 32/64 binario para Windows, macOS o se puede construir desde la fuente siguiendo las instrucciones a continuación.

La última versión de desarrollo también está disponible previamente construida.

Gittyup es una continuación del cliente de GitaHead.

Tabla de contenido

• Características
• Cómo obtener ayuda
• Construir entorno
• Dependencias
• Cómo construir
• Cómo instalar
  • Flatpak de la terminal
• Cómo contribuir
• Licencia

Características

Para obtener una descripción general de las características actuales, eche un vistazo a la página de GitHub

Cómo obtener ayuda

Haga preguntas sobre la construcción o el uso de Gittyup en Stack Overflow incluyendo la etiqueta gittyup . Recuerde buscar preguntas existentes antes de crear una nueva.

Informe errores en Gittyup abriendo un problema en el rastreador de problemas. Recuerde buscar problemas existentes antes de crear uno nuevo.

Si aún necesita ayuda, consulte nuestro canal Matrix Gittyup: matrix.org.

Construir entorno

• Compilador C ++ 11
  • Windows - MSVC> = 2017 Recomendado
  • Linux - GCC> = 6.2 Recomendado
  • macOS - xcode> = 10.1 Recomendado
• Cmake> = 3.3.1
• Ninja (opcional)

Dependencias

Las dependencias externas pueden ser satisfechas por bibliotecas del sistema o instaladas por separado. Las dependencias incluidas son submódulos de este repositorio. Algunos submódulos son opcionales o también pueden estar satisfechos con las bibliotecas del sistema.

Dependencias externas

• Qt (requerido> = 5.12)

Dependencias incluidas

• libgit2 (requerido)
• CMark (requerido)
• Git (solo necesario para los ayudantes de credenciales)
• libssh2 (necesaria por libgit2 para soporte ssh)
• OpenSSL (necesario por libssh2 y libgit2 en algunas plataformas)

Tenga en cuenta que el edificio OpenSSL en las ventanas requiere Perl y NASM .

Cómo construir

Inicializar submódulos

 git submodule init
git submodule update --depth 1

Construir openssl

 # Start from root of gittyup repo.
cd dep/openssl/openssl

Windows:

 perl Configure VC-WIN64A
nmake

macOS (Intel):

 ./Configure darwin64-x86_64-cc no-shared
make

MacOS (Apple Silicon)

 ./Configure darwin64-arm64-cc no-shared
make

Linux:

 ./config -fPIC
make

Configurar compilación

 # Start from root of gittyup repo.
mkdir -p build/release
cd build/release
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ../..

Si tiene un QT instalado en una ubicación no estándar, es posible que deba especificar la ruta al QT pasando -DCMAKE_PREFIX_PATH=<path-to-qt> Where < <path-to-qt> señala el directorio de instalación QT que contiene bin , lib , etc.

Construir

    ninja

Aquí está disponible un script de shell conveniente para Ubuntu, e instalará todos los requisitos previos necesarios y construirá una versión de lanzamiento para su uso inmediato.

Cómo instalar

Linux

La forma más fácil de instalar Gittyup es mediante el uso de Flatpak.

Arch Linux

Instale el paquete gittyup desde el repositorio de usuarios de Arch.

 git clone https://aur.archlinux.org/gittyup.git
cd gittyup
makepkg -si

O use un ayudante Aur. Instale gittyup-git para la compilación de VCS.

Mac OS

Cerveza casera

Instale el barril gittyup desde Homebrew.

 brew install gittyup

Flatpak de la terminal

Si desea un uso de consola más puro, este script ejecuta la versión Flatpak que defiendo el proceso y silencie la salida que lo empuja a /dev /null. Simplemente guarde el script en algún lugar de su ruta, por ejemplo /usr/bin (o ~/.local/bin si lo ha exportado), dan permisos de ejecución chmod +x y ejecute gittyup desde su terminal.

 #! /bin/bash
DIR= $( dirname " ${BASH_SOURCE[0]} " )
function run_disown() {
    " $@ " & disown
}
function run_disown_silence(){
    run_disown " $@ " 1> /dev/null 2> /dev/null
}
run_disown_silence flatpak run com.github.Murmele.Gittyup

Cómo contribuir

Agradecemos contribuciones de todo tipo, incluidas correcciones de errores, nuevas características, documentación y traducciones. Al contribuir, usted acepta publicar sus contribuciones bajo los términos de la licencia.

Contribuya siguiendo el típico flujo de trabajo de GitHub para solicitudes de extracción. Bifurca el repositorio y realice cambios en una nueva rama nombrada. Cree solicitudes de extracción contra la rama master . Siga las siete directrices para escribir un gran mensaje de confirmación.

Antes de cometer un cambio, use cl-fmt.sh para asegurarse de que su código se adhiera a las convenciones de formato para este proyecto. También puede usar el script setup-env.sh para instalar un gancho anterior a Commit que ejecutará automáticamente clang-format en todos los archivos modificados.

Antes de impulsar un cambio, asegúrese de ejecutar las pruebas unitarias para evitar cualquier regresión. Estos se encuentran en <build-dir>/test y se pueden ejecutar usando ctest .

Licencia

Gittyup y su predecesor GitaHead tienen licencia bajo la licencia MIT. Vea la licencia.md para más detalles.