Реализация 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.ssh.apache.agent

  Дополнительная поддержка SSH агентов для org.eclipse.jgit.ssh.apache.

• 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 6.0 и выше требуют хотя бы Java 11. Более старые версии требуют хотя бы Java 1.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, HTTP и Amazon S3. JGit пока не применяет дельту к отправленным пакетам, поэтому они могут быть значительно больше по размеру, чем пакеты C Git.

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

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

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

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

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

• org.eclipse.jgit.ant

  • Задачи для Apache Ant

• org.eclipse.jgit.archive

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

• org.eclipse.jgit.http

  • Поддержка клиентских и серверных запросов HTTP

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

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

• Подписывание пушей
• Мелкие и частичные клонирования
• Поддержка удалённых помощников
• Поддержка помощников для учетных данных
• Поддержка нескольких рабочих деревьев (git-worktree)
• Использование внешних средств сравнения
• Поддержка сертификатов клиента для HTTPS
• Объектные идентификаторы SHA-256
• Протокол Git версии 2 (клиентская сторона): packfile-uris
• Многопаковый индекс
• Разделённый индекс

Поддержка

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

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

О Git

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