git cola
v4.10.1
Git Cola는 매끄럽고 직관적 인 사용자 인터페이스를 갖춘 강력한 Git Gui입니다.
git clone https://github.com/git-cola/git-cola.git
스크린 샷
다운로드
키보드 단축키
HTML 문서
git 콜라 문서
git dag 문서
기고 가이드 라인
Git 2.2.0 또는 새로.
파이썬 3.6 또는 새로.
QTPY 2.0.0 또는 새로.
Git Cola는 QTPY를 사용하므로 PYQT6, PYQT5 및 PYSIDE2를 원하는대로 pyqt6 , pyqt5 또는 PYSIDE2로 설정하여 QT_API , PYQT5 및 pyside2 중에서 선택할 수 있습니다. qtpy 기본값은 pyqt5 로, pyqt5 설치되지 않은 경우 pyqt6 및 pyside2 로 돌아갑니다.
다음 Python QT 라이브러리를 설치해야합니다.
PYQT5 / PYQT6 5.9 또는 최신이 필요합니다. QT 6.2 또는 Newer도 QTPY를 통해 지원됩니다.
Pyside2 5.12.0 또는 새로.
Git Cola는 다음 파이썬 모듈이 설치 될 때 추가 기능을 활성화합니다.
send2trash는 크로스 플랫폼 "Trash to Trash"기능을 활성화합니다. (원천)
Notify2를 사용하면 데스크탑 알림을 제공 할 수 있습니다. (원천)
PYOBJC는 MACOS에서 MACOS 관련 응용 프로그램 테마를 활성화합니다. (원천)
Git Cola를 설치하는 방법에는 여러 가지가 있지만 실행하기 위해 Git Cola를 "설치"할 필요는 없습니다.
Git Cola는 소스 트리에서 직접 실행되도록 설계되었습니다. 설치는 선택 사항입니다.
최신 Git Cola 버전을 실행하기위한 권장되는 접근법은 배포 패키지 관리자를 사용하여 PYQT 종속성을 설치 한 다음 소스에서 직접 ./bin/git-cola 실행하는 것입니다.
Git Cola는 PYQT5 또는 PYQT6과 함께 PYQT 호환성을 위해 QTPY 라이브러리를 사용하기 때문에 작동합니다.
최신 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를 설치하는 방법 또는 소스 트리와 별개의 위치에 설치하는 방법을 자세히 설명합니다.
리눅스입니다! 배포판은 이미 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 외부 또는 루트로 실행하지 마십시오!
중요 : 패키지 관리자가 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
~/.local/bin/git-cola 와 같은 PATH 어딘가에서 env3/bin 디렉토리를 PATH 에 추가하거나 Symlink에 bin/git-cola 에 추가하면 다른 내장 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)을 추가하면 virtualenv 외부에서 내장 된 git 명령 인 것처럼 git cola 실행할 수 있습니다 (예 : "deactivate"또는 새 쉘을 열 때).
Running garden -D prefix=$HOME/.local install $HOME/.local directory ( $HOME/.local/bin/git-cola , $HOME/.local/lib 등)에 git cola를 설치합니다.
이 설치 방법은 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를 설치하는 쉬운 방법은 홈브류를 사용하는 것입니다. 홈 브루를 사용하여 Git-Cola 레시피를 설치하십시오.
brew install git-cola
홈 브루를 사용하여 설치하면이 단계에서 중지 할 수 있습니다. repo 나 다른 것을 복제 할 필요는 없습니다.
pip 또는 brew 통해 모든 종속성이 설치된 경우 /Applications 사용하기 위해 Shell git-cola.app App Bundle Wrapper를 구축 할 수 있습니다.
/Applications 위한 git-cola.app 번들을 빌드하려면 다음 명령을 실행하십시오.
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 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 하위 명령을 통해 대화식 Rebase를 시작하여 git-cola-sequence-editor 사용하십시오.
git cola rebase @{upstream}
git-cola-sequence-editor git rebase GIT_SEQUENCE_EDITOR 환경 변수를 통해 편집기로 사용하도록 지시함으로써 git cola와 독립적으로 시작할 수 있습니다.
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Bash 및 Zsh에는 쉘 완료 스크립트를 사용할 수 있습니다. 각 스크립트에는 완료를 설치하고 활성화하는 방법에 대한 지침이 포함되어 있습니다.
BASH 완료 스크립트
ZSH 완성 스크립트
git-cola Command는 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
테스트 스위트는 테스트 디렉토리에서 찾을 수 있습니다.
Commit and Pull 요청은 GitHub 작업을 사용하여 코드 품질에 대해 자동으로 테스트됩니다.
Auto-Format cola/i18n/*.po 파일 번역 업데이트 할 때 커밋하기 전에 :
$ garden po
패치를 제출할 때 기고 가이드 라인을 참조하십시오.
Git Cola는 Setuptools를 사용하여 모듈을 기본 Python Site-Packages 디렉토리 (예 : lib/python3.7/site-packages )에 설치합니다.
최종 사용자는 pip install git-cola 사용하여 Git Cola를 설치할 수 있지만 Packagers는 garden -D prefix=/usr install 프로세스를 사용해야합니다. Git Cola 's Garden Recipe Wraps pip install --prefix=<prefix> 포장 친화적 인 garden install 대상을 제공합니다.
이전 버전의 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이 설치된 경우 contrib/win32/cola Launcher 스크립트는 PYQT가 설치된 Python 대신 최신 버전을 선택할 수 있습니다. 이를 해결하기 위해 cola.pythonlocation git 구성 변수를 설정하여 Cola에게 파이썬을 찾을 위치를 알려줍니다. 예를 들어:
git config --global cola.pythonlocation /c/Python39
Windows 설치 프로그램은 사용하여 구축됩니다
Pynsist.
NSI도 필요합니다.
Pynsist Run을 사용하여 설치 프로그램을 구축하려면 :
./contrib/win32/run-pynsist.sh
이것은 build/nsis/ 에서 설치 프로그램을 생성합니다.
Windows의 이전 버전의 Git Cola에서 업그레이드하는 경우 히스토리 브라우저를 구성해야 할 수도 있습니다.
gitk 원래 기본 히스토리 브라우저 였지만 gitk gitk 쉘 스크립트이기 때문에 Windows에서 Gitk를 시작할 수 없습니다.
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에서 기본 기록 브라우저가되었으므로 새로운 사용자는 아무것도 구성 할 필요가 없습니다.
