Реализация Git на Java

Это проект реализации системы контроля версий Git на чистом Java.

Проект лицензирован под лицензией EDL (Eclipse Distribution License).

JGit можно импортировать прямо в Eclipse и выполнить сборку и тестирование оттуда. Проект также может быть собран с помощью командной строки с использованием Maven или Bazel. Автоматизированные сборки используют Maven и выполняются на Jenkins.

• org.eclipse.jgit

  Библиотека на чистом Java, способная работать самостоятельно без использования дополнительных библиотек. Она предоставляет классы для чтения и записи репозитория Git и работы с рабочими директориями.

  Все части JGit покрываются лицензией EDL. В этом пакете абсолютно не принимаются вклады под лицензиями GPL, LGPL или EPL.

• org.eclipse.jgit.ant

  Задачи для Apache Ant, основанные на JGit.

• org.eclipse.jgit.archive

  Поддержка экспорта в различные архивные форматы (zip и т.д.).

• org.eclipse.jgit.http.apache

  Поддержка Apache HttpClient.

• org.eclipse.jgit.http.server

  Сервер для умного и простого HTTP протокола Git.

• org.eclipse.jgit.lfs

  Поддержка LFS (Large File Storage).

• org.eclipse.jgit.lfs.server

  Основная поддержка сервера LFS.

• org.eclipse.jgit.packaging

  Создание Eclipse функций и репозитория p2 для JGit. Узнайте больше о том, зачем и как использовать этот модуль, на страницах JGit Wiki.- org.eclipse.jgit.pgm

  Интерфейс командной строки Git, реализованный с помощью JGit ("pgm" означает программу).

• org.eclipse.jgit.ssh.apache

  Клиентская поддержка протокола SSH на основе Apache Mina sshd.

• org.eclipse.jgit.ui

  Простое графическое окружение для отображения журнала Git.

Тестирование - org.eclipse.jgit.junit, org.eclipse.jgit.junit.http,

org.eclipse.jgit.junit.ssh: Помощники для юнит-тестирования

• org.eclipse.jgit.ant.test: Юнит-тесты для org.eclipse.jgit.ant
• org.eclipse.jgit.http.test: Юнит-тесты для org.eclipse.jgit.http.server
• org.eclipse.jgit.lfs.server.test: Юнит-тесты для org.eclipse.jgit.lfs.server
• org.eclipse.jgit.lfs.test: Юнит-тесты для org.eclipse.jgit.lfs
• org.eclipse.jgit.pgm.test: Юнит-тесты для org.eclipse.jgit.pgm
• org.eclipse.jgit.ssh.apache.test: Юнит-тесты для org.eclipse.jgit.ssh.apache
• org.eclipse.jgit.test: Юнит-тесты для org.eclipse.jgit

Предупреждения/Ограничения

• Поддержка нативных символьных ссылок зависит от того, поддерживает ли файловая система такие ссылки. Для Windows требуется использовать учетную запись, которая не является администраторской, а также иметь разрешение SeCreateSymbolicLinkPrivilege.

• В случае, если индекс загрязнён, JGit использует только метку времени индекса.

• JGit требует хотя бы JDK версии 8.

• Преобразование CRLF выполняется в зависимости от значения core.autocrlf. Однако Git для Windows по умолчанию хранит это значение во время установки в системном конфигурационном файле. Если Git не установлен, используйте глобальную или репозиторий конфигурацию для настройки core.autocrlf.- Конфигурационный файл системы расположен относительно места установки C Git. Убедитесь, что Git доступен через переменную окружения PATH. При установке Git для Windows выберите опцию "Запустить Git из командной строки Windows". Есть другие варианты, такие как настройки Eclipse, которые можно использовать для указания местоположения C Git. Изменение PATH рекомендуется, если C Git установлен.

• Мы стараемся использовать ту же нотацию для $HOME, которую использует C Git. На Windows этот путь часто отличается от значения системного свойства user.home.- org.eclipse.jgit

  • Чтение разрозненных и упакованных коммитов, деревьев, бинарных блоков, включая объекты с применением дельта-кодирования.
  • Чтение объектов из общих репозиториев.
  • Запись разрозненных коммитов, деревьев, бинарных блоков.
  • Запись бинарных блоков из локальных файлов или Java InputStreams.
  • Чтение бинарных блоков как Java InputStreams.
  • Копирование деревьев в локальные директории или из локальных директорий в деревья.
  • Ленивое загрузочное чтение объектов при необходимости.
  • Чтение и запись файлов .git/config.
  • Создание нового репозитория.
  • Чтение и запись ref'ов, включая прохождение через symref'ы.
  • Чтение, обновление и запись индекса Git.

• Выполнение checkout в загрязненной рабочей директории, если это возможно.

• Прохождение истории начиная с указанного набора коммитов в поисках коммитов, вводящих изменения в файлы под определенным путем.

• Объектный транспорт Получение данных через SSH, Git, HTTP, Amazon S3 и пакеты. Отправка данных через SSH, Git и Amazon S3. JGit пока не использует дельта-кодирование отправленных пакетов, поэтому они могут быть значительно больше по размеру, чем пакеты C Git.

• Очистка мусора

• Объединение

• Переопределение

• И многое другое — org.eclipse.jgit.pgm

• Набор различных утилит командной строки. В основном для случайного тестирования jgit лог, глог, фетч и т. д.

• org.eclipse.jgit.ant

  • Задачи Ant

• org.eclipse.jgit.archive

  • Поддержка форматов Zip/Tar и других

• org.eclipse.http

  • Поддержка HTTP-клиента и сервера

Отсутствующие возможности

Существуют некоторые отсутствующие возможности:

• проверка подписанных коммитов
• подпись тегов
• подпись отправки

Поддержка

Задайте вопросы, сделайте замечания или начните обсуждение на почтовый список jgit-dev@eclipse.org. Для публикаций вам необходимо быть подписанным. Отправьте ошибки и запросы на улучшения в Bugzilla.

Вклад

Узнайте больше в руководстве участника EGit.

О Git

Более подробную информацию о Git, его формате репозитория и канонической реализации на C можно найти на веб-сайте Git.