Gear/gear-import: различия между версиями

Материал из ALT Linux Wiki
(Новая страница: «== Утилита gear-import == === Цель === Эта высокоуровневая утилита предназначена для импортировани...»)
 
Нет описания правки
 
Строка 36: Строка 36:
Основной обязательной директивой является "pattern". Она определяет регулярное выражение (extended posix regexp), которое разбирает имя архива.
Основной обязательной директивой является "pattern". Она определяет регулярное выражение (extended posix regexp), которое разбирает имя архива.


[[Категория:Gear]]
{{Category navigation|title=gear|category=gear|sortkey={{SUBPAGENAME}}}}

Текущая версия от 21:14, 16 июля 2015

Утилита gear-import

Цель

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

Зачем?

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

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

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

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

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

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

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

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

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

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

<directive>: <value>

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

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

gear