Gear/gear-import

Материал из ALT Linux Wiki

Утилита gear-import

Цель

Эта высокоуровневая утилита предназначена для импортирования в репозиторий исходников из tar-архивов (или из другого формата архива). Архивы добавляются одним коммитом и выставляется тэг по версии архива. Дата коммита и тега соответствует дате модификации архива.

Зачем?

Утилита может быть полезна:

  • Импортирование истории проекта из архивов (не из srpm-пакетов);
  • Обновление репозитория из архива проекта.

В отличии от gear-update эта утилита импортирует архивы, угадывая его имя и версию по названию файла.

Как работает?

Утилита gear-import использует набор правил для разбора имени файла на компоненты: имя проекта и версию. Вы можете создать файл с правилами, специфичными для вашего проекта.

Есть три способа указать файл с правилами:

  • Передать имя файла через аргументы утилиты;
  • Определить переменную IMPORT_RULES;
  • Определить параметр gear.import.rules в конфигурации репозитория.

Правила разбора имени архива

Правила в файле записываются блоками директив. Каждый блок описывает разбор какого-либо имени файла. Если в rules-файле описано несколько блоков правил, то они применяются к имени архива сверку вниз до тех пор пока не удастся получить имя проекта и версию.

Правила имеют вид:

<directive>: <value>

Строки начинающиеся с символа "#" считаются комментариями.

Основной обязательной директивой является "pattern". Она определяет регулярное выражение (extended posix regexp), которое разбирает имя архива.