Gittyup

Gittyup

O Gittyup é um cliente GIT gráfico projetado para ajudá -lo a entender e gerenciar seu histórico de código -fonte. A versão estável mais recente está disponível como Flatpak pré-criada para Linux, 32/64 binário para Windows, MacOS, ou pode ser construído a partir da fonte seguindo as direções abaixo.

A versão mais recente de desenvolvimento também está disponível antes da criação.

Gittyup é uma continuação do cliente GitaHead.

Índice

• Características
• Como obter ajuda
• Construir ambiente
• Dependências
• Como construir
• Como instalar
  • Flatpak do terminal
• Como contribuir
• Licença

Características

Para obter uma visão geral dos recursos atuais, dê uma olhada na página do GitHub

Como obter ajuda

Faça perguntas sobre a construção ou o uso do GittyUp On Stack Overflow, incluindo a tag gittyup . Lembre -se de procurar perguntas existentes antes de criar uma nova.

Relatório Bugs em Gittyup abrindo um problema no rastreador de edição. Lembre -se de procurar problemas existentes antes de criar um novo.

Se você ainda precisar de ajuda, consulte nosso canal Matrix Gittyup: matrix.org.

Construir ambiente

• Compilador C ++ 11
  • Windows - MSVC> = 2017 recomendado
  • Linux - GCC> = 6.2 Recomendado
  • MacOS - Xcode> = 10.1 recomendado
• Cmake> = 3.3.1
• Ninja (opcional)

Dependências

As dependências externas podem ser satisfeitas por bibliotecas do sistema ou instaladas separadamente. As dependências incluídas são submódulos deste repositório. Alguns submódulos são opcionais ou também podem ser satisfeitos pelas bibliotecas do sistema.

Dependências externas

• Qt (necessário> = 5.12)

Dependências incluídas

• libgit2 (necessário)
• CMARK (necessário)
• Git (necessário apenas para os ajudantes de credenciais)
• libsh2 (necessário para libgit2 para suporte ssh)
• OpenSSL (necessário para libssh2 e libgit2 em algumas plataformas)

Observe que a construção OpenSSL no Windows requer Perl e NASM .

Como construir

Inicialize os submódulos

 git submodule init
git submodule update --depth 1

Build OpenSSL

 # Start from root of gittyup repo.
cd dep/openssl/openssl

Windows:

 perl Configure VC-WIN64A
nmake

MacOS (Intel):

 ./Configure darwin64-x86_64-cc no-shared
make

MacOS (Apple Silicon)

 ./Configure darwin64-arm64-cc no-shared
make

Linux:

 ./config -fPIC
make

Configure a construção

 # Start from root of gittyup repo.
mkdir -p build/release
cd build/release
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ../..

Se você tiver o QT instalado em um local fora do padrão, talvez seja necessário especificar o caminho para o QT, passando -DCMAKE_PREFIX_PATH=<path-to-qt> onde <path-to-qt> aponta para o diretório de instalação QT que contém bin , lib , etc.

Construir

    ninja

Um script de shell conveniente para o Ubuntu está disponível aqui e instalará todos os pré -requisitos necessários e criará uma versão de liberação para uso imediato.

Como instalar

Linux

A maneira mais fácil de instalar o Gittyup é usando o Flatpak.

Arch Linux

Instale o pacote gittyup no repositório de usuário do ARCH.

 git clone https://aur.archlinux.org/gittyup.git
cd gittyup
makepkg -si

Ou use um ajudante AUR. Instale gittyup-git para a construção do VCS.

Mac OS

Homebrew

Instale o barril gittyup da Homebrew.

 brew install gittyup

Flatpak do terminal

Se você deseja um uso mais puro do console, esta versão do Script Run Flatpak, que renove o processo e o silencia a saída, empurrando -o para /dev /null. Basta salvar o script em algum lugar do seu caminho, por exemplo /usr/bin (ou ~/.local/bin , se você o tiver exportado), dê permissões de execução chmod +x e execute gittyup do seu terminal.

 #! /bin/bash
DIR= $( dirname " ${BASH_SOURCE[0]} " )
function run_disown() {
    " $@ " & disown
}
function run_disown_silence(){
    run_disown " $@ " 1> /dev/null 2> /dev/null
}
run_disown_silence flatpak run com.github.Murmele.Gittyup

Como contribuir

Congratulamo -nos com contribuições de todos os tipos, incluindo correções de bugs, novos recursos, documentação e traduções. Ao contribuir, você concorda em divulgar suas contribuições nos termos da licença.

Contribua seguindo o fluxo de trabalho típico do GitHub para solicitações de tração. Fire o repositório e faça alterações em uma nova filial nomeada. Crie solicitações de tração contra a filial master . Siga as sete diretrizes para escrever uma ótima mensagem de confirmação.

Antes de cometer uma alteração, use cl-fmt.sh para garantir que seu código adere às convenções de formatação deste projeto. Você também pode usar o script setup-env.sh para instalar um gancho de pré-compromisso que executará automaticamente clang-format em todos os arquivos modificados.

Antes de promover uma mudança, verifique se você executa os testes de unidade para evitar regressões. Estes são encontrados em <build-dir>/test e podem ser executados usando ctest .

Licença

Gittyup e seu antecessor Gitahead estão licenciados sob a licença do MIT. Consulte License.md para obter detalhes.