git cola
v4.10.1
GIT COLA هي واجهة مستهجمة GIT قوية مع واجهة مستخدم بديهية وبديهية.
git clone https://github.com/git-cola/git-cola.git
لقطات الشاشة
التنزيلات
اختصارات لوحة المفاتيح
وثائق HTML
توثيق Git Cola
GIT DAG وثائق
الإرشادات المساهمة
git 2.2.0 أو الأحدث.
بيثون 3.6 أو الأحدث.
qtpy 2.0.0 أو الأحدث.
يستخدم Git Cola QTPY ، بحيث يمكنك الاختيار بين PYQT6 و PYQT5 و Pyside2 من خلال تعيين متغير بيئة QT_API إلى pyqt6 أو pyqt5 أو pyside2 حسب الرغبة. qtpy الافتراضيات إلى pyqt5 ويعود إلى pyqt6 و pyside2 إذا لم يتم تثبيت pyqt5 .
يجب تثبيت أي من مكتبات Python QT التالية:
مطلوب PYQT5 / PYQT6 5.9 أو الأحدث. QT 6.2 أو الأحدث مدعوم أيضًا عبر QTPY.
Pyside2 5.12.0 أو الأحدث.
تتيح Git Cola ميزات إضافية عند تثبيت وحدات Python التالية.
Send2Trash يمكّن من الوظائف عبر المنصات "إرسال إلى القمامة". (مصدر)
الإخطار 2 يتيح تسليم إشعارات سطح المكتب. (مصدر)
يتيح PyobJC موضوعات تطبيق MacOS الخاصة على MacOS. (مصدر)
هناك عدة طرق لتثبيت Git Cola لكنك لا تحتاج إلى "تثبيت" Git Cola لتشغيلها.
تم تصميم Git Cola لتشغيل مباشرة من شجرة المصدر. التثبيت اختياري.
النهج الموصى به لتشغيل أحدث إصدار من GIT Cola هو تثبيت تبعيات PYQT الخاصة به باستخدام مدير حزمة التوزيع الخاص بك ثم ./bin/git-cola .
يعمل Git Cola مع PYQT5 أو PYQT6 لأنه يستخدم مكتبة QTPY لتوافق PYQT.
يمكن للمستخدمين على إصدار Debian/Ubuntu الأحدث تثبيت حزمة واحدة لتشغيلها من المصدر.
sudo apt install python3-qtpy إذا كنت على إصدار أقدم لا يحتوي على python3-qtpy ، فيمكنك تثبيت الحزم التالية مباشرة.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgإذا كنت ترغب في استخدام Git Cola مع النظام البيئي الأحدث PYQT6 ، فيمكنك تثبيت هذه الحزم بدلاً من PYQT5.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine ./bin/git-cola هذه المرحلة ، يجب أن تكون قادرًا على الإطلاق.
توضح الإرشادات الإضافية أدناه كيفية تثبيت Git Cola من PYPI أو كيفية تثبيته في موقع منفصل عن شجرة المصدر.
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
هام : لا تقم أبدًا بتشغيل pip install أو garden install خارج Python Virtualenv أو جذر!
هام : إذا كنت على توزيعات Linux حيث تتوفر PYQT6 أو PYQT5 من مدير الحزمة الخاص بك ، فمن المستحسن بشدة تثبيت تلك التبعيات باستخدام مدير حزمة النظام الخاص بك. انظر القسم أعلاه للحصول على التفاصيل.
طريقة واحدة لتثبيت أحدث إصدار تم إصداره هو استخدام venv (VirtualEnV) و pip . هذا يثبت git-cola من pypi.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
أضف دليل env3/bin إلى PATH أو symlink إلى bin/git-cola من مكان ما في PATH مثل ~/.local/bin/git-cola ، ويمكنك تشغيل git cola مثل أي أمر git مضمّن آخر:
git cola
git dag
إذا لم يكن لديك تثبيت PYQT ، فإن أسهل طريقة للحصول عليها هي استخدام Python Virtualenv وتثبيت Git Cola في وضع "قابل للتحرير".
تتيح لك طريقة التثبيت هذه ترقية Git Cola عن طريق تشغيل 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
إذا قمت بإضافة env3/bin (أو Symlink إلى env3/bin/git-cola ) في مكان ما في $PATH الخاص بك ، فيمكنك تشغيل git cola كما لو كان أمرًا مبنيًا git من خارج Virtualenv (على سبيل المثال بعد تشغيل "Deactivate" أو عند فتح قشرة جديدة).
تشغيل garden -D prefix=$HOME/.local install GIT COLA في دليل $HOME/.local الخاص بك ( $HOME/.local/bin/git-cola ، $HOME/.local/lib ، etc).
تفترض طريقة التثبيت هذه أن التبعيات 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
بالنسبة لمعظم المستخدمين النهائيين ، نوصي باستخدام إما Homebrew أو التثبيت في Python VirtualenV كما هو موضح أعلاه.
يمكنك تثبيت Git Cola من المصدر باستخدام نفس الخطوات المذكورة أعلاه.
طريقة سهلة لتثبيت Git Cola هي استخدام Homebrew. استخدم Homebrew لتثبيت وصفة Git-Cola:
brew install git-cola
إذا قمت بالتثبيت باستخدام Homebrew ، فيمكنك التوقف عند هذه الخطوة. لا تحتاج إلى استنساخ الريبو أو أي شيء.
إذا كان لديك جميع التبعيات المثبتة ، إما عبر pip أو brew ، فيمكنك إنشاء غلاف حزمة تطبيق shell git-cola.app للاستخدام في /Applications .
إذا كنت ترغب في إنشاء حزمة 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 بت.
قم بتنزيل وتثبيت ما يلي:
GIT لنظام التشغيل Windows
غيت كولا
بمجرد تثبيت هذه ، يمكنك تشغيل Git Cola من قائمة START.
انظر "Windows (تابع)" أدناه لمزيد من التفاصيل.
إذا كنت ترغب في تثبيت Git Cola مع Winget Run الأمر التالي:
winget install git-cola.git-cola
نظرًا لعدم وجود دقة تبعية ، لكن عليك تثبيت GIT أيضًا مع:
winget install Git.Git
يشحن Git Cola مع محرر Rebase التفاعلي يسمى git-cola-sequence-editor . يتم استخدام git-cola-sequence-editor لإعادة ترتيب واختيار الالتزامات عند التخلص منها. ابدأ Rebase التفاعلي من خلال قائمة "Rebase" ، أو من خلال git cola rebase Sommand لاستخدام git-cola-sequence-editor :
git cola rebase @{upstream}
يمكن إطلاق git-cola-sequence-editor بشكل مستقل عن Git Cola من خلال إخبار git rebase باستخدامه كمحرر من خلال متغير بيئة GIT_SEQUENCE_EDITOR :
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
البرامج النصية لإكمال شل متوفرة لباش و ZSH. يحتوي كل برنامج نصي على تعليمات حول كيفية تثبيت وتنشيط الإكمال.
نص إكمال باش
ZSH الانتهاء السيناريو
يعرض أمر git-cola مختلف الأدوات الفرعية التي تسمح لك بإطلاق أدوات متوفرة بسرعة من داخل واجهة Git-Cola. على سبيل المثال ، git cola find على إطلاق File Finder ، وتطلق 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.
Format cola/i18n/*.po
$ garden po
عند تقديم تصحيحات ، راجع الإرشادات المساهمة.
تقوم Git Cola بتثبيت وحداتها في دليل حزم موقع Python الافتراضي (مثل lib/python3.7/site-packages ) باستخدام setuptools.
بينما يمكن للمستخدمين النهائيين استخدام pip install git-cola لتثبيت Git Cola ، يجب على حزم التوزيع استخدام عملية garden -D prefix=/usr install . تلتف وصفة حديقة Git Cola pip install --prefix=<prefix> لتوفير هدف garden install صديق للتغليف.
قد تكون الإصدارات السابقة من Git Cola قد تم شحنها بدون vcruntime140.dll وقد لا تعمل على الأجهزة التي تفتقد إلى DLL.
لإصلاح هذا ، قم بتنزيل Microsoft Visual C ++ 2015 القابلة لإعادة التوزيع وتثبيته
GIT COLA v4.0.0 وأحدث تشمل هذا DLL ولا يتطلب تثبيت هذا بشكل منفصل.
من أجل تطوير Git Cola على Windows ، ستحتاج إلى تثبيت Python3 و PIP. تثبيت PYQT5 باستخدام pip install PyQt5 لجعل روابط PYQT5 متاحة للبيثون.
بمجرد تثبيت هذه ، يمكنك استخدام python.exe للتشغيل مباشرة من شجرة المصدر. على سبيل المثال ، من محطة باش بالجيت:
/c/Python39/python.exe ./bin/git-cola
إذا كان لديك إصدارات متعددة من Python مثبتة ، فقد يختار البرنامج النصي contrib/win32/cola Launcher الإصدار الأحدث بدلاً من Python الذي تم تثبيته. من أجل حل ذلك ، يمكنك تعيين متغير تكوين GIT cola.pythonlocation لإخبار Cola بمكان العثور على Python. على سبيل المثال:
git config --global cola.pythonlocation /c/Python39
تم تصميم مثبتات Windows باستخدام
Pynsist.
هناك حاجة أيضًا إلى NSIS.
لبناء المثبت باستخدام Pynsist Run:
./contrib/win32/run-pynsist.sh
سيؤدي ذلك إلى إنشاء مثبت في build/nsis/ .
قد تحتاج إلى تكوين متصفح السجل الخاص بك إذا كنت تقوم بالترقية من إصدار أقدم من Git Cola على Windows.
كان gitk في الأصل متصفح التاريخ الافتراضي ، ولكن لا يمكن إطلاق gitk كما هو على Windows لأن gitk هو نص Shell.
إذا تم تكوينك لاستخدام gitk ، فقم بتغيير التكوين الخاص بك للذهاب من خلال Git's sh.exe على Windows. وبالمثل ، يجب أن نمر عبر python.exe إذا كنا نريد استخدام git-dag .
إذا كنت ترغب في استخدام GITK كمتصفح التاريخ ، افتح شاشة التفضيلات وتغيير أمر متصفح التاريخ إلى:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
أصبح git-dag متصفح السجل الافتراضي على Windows في v2.3 ، لذلك لا يحتاج المستخدمون الجدد إلى تكوين أي شيء.
