Gittyup

Gittyup

Gittyup est un client Git graphique conçu pour vous aider à comprendre et à gérer l'historique de votre code source. La dernière version stable est disponible soit en tant que Flatpak pré-construit pour Linux, 32/64 binaire pour Windows, MacOS ou peut être construit à partir de la source en suivant les instructions ci-dessous.

La dernière version de développement est également disponible prédéfinie.

Gittyup est une continuation du client Gitahead.

Table des matières

• Caractéristiques
• Comment obtenir de l'aide
• Construire un environnement
• Dépendances
• Comment construire
• Comment installer
  • Flatpak du terminal
• Comment contribuer
• Licence

Caractéristiques

Pour obtenir un aperçu des fonctionnalités actuelles, veuillez consulter la page GitHub

Comment obtenir de l'aide

Posez des questions sur la construction ou l'utilisation de Gittyup sur Stack Overflow en incluant la balise gittyup . N'oubliez pas de rechercher des questions existantes avant d'en créer une nouvelle.

Signaler des bogues dans Gittyup en ouvrant un problème dans le tracker du numéro. N'oubliez pas de rechercher des problèmes existants avant d'en créer un nouveau.

Si vous avez toujours besoin d'aide, consultez notre canal matriciel gittyup: matrix.org.

Construire un environnement

• Compilateur C ++ 11
  • Windows - msvc> = 2017 recommandé
  • Linux - gcc> = 6,2 recommandé
  • macOS - xcode> = 10.1 recommandé
• Cmake> = 3.3.1
• Ninja (facultatif)

Dépendances

Les dépendances externes peuvent être satisfaites par les bibliothèques système ou installées séparément. Les dépendances incluses sont des sous-modules de ce référentiel. Certains sous-modules sont facultatifs ou peuvent également être satisfaits par les bibliothèques système.

Dépendances externes

• Qt (requis> = 5.12)

Dépendances incluses

• libgit2 (requis)
• CMARK (requis)
• git (nécessaire uniquement pour les assistants))
• LiBSSH2 (nécessaire par libgit2 pour le soutien SSH)
• OpenSSL (nécessaire par libssh2 et libgit2 sur certaines plateformes)

Notez que le bâtiment OpenSSL sur Windows nécessite Perl et NASM .

Comment construire

Initialiser les sous-modules

 git submodule init
git submodule update --depth 1

Build 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 (silicium Apple)

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

Linux:

 ./config -fPIC
make

Configurer la construction

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

Si vous avez l'installation de QT dans un emplacement non standard, vous devrez peut-être spécifier le chemin d'accès à QT en passant -DCMAKE_PREFIX_PATH=<path-to-qt> où <path-to-qt> pointe vers le répertoire d'installation QT qui contient bin , lib , etc.

Construire

    ninja

Un script de shell pratique pour Ubuntu est disponible ici et installera toutes les conditions préalables nécessaires et créera une version de version pour une utilisation immédiate.

Comment installer

Linux

La façon la plus simple d'installer Gittyup est d'utiliser Flatpak.

Arch Linux

Installez le package gittyup à partir du référentiel d'utilisateurs Arch.

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

Ou utilisez une aide AUR. Installez gittyup-git pour la construction VCS.

Mac OS

Homebrew

Installez le gittyup Cask de Homebrew.

 brew install gittyup

Flatpak du terminal

Si vous voulez une utilisation de console plus pure, ce script exécute la version Flatpak renonçant le processus et rédigez la sortie en le poussant vers / dev / null. Enregistrez simplement le script quelque part dans votre chemin, par exemple /usr/bin (ou ~/.local/bin si vous l'avez exporté), donnez des autorisations d'exécution chmod +x et exécutez gittyup à partir de votre 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

Comment contribuer

Nous accueillons les contributions de toutes sortes, y compris les corrections de bogues, les nouvelles fonctionnalités, la documentation et les traductions. En contribuant, vous acceptez de divulguer vos contributions aux termes de la licence.

Contribuer en suivant le flux de travail GitHub typique pour les demandes de traction. Fourk le référentiel et apportez des modifications à une nouvelle branche nommée. Créez des demandes de traction contre la branche master . Suivez les sept directives pour rédiger un grand message de validation.

Avant de commettre un changement, veuillez utiliser cl-fmt.sh pour vous assurer que votre code adhère aux conventions de mise en forme de ce projet. Vous pouvez également utiliser le script setup-env.sh pour installer un crochet pré-engagé qui exécutera automatiquement clang-format par rapport à tous les fichiers modifiés.

Avant de pousser un changement, veuillez vous assurer d'exécuter les tests unitaires pour éviter toute régressions. Ceux-ci se trouvent dans <build-dir>/test et peuvent être exécutés à l'aide ctest .

Licence

Gittyup et son prédécesseur Gitahead sont autorisés sous la licence du MIT. Voir Licence.MD pour plus de détails.