Setup and Config

• git
• config
• help
• bugreport
• Credential helpers

Getting and Creating Projects

• init
• clone

Basic Snapshotting

• add
• status
• diff
• commit
• notes
• restore
• reset
• rm
• mv

Branching and Merging

• branch
• checkout
• switch
• merge
• mergetool
• log
• stash
• tag
• worktree

Sharing and Updating Projects

• fetch
• pull
• push
• remote
• submodule

Inspection and Comparison

• show
• log
• diff
• difftool
• range-diff
• shortlog
• describe

Patching

• apply
• cherry-pick
• diff
• rebase
• revert

Debugging

• bisect
• blame
• grep

Email

• am
• apply
• imap-send
• format-patch
• send-email
• request-pull

External Systems

• svn
• fast-import

Server Admin

• daemon
• update-server-info

Guides

• gitattributes
• Command-line interface conventions
• Everyday Git
• Frequently Asked Questions (FAQ)
• Glossary
• Hooks
• gitignore
• gitmodules
• Revisions
• Submodules
• Tutorial
• Workflows
• All guides...

Administration

• clean
• gc
• fsck
• reflog
• filter-branch
• instaweb
• archive
• bundle

Plumbing Commands

• cat-file
• check-ignore
• checkout-index
• commit-tree
• count-objects
• diff-index
• for-each-ref
• hash-object
• ls-files
• ls-tree
• merge-base
• read-tree
• rev-list
• rev-parse
• show-ref
• symbolic-ref
• update-index
• update-ref
• verify-pack
• write-tree

git-imap-send — Отправить коллекцию патчей из стандартного ввода в папку IMAP

git imap-send [-v] [-q] [--[no-]curl] [(--folder|-f) <папка>]
git imap-send --list

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

Типичное использование выглядит примерно так:

-v

--verbose

Быть многословнее.

-q

--quiet

Тихий режим.

-f <папка>

--folder=<папка>

Указывает папку, в которой должны быть сохранены письма. Например: --folder=[Gmail]/Drafts или -f INBOX/Drafts.

--curl

Использовать libcurl для связи с сервером IMAP, если не используется туннель. Игнорируется, если Git был собран без установленного параметра USE_CURL_FOR_IMAP_SEND.

--no-curl

Общаться с сервером IMAP, используя собственные процедуры IMAP git вместо libcurl. Игнорируется, если Git был собран с установленным параметром NO_OPENSSL.

--list

Выполнить команду IMAP LIST, чтобы вывести список всех существующих папок.

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

Дальнейшее содержание этого раздела (в отличие от того, что было описано до данной строки), повторяет то, что можно найти в документации git-config[1]:

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

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

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

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

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

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

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

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

Если вы хотите использовать аутентификацию на основе OAuth2.0, вы можете указать механизм OAUTHBEARER или XOAUTH2 в своей конфигурации. Это более безопасно, чем использование паролей для конкретных приложений, а также не требует наличия многофакторной аутентификации. Вам нужно будет использовать токен доступа OAuth2.0 вместо вашего пароля при использовании этой аутентификации.

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

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

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

Просто убедитесь, что вы отключили перенос строк в почтовом клиенте (веб-интерфейс 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)

Является частью пакета git[1]