git cola
v4.10.1
Git Cola adalah GUI Git yang kuat dengan antarmuka pengguna yang licin dan intuitif.
git clone https://github.com/git-cola/git-cola.git
Tangkapan layar
Unduhan
Pintasan keyboard
Dokumentasi HTML
Dokumentasi Git Cola
Dokumentasi Git Dag
Pedoman yang berkontribusi
Git 2.2.0 atau lebih baru.
Python 3.6 atau lebih baru.
Qtpy 2.0.0 atau lebih baru.
Git Cola menggunakan qtpy, sehingga Anda dapat memilih antara pyqt6, pyqt5 dan pyside2 dengan mengatur variabel lingkungan QT_API ke pyqt6 , pyqt5 atau pyside2 seperti yang diinginkan. qtpy default ke pyqt5 dan jatuh kembali ke pyqt6 dan pyside2 jika pyqt5 tidak diinstal.
Perpustakaan Python QT berikut harus diinstal:
PYQT5 / PYQT6 5.9 atau lebih baru diperlukan. QT 6.2 atau yang lebih baru juga didukung melalui QTPY.
Pyside2 5.12.0 atau lebih baru.
Git Cola memungkinkan fitur tambahan ketika modul python berikut diinstal.
Send2Trash Mengaktifkan fungsionalitas lintas platform "Send to Trash". (sumber)
Notify2 Mengaktifkan pengiriman pemberitahuan desktop. (sumber)
pyobjc memungkinkan tema aplikasi khusus macOS pada macOS. (sumber)
Ada beberapa cara untuk menginstal git cola tetapi Anda tidak perlu "menginstal" git cola untuk menjalankannya.
Git Cola dirancang untuk berjalan langsung dari pohon sumbernya. Instalasi adalah opsional.
Pendekatan yang disarankan untuk menjalankan versi Git Cola terbaru adalah menginstal dependensi PYQT-nya menggunakan manajer paket distribusi Anda dan kemudian menjalankan ./bin/git-cola langsung dari sumber.
Git Cola bekerja dengan PYQT5 atau PYQT6 karena menggunakan pustaka Qtpy untuk kompatibilitas PYQT.
Pengguna pada versi Debian/Ubuntu yang lebih baru dapat menginstal satu paket untuk dijalankan dari sumber.
sudo apt install python3-qtpy Jika Anda berada di versi yang lebih lama yang tidak memiliki python3-qtpy yang tersedia maka Anda dapat menginstal paket berikut secara langsung.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgJika Anda ingin menggunakan Git Cola dengan ekosistem PYQT6 yang lebih baru maka Anda dapat menginstal paket -paket ini alih -alih PYQT5.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine Pada titik ini Anda harus dapat meluncurkan ./bin/git-cola dari pohon sumber dan tidak ada lagi yang bisa dilakukan.
Instruksi lebih lanjut di bawah ini merinci cara menginstal git cola dari pypi atau cara menginstalnya ke lokasi yang terpisah dari pohon sumber.
Linux itu! Distro Anda mungkin sudah dikemas git-cola . Jika tidak, silakan ajukan bug terhadap distribusi Anda ;-)
Tersedia di AUR.
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
Tersedia di slackbuilds.org.
Lihat di sini untuk versi yang tersedia di repositori 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
PENTING : Jangan pernah menjalankan pip install atau garden install di luar Python VirtualEnv atau sebagai root!
PENTING : Jika Anda berada di distribusi Linux di mana PYQT6 atau PYQT5 tersedia dari manajer paket Anda maka sangat disarankan untuk menginstal dependensi tersebut menggunakan manajer paket sistem Anda. Lihat bagian di atas untuk detailnya.
Salah satu cara untuk menginstal versi terbaru yang dirilis adalah dengan menggunakan venv (VirtualEnv) dan pip . Ini menginstal Git-Cola dari pypi.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
Tambahkan Direktori env3/bin ke PATH Anda atau symlink ke bin/git-cola dari suatu tempat di PATH Anda seperti ~/.local/bin/git-cola , dan Anda dapat meluncurkan git cola seperti perintah git bawaan lainnya:
git cola
git dag
Jika Anda tidak menginstal PYQT maka cara termudah untuk mendapatkannya adalah dengan menggunakan Python VirtualEnv dan menginstal Git Cola ke dalamnya dalam mode "Editable".
Metode instal ini memungkinkan Anda memutakhirkan Git Cola dengan menjalankan 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
Jika Anda menambahkan env3/bin (atau symlink ke env3/bin/git-cola ) di suatu tempat di $PATH Anda maka Anda dapat menjalankan git cola seolah-olah itu adalah perintah git builtin dari luar virtualEnv (misalnya setelah menjalankan "Nonaktifkan" atau ketika membuka cangkang baru).
Running garden -D prefix=$HOME/.local install akan menginstal git cola di direktori $HOME/.local Anda ( $HOME/.local/bin/git-cola , $HOME/.local/lib , dll).
Metode instalasi ini mengasumsikan bahwa dependensi qtpy dan PyQt* telah dipasang sebelumnya.
Resep taman juga mendukung DESTDIR untuk mendukung pembuatan paket untuk manajer paket Linux:
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
Jika Anda tidak memiliki garden yang tersedia maka make dapat digunakan sebagai gantinya. Makefile mendukung pemasangan bertahap menggunakan variabel destdir dan awalan konvensional.
make DESTDIR=/tmp/stage prefix=/usr/local install
Untuk sebagian besar pengguna akhir, kami sarankan menggunakan homebrew atau memasang ke dalam virtualEnv Python seperti dijelaskan di atas.
Anda dapat menginstal git cola dari sumber menggunakan langkah yang sama seperti di atas.
Cara mudah untuk memasang git cola adalah dengan menggunakan homebrew. Gunakan Homebrew untuk memasang resep Git-Cola:
brew install git-cola
Jika Anda menginstal menggunakan Homebrew, Anda dapat berhenti pada langkah ini. Anda tidak perlu mengkloning repo atau apapun.
Jika Anda memiliki semua dependensi yang diinstal, baik melalui pip atau brew maka Anda dapat membangun pembungkus bundel aplikasi shell git-cola.app untuk digunakan di /Applications .
Jika Anda ingin membangun bundel git-cola.app untuk /Applications jalankan perintah ini:
garden macos/app
Anda perlu membangun kembali pembungkus aplikasi secara berkala setiap kali Python ditingkatkan.
Memperbarui macOS sering dapat merusak perangkat lunak yang dikelola homebrew.
Jika Anda memperbarui macOS dan git cola berhenti bekerja maka Anda mungkin perlu menginstal ulang dependensi Git Cola.
Instalasi ulang dari awal menggunakan instruksi di bawah ini bisa mendapatkan kembali bentuknya.
brew update
brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove
brew install git-cola
Penting Jika Anda memiliki mesin 64-bit, instal versi 64-bit saja. Jangan mencampur versi 32-bit dan 64-bit.
Unduh dan instal yang berikut:
Git untuk windows
Git cola
Setelah ini diinstal, Anda dapat menjalankan git cola dari menu start.
Lihat "Windows (Lanjutan)" di bawah ini untuk detail lebih lanjut.
Jika Anda ingin menginstal git cola dengan winget jalankan perintah berikut:
winget install git-cola.git-cola
Karena tidak ada resolusi ketergantungan namun Anda harus menginstal git juga dengan:
winget install Git.Git
Git Cola kapal dengan editor rebase interaktif yang disebut git-cola-sequence-editor . git-cola-sequence-editor digunakan untuk memesan ulang dan memilih komit saat rebasing. Mulailah rebase interaktif melalui menu "rebase", atau melalui sub-perintah git cola rebase untuk menggunakan git-cola-sequence-editor :
git cola rebase @{upstream}
git-cola-sequence-editor dapat diluncurkan secara independen dari git cola dengan memberi tahu git rebase untuk menggunakannya sebagai editornya melalui variabel lingkungan GIT_SEQUENCE_EDITOR :
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Skrip penyelesaian shell tersedia untuk Bash dan Zsh. Setiap skrip berisi instruksi tentang cara menginstal dan mengaktifkan penyelesaian.
BASH SCRIPTION SCRIPT
Zsh Skrip Penyelesaian
Perintah git-cola memperlihatkan berbagai sub-komando yang memungkinkan Anda meluncurkan alat dengan cepat yang tersedia dari dalam antarmuka Git-Cola. Misalnya, git cola find meluncurkan pencari file, dan git cola grep meluncurkan alat Grep.
Lihat git cola --help-commands untuk daftar lengkap perintah.
$ 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
Jika Anda sudah menginstal dependensi Git Cola maka Anda dapat memulai cola sebagai modul Python jika Anda memiliki kode sumber yang tersedia.
python -m cola
python -m cola dag
Perintah berikut harus dijalankan selama pengembangan:
# Run the unit tests
$ garden test
# Run tests and doc checks
$ garden check
# Run tests against multiple python interpreters using tox
$ garden tox
Suite tes dapat ditemukan di direktori tes.
Permintaan komit dan tarik diuji secara otomatis untuk kualitas kode menggunakan tindakan GitHub.
Format otomatis cola/i18n/*.po file sebelum melakukan saat memperbarui terjemahan:
$ garden po
Saat mengirimkan tambalan, konsultasikan dengan pedoman yang berkontribusi.
Git Cola menginstal modulnya ke direktori paket-situs python default (misalnya lib/python3.7/site-packages ) menggunakan setuptools.
Sementara pengguna akhir dapat menggunakan pip install git-cola untuk menginstal git cola, pengemas distribusi harus menggunakan garden -D prefix=/usr install . Resep Taman Git Cola Wraps pip install --prefix=<prefix> Untuk menyediakan target garden install yang ramah kemasan.
Versi git cola sebelumnya mungkin telah dikirim tanpa vcruntime140.dll dan mungkin tidak berjalan pada mesin yang kehilangan DLL ini.
Untuk memperbaikinya, unduh Microsoft Visual C ++ 2015 yang dapat didistribusikan dan instal
Git Cola V4.0.0 dan yang lebih baru menyertakan DLL ini dan tidak mengharuskan ini untuk diinstal secara terpisah.
Untuk mengembangkan git cola di windows, Anda harus menginstal Python3 dan PIP. Instal PYQT5 menggunakan pip install PyQt5 untuk membuat binding PYQT5 tersedia untuk Python.
Setelah ini dipasang, Anda dapat menggunakan python.exe untuk berjalan langsung dari pohon sumber. Misalnya, dari terminal bash git:
/c/Python39/python.exe ./bin/git-cola
Jika Anda memiliki beberapa versi Python yang diinstal, skrip peluncur contrib/win32/cola mungkin memilih versi yang lebih baru daripada yang diinstal Pyqt. Untuk menyelesaikan ini, Anda dapat mengatur variabel konfigurasi git cola.pythonlocation untuk memberi tahu Cola di mana menemukan Python. Misalnya:
git config --global cola.pythonlocation /c/Python39
Installer Windows Dibangun Menggunakan
Pynsist.
NSIS juga dibutuhkan.
Untuk membangun penginstal menggunakan Pynsist Run:
./contrib/win32/run-pynsist.sh
Ini akan menghasilkan penginstal di build/nsis/ .
Anda mungkin perlu mengkonfigurasi browser riwayat Anda jika Anda meningkatkan dari versi Git Cola di Windows yang lebih lama.
gitk pada awalnya adalah browser sejarah default, tetapi gitk tidak dapat diluncurkan pada Windows karena gitk adalah skrip shell.
Jika Anda dikonfigurasi untuk menggunakan gitk , maka ubah konfigurasi Anda untuk melewati git's sh.exe pada windows. Demikian pula, kita harus melalui python.exe jika kita ingin menggunakan git-dag .
Jika Anda ingin menggunakan Gitk sebagai browser riwayat Anda, buka layar Preferensi dan ubah perintah browser riwayat menjadi:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
git-dag menjadi browser riwayat default di Windows di v2.3 , sehingga pengguna baru tidak perlu mengkonfigurasi apa pun.
