git cola
v4.10.1
Git Cola es una poderosa GUI GIT con una interfaz de usuario elegante e intuitiva.
git clone https://github.com/git-cola/git-cola.git
Capturas de pantalla
Descargas
Atajos de teclado
Documentación HTML
Documentación de git cola
Documentación de git dag
Pautas contribuyentes
Git 2.2.0 o más nuevo.
Python 3.6 o más nuevo.
QTPY 2.0.0 o más nuevo.
Git Cola usa QTPY, por lo que puede elegir entre Pyqt6, Pyqt5 y Pyside2 estableciendo la variable QT_API en pyqt6 , pyqt5 o pyside2 como se desea. qtpy es predeterminado a pyqt5 y vuelve a pyqt6 y pyside2 si no está instalado pyqt5 .
Se deben instalar cualquiera de las siguientes bibliotecas Python QT:
Se requiere pyqt5 / pyqt6 5.9 o más nuevo. Qt 6.2 o más nuevo también se admite a través de QTPY.
Pyside2 5.12.0 o más nuevo.
Git Cola permite características adicionales cuando se instalan los siguientes módulos de Python.
Send2Trash habilita la funcionalidad de la plataforma cruzada "Enviar a la basura". (fuente)
Notify2 habilita la entrega de notificaciones de escritorio. (fuente)
PYOBJC habilita temas de aplicación específicos de macOS en macOS. (fuente)
Hay varias formas de instalar git cola, pero no necesita "instalar" git cola para ejecutarlo.
Git Cola está diseñado para funcionar directamente desde su árbol fuente. La instalación es opcional.
El enfoque recomendado para ejecutar la última versión de Git Cola es instalar sus dependencias PYQT utilizando el Administrador de paquetes de su distribución y luego ejecutar ./bin/git-cola directamente desde la fuente.
Git Cola funciona con PYQT5 o PYQT6 porque utiliza la biblioteca QTPY para la compatibilidad de Pyqt.
Los usuarios de la nueva versión de Debian/Ubuntu pueden instalar un solo paquete para ejecutar desde la fuente.
sudo apt install python3-qtpy Si está en una versión anterior que no tiene python3-qtpy disponible, puede instalar los siguientes paquetes directamente.
sudo apt install python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtwebengine python3-pyqt5.qtsvgSi desea usar Git Cola con el nuevo ecosistema PYQT6, puede instalar estos paquetes en lugar de PYQT5.
sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qtwebengine En este punto, debería poder lanzar ./bin/git-cola desde el árbol de origen y no hay nada más que hacer.
Las instrucciones adicionales a continuación detallan cómo instalar Git Cola de Pypi o cómo instalarlo en una ubicación separada del árbol de origen.
¡Linux lo es! Tu distribución probablemente ya haya empaquetado git-cola . Si no es así, presente un error contra su distribución ;-)
Disponible en el aur.
apt install git-cola
dnf install git-cola
emerge git-cola
zypper install git-cola
Disponible en SlackBuilds.org.
Vea aquí las versiones que están disponibles en los repositorios de 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 ejecute pip install o garden install fuera de un Python Virtualenv o como Root!
IMPORTANTE : Si está en distribuciones de Linux donde PYQT6 o PYQT5 están disponibles en su Administrador de paquetes, se recomienda instalar esas dependencias utilizando el Administrador de paquetes de su sistema. Consulte la sección de arriba para más detalles.
Una forma de instalar la última versión lanzada es usar venv (VirtualEnv) y pip . Esto instala Git-Cola de Pypi.org.
python3 -m venv --system-site-packages env3
./env3/bin/pip install git-cola
./env3/bin/git-cola
Agregue el directorio env3/bin a su PATH o enlace simbólico a bin/git-cola desde algún lugar de su PATH , como ~/.local/bin/git-cola , y puede iniciar git cola como cualquier otro comando git incorporado:
git cola
git dag
Si no tiene instalado PYQT, la forma más fácil de conseguirlo es usar un Python VirtualEnv e instalar Git Cola en el modo "Editable".
Este método de instalación le permite actualizar Git Cola ejecutando 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
Si agrega env3/bin (o enlace simbólico a env3/bin/git-cola ) en algún lugar de su $PATH , puede ejecutar git cola como si fuera un comando git Builtin desde fuera del virtualenv (por ejemplo, después de ejecutar "desactivar" o al abrir un nuevo caparazón).
Running garden -D prefix=$HOME/.local install Install Git Cola en su directorio $HOME/.local ( $HOME/.local/bin/git-cola , $HOME/.local/lib , etc.).
Este método de instalación supone que las dependencias qtpy y PyQt* se han preinstalado.
La receta del jardín también es compatible con DESTDIR para admitir la creación de paquetes para los administradores de paquetes de Linux:
garden -D DESTDIR=/tmp/stage -D prefix=/usr/local install
Si no tiene garden disponible, entonces make puede usar. Makefile admite instalaciones escenificadas utilizando las variables de Destdir y prefijo convencionales.
make DESTDIR=/tmp/stage prefix=/usr/local install
Para la mayoría de los usuarios finales, recomendamos usar Homebrew o instalar en un Python VirtualEnv como se describió anteriormente.
Puede instalar Git Cola desde la fuente utilizando los mismos pasos que anteriormente.
Una manera fácil de instalar git cola es usar casería casera. Use Homebrew para instalar la receta Git-Cola:
brew install git-cola
Si instala usando HomeBrew, puede detenerse en este paso. No necesitas clonar el repositorio ni nada.
Si tiene todas las dependencias instaladas, ya sea a través de pip o brew , puede construir un shell git-cola.app de envoltura de paquetes para usar en /Applications .
Si desea construir un paquete git-cola.app para /Applications Ejecute este comando:
garden macos/app
Deberá reconstruir periódicamente el envoltorio de aplicaciones cada vez que se actualice Python.
La actualización de los macOS a menudo puede romper el software gestionado por el homebrew.
Si actualiza MacOS y Git Cola deja de funcionar, entonces probablemente necesite reinstalar las dependencias de Git Cola.
Reinstalar desde cero el uso de las instrucciones a continuación puede volver a poner las cosas en forma.
brew update
brew uninstall git-cola
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove
brew install git-cola
Importante si tiene una máquina de 64 bits, instale solo las versiones de 64 bits. No mezcle versiones de 32 bits y 64 bits.
Descargue e instale lo siguiente:
Git para Windows
Git cola
Una vez que se instalen, puede ejecutar Git Cola desde el menú de inicio.
Consulte "Windows (continuación)" a continuación para obtener más detalles.
Si desea instalar Git Cola con Winget, ejecute el siguiente comando:
winget install git-cola.git-cola
Como no hay una resolución de dependencia, pero también debe instalar GIT con:
winget install Git.Git
Git Cola se envía con un editor interactivo de Rebase llamado git-cola-sequence-editor . git-cola-sequence-editor se usa para reordenar y elegir compromisos al rebotar. Comience una rebase interactiva a través del menú "Rebase", o a través del subcomcomando git cola rebase para usar el git-cola-sequence-editor :
git cola rebase @{upstream}
git-cola-sequence-editor se puede lanzar independientemente de Git Cola diciéndole git rebase que lo use como su editor a través de la variable de entorno GIT_SEQUENCE_EDITOR :
export GIT_SEQUENCE_EDITOR="$HOME/git-cola/bin/git-cola-sequence-editor"
git rebase -i @{upstream}
Los scripts de finalización de shell están disponibles para Bash y ZSH. Cada script contiene instrucciones sobre cómo instalar y activar las terminaciones.
Script de finalización de Bash
Script de finalización de ZSH
El comando git-cola expone varios subcomcomandos que le permiten iniciar rápidamente herramientas que están disponibles desde la interfaz Git-Cola. Por ejemplo, git cola find inicia el buscador de archivos, y git cola grep inicia la herramienta GREP.
Consulte git cola --help-commands para la 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
Si ya tiene las dependencias de Git Cola instaladas, puede iniciar cola como módulo Python si tiene el código fuente disponible.
python -m cola
python -m cola dag
Los siguientes comandos deben ejecutarse durante el desarrollo:
# Run the unit tests
$ garden test
# Run tests and doc checks
$ garden check
# Run tests against multiple python interpreters using tox
$ garden tox
El conjunto de pruebas se puede encontrar en el directorio de prueba.
Las solicitudes de compromiso y extracción se prueban automáticamente para la calidad del código utilizando acciones GitHub.
Archivos Auto-Format cola/i18n/*.po antes de comprometerse al actualizar las traducciones:
$ garden po
Al enviar parches, consulte las pautas contribuyentes.
Git Cola instala sus módulos en el directorio predeterminado de Python Site-Packages (por ejemplo lib/python3.7/site-packages ) utilizando SetupTools.
Mientras que los usuarios finales pueden usar pip install git-cola para instalar Git Cola, los empacadores de distribución deben usar el proceso garden -D prefix=/usr install . Git Cola's Garden Recipe envuelve pip install --prefix=<prefix> Para proporcionar un objetivo garden install con el paquete.
Las versiones anteriores de Git Cola pueden haberse enviado sin vcruntime140.dll y no pueden funcionar en máquinas que les faltan esta DLL.
Para solucionar esto, descargue el Redistributable Microsoft Visual C ++ 2015 e instálelo
Git Cola V4.0.0 y Newer incluyen esta DLL y no requieren que esto se instale por separado.
Para desarrollar Git Cola en Windows, deberá instalar Python3 y PIP. Instale PYQT5 usando pip install PyQt5 para que las enlaces PYQT5 estén disponibles para Python.
Una vez que se instalen, puede usar python.exe para ejecutar directamente desde el árbol de origen. Por ejemplo, de un terminal de Bash Git:
/c/Python39/python.exe ./bin/git-cola
Si tiene múltiples versiones de Python instaladas, el script contrib/win32/cola Launcher podría elegir la versión más nueva en lugar del Python que tiene Pyqt instalado. Para resolver esto, puede establecer la variable de configuración Git cola.pythonlocation para decirle a Cola dónde encontrar Python. Por ejemplo:
git config --global cola.pythonlocation /c/Python39
Los instaladores de Windows están construidos usando
Pynsist.
NSIS también es necesario.
Para construir el instalador con Pynsist Run:
./contrib/win32/run-pynsist.sh
Esto generará un instalador en build/nsis/ .
Es posible que deba configurar su navegador de historial si está actualizando desde una versión anterior de Git Cola en Windows.
Originalmente, gitk era el navegador de historial predeterminado, pero gitk no se puede iniciar como está en Windows porque gitk es un script de shell.
Si está configurado para usar gitk , cambie su configuración para pasar por Git's sh.exe en Windows. Del mismo modo, debemos pasar por python.exe si queremos usar git-dag .
Si desea usar GITK mientras su navegador History, abra la pantalla Preferencias y cambie el comando History Browser a:
"C:/Program Files/Git/bin/sh.exe" --login -i C:/Git/bin/gitk
git-dag se convirtió en el navegador de historial predeterminado en Windows en v2.3 , por lo que los nuevos usuarios no necesitan configurar nada.
