git cola
v4.10.1
O Git Cola é um poderoso GUI Git com uma interface de usuário lisa e intuitiva.
git clone https://github.com/git-cola/git-cola.git
Capturas de tela
Downloads
Atalhos de teclado
Documentação HTML
Documentação do Git Cola
Documentação do Git DAG
Diretrizes contribuintes
Git 2.2.0 ou mais recente.
Python 3.6 ou mais recente.
Qtpy 2.0.0 ou mais recente.
O Git Cola usa QTPY, para que você possa escolher entre Pyqt6, Pyqt5 e Pyside2, definindo a variável de ambiente QT_API como pyqt6 , pyqt5 ou pyside2 conforme desejado. qtpy padrão para pyqt5 e volta ao pyqt6 e pyside2 se pyqt5 não estiver instalado.
Qualquer uma das seguintes bibliotecas Python QT deve ser instalada:
PYQT5 / PYQT6 5.9 ou mais recente é necessário. Qt 6.2 ou mais recente também é suportado via QTPY.
Pyside2 5.12.0 ou mais recente.
O Git Cola permite recursos adicionais quando os seguintes módulos Python são instalados.
O send2trash permite a funcionalidade entre plataforma "Enviar para lixo". (fonte)
Notify2 permite a entrega de notificações de desktop. (fonte)
O PYOBJC permite temas de aplicativos específicos para MacOS no macOS. (fonte)
Existem várias maneiras de instalar o Git Cola, mas você não precisa "instalar" o Git Cola para executá -lo.
O Git Cola foi projetado para executar diretamente a partir de sua árvore de origem. A instalação é opcional.
A abordagem recomendada para a execução da versão mais recente do Git Cola é instalar suas dependências PYQT usando o gerenciador de pacotes da sua distribuição e executar ./bin/git-cola diretamente da fonte.
O Git Cola funciona com PYQT5 ou PYQT6 porque usa a biblioteca QTPY para compatibilidade com PYQT.
Os usuários na versão mais recente do Debian/Ubuntu podem instalar um único pacote para executar da fonte.
sudo apt install python3-qtpy Se você estiver em uma versão mais antiga que não possui python3-qtpy disponível, poderá instalar os seguintes pacotes diretamente.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgSe você quiser usar o Git Cola com o ecossistema PYQT6 mais recente, poderá instalar esses pacotes em vez do PYQT5.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine Nesse ponto, você poderá lançar ./bin/git-cola a partir da árvore de origem e não há mais nada a fazer.
As instruções adicionais abaixo detalham como instalar o Git Cola a partir do Pypi ou como instalá -lo em um local separado da árvore de origem.
Linux é isso! Sua distro provavelmente já empacotou git-cola . Caso contrário, registre um bug na sua distribuição ;-)
Disponível na AUR.
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
Disponível em slackbuilds.org.
Veja aqui as versões disponíveis nos repositórios do 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
IMPORTANTE : Nunca execute pip install ou garden install fora de um Python VirtualEnv ou como raiz!
IMPORTANTE : Se você estiver nas distribuições Linux, onde Pyqt6 ou PYQT5 estão disponíveis no seu gerenciador de pacotes, é altamente recomendável instalar essas dependências usando o gerenciador de pacotes do seu sistema. Veja a seção acima para obter detalhes.
Uma maneira de instalar a versão mais recente lançada é usar venv (VirtualEnv) e pip . Isso instala Git-Cola em Pypi.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
Adicione o diretório env3/bin ao seu PATH ou symblink para bin/git-cola de algum lugar do seu PATH , como ~/.local/bin/git-cola , e você pode lançar o Git Cola como qualquer outro comando git embutido:
git cola
git dag
Se você não possui o PYQT instalado, a maneira mais fácil de obtê -lo é usar um Python Virtualenv e instalar o Git Cola no modo "editável".
Este método de instalação permite que você atualize o Git Cola executando 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
Se você adicionar env3/bin (ou Symlink a env3/bin/git-cola ) em algum lugar do seu $PATH , poderá executar git cola como se fosse um comando git incorporado fora do VirtualEnv (por exemplo, depois de executar "Deactivate" ou ao abrir um novo shell).
garden -D prefix=$HOME/.local install instalará o Git Cola no seu diretório $HOME/.local ( $HOME/.local/bin/git-cola , $HOME/.local/lib , etc).
Este método de instalação pressupõe que as dependências qtpy e PyQt* foram pré-instaladas.
A receita do jardim também suporta DESTDIR para apoiar a criação de pacotes para gerentes de pacotes Linux:
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
Se você não possui garden disponível, make poderá ser usada. O Makefile suporta instalações encenadas usando as variáveis convencionais de Destdir e Prefix.
make DESTDIR=/tmp/stage prefix=/usr/local install
Para a maioria dos usuários finais, recomendamos o uso de homebrew ou instalação em um Python VirtualEnv, conforme descrito acima.
Você pode instalar o git cola a partir da fonte usando as mesmas etapas acima.
Uma maneira fácil de instalar o Git Cola é usar o Homebrew. Use homebrew para instalar a receita Git-Cola:
brew install git-cola
Se você instalar usando o homebrew, poderá parar nesta etapa. Você não precisa clonar o repositório ou qualquer coisa.
Se você tiver todas as dependências instaladas, via pip ou brew , poderá criar um invólucro de pacote de aplicativos do Shell git-cola.app para uso em /Applications .
Se você quiser construir um pacote git-cola.app para /Applications execute este comando:
garden macos/app
Você precisará reconstruir periodicamente o invólucro de aplicativos sempre que o Python for atualizado.
A atualização do MacOS geralmente pode quebrar o software gerenciado por homebrew.
Se você atualizar o MacOS e o Git Cola parar de funcionar, então provavelmente precisará reinsinar as dependências do Git Cola.
A reinstalação do zero usando as instruções abaixo pode recuperar as coisas.
brew update
brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove
brew install git-cola
Importante se você tiver uma máquina de 64 bits, instale apenas as versões de 64 bits. Não misture versões de 32 e 64 bits.
Baixe e instale o seguinte:
Git for windows
Git cola
Depois que estes estiverem instalados, você poderá executar o Git Cola no menu Iniciar.
Consulte "Windows (continuação)" abaixo para obter mais detalhes.
Se você quiser instalar o Git Cola com Winget, execute o seguinte comando:
winget install git-cola.git-cola
Como não há resolução de dependência, você também precisa instalar o Git com:
winget install Git.Git
O Git Cola envia um editor interativo de rebase chamado git-cola-sequence-editor . git-cola-sequence-editor é usado para reordenar e escolher compromissos ao se rebasar. Inicie uma rebase interativa através do menu "Rebase", ou através do subcomando git cola rebase para usar o git-cola-sequence-editor :
git cola rebase @{upstream}
git-cola-sequence-editor pode ser lançado independentemente do Git Cola, dizendo git rebase para usá-lo como seu editor através da variável de ambiente GIT_SEQUENCE_EDITOR :
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Os scripts de conclusão do shell estão disponíveis para Bash e Zsh. Cada script contém instruções sobre como instalar e ativar as conclusões.
script de conclusão de bash
Script de conclusão do ZSH
O comando git-cola expõe vários subcomandos que permitem iniciar rapidamente as ferramentas disponíveis na interface Git-Cola. Por exemplo, git cola find lança o File Finder e git cola grep lança a ferramenta Grep.
Consulte git cola --help-commands para obter a lista completa de comandos.
$ 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
Se você já possui as dependências do Git Cola instaladas, poderá iniciar cola como um módulo Python se tiver o código -fonte disponível.
python -m cola
python -m cola dag
Os seguintes comandos devem ser executados durante o desenvolvimento:
# Run the unit tests
$ garden test
# Run tests and doc checks
$ garden check
# Run tests against multiple python interpreters using tox
$ garden tox
O conjunto de testes pode ser encontrado no diretório de teste.
As solicitações de compromisso e puxar são testadas automaticamente para obter qualidade de código usando ações do GitHub.
cola/i18n/*.po
$ garden po
Ao enviar patches, consulte as diretrizes contribuintes.
O Git Cola instala seus módulos no diretório padrão de sites python (por exemplo, lib/python3.7/site-packages ) usando o setupTools.
Enquanto os usuários finais podem usar pip install git-cola para instalar o Git Cola, os pacotes de distribuição devem usar o processo garden -D prefix=/usr install . A receita do jardim da Git Cola envolve pip install --prefix=<prefix> para fornecer um alvo garden install amigável para embalagens.
As versões anteriores do Git Cola podem ter enviado sem vcruntime140.dll e não podem ser executadas em máquinas que estão perdendo essa DLL.
Para corrigir isso, faça o download do Microsoft Visual C ++ 2015 Redistributable e instale -o
Git Cola v4.0.0 e mais recente incluem esta DLL e não exigem que isso seja instalado separadamente.
Para desenvolver o Git Cola no Windows, você precisará instalar o Python3 e o PIP. Instale o PYQT5 usando pip install PyQt5 para disponibilizar as ligações PYQT5 ao Python.
Depois que estes forem instalados, você pode usar python.exe para executar diretamente da árvore de origem. Por exemplo, de um terminal Git Bash:
/c/Python39/python.exe ./bin/git-cola
Se você tiver várias versões do Python instalado, o script contrib/win32/cola Launcher poderá escolher a versão mais recente em vez do Python que possui o PYQT instalado. Para resolver isso, você pode definir a variável de configuração Git cola.pythonlocation para informar a Cola onde encontrar o Python. Por exemplo:
git config --global cola.pythonlocation /c/Python39
Os instaladores do Windows são construídos usando
Pynsist.
NSIS também é necessário.
Para construir o instalador usando Pynsist Run:
./contrib/win32/run-pynsist.sh
Isso gerará um instalador no build/nsis/ .
Pode ser necessário configurar seu navegador de histórico se estiver atualizando a partir de uma versão mais antiga do Git Cola no Windows.
gitk era originalmente o navegador histórico padrão, mas gitk não pode ser lançado como está no Windows porque gitk é um script de shell.
Se você estiver configurado para usar gitk , altere sua configuração para passar pelo sh.exe do Git no Windows. Da mesma forma, devemos passar pelo python.exe se quisermos usar git-dag .
Se você deseja usar o GITK como seu navegador de histórico, abre a tela Preferências e altere o comando History Browser para:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
git-dag se tornou o navegador histórico padrão no Windows na v2.3 , para que novos usuários não precisem configurar nada.
