git cola

git-cola：高度含咖啡因的吉特·吉（Gui）

Git Cola是具有光滑且直觀的用戶界面的功能強大的GIT GUI。

 git clone https://github.com/git-cola/git-cola.git

• 屏幕截圖

• 下載

文件

• 鍵盤快捷鍵

• HTML文檔

• Git Cola文檔

• GIT DAG文檔

• 貢獻準則

要求

建造

• Sphinx用於生成文檔。

運行時

• git 2.2.0或更新。

• Python 3.6或更新。

• QTPY 2.0.0或更新。

Git Cola使用QTPY，因此您可以根據需要將QT_API環境變量設置為PYQT6，PYQT5或PYSIDE2，從而在pyqt6 ， pyqt5和pyside2之間進行選擇。如果未安裝pyqt5 ，則將qtpy默認為pyqt5 ，然後落回pyqt6和pyside2 。

必須安裝以下任何Python QT庫：

• PYQT5 / PYQT6 5.9或需要更新。還通過QTPY支持QT 6.2或更新。

• Pyside2 5.12.0或更新。

可選功能

當安裝以下Python模塊時，Git Cola可以啟用其他功能。

send2trash啟用跨平台“發送到垃圾”功能。 （來源）

notify2啟用桌面通知。 （來源）

PYOBJC在MacOS上啟用MacOS特定應用主題。 （來源）

安裝

有幾種安裝git可樂的方法，但是您不需要“安裝” git Cola即可運行它。

Git Cola旨在直接從其源樹運行。安裝是可選的。

來自來源

運行最新git Cola版本的推薦方法是使用Distraction的軟件包管理器安裝其PYQT依賴關係，然後直接從源運行./bin/git-cola 。

在Debian / Ubuntu Systems上安裝PYQT依賴

Git Cola可與PYQT5或PYQT6一起使用，因為它使用QTPY庫進行PYQT兼容性。

pyqt5

較新的Debian/Ubuntu版本上的用戶可以安裝一個從源運行的單個軟件包。

sudo apt install python3-qtpy

如果您使用的是沒有python3-qtpy的舊版本，則可以直接安裝以下軟件包。

sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvg

pyqt6

如果您想將Git Cola與較新的PYQT6生態系統一起使用，則可以安裝這些軟件包而不是PYQT5。

sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine

在這一點上，您應該能夠從源樹啟動./bin/git-cola ，而無事可做。

下面的其他說明詳細介紹瞭如何從PYPI安裝Git Cola或如何將其安裝到與源樹分開的位置。

Linux

Linux是它！您的發行版可能已經包裝了git-cola 。如果沒有，請針對您的分發提交錯誤;-)

拱

在AUR中可用。

Debian，Ubuntu

 apt install git-cola

軟呢帽

 dnf install git-cola

Gentoo

 emerge git-cola

opensuse，sle

 zypper install git-cola

Slackware

可在SlackBuilds.org中找到。

Ubuntu

有關Ubuntu的存儲庫中可用的版本，請參見此處。

freebsd

 # Install from official binary packages
pkg install -r FreeBSD devel/git-cola

# Build from source
cd /usr/ports/devel/git-cola && make clean install

使用PIP安裝PYPI的Python Virtualenv

重要的是：切勿在Python Virtualenv或Root上安裝pip install或garden install ！

重要的是：如果您正在使用PYQT6或PYQT5的Linux發行版，則強烈建議使用系統的軟件包管理器安裝這些依賴項。有關詳細信息，請參見上面的部分。

安裝最新發布版本的一種方法是使用venv （Virtualenv）和pip 。這是從pypi.org安裝git-cola。

 python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola

將env3/bin目錄添加到您的PATH或符號鏈接中，從PATH中的某個地方（例如~/.local/bin/git-cola添加到bin/git-cola ，您可以像任何其他內置的git命令一樣啟動git cola：

 git cola
git dag

從源安裝到python virtualenv中

如果您沒有安裝PYQT，那麼獲得它的最簡單方法是使用Python Virtualenv並以“可編輯”模式安裝Git Cola。

此安裝方法使您可以通過運行git pull來升級git Cola。

 # 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

如果將env3/bin （或Symlink添加到env3/bin/git-cola ）在$PATH中的某個地方，則可以運行git cola ，就好像它是來自Virtualenv外部的內置git命令（例如，在運行“停用”或打開新的外殼時）。

來自來源的獨立安裝

運行garden -D prefix=$HOME/.local install將在您的$HOME/.local目錄中安裝git cola（ $HOME/.local/bin/git-cola ， $HOME/.local/lib等）。

此安裝方法假定qtpy和PyQt*依賴項已預先安裝。

花園食譜還支持DESTDIR支持為Linux軟件包經理創建包裝：

 garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install

如果您沒有可用的garden ，則可以改用make 。 Makefile支持使用常規的Destdir和前綴變量進行安裝。

 make DESTDIR=/tmp/stage prefix=/usr/local install

macos

對於大多數最終用戶，我們建議使用上述自製或安裝到Python Virtualenv中。

您可以使用與上述相同的步驟從源安裝git Cola。

自製

安裝Git Cola的一種簡單方法是使用自製。使用自製的安裝git-cola食譜：

 brew install git-cola

如果您使用Homebrew安裝，則可以在此步驟中停止。您無需克隆回購或任何東西。

git-cola.app

如果您安裝了所有依賴項，則可以通過pip或brew ，然後可以構建一個shell git-cola.app應用包包裝器，以便在/Applications中使用。

如果您想構建一個git-cola.app捆綁包/Applications運行以下命令：

 garden macos/app

每當python升級時，您都需要定期重建應用程序包裝器。

更新Macos和自製

更新MacOS通常會破壞由自製的軟件。

如果您更新MacOS和Git Cola停止工作，那麼您可能需要重新安裝Git Cola的依賴項。

使用下面的說明從頭開始重新安裝可以使情況恢復原狀。

 brew update

brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove

brew install git-cola

視窗

重要的是，如果您擁有64位機器，請僅安裝64位版本。請勿混合32位和64位版本。

下載並安裝以下內容：

• Windows的git

• Git Cola

安裝這些內容後，您可以從開始菜單運行git Cola。

有關更多詳細信息，請參見下面的“ Windows（續）”。

如果您想在Winget上安裝Git Cola，請運行以下命令：

 winget install git-cola.git-cola

由於尚無依賴分辨率，因此您也必須安裝git：

 winget install Git.Git

好東西

Git Cola用互動式git-cola-sequence-editor editor 。 git-cola-sequence-editor用於重新訂購併選擇提交。通過“ rebase”菜單或通過git cola rebase子命令啟動交互式重新構想以使用git-cola-sequence-editor ：

 git cola rebase @{upstream}

可以通過告訴git rebase將其通過GIT_SEQUENCE_EDITOR環境變量將其用作編輯器，可以獨立於git cola啟動git-cola-sequence-editor ：

 export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}

外殼完成

外殼完成腳本可用於BASH和ZSH。每個腳本都包含有關如何安裝和激活完成的說明。

• bash完成腳本

• ZSH完成腳本

git cola子命令

git-cola命令公開了各種子命令，使您可以快速啟動從Git-Cola接口中可用的工具。例如， git cola find啟動了文件查找器， git cola grep啟動了GREP工具。

有關完整的git cola --help-commands 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

發展

如果您已經安裝了Git Cola的依賴項，則如果您有可用的源代碼，則可以啟動cola作為Python模塊。

 python -m cola
python -m cola dag

在開發過程中應運行以下命令：

 # Run the unit tests
$ garden test

# Run tests and doc checks
$ garden check

# Run tests against multiple python interpreters using tox
$ garden tox

可以在測試目錄中找到測試套件。

使用GitHub操作自動測試提交和拉動請求的代碼質量。

在更新翻譯時提交之前，自動式cola/i18n/*.po文件：

 $ garden po

提交補丁時，請諮詢貢獻指南。

包裝筆記

Git Cola使用SetUptools將其模塊安裝到默認的Python站點包裝目錄中（例如lib/python3.7/site-packages ）。

儘管最終用戶可以使用pip install git-cola安裝git cola，但分銷包裝器應使用garden -D prefix=/usr install過程。 Git Cola的花園食譜包裝pip install --prefix=<prefix>提供包裝友好的garden install目標。

Windows（續）

Microsoft Visual C ++ 2015可重新分佈

Git Cola的早期版本可能已經發貨了，沒有vcruntime140.dll ，並且可能不會在缺少該DLL的機器上運行。

要解決此問題，請下載Microsoft Visual C ++ 2015重新分配並安裝

git cola v4.0.0及其較新的包含此DLL，不需要單獨安裝。

發展

為了在Windows上開發Git Cola，您需要安裝Python3和Pip。使用pip install PyQt5以使Pyqt5綁定可用於Python。

安裝這些內容後，您可以使用python.exe直接從源樹運行。例如，來自git bash終端：

 /c/Python39/python.exe ./bin/git-cola

多個Python版本

如果您安裝了多個版本的Python，則contrib/win32/cola Launcher腳本可能會選擇較新版本，而不是已安裝PYQT的Python。為了解決此問題，您可以設置cola.pythonlocation Git配置變量，以告訴Cola在哪裡可以找到Python。例如：

 git config --global cola.pythonlocation /c/Python39

構建Windows安裝程序

Windows安裝程序是使用

• pynsist。

• 還需要NSIS。

使用pynsist運行構建安裝程序：

 ./contrib/win32/run-pynsist.sh

這將在build/nsis/中生成安裝程序。

Windows“歷史記錄瀏覽器”配置升級

如果您正在從Windows上的git Cola升級，則可能需要配置歷史記錄瀏覽器。

gitk最初是默認的歷史記錄瀏覽器，但是gitk不能在Windows上啟動，因為gitk是Shell腳本。

如果您被配置為使用gitk ，請更改配置，以通過Windows上的Git的sh.exe 。同樣，如果要使用git-dag ，我們必須通過python.exe進行。

如果要使用gitk作為歷史記錄瀏覽器打開首選項屏幕，然後將“歷史記錄瀏覽器命令”更改為：

 "C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk

git-dag成為v2.3中Windows上的默認歷史記錄瀏覽器，因此新用戶無需配置任何內容。