git cola
v4.10.1
Git Cola ist eine leistungsstarke GIT -GIT -GUI mit einer glatten und intuitiven Benutzeroberfläche.
git clone https://github.com/git-cola/git-cola.git
Screenshots
Downloads
Tastaturverknüpfungen
HTML -Dokumentation
Git Cola -Dokumentation
Git DAG -Dokumentation
Richtlinien beitragen
Git 2.2.0 oder neuer.
Python 3.6 oder neuer.
Qtpy 2.0.0 oder neuer.
Git Cola verwendet Qtpy, sodass Sie zwischen PYQT6, PYQT5 und PYSIDE2 wählen können, indem Sie die QT_API -Umgebungsvariable in pyqt6 , pyqt5 oder pyside2 wie gewünscht einstellen. qtpy standardmäßig pyqt5 und fällt auf pyqt6 und pyside2 zurück, wenn pyqt5 nicht installiert ist.
Eine der folgenden Python -QT -Bibliotheken muss installiert werden:
PYQT5 / PYQT6 5.9 oder neuer ist erforderlich. QT 6.2 oder neuer wird auch über QTPY unterstützt.
Pyside2 5.12.0 oder neuer.
Git Cola ermöglicht zusätzliche Funktionen, wenn die folgenden Python -Module installiert sind.
SEND2TRASH aktiviert eine plattformübergreifende "Send an Müll" -Funktionalität. (Quelle)
Notify2 ermöglicht die Lieferung von Desktop -Benachrichtigungen. (Quelle)
PyobJC ermöglicht macOS-spezifische Anwendungsthemen auf macOS. (Quelle)
Es gibt verschiedene Möglichkeiten, Git Cola zu installieren, aber Sie müssen Git Cola nicht "installieren", um es auszuführen.
Git Cola ist so konzipiert, dass sie direkt aus seinem Quellbaum läuft. Die Installation ist optional.
Der empfohlene Ansatz zum Ausführen der neuesten Git Cola-Version besteht darin, die PYQT-Abhängigkeiten mithilfe des Paketmanagers Ihrer Verteilung zu installieren und dann direkt von der Quelle ./bin/git-cola .
Git Cola arbeitet entweder mit PYQT5 oder PYQT6 zusammen, da die QTPy -Bibliothek für die PYQT -Kompatibilität verwendet wird.
Benutzer einer neueren Debian/Ubuntu -Version können ein einzelnes Paket installieren, das von Quelle ausgeführt wird.
sudo apt install python3-qtpy Wenn Sie sich in einer älteren Version befinden, in der keine python3-qtpy verfügbar ist, können Sie die folgenden Pakete direkt installieren.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgWenn Sie Git Cola mit dem neueren PYQT6 -Ökosystem verwenden möchten, können Sie diese Pakete anstelle von PYQT5 installieren.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine Zu diesem Zeitpunkt sollten Sie in der Lage sein zu starten ./bin/git-cola vom Quellbaum aus und es gibt nichts mehr zu tun.
In den weiteren Anweisungen unten detailliert, wie Git Cola von PYPI installiert werden oder wie sie an einem vom Quellbaum getrennten Ort installiert werden.
Linux ist es! Ihre Distribution hat git-cola wahrscheinlich bereits verpackt. Wenn nicht, stellen Sie bitte einen Fehler gegen Ihre Verteilung ein ;-)
Erhältlich in der AUR.
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
Erhältlich in Slackbuilds.org.
Hier finden Sie die Versionen, die in Ubuntus Repositories erhältlich sind.
# Install from official binary packages
pkg install -r FreeBSD devel/git-cola
# Build from source
cd /usr/ports/devel/git-cola && make clean install
WICHTIG : Führen Sie niemals pip install oder garden install außerhalb eines Python -Virtuellenvs oder als Wurzel aus!
Wichtig : Wenn Sie sich unter Linux -Verteilungen befinden, bei denen PYQT6 oder PYQT5 bei Ihrem Paketmanager verfügbar sind, wird dringend empfohlen, diese Abhängigkeiten mit dem Paketmanager Ihres Systems zu installieren. Weitere Informationen finden Sie im Abschnitt oben.
Eine Möglichkeit, die neueste veröffentlichte Version zu installieren, besteht darin, venv (Virtualenv) und pip zu verwenden. Dies installiert Git-Cola von pypi.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
Fügen Sie das Verzeichnis env3/bin zu Ihrem PATH oder Symlink zu bin/git-cola von irgendwo in Ihrem PATH , wie ~/.local/bin/git-cola , und Sie können Git Cola wie jeder andere integrierte git Befehl starten:
git cola
git dag
Wenn Sie PYQT nicht installiert haben, ist der einfachste Weg, um es zu erhalten, eine Python -Virtualenv -Verwendung und die Installation von Git Cola im "bearbeitbaren" Modus.
Mit dieser Installationsmethode können Sie Git Cola durch Ausführen von git pull aufrüsten.
# 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
Wenn Sie env3/bin (oder Symlink zu env3/bin/git-cola ) irgendwo in Ihrem $PATH hinzufügen, können Sie git cola so ausführen, als wäre es ein gebauter git -Befehl von außerhalb des Virtualenv (z. B. nach dem Ausführen von "Deaktivieren" oder beim Öffnen einer neuen Shell).
Running garden -D prefix=$HOME/.local install wird Git Cola in Ihrem $HOME/.local -Verzeichnis ( $HOME/.local/bin/git-cola , $HOME/.local/lib usw.) installieren.
Diese Installationsmethode geht davon aus, dass die Abhängigkeiten von qtpy und PyQt* vorinstalliert wurden.
Das Gartenrezept unterstützt auch DESTDIR , um das Erstellen von Paketen für Linux -Paketmanager zu unterstützen:
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
Wenn Sie keinen garden zur Verfügung haben, können make stattdessen verwendet werden. Die Makefile unterstützt inszenierte Installationen mit den herkömmlichen Destdir- und Präfixvariablen.
make DESTDIR=/tmp/stage prefix=/usr/local install
Für die meisten Endbenutzer empfehlen wir, wie oben beschrieben entweder Homebrew oder eine Installation in ein Python Virtualenv zu verwenden.
Sie können Git Cola aus der Quelle mit den gleichen Schritten wie oben installieren.
Eine einfache Möglichkeit, Git Cola zu installieren, besteht darin, Homebrew zu verwenden. Verwenden Sie Homebrew, um das Git-Cola-Rezept zu installieren:
brew install git-cola
Wenn Sie mit Homebrew installieren, können Sie bei diesem Schritt anhalten. Sie müssen das Repo oder so nicht klonen.
Wenn Sie alle Abhängigkeiten installiert haben, entweder über pip oder brew , können Sie eine Shell git-cola.app -App-Bündel-Wrapper für die Verwendung in /Applications erstellen.
Wenn Sie ein git-cola.app -Bundle für /Applications erstellen möchten, führen Sie diesen Befehl aus:
garden macos/app
Sie müssen die App -Wrapper regelmäßig umbauen, wenn Python aktualisiert wird.
Das Aktualisieren von macOS kann häufig die von der Home brew verwaltete Software brechen.
Wenn Sie MacOS und Git Cola nicht mehr funktionieren, müssen Sie die Abhängigkeiten von Git Cola wahrscheinlich neu installieren.
Neuinstallation von Grund auf mit den folgenden Anweisungen kann die Dinge wieder in Form bringen.
brew update
brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove
brew install git-cola
Wichtig, wenn Sie eine 64-Bit-Maschine haben, installieren Sie nur die 64-Bit-Versionen. Mischen Sie keine 32-Bit- und 64-Bit-Versionen.
Laden Sie Folgendes herunter und installieren Sie Folgendes:
Git für Windows
Git Cola
Sobald diese installiert sind, können Sie Git Cola aus dem Startmenü ausführen.
Weitere Informationen finden Sie in "Windows (Fortsetzung)".
Wenn Sie Git Cola mit Winget installieren möchten, führen Sie den folgenden Befehl aus:
winget install git-cola.git-cola
Da es noch keine Abhängigkeitsauflösung gibt, müssen Sie auch Git installieren mit:
winget install Git.Git
Git Cola wird mit einem interaktiven Rebase-Editor namens git-cola-sequence-editor ausgeliefert. git-cola-sequence-editor wird verwendet, um beim Wiedergebäude nachzuordnen und zu wählen. Starten Sie eine interaktive Rebase durch das "Rebase" -Menü oder über den Unterkommando git cola rebase , um den git-cola-sequence-editor zu verwenden:
git cola rebase @{upstream}
git-cola-sequence-editor kann unabhängig von Git Cola auf den Markt gebracht werden, indem git rebase mitgeteilt wird, dass er sie als Editor über die Umgebungsvariable GIT_SEQUENCE_EDITOR verwenden soll:
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Shell Completion -Skripte sind für Bash und ZSH verfügbar. Jedes Skript enthält Anweisungen zum Installieren und Aktivieren der Abschlüsse.
Bash Completion Skript
ZSH Completion Skript
Der Befehl git-cola enthält verschiedene Unterkommandis, mit denen Sie Tools, die innerhalb der Git-Cola-Schnittstelle von Git-Cola-Schnittstelle verfügbar sind, schnell starten können. Zum Beispiel startet git cola find den Dateifinder und git cola grep startet das Grep -Tool.
Die vollständige Liste der Befehle finden Sie in git cola --help-commands .
$ 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
Wenn Sie bereits die Abhängigkeiten von Git Cola installiert haben, können Sie cola als Python -Modul starten, wenn Sie den Quellcode verfügbar haben.
python -m cola
python -m cola dag
Die folgenden Befehle sollten während der Entwicklung ausgeführt werden:
# Run the unit tests
$ garden test
# Run tests and doc checks
$ garden check
# Run tests against multiple python interpreters using tox
$ garden tox
Die Testsuite befindet sich im Testverzeichnis.
Commits und Pull -Anfragen werden automatisch auf Codequalität unter Verwendung von GitHub -Aktionen getestet.
Auto-Format cola/i18n/*.po Dateien, bevor Sie bei der Aktualisierung von Übersetzungen festlegen:
$ garden po
Bei der Einreichung von Patches konsultieren Sie die beitragenden Richtlinien.
Git Cola installiert seine Module mit Setuptools in das Standard-Verzeichnis für Python-Site-Packages (z. lib/python3.7/site-packages ).
Während Endbenutzer pip install git-cola verwenden können, um Git Cola zu installieren, sollten Distributionspakete den garden -D prefix=/usr install verwenden. Git Colas Gartenrezept Wraps pip install --prefix=<prefix> , um ein paketfreundliches garden install Ziel zu bieten.
Frühere Versionen von Git Cola haben möglicherweise ohne vcruntime140.dll versendet und können nicht auf Maschinen ausgeführt werden, die diese DLL fehlen.
Um dies zu beheben, laden Sie das microsoft visuelle C ++ 2015 herunter und installieren Sie es
Git Cola v4.0.0 und neuer enthalten diese DLL und verlangen nicht, dass dies separat installiert werden muss.
Um Git Cola unter Windows zu entwickeln, müssen Sie Python3 und PIP installieren. Installieren Sie PYQT5 mit pip install PyQt5 um die PYQT5 -Bindungen für Python zur Verfügung zu stellen.
Sobald diese installiert sind, können Sie python.exe verwenden, um direkt vom Quellbaum aus zu laufen. Zum Beispiel aus einem Git -Bash -Terminal:
/c/Python39/python.exe ./bin/git-cola
Wenn Sie mehrere Versionen von Python installiert haben, kann das Drehbuch contrib/win32/cola die neuere Version anstelle des Python, das PYQT installiert hat, die neuere Version auswählt. Um dies zu beheben, können Sie die cola.pythonlocation Git -Konfigurationsvariable festlegen, um Cola zu sagen, wo Python zu finden ist. Zum Beispiel:
git config --global cola.pythonlocation /c/Python39
Windows -Installateure werden mit Verwendung erstellt
Pynsist.
NSIS wird ebenfalls benötigt.
So bauen Sie den Installateur mit Pynsist Run:
./contrib/win32/run-pynsist.sh
Dadurch wird ein Installateur in build/nsis/ generiert.
Möglicherweise müssen Sie Ihren Verlaufsbrowser konfigurieren, wenn Sie von einer älteren Version von Git Cola unter Windows aktualisieren.
gitk war ursprünglich der Standard-History-Browser, aber gitk kann nicht wie bei Windows gestartet werden, da gitk ein Shell-Skript ist.
Wenn Sie für die Verwendung gitk konfiguriert sind, ändern Sie Ihre Konfiguration, um sh.exe von Git unter Windows zu durchlaufen. In ähnlicher Weise müssen wir python.exe durchgehen, wenn wir git-dag verwenden wollen.
Wenn Sie Gitk als History -Browser verwenden möchten, öffnen Sie den Bildschirm "Einstellungen" und ändern Sie den Befehl historischer Browser in:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
git-dag wurde zum Standard-Historie-Browser unter Windows in v2.3 , sodass neue Benutzer nichts konfigurieren müssen.
