mailcap — Обработка файлов mailcap

Исходный код: Lib/mailcap.py

Файлы mailcap используются для настройки того, как приложения, учитывающие MIME-типы, такие как почтовые клиенты и веб-браузеры, реагируют на файлы с различными MIME-типами. (Название «mailcap» происходит от фразы «mail capability».) Например, файл mailcap может содержать строку, подобную video/mpeg; xmpeg %s. Затем, если пользователь столкнётся с электронным письмом или веб-документом с MIME-типом video/mpeg, %s будет заменён именем файла (обычно именем временного файла), и программа xmpeg может быть автоматически запущена для просмотра файла.

Формат mailcap описан в RFC 1524, «A User Agent Configuration Mechanism For Multimedia Mail Format Information», но не является интернет-стандартом. Однако файлы mailcap поддерживаются на большинстве Unix-систем.

mailcap.findmatch(caps, MIMEtype, key='view', filename='/dev/null', plist=[])

Возвращает кортеж из 2 элементов; первый элемент — строка, содержащая командную строку для выполнения (которую можно передать в os.system()), а второй элемент — запись mailcap для данного MIME-типа. Если соответствующий MIME-тип не найден, возвращается (None, None).

key — имя желаемого поля, которое представляет собой тип выполняемого действия; значение по умолчанию — ‘view’, так как в большинстве случаев вам просто нужно просмотреть тело данных MIME-типа. Другие возможные значения могут быть ‘compose’ и ‘edit’, если вы хотите создать новый документ данного MIME-типа или изменить существующие данные тела. См. RFC 1524 для полного списка этих полей.

filename — имя файла, которое будет подставлено вместо %s в командной строке; значение по умолчанию — '/dev/null', что, скорее всего, не то, что вам нужно, поэтому вы обычно переопределите его, указав имя файла.

plist может быть списком, содержащим именованные параметры; значение по умолчанию — пустой список. Каждый элемент списка должен быть строкой, содержащей имя параметра, знак равенства ('=') и значение параметра. Записи mailcap могут содержать именованные параметры, такие как %{foo}, которые будут заменены значением параметра с именем ‘foo’. Например, если командная строка showpartial %{id} %{number} %{total} была в файле mailcap, а plist был установлен на ['id=1', 'number=2', 'total=3'], результирующая командная строка будет 'showpartial 1 2 3'.

В файле mailcap поле «test» может быть указано для проверки некоторого внешнего условия (например, архитектуры машины или используемой оконной системы), чтобы определить, применяется ли строка mailcap. findmatch() автоматически проверит такие условия и пропустит запись, если проверка завершится неудачно.

mailcap.getcaps()

Возвращает словарь, сопоставляющий MIME-типы со списком записей файлов mailcap. Этот словарь должен быть передан функции findmatch(). Запись хранится в виде списка словарей, но знать подробности этого представления не обязательно.

Информация извлекается из всех файлов mailcap, найденных в системе. Настройки в файле mailcap пользователя $HOME/.mailcap будут переопределять настройки в системных файлах mailcap /etc/mailcap, /usr/etc/mailcap, и /usr/local/etc/mailcap.

Пример использования:

>>> import mailcap
>>> d = mailcap.getcaps()
>>> mailcap.findmatch(d, 'video/mpeg', filename='tmp1223')
('xmpeg tmp1223', {'view': 'xmpeg %s'})