git cola
v4.10.1
Git Cola est une puissante GIT GUI avec une interface utilisateur lisse et intuitive.
git clone https://github.com/git-cola/git-cola.git
Captures d'écran
Téléchargements
Raccourcis clavier
Documentation HTML
Documentation Git Cola
Documentation Git Dag
Lignes directrices contributives
GIT 2.2.0 ou plus récent.
Python 3.6 ou plus récent.
Qtpy 2.0.0 ou plus récent.
Git Cola utilise QTPY, vous pouvez donc choisir entre PYQT6, PYQT5 et PYSIDE2 en définissant la variable d'environnement QT_API sur pyqt6 , pyqt5 ou pyside2 comme souhaité. qtpy par défaut est pyqt5 et retombe à pyqt6 et pyside2 si pyqt5 n'est pas installé.
L'une des bibliothèques Python QT suivantes doit être installée:
PYQT5 / PYQT6 5.9 ou plus récent est requis. QT 6.2 ou plus nouveau est également pris en charge via QTPY.
Pyside2 5.12.0 ou plus récent.
Git Cola permet des fonctionnalités supplémentaires lorsque les modules Python suivants sont installés.
Send2Trash permet la fonctionnalité multiplateforme "Send to Trash". (source)
Notify2 permet la livraison des notifications de bureau. (source)
PYOBJC permet les thèmes d'application spécifiques à MacOS sur MacOS. (source)
Il existe plusieurs façons d'installer Git Cola, mais vous n'avez pas besoin de "installer" Git Cola afin de l'exécuter.
Git Cola est conçu pour courir directement à partir de son arbre source. L'installation est facultative.
L'approche recommandée pour exécuter la dernière version GIT COLA consiste à installer ses dépendances PYQT à l'aide du gestionnaire de packages de votre distribution, puis d'exécuter ./bin/git-cola directement à partir de la source.
Git Cola fonctionne avec PYQT5 ou PYQT6 car il utilise la bibliothèque QTPY pour la compatibilité PYQT.
Les utilisateurs de la nouvelle version Debian / Ubuntu peuvent installer un seul package pour s'exécuter à partir de la source.
sudo apt install python3-qtpy Si vous êtes sur une ancienne version qui n'a pas python3-qtpy disponible, vous pouvez installer directement les packages suivants.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgSi vous souhaitez utiliser Git Cola avec le nouveau écosystème PYQT6, vous pouvez installer ces packages au lieu de PYQT5.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine À ce stade, vous devriez pouvoir lancer ./bin/git-cola de l'arbre source et il n'y a plus rien à faire.
Les autres instructions ci-dessous détaillent comment installer Git Cola à partir de PYPI ou comment l'installer dans un emplacement distinct de l'arborescence source.
Linux est ça! Votre distribution a probablement déjà emballé git-cola . Sinon, veuillez déposer un bogue à votre distribution ;-)
Disponible dans l'AUR.
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
Disponible dans slackbuilds.org.
Voir ici pour les versions disponibles dans les référentiels d'Ubuntu.
# Install from official binary packages
pkg install -r FreeBSD devel/git-cola
# Build from source
cd /usr/ports/devel/git-cola && make clean install
IMPORTANT : Ne faites jamais pip install ou garden install en dehors d'un virtualenv python ou comme racine!
IMPORTANT : Si vous êtes sur des distributions Linux où PYQT6 ou PYQT5 sont disponibles auprès de votre gestionnaire de packages, il est fortement recommandé d'installer ces dépendances à l'aide du gestionnaire de packages de votre système. Voir la section ci-dessus pour plus de détails.
Une façon d'installer la dernière version publiée consiste à utiliser venv (VirtualEnv) et pip . Cela installe Git-Cola à partir de PYPI.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
Ajoutez le répertoire env3/bin à votre PATH ou à votre lien symbolique à bin/git-cola de quelque part dans votre PATH , comme ~/.local/bin/git-cola , et vous pouvez lancer Git cola comme toute autre commande git intégrée:
git cola
git dag
Si vous n'avez pas installé PYQT, le moyen le plus simple de l'obtenir est d'utiliser un Python VirtualEnv et d'installer Git Cola en mode "modifiable".
Cette méthode d'installation vous permet de mettre à niveau Git Cola en exécutant git pull .
# Create a virtualenv called "env3" and activate it.
python3 -m venv --system-site-packages env3
# Install PyQt and (optional) extra packages to enable all features.
./env3/bin/pip install --editable '.[extras,pyqt6]'
# Run Git Cola via the "git-cola" Git subcommand.
source env3/bin/activate
git cola
Si vous ajoutez env3/bin (ou SymLink à env3/bin/git-cola ) quelque part dans votre $PATH , vous pouvez exécuter git cola comme s'il s'agissait d'une commande git intégrée de l'extérieur du VirtualEnv (par exemple après avoir exécuté "désactiver" ou lors de l'ouverture d'un nouveau shell).
Running garden -D prefix=$HOME/.local install installera Git Cola dans votre répertoire $HOME/.local ( $HOME/.local/bin/git-cola , $HOME/.local/lib , etc.).
Cette méthode d'installation suppose que les dépendances qtpy et PyQt* ont été préinstallées.
La recette de jardin prend également en charge DESTDIR pour prendre en charge la création de packages pour les gestionnaires de packages Linux:
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
Si vous n'avez pas garden disponible, make à la place peut être utilisé à la place. Le Makefile prend en charge les installations mise en scène en utilisant les variables destdir et préfixes conventionnelles.
make DESTDIR=/tmp/stage prefix=/usr/local install
Pour la plupart des utilisateurs finaux, nous vous recommandons d'utiliser Homebrew ou d'installer dans un Python VirtualEnv comme décrit ci-dessus.
Vous pouvez installer Git Cola depuis Source en utilisant les mêmes étapes que ci-dessus.
Un moyen facile d'installer Git Cola est d'utiliser Homebrew. Utilisez Homebrew pour installer la recette de Git-Cola:
brew install git-cola
Si vous installez à l'aide de Homebrew, vous pouvez vous arrêter à cette étape. Vous n'avez pas besoin de cloner le repo ou quoi que ce soit.
Si toutes les dépendances sont installées, via pip ou brew , vous pouvez créer un emballage Shell git-cola.app App Bundle pour une utilisation dans /Applications .
Si vous souhaitez créer un bundle git-cola.app pour /Applications Exécutez cette commande:
garden macos/app
Vous devrez reconstruire périodiquement l'emballage de l'application chaque fois que Python est mis à niveau.
La mise à jour des macOS peut souvent casser les logiciels gérés par les homebrew.
Si vous mettez à jour MacOS et GIT COLA cesse de fonctionner, vous devez probablement réinstaller les dépendances de Git Cola.
La réinstallation à partir de zéro en utilisant les instructions ci-dessous peut remettre les choses en forme.
brew update
brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove
brew install git-cola
Important Si vous avez une machine 64 bits, installez les versions 64 bits uniquement. Ne mélangez pas les versions 32 bits et 64 bits.
Téléchargez et installez ce qui suit:
Git pour Windows
Git cola
Une fois ceux-ci installés, vous pouvez exécuter Git Cola à partir du menu Démarrer.
Voir "Windows (suite)" ci-dessous pour plus de détails.
Si vous souhaitez installer Git Cola avec Winget, exécutez la commande suivante:
winget install git-cola.git-cola
Comme il n'y a pas encore de résolution de dépendance, vous devez également installer Git avec:
winget install Git.Git
Git Cola est expédié avec un éditeur de rebase interactif appelé git-cola-sequence-editor . git-cola-sequence-editor est utilisé pour réorganiser et choisir des engagements lors de la rebasse. Démarrez une rebase interactive via le menu "Rebase", ou via le sous-commande git cola rebase pour utiliser le git-cola-sequence-editor :
git cola rebase @{upstream}
git-cola-sequence-editor peut être lancé indépendamment de Git Cola en disant git rebase de l'utiliser comme éditeur via la variable d'environnement GIT_SEQUENCE_EDITOR :
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Des scripts d'achèvement de la coquille sont disponibles pour Bash et Zsh. Chaque script contient des instructions sur la façon d'installer et d'activer les compléments.
script d'achèvement de bash
script d'achèvement Zsh
La commande git-cola expose divers sous-communs qui vous permettent de lancer rapidement des outils disponibles à partir de l'interface Git-Cola. Par exemple, git cola find lance le File Finder et git cola grep lance l'outil GREP.
Voir git cola --help-commands pour la liste complète des commandes.
$ git cola --help-commands
usage: git-cola [-h]
{cola,am,archive,branch,browse,config,
dag,diff,fetch,find,grep,merge,pull,push,
rebase,remote,search,stash,tag,version}
...
valid commands:
{cola,am,archive,branch,browse,config,
dag,diff,fetch,find,grep,merge,pull,push,
rebase,remote,search,stash,tag,version}
cola start git-cola
am apply patches using "git am"
archive save an archive
branch create a branch
browse browse repository
config edit configuration
dag start git-dag
diff view diffs
fetch fetch remotes
find find files
grep grep source
merge merge branches
pull pull remote branches
push push remote branches
rebase interactive rebase
remote edit remotes
search search commits
stash stash and unstash changes
tag create tags
version print the version
Si vous avez déjà installé les dépendances de Git Cola, vous pouvez démarrer cola en tant que module Python si vous avez le code source disponible.
python -m cola
python -m cola dag
Les commandes suivantes doivent être exécutées pendant le développement:
# Run the unit tests
$ garden test
# Run tests and doc checks
$ garden check
# Run tests against multiple python interpreters using tox
$ garden tox
La suite de test peut être trouvée dans le répertoire de test.
Les demandes de validation et de traction sont automatiquement testées pour la qualité du code à l'aide des actions GitHub.
Fichiers Auto-format cola/i18n/*.po avant de s'engager lors de la mise à jour des traductions:
$ garden po
Lors de la soumission des correctifs, consultez les directives contributives.
GIT COLA installe ses modules dans le répertoire Python de site Python par défaut (par exemple lib/python3.7/site-packages ) à l'aide de SETUTPOTOHS.
Alors que les utilisateurs finaux peuvent utiliser pip install git-cola pour installer Git COLA, les emballages de distribution doivent utiliser le processus garden -D prefix=/usr install . La recette de jardin de Git Cola enveloppe pip install --prefix=<prefix> pour fournir une cible garden install adaptée aux emballages.
Les versions antérieures de Git Cola peuvent avoir expédié sans vcruntime140.dll et ne peuvent pas fonctionner sur des machines qui manquent cette DLL.
Pour résoudre ce problème, téléchargez le Microsoft Visual C ++ 2015 redistribuable et installez-le
Git Cola V4.0.0 et plus récents incluent cette DLL et ne nécessitent pas que cela soit installé séparément.
Afin de développer Git Cola sur Windows, vous devrez installer Python3 et PIP. Installez PYQT5 à l'aide pip install PyQt5 pour rendre les liaisons PYQT5 disponibles pour Python.
Une fois ceux-ci installés, vous pouvez utiliser python.exe pour fonctionner directement à partir de l'arborescence source. Par exemple, à partir d'un terminal Git bash:
/c/Python39/python.exe ./bin/git-cola
Si vous avez plusieurs versions de Python installées, le script contrib/win32/cola Launcher peut choisir la version la plus récente au lieu du Python qui a installé PYQT. Afin de résoudre ce problème, vous pouvez définir la variable de configuration cola.pythonlocation Git pour dire à COLA où trouver Python. Par exemple:
git config --global cola.pythonlocation /c/Python39
Les installateurs de Windows sont construits en utilisant
Pynsiste.
NSIS est également nécessaire.
Pour construire le programme d'installation à l'aide de pynsiste Run:
./contrib/win32/run-pynsist.sh
Cela générera un installateur dans build/nsis/ .
Vous devrez peut-être configurer votre navigateur d'historique si vous passez à partir d'une ancienne version de Git Cola sur Windows.
gitk était à l'origine le navigateur d'historique par défaut, mais gitk ne peut pas être lancé tel quel sur Windows car gitk est un script shell.
Si vous êtes configuré pour utiliser gitk , modifiez votre configuration pour passer par Git's sh.exe sous Windows. De même, nous devons passer par python.exe si nous voulons utiliser git-dag .
Si vous souhaitez utiliser Gitk car votre navigateur d'historique ouvre l'écran Préférences et modifiez la commande du navigateur d'historique en:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
git-dag est devenu le navigateur d'historique par défaut sur Windows dans v2.3 , donc les nouveaux utilisateurs n'ont pas besoin de configurer quoi que ce soit.
