git-svn-helpers

Git-SVN-помічники є колекція інструментів командного рядка, який значно спрощує допомогою Git репозиторіїв SVN.
Основна мета GIT-SVN-хелперів тому, щоб зробити створення локального репозиторія Git після існуючого SVN перевірки "їжаку зрозуміло".
У ньому також розглядаються за допомогою одного Git-SVN репозиторій для роботи на кількох касових частини (як правило) різних галузей і перемикатися між ними.
Основи використання (приклад)
Керуюче резюме:
> CD шлях / до / SVN / РЕПО
> Gitify
Ось приклад сеансу:
> CD / TMP
> SVN зі https://svn.plone.org/svn/plone/plone.app.form/branches/1.1 plone.app.form
1,1 / setup.py
...
Перевірений 27228 перегляду.
> CD plone.app.form
> Gitify
Ні репозиторій знаходиться в /Users/tomster/.gitcache/.
Ініціювання клонування в кеш.
Аналізуючи лог SVN ...
Клонування https://svn.plone.org/svn/plone/plone.app.form/ з r10593: 27155 в /Users/tomster/.gitcache/
Initialized сховище порожньо Git в /Users/tomster/.gitcache/plone.app.form/.git/
...
Git гілка 'місний / 1.1' тепер слід SVN філії "1,1":
# На гілці місцевий / 1.1
нічого не зробити (робочий каталог чистої)
> Git філія
* Місцевий / 1.1
І NBSP; майстер
Зауваження:
І NBSP; * gitify обмежується клонування до перегляду знайдених в SVN лог кореня пакета (тут https://svn.plone.org/svn/plone/plone.app.form/). Значно економити час, особливо на великих сховищ (наприклад, plone.collective)
І NBSP; * gitify створив репозиторій на ~ / .gitcache не стоїть на місці
І NBSP; * gitify створено місцеве відділення місцевої / 1,1, що слід (дистанційний) SVN філія 1,1 і переключився на нього
Кілька реєстрація від'їзду
На практиці ви будете часто працювати з різними локальними копіями даного сховища, тобто на стовбурі і на художньому відділенні. Ось коли каталог .gitcache, створений раніше знадобиться. Давайте рухатися наш попередній перевірку в сторону і створити технічне обслуговування перевірку, що слід стовбур:
> CD ..
> MkDir функція-філія
> MV plone.app.form функція-філія /
> Обслуговування MkDir
> Обслуговування кд /
> SVN зі https://svn.plone.org/svn/plone/plone.app.form/trunk plone.app.form
Plone.app.form / setup.py
...
І NBSP; U plone.app.form
Перевірений 27228 перегляду.
Що станеться, якщо ми запустимо gitify тут?:
> CD plone.app.form /
> Gitify
Git гілка 'місний / багажник "тепер слід SVN гілка' стовбур ':
# На гілці місний / багажника
нічого не зробити (робочий каталог чистої)
Зверніть увагу, що ця операція пішла набагато швидше, оскільки тепер ми використовували існуючий репозиторій Git в каталозі кеша. Це може бути також свідчить, дивлячись на доступні місцевих відділень Зараз:
> Git філія
І NBSP; місцеві / 1,1
* Місцевий / багажник
І NBSP; майстер
Попередження
.git «Рециркуляція» таким чином працює (як це не дивно) добре працює на практиці, але ви повинні тримати на увазі наступне:
Всі витягів і той же індекс!
Давайте поглянемо на те, що це означає, шляхом перемикання назад в наш відгалуження:
> CD ../../feature-branch/plone.app.form/
> Стан Git
# На гілці місний / багажника
# Змінилося, але не оновлюється:
# (Використання "Git додати / RM ...", щоб оновити те, що буде скоєно)
# (Використання "Git замовлення - ...", щоб скасувати зміни до робочої директорії)
#
# Внесено зміни: документи / History.txt
...
# Вилучений: Plone / додаток / форма / KSS / тести / test_kss.py
...
#
# Неотслежіваемих файли:
# (Використання "Git додати ...", щоб включити в те, що буде скоєно)
#
# Plone / додаток / форма / тести / test_kss.py
Wohah! Те, що сталося, що .git тепер вказує на стовбур і, таким чином, команда стану показує різницю між цим і нашої галузі у вигляді локальних змін, так як це те, що являє файлова система. Ми можемо перевірити це за допомогою команди стану диверсії:
> SVN вул

Уф! Все гаразд! Але що робити з Git? Ми закінчили роботу над стовбуром і хочете повернутися до нашої відгалуження, але індекс Git це все неправда?! Просто: повторно запустити gitify:
> Gitify
Git гілка 'місний / 1.1' тепер слід SVN філії "1,1":
# На гілці місцевий / 1.1
нічого не зробити (робочий каталог чистої)
В принципі, це все, що вам потрібно пам'ятати при роботі з декількома контрольно-аутів одного пакету: Завжди запускати gitify при перемиканні між контрольно-аутів

Що нового У цьому випуску

• канонічних сховище в даний час в https://github.com/collective. [Rossp]
• Fix обробку при переході на SVN гілки, Git вже має місцеве відділення для. [Rossp]

Що нового у версії 0.8:

• Зробити команда ініціалізації слідувати, якщо сховище SVN був перейшов на іншу гілку. Завдяки Калвін Хендрікс Паркер за повідомлення про проблему. [Tomster]

Що нового у версії 0.7:

• Використовувати повні копії замість символічних посилань для створення робочих копій. Це дозволяє уникнути питання про проведення ШКТ і SVN репозиторій з синхронізації при роботі з декількома копіями одного і того ж сховища і значно знижує ризик виникнення конфліктів.
• Це також означає, що команда вибірки тепер працює тільки в кеші, не змінюючи робочу копію (що робить його безпечним для запуску за допомогою кронтаб, наприклад)
• Запуск gitify проти робочої копії старого стилю буде видавати помилку. Просте видалення символічного посилання і повторний запуск gitify кошти, які, однак.
• Інший ефект, є те, що команда ініціалізації зараз потрібно тільки один раз для кожного робочої копії (це вже не потрібно повторно запустити команду після перемикання між різними робочими копіями одного і того ж сховища).
• gitify тому більше не має значення за замовчуванням в команду ініціалізації (як не Git, ні SVN зробити що-небудь без подачі явний дія). Крім того, він був перейменований з gitify (на задній панелі), щоб ініціалізувати. [Tomster]
• Дозволити допомогу, --version і принести команди для запуску поза папок .svn [Tomster]

Що нового у версії 0.5:

• Додана команда gitify оновлення, який виконує Git-SVN перебазуватися Робота для поточного SVN перевірки, але також займається непідтверджені локальні зміни gracelully (на відміну від мерзотника SVN, але, як SVN робить)
• більше не використовувати модуль ведення журналу для зворотного зв'язку з користувачем. Ця ідея була досить хибним

Що нового у версії 0.4:

• реструктурировать точки входу, щоб просто використовувати gitify. Всі інші команди тепер суб-команди gitify:
• GS-фіксації була замінена gitify натисканням
• GS-вибірки була замінена gitify принести
• Додана використання та допомога вихід для кожної команди.
• Вилучено точку входу GS-клон, як це було тільки коли-небудь використовували разом з основним gitify команди в кожному разі.
• Використовуйте належні реєстрацію, а не просто друк на стандартний висновок
• Додана всебічні випробування, в тому числі функціональних тестів, які охоплюють весь оновлення / зробити цикл клонування репозиторію SVN і здійснювали повернутися до нього.

Що нового у версії 0.3.1:

• Виправлення: Чи не використовувати користувальницькі псевдоніми, як вони не можуть бути встановлені. Це вирішує http://github.com/tomster/git-svn-helpers/issues#issue/2
• Виправлення: явно перерахувати ElementTree як залежність Це вирішує http://github.com/tomster/git-svn-helpers/issues#issue/1)

Що нового у версії 0.3 Beta:

• Додана команда, яка допомагає зобов'язує назад в GS-зобов'язання SVN і тримати Git і SVN в синхронізації

Що нового у версії 0.2 Beta:

• Додана команда, яка допомагає тримати кеш GS-вибірки до сучасних

Вимоги

• Python