[devel] I: gear new utility

[devel] I: gear new utility

[Alexey Gladkov]

Приветствую!

Я закончил дорабатывать новую утилиту (пока только под себя) - gear-merge. 
Думаю она готова к основной ветке. Дим, как будет у тебя время смердж её 
в основную ветку.

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

Основная задача утилиты -- это слияние (merge) нескольких бранчей в 
один результирующий master-бранч, из которого можно собирать пакет.

Собственно пример использования:

[legion ash]$ git-branch 
* master
  patch/add-losetup
  patch/cleanup-warnings
  patch/fix-gcc-warnings
  patch/use-cflags
  upstream

[legion ash]$ cat .gear/merge 
merge: upstream               message="Merge upstream sources"
merge: patch/add-losetup      message="Apply patch 'add-losetup'"
merge: patch/cleanup-warnings message="Apply patch 'cleanup-warnings'"
merge: patch/fix-gcc-warnings message="Apply patch 'fix-gcc-warnings'"
merge: patch/use-cflags       message="Apply patch 'use-cflags'"

Результатом будет бранч (master) в котором будут слиты исходники и патчи
из отдельных веток.

Или так, если предпочитаете держать патчи не приложенными:

[legion ash]$ cat .gear/merge 
merge: upstream               message="Merge upstream sources"
gendiff: patch/add-losetup      master name=dash-alt-add-losetup.patch
gendiff: patch/cleanup-warnings master name=dash-alt-cleanup-warnings.patch
gendiff: patch/fix-gcc-warnings master name=dash-alt-fix-gcc-warnings.patch
gendiff: patch/use-cflags       master name=dash-alt-use-cflags.diff

Нечто подобное есть в git.alt:/people/vsu/packages/kernel-build-scripts.git
под названием merge-all-branches. Некоторые идеи были взяты оттуда.

С добавлением этой утилиты появится ещё один способ организовать
репозиторий (по крайней мере для меня).

http://git.altlinux.org/people/legion/packages/gear.git?p=gear.git;a=shortlog;h=legion/gear-merge

P.S. Дим, даю копию в devel@.

-- 
Rgrds, legion

Re: [devel] I: gear new utility

[Damir Shayhutdinov]

> Эта утилита может помочь, если вы предполагаете хранить оригинальные
> исходники, патчи на них и метафайлы, требующиеся для сборки, в
> отдельных бранчах.
>
> Основная задача утилиты -- это слияние (merge) нескольких бранчей в
> один результирующий master-бранч, из которого можно собирать пакет.

Я написал для себя нечто подобное, с помощью которого веду репозиторий KoLmafia.

У меня тоже есть файл, в котором перечисляется что куда мержить.

Только у меня merge идет по тегам.

Сначала идет тег на апстрим (upstream-tip), потом этот тег мержится в
первую ветку (branch1), накладывается (перемещается) новый тег
(branch1-tip).
Полученный тег branch1-tip мержится в branch2, ставится (перемещается)
тег branch2-tip. И т.д. Последний тег branchN-tip мержится в master.

Такая схема (с перемещающимися тегами) позволяет не менять содержимое
.gear-rules. После запуска этой утилиты достаточно выполнить
gear-update-tag -ac, подправить версию в спеке, закоммитить и собрать
пакет.

Утилита запускается с параметром, означающим "причину обновления". В
моем случае это либо обновление до версии апстрима - KoLmafia-X.Y,
либо до версии из svn - svnXXXX. Из этой причины составляется
аннотация тегов. У тега на ветку upstream (upstream-tip) в аннотация
указывается эта причина. А у тега на ветки branchN (branchN-tip) в
аннотации указывается "Updated to <причина>".

В целом ИМХО получается достаточно прилично. Автоматическая подгонка
патчей производится за пару секунд.

Вот текст этого маленького скрипта, если кому интересно:


$ cat /home/damir/bin/update-branches
8<---------------------------------------
#!/bin/bash

# This script updates and merges all patch-branches in some order


UPDATE_BRANCHES=$(<.git/update-branches)

REASON="$1"

if [ -z "$REASON" ];
then
        echo "Usage: update-branches <reason>"
        exit 1
fi

PREV=
for branch in $UPDATE_BRANCHES
do
        if [ -z "$PREV" ]; then
                git-tag -f -m "$REASON" -s "$branch-tip" "refs/heads/$branch"
        else
                git-checkout -f "$branch"
                git-merge "$PREV-tip" || exit 1
                git-tag -f -m "Updated to $REASON" -s "$branch-tip"
"refs/heads/$branch"
        fi
        PREV="$branch"
done

git-checkout -f master
git-merge "$PREV-tip"
8<------------------------------------------

При этом содержимое .git/update-branches вот такое:

cat /home/damir/ALTLinux/KoLmafia/.git/update-branches
upstream
equipment-fixes
pvp-fixes
price-limit
monsters-info

Результат работы можно посмотреть на
http://git.altlinux.org/people/damir/packages/KoLmafia.git

Re: [devel] I: gear new utility

[Alexey Gladkov]

Damir Shayhutdinov wrote:
> У меня тоже есть файл, в котором перечисляется что куда мержить.
> 
> Только у меня merge идет по тегам.

Для merge по тэгам у нас есть gear-update-tag, но это не всегда годится.

> Такая схема (с перемещающимися тегами) позволяет не менять содержимое
> .gear-rules. После запуска этой утилиты достаточно выполнить
> gear-update-tag -ac, подправить версию в спеке, закоммитить и собрать
> пакет.

Для новой утилиты должны быть свои правила: .gear/merge.

-- 
Rgrds, legion

Re: [devel] I: gear new utility

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 468 bytes --]

* Alexey Gladkov <legion@> [071106 15:30]:
> Основная задача утилиты -- это слияние (merge) нескольких бранчей в 
> один результирующий master-бранч, из которого можно собирать пакет.
А оно у тебя как мержит?  Все по очереди в master, или upstream
-> patch-a -> patch-b -> master ?

-- 
Regards, Alexey I. Froloff
AIF5-RIPN, AIF5-RIPE
-------------------------------------------
  Inform-Mobil, Ltd. System Administrator
       http://www.inform-mobil.ru/

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] I: gear new utility

[Alexey Gladkov]

Alexey I. Froloff wrote:
> * Alexey Gladkov <legion@> [071106 15:30]:
>> Основная задача утилиты -- это слияние (merge) нескольких бранчей в 
>> один результирующий master-бранч, из которого можно собирать пакет.
> А оно у тебя как мержит?  Все по очереди в master, или upstream
> -> patch-a -> patch-b -> master ?

В порядке указанном в gear/merge т.е. в правилках.

-- 
Rgrds, legion

Re: [devel] I: gear new utility

[Alexey Gladkov]

Alexey I. Froloff wrote:
> * Alexey Gladkov <legion@> [071106 15:30]:
>> Основная задача утилиты -- это слияние (merge) нескольких бранчей в 
>> один результирующий master-бранч, из которого можно собирать пакет.
> А оно у тебя как мержит?  Все по очереди в master, или upstream
> -> patch-a -> patch-b -> master ?

По очереди в master

-- 
Rgrds, legion

Re: [devel] I: gear new utility

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 547 bytes --]

* Alexey Gladkov <legion@> [071106 16:46]:
> >> Основная задача утилиты -- это слияние (merge) нескольких бранчей в 
> >> один результирующий master-бранч, из которого можно собирать пакет.
> > А оно у тебя как мержит?  Все по очереди в master, или upstream
> > -> patch-a -> patch-b -> master ?
> По очереди в master
Понятно.  К сожалению мимо меня пройдёт.

-- 
Regards, Alexey I. Froloff
AIF5-RIPN, AIF5-RIPE
-------------------------------------------
  Inform-Mobil, Ltd. System Administrator
       http://www.inform-mobil.ru/

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] I: gear new utility

[Alexey Gladkov]

Alexey I. Froloff wrote:
> Понятно.  К сожалению мимо меня пройдёт.

А тебе нужно чтобы можно было делать вторую схему ?

Если да, то опиши подробнее пожалуйста. Я на эту тему тоже думал, но
задач таких у меня нет, поэтому не реализовал.

-- 
Rgrds, legion

Re: [devel] I: gear new utility

[@ 2007-11-06 14:40 UTC (permalink / raw)]

Re: [devel] I: gear new utility

[@ 2007-11-06 20:17 UTC (permalink / raw)]

Re: [devel] I: gear new utility

[@ 2007-11-11 23:21 UTC (permalink / raw)]