Gittyup

Gittyup

Gittyup - это графический клиент GIT, предназначенный для того, чтобы помочь вам понять и управлять историей исходного кода. Последний стабильный релиз доступен либо в виде предварительно построенного Flatpak для Linux, 32/64 Binary для Windows, MacOS, или может быть построен из источника, следуя указаниям ниже.

Последняя версия для разработки также доступна и предварительно построена.

Gittyup - это продолжение клиента Gitahead.

Оглавление

• Функции
• Как получить помощь
• Построить окружающую среду
• Зависимости
• Как построить
• Как установить
  • Flatpak от терминала
• Как внести свой вклад
• Лицензия

Функции

Чтобы получить обзор текущих функций, посмотрите на страницу GitHub

Как получить помощь

Задайте вопросы о построении или использовании Gittyup на переполнении стека, включив тег gittyup . Не забудьте искать существующие вопросы, прежде чем создавать новый.

Сообщите об ошибках в Gittyup, открыв проблему в трекере выпуска. Не забудьте искать существующие проблемы, прежде чем создавать новый.

Если вам все еще нужна помощь, ознакомьтесь с нашим матричным каналом Gittyup: Matrix.org.

Построить окружающую среду

• C ++ 11 компилятор
  • Windows - MSVC> = 2017 Рекомендуется
  • Linux - GCC> = 6,2 рекомендуется
  • macos - xcode> = 10.1 Рекомендуется
• Cmake> = 3.3.1
• Ниндзя (необязательно)

Зависимости

Внешние зависимости могут быть удовлетворены системными библиотеками или установлены отдельно. Включенные зависимости являются подмодулями этого репозитория. Некоторые подмодули являются необязательными или также могут быть удовлетворены системными библиотеками.

Внешние зависимости

• Qt (обязательно> = 5,12)

Включены зависимости

• libgit2 (требуется)
• cmark (требуется)
• git (необходимый только для помощников по учете)
• Libssh2 (необходимый libgit2 для поддержки SSH)
• openssl (необходимый libssh2 и libgit2 на некоторых платформах)

Обратите внимание, что здание OpenSSL в Windows требует Perl и NASM .

Как построить

Инициализировать подмодули

 git submodule init
git submodule update --depth 1

Построить 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 (яблочный кремний)

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

Linux:

 ./config -fPIC
make

Настройка сборки

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

Если у вас установлен QT в нестандартном месте, вам, возможно, придется указать путь к QT, передавая -DCMAKE_PREFIX_PATH=<path-to-qt> , где <path-to-qt> указывает на каталог установки QT, который содержит bin , lib и т. Д.

Строить

    ninja

Удобный сценарий оболочки для Ubuntu доступен здесь и установит все необходимые предпосылки и создаст версию релиза для немедленного использования.

Как установить

Linux

Самый простой способ установить gittyup - это использовать Flatpak.

Arch Linux

Установите пакет gittyup из репозитория пользователя Arch.

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

Или используйте помощника AUR. Установите gittyup-git для сборки VCS.

Mac OS

Домашний

Установите бочку gittyup от Homebrew.

 brew install gittyup

Flatpak от терминала

Если вы хотите более чистого использования консоли, этот скрипт запускает версию Flatpak от отречения от процесса и замолчала вывод, подталкивая его /dev /null. Просто сохраните скрипт где -нибудь на своем пути, например, /usr/bin (или ~/.local/bin если вы его экспортировали), дайте разрешения на выполнение chmod +x и запустите gittyup из вашего терминала.

 #! /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

Как внести свой вклад

Мы приветствуем вклад всех видов, включая исправления ошибок, новые функции, документацию и переводы. Внеся свой вклад, вы соглашаетесь выпустить свои взносы в соответствии с условиями лицензии.

Внести свой вклад, следуя типичному рабочему процессу GitHub для запросов на привлечение. Разбейте репозиторий и внесите изменения в новом названном филиале. Создать запросы на тягу против master ветви. Следуйте семи рекомендациям по написанию отличного послания коммита.

До совершения изменения, пожалуйста, используйте cl-fmt.sh , чтобы убедиться, что ваш код придерживается форматирования конвенций для этого проекта. Вы также можете использовать скрипт setup-env.sh , чтобы установить крюк с предварительной коммитацией, который автоматически запускает clang-format против всех измененных файлов.

Перед тем, как изменить изменение, убедитесь, что вы запустите модульные тесты, чтобы избежать каких -либо регрессий. Они найдены в <build-dir>/test и могут быть запущены с помощью ctest .

Лицензия

Gittyup и его предшественник Gitahead лицензированы по лицензии MIT. Смотрите License.md для деталей.