git cola
v4.10.1
Git Colaは、滑らかで直感的なユーザーインターフェイスを備えた強力なGit GUIです。
git clone https://github.com/git-cola/git-cola.git
スクリーンショット
ダウンロード
キーボードショートカット
HTMLドキュメント
Git Colaドキュメント
Git DAGドキュメント
貢献ガイドライン
GIT 2.2.0以降。
Python 3.6以降。
QTPY 2.0.0以降。
Git ColaはQTPYを使用しているため、 QT_API環境変数をPYQT6、PyQT5、またはPyside2に設定することにより、 pyqt6 、 pyqt5 、 pyside2のいずれかを選択できます。 qtpy pyqt5にデフォルトで、 pyqt5がインストールされていない場合、 pyqt6およびpyside2に戻ります。
次のPython QTライブラリのいずれかをインストールする必要があります。
pyqt5 / pyqt6 5.9以降が必要です。 QT 6.2以降はQTPYを介してサポートされています。
pyside2 5.12.0以降。
Git Colaは、次のPythonモジュールがインストールされている場合、追加機能を有効にします。
Send2Trashは、クロスプラットフォームの「The Trashに送信」機能を有効にします。 （ソース）
notify2は、デスクトップ通知の配信を有効にします。 （ソース）
PyoBJCは、macOSに関するmacOS固有のアプリケーションテーマを有効にします。 （ソース）
Git Colaをインストールする方法はいくつかありますが、実行するためにGit Colaを「インストール」する必要はありません。
Git Colaは、ソースツリーから直接実行するように設計されています。インストールはオプションです。
最新のGit Colaバージョンを実行するための推奨アプローチは、配信のパッケージマネージャーを使用してPYQT依存関係をインストールし、ソースから直接./bin/git-colaを実行することです。
Git Colaは、Pyqtライブラリを使用してPyqt互換性を使用するため、Pyqt5またはPyqt6のいずれかで動作します。
新しい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を使用したい場合は、PyQT5の代わりにこれらのパッケージをインストールできます。
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengineこの時点で、ソースツリーから./bin/git-colaを起動できるはずです。これ以上のことはありません。
以下の詳細については、PypiからGit Colaをインストールする方法、またはソースツリーとは別の場所にインストールする方法を詳しく説明しています。
Linuxです！あなたのディストリビューションは、おそらくすでにパッケージ化されたgit-colaです。そうでない場合は、配布に対してバグを提出してください;-)
AURで利用可能。
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
slackbuilds.orgで入手可能。
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
重要：Python Virtualenvの外側またはルートとしてpip installやgarden installを実行しないでください！
重要：Pyqt6またはPyqt5がパッケージマネージャーから利用可能なLinuxディストリビューションを使用している場合は、システムのパッケージマネージャーを使用してそれらの依存関係をインストールすることを強くお勧めします。詳細については、上記のセクションを参照してください。
最新のリリースバージョンをインストールする1つの方法は、 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に追加するか、 ~/.local/bin/git-colaなどのPATHのどこかからbin/git-colaにsymlinkを追加すると、他の組み込みgitコマンドと同じようにGit Colaを起動できます。
git cola
git dag
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
$PATHのどこかにenv3/bin （またはenv3/bin/git-colaにsymlink）を追加すると、 git cola virtualenvの外側から組み込みgitコマンドであるかのように実行できます（「無効」を実行した後、または新しいシェルを開くとき）。
garden -D prefix=$HOME/.local install $HOME/.localディレクトリ（ $HOME/.local/bin/git-cola 、 $HOME/.local/libなど）にgit colaをインストールします。
このインストール方法では、 qtpyおよびPyQt*依存関係が事前にインストールされていることを前提としています。
Garden Recipeは、Linuxパッケージマネージャー向けのパッケージの作成をサポートするDESTDIRもサポートしています。
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
利用可能なgardenがない場合は、代わりに使用することができmake 。 Makefile 、従来のDestDirとプレフィックス変数を使用して、段階的なインストールをサポートしています。
make DESTDIR=/tmp/stage prefix=/usr/local install
ほとんどのエンドユーザーについては、上記のようにHomebrewを使用するか、Python Virtualenvにインストールすることをお勧めします。
上記と同じ手順を使用して、ソースからGit Colaをインストールできます。
Git Colaをインストールする簡単な方法は、Homebrewを使用することです。 homebrewを使用して、git-colaレシピをインストールします。
brew install git-cola
HomeBrewを使用してインストールすると、このステップで停止できます。リポジトリなどをクローンする必要はありません。
pipまたはbrewを介してすべての依存関係をインストールしている場合、 /Applicationsで使用するためにシェルgit-cola.appアプリバンドルラッパーを構築できます。
git-cola.appバンドルを作成したい場合/Applicationsを実行します。このコマンドを実行します。
garden macos/app
Pythonがアップグレードされるたびに、アプリラッパーを定期的に再構築する必要があります。
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と呼ばれるインタラクティブなRebaseエディターと一緒に出荷されます。 git-cola-sequence-editor再秩序を並べ替えるために使用され、リベッシング時にコミットを選択します。 「Rebase」メニューを介して、またはgit cola rebaseサブコマンドを介してインタラクティブなリベースを開始して、 git-cola-sequence-editorを使用します。
git cola rebase @{upstream}
git-cola-sequence-editor GIT_SEQUENCE_EDITOR環境変数を介してeditorとして使用するようにgit rebaseに使用するようにgitコーラとは独立して発売できます。
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
シェル完了スクリプトは、BASHとZSHで使用できます。各スクリプトには、完了をインストールしてアクティブ化する方法に関する指示が含まれています。
バッシュ完了スクリプト
ZSH完了スクリプト
git-colaコマンドは、Git-Colaインターフェイス内から利用できるツールをすばやく起動できるさまざまなサブコマンドを公開します。たとえば、 git cola findファイルファインダーを起動し、 git cola grep Grepツールを起動します。
コマンドの完全なリストについては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
既に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's Garden Recipe Laps pip install --prefix=<prefix>パッケージに優しいgarden installターゲットを提供します。
Git Colaの以前のバージョンは、 vcruntime140.dllなしで出荷された可能性があり、このDLLが欠落しているマシンで実行されない場合があります。
これを修正するには、Microsoft VisualC ++ 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の複数のバージョンがインストールされている場合、 contrib/win32/colaランチャースクリプトは、pyqtがインストールされているPythonの代わりに新しいバージョンを選択する場合があります。これを解決するために、 cola.pythonlocation git構成変数を設定して、ColaにPythonを見つける場所を伝えることができます。例えば：
git config --global cola.pythonlocation /c/Python39
Windowsインストーラーは使用して構築されています
ピンシスト。
NSISも必要です。
Pynsist Runを使用してインストーラーを構築するには：
./contrib/win32/run-pynsist.sh
これによりbuild/nsis/にインストーラーが生成されます。
Windows上のGit Colaの古いバージョンからアップグレードする場合は、履歴ブラウザーを構成する必要がある場合があります。
gitkもともとデフォルトの履歴ブラウザーでしたが、 gitkはシェルスクリプトであるため、 gitk Windowsでは発売できません。
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のデフォルトの履歴ブラウザになったため、新しいユーザーは何も構成する必要はありません。
