gitui

GitUI oferece o conforto de uma GUI git, mas diretamente no seu terminal

Índice

1. Características
2. Motivação
3. Referências
4. Roteiro
5. Limitações
6. Instalação
7. Construir
8. Perguntas frequentes
9. Diagnóstico
10. Tema de cores
11. Associações de teclas
12. Patrocínio
13. Inspiração
14. Contribuindo
15. Colaboradores

1. ^{Principais recursos ▲}

• Controle rápido e intuitivo apenas pelo teclado
• Ajuda baseada em contexto ( não há necessidade de memorizar toneladas de teclas de atalho)
• Inspecione, confirme e altere alterações (incluindo ganchos: pre-commit , commit-msg , post-commit , prepare-commit-msg )
• Preparar, remover o preparo, reverter e redefinir arquivos, pedaços e linhas
• Stashing (salvar, abrir, aplicar, soltar e inspecionar)
• Empurrar/buscar para/do controle remoto
• Lista de filiais (criar, renomear, excluir, finalizar compra, controles remotos)
• Navegar/ Pesquisar log de commit, diferenças de alterações confirmadas
• UI de terminal responsivo
• API git assíncrona para controle fluido
• Suporte a submódulos
• assinatura de commit gpg com deficiências (veja #97))

2. Motivação ^{Superior ▲}

Eu faço a maior parte do meu trabalho git em um terminal, mas frequentemente me vejo usando GUIs git para alguns casos de uso como: index, commit, diff, stash, culpa e log.

Infelizmente, todas as GUIs git populares falham em repositórios gigantes ou deixam de responder e ficam inutilizáveis.

GitUI fornece a experiência do usuário e o conforto de uma GUI git, mas diretamente no seu terminal, ao mesmo tempo que é portátil, rápido, gratuito e de código aberto.

3. Referências ^{superiores ▲}

Para uma apresentação (slides) do encontro RustBerlin, comparei lazygit , tig e gitui analisando todo o repositório git do Linux (que contém mais de 900 mil commits):

	Tempo	Memória (GB)	Binário (MB)	Congela	Falhas
gitui	24s ✅	0,17 ✅	10	Não ✅	Não ✅
lazygit	57 segundos	2.6	25	Sim	Às vezes
tig	4m 20s	1.3	0,6 ✅	Às vezes	Não ✅

4. Estrada (mapa) para 1.0 ^{Topo ▲}

Estas são as metas de alto nível antes de anunciar 1.0 :

• visualize a estrutura de ramificação na guia log (#81)
• rebase interativo (#32)

5. Limitações Conhecidas ^{Superior ▲}

• nenhum suporte de repositório esparso (veja #1226)
• sem suporte para git-lfs (veja #1089)
• credential.helper para https precisa ser configurado explicitamente (veja #800)

Atualmente, esta ferramenta não substitui totalmente o git shell , porém ambas as ferramentas funcionam bem em conjunto.

As prioridades do gitui estão nos recursos que me deixam louco quando feitos no git shell , como stashing, staging lines ou hunks. Eventualmente, poderei trabalhar para tornar gitui uma solução completa - mas para isso preciso de ajuda - este é apenas um projeto de tempo livre por enquanto.

Todo apoio é bem-vindo! Patrocinadores também! ❤️

6. Instalação ^{superior ▲}

GitUI está em versão beta e pode conter bugs e recursos ausentes. No entanto, para uso pessoal é razoavelmente estável e está sendo usado enquanto se desenvolve.

Vários gerenciadores de pacotes

Instruções de instalação

Arco Linux

pacman -S gitui

Fedora

sudo dnf install gitui

Gentoo

Disponível em sobreposição dm9pZCAq

sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge dev-vcs/gitui::dm9pZCAq

openSUSE

sudo zypper install gitui

Homebrew (macOS)

brew install gitui

MacPorts (macOS)

port install gitui

Winget (Windows)

 winget install gitui

Colher (Windows)

 scoop install gitui

Chocolate (Windows)

 choco install gitui

Nix (Nix/NixOS)

Nixpkg

 nix-env -iA nixpkgs.gitui

NixOS

 nix-env -iA nixos.gitui

Termux (Android)

 pkg install gitui

Anaconda

 conda install -c conda-forge gitui

Liberar binários

Disponível para download em lançamentos

Binários disponíveis para:

Linux

• gitui-linux-x86_64.tar.gz (linux musl vinculado estaticamente)
• gitui-linux-aarch64.tar.gz (linux no braço de 64 bits)
• gitui-linux-arm.tar.gz
• gitui-linux-armv7.tar.gz

Todos contêm um único arquivo binário

macOS

• gitui-mac.tar.gz (arm64)
• gitui-mac-x86.tar.gz (intel x86)

Windows

• gitui-win.tar.gz (binário único de 64 bits)
• gitui-win.msi (pacote de instalação de 64 bits)

Construções noturnas

veja NOITES.md

7. Construir ^{Topo ▲}

Requisitos

• Versão mínima rust / cargo suportada: 1.70

  • Consulte Instalar Rust

• Para construir a dependência do openssl (consulte https://docs.rs/openssl/latest/openssl/)

  • perl >= 5.12 (strawberry perl funciona para windows https://strawberryperl.com/)
  • compilador ac (msvc, gcc ou clang, cargo irá encontrá-lo)

• Para executar o conjunto de testes completo, python é necessário (e deve ser invocável como python )

Instalação de carga

A maneira mais simples de começar a brincar com gitui é fazer com que cargo construa e instale-o com cargo install gitui --locked . Se você não está familiarizado com ferrugem e carga: Primeiros passos com ferrugem

Recursos de carga

rastreamento-libgit

ativar o rastreamento libgit2

funciona se libgit2 for construído com -DENABLE_TRACE=ON

este recurso habilitado por padrão, para desabilitar: cargo install --no-default-features

8. ^{Principais perguntas frequentes ▲}

veja a página de perguntas frequentes

9. Diagnóstico ^{superior ▲}

Para executar com o log ativado, execute gitui -l .

Isso registrará em:

• macOS: $HOME/Library/Caches/gitui/gitui.log
• Linux usando XDG : $XDG_CACHE_HOME/gitui/gitui.log
• Linux: $HOME/.cache/gitui/gitui.log
• Windows: %LOCALAPPDATA%/gitui/gitui.log

10. Tema de cores ^{superior ▲}

gitui deve funcionar automaticamente em temas de terminal claros e escuros.

Porém, você pode personalizar tudo ao seu gosto: Veja Temas.

11. Atalhos de Teclas ^{Superior ▲}

As combinações de teclas podem ser personalizadas: Consulte Key Config para saber como configurá-las para ligações do tipo vim .

12. Patrocínio ^{Superior ▲}

13. Inspiração ^{Superior ▲}

• preguiçoso
• tig
• GitUp
  • Seria bom encontrar uma maneira de disponibilizar a visualização do mapa em uma ferramenta de terminal
• brunch

14. ^{Principais Contribuições ▲}

Consulte CONTRIBUTING.md.

15. ^{Principais colaboradores ▲}

Obrigado a todos os contribuidores que ajudam a tornar o GitUI incrível! ❤️

Quer se tornar um co-mantenedor? Estamos procurando por você!