git-imap-send

git-imap-send — отправка набора патчей из stdin в папку IMAP

Эта команда загружает почтовый ящик, созданный с помощью git format-patch, в папку черновиков IMAP. Это позволяет отправлять патчи так же, как и другие письма, при использовании почтовых клиентов, которые не могут напрямую читать файлы почтовых ящиков. Команда также работает с любым обычным почтовым ящиком, в котором письма содержат поля From, Date и Subject именно в таком порядке.

Обычно её используют примерно так:

$ git format-patch --signoff --stdout --attach origin | git imap-send

Чтобы использовать эту утилиту, параметр imap.folder и либо imap.tunnel, либо imap.host должны иметь соответствующие значения.

Содержимое этой секции до данной строки не включено из документации git-config[1]. Далее приведено то же содержимое, что и в ней:

Чтобы отправить письмо в определённую папку, нужно знать её точное имя в почтовом ящике. Названия вроде «Junk», «Trash» и т. п., отображаемые разными почтовыми клиентами, не обязательно совпадают с фактическими именами папок, хранящихся на почтовом сервере вашего провайдера.

Чтобы узнать правильное имя папки для использования с git imap-send, выполните команду git imap-send --list. Она выведет список допустимых имён папок. Пример такого вывода для учётной записи Gmail:

* LIST (\HasNoChildren) "/" "INBOX"
* LIST (\HasChildren \Noselect) "/" "[Gmail]"
* LIST (\All \HasNoChildren) "/" "[Gmail]/All Mail"
* LIST (\Drafts \HasNoChildren) "/" "[Gmail]/Drafts"
* LIST (\HasNoChildren \Important) "/" "[Gmail]/Important"
* LIST (\HasNoChildren \Sent) "/" "[Gmail]/Sent Mail"
* LIST (\HasNoChildren \Junk) "/" "[Gmail]/Spam"
* LIST (\Flagged \HasNoChildren) "/" "[Gmail]/Starred"
* LIST (\HasNoChildren \Trash) "/" "[Gmail]/Trash"

Здесь видно, что правильное имя папки «Junk» — [Gmail]/Spam, а папки «Trash» — [Gmail]/Trash. Аналогичным образом можно определить имена и других папок.

Использование режима туннеля:

[imap]
    folder = "INBOX.Drafts"
    tunnel = "ssh -q -C user@example.com /usr/bin/imapd ./Maildir 2> /dev/null"

Использование прямого режима:

[imap]
    folder = "INBOX.Drafts"
    host = imap://imap.example.com
    user = bob
    pass = p4ssw0rd

Использование прямого режима с SSL:

[imap]
    folder = "INBOX.Drafts"
    host = imaps://imap.example.com
    user = bob
    pass = p4ssw0rd
    port = 123
    ; sslVerify = false

Использование интерфейса IMAP Gmail:

[imap]
    folder = "[Gmail]/Drafts"
    host = imaps://imap.gmail.com
    user = user@gmail.com
    port = 993

Gmail не позволяет использовать обычный пароль для git imap-send. Если для вашей учётной записи Gmail настроена многофакторная аутентификация, вы можете создать пароль приложения для использования с git imap-send. Создайте его на странице https://security.google.com/settings/security/apppasswords. Также можно использовать аутентификацию OAuth2.0, описанную ниже.

Для аутентификации на основе OAuth2.0 можно указать в конфигурации механизм OAUTHBEARER или XOAUTH2. Он безопаснее паролей приложений и не требует включения многофакторной аутентификации. При использовании этого способа аутентификации вместо пароля необходимо указать токен доступа OAuth2.0.

[imap]
    folder = "[Gmail]/Drafts"
    host = imaps://imap.gmail.com
    user = user@gmail.com
    port = 993
    authmethod = OAUTHBEARER

Использование интерфейса IMAP Outlook:

В отличие от Gmail, Outlook поддерживает только аутентификацию на основе OAuth2.0. Кроме того, в качестве механизма поддерживается только XOAUTH2.

[imap]
    folder = "Drafts"
    host = imaps://outlook.office365.com
    user = user@outlook.com
    port = 993
    authmethod = XOAUTH2

Когда коммиты будут готовы к отправке, выполните следующую команду:

$ git format-patch --cover-letter -M --stdout origin/master | git imap-send

Не забудьте отключить перенос строк в почтовом клиенте (веб-интерфейс Gmail будет переносить строки в любом случае, поэтому необходимо использовать полноценный клиент IMAP).

Если вы используете аутентификацию OAuth2.0, для создания токенов удобнее воспользоваться помощниками для учётных данных. Помощники для учётных данных, рекомендованные в git-send-email[1], можно использовать и для git imap-send.

Вы по-прежнему несёте ответственность за то, чтобы письмо, отправленное вашей почтовой программой, соответствовало стандартам вашего проекта. Многие проекты не приветствуют патчи во вложениях. Некоторые почтовые агенты преобразуют патчи (например, переносят строки или отправляют их в формате format=flowed) так, что патчи становятся непригодными. Если вы это не проверите, вас подвергнут резкой критике.

Известно, что Thunderbird особенно проблематичен. Пользователям Thunderbird стоит посетить эту веб-страницу, чтобы узнать больше: https://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email

git-format-patch[1], git-send-email[1], mbox(5)