# Gusgit: cli для связывания карточек Trello с коммитами git

### Read in [EN](/README.md)

## Почему gusgit?

Во время командной работы в Trello порой возникает потребность систематизировать названия коммитов и веток, а так же привязывать их непосредственно к карточкам для Code Review.

Gusgit автоматизирует вышеперечисленные процессы.

## Установка

    sudo npm i -g gusgit

## Использование

    gusgit branch <branch>        

Создает git-ветку с названием "T\<number>". \<branch> - это либо ссылка на Trello, либо название ветки в формате "T\<number>".

    gusgit rebase [<from>]        
    
Компанует набор коммитов из текущей ветки в один. \<from> - это название ветки, относительно которой должна произойти компановка. По умолчанию \<from> = master.

    gusgit land [<to>]            
    
Мержит текущую ветку с веткой \<to>, удаляет ее и добавляет ссылку на коммит в карточку Trello, к которой была прикреплена ветка. По умолчанию \<to> = master.

## Конфигурация

Для корректной работы cli в проекте необходимо чтобы внутри него находился конфиг с названием **gusgit.config.json**.

## Формат конфига
    {
      "appkey": <API ключ Trello>,
      "token": <API токен пользователя Trello>,
      "boardId": <ID доски Trello>,
      "repository": <Ссылка на git-репозиторий>
    }

### * Получить API ключ и токен Trello можно по ссылке: https://trello.com/app-key

### * ID доски содержится в ссылке на доску, которая, как правило, отображается в следующем формате: https://trello.com/b/<ID доски>/<Название проект>

    Например: https://trello.com/b/XtVBJIta/gusgit

### * В данный момент поддерживаются только ссылки на github и bitbucket