`mhlib.md`

154 строк · 6.6 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/library/mhlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 18.5. [`mhlib`](https://python-all.ru/2.7/library/mhlib.html#module-mhlib) – Доступ к почтовым ящикам MH89Устарело с версии 2.6: Модуль [`mhlib`](https://python-all.ru/2.7/library/mhlib.html#module-mhlib) удалён в Python 3. Вместо него используйте [`mailbox`](https://python-all.ru/2.7/library/mailbox.html#module-mailbox).1011Модуль [`mhlib`](https://python-all.ru/2.7/library/mhlib.html#module-mhlib) предоставляет интерфейс Python для работы с папками MH и их содержимым.1213Модуль содержит три основных класса: [`MH`](https://python-all.ru/2.7/library/mhlib.html#mhlib.MH), представляющий определённую коллекцию папок; [`Folder`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Folder), представляющий отдельную папку; и [`Message`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Message), представляющий отдельное сообщение.1415#### `class mhlib.MH([path[, profile]])`1617[`MH`](https://python-all.ru/2.7/library/mhlib.html#mhlib.MH) представляет коллекцию папок MH.1819#### `class mhlib.Folder(mh, name)`2021Класс [`Folder`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Folder) представляет отдельную папку и её сообщения.2223#### `class mhlib.Message(folder, number[, name])`2425Объекты [`Message`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Message) представляют отдельные сообщения в папке. Класс Message наследуется от [`mimetools.Message`](https://python-all.ru/2.7/library/mimetools.html#mimetools.Message).2627## 18.5.1. Объекты MH2829Экземпляры [`MH`](https://python-all.ru/2.7/library/mhlib.html#mhlib.MH) имеют следующие методы:3031#### `MH.error(format[, ...])`3233Выводит сообщение об ошибке – можно переопределить.3435#### `MH.getprofile(key)`3637Возвращает запись профиля (`None`, если не задана).3839#### `MH.getpath()`4041Возвращает путь к почтовому ящику.4243#### `MH.getcontext()`4445Возвращает имя текущей папки.4647#### `MH.setcontext(name)`4849Устанавливает имя текущей папки.5051#### `MH.listfolders()`5253Возвращает список папок верхнего уровня.5455#### `MH.listallfolders()`5657Возвращает список всех папок.5859#### `MH.listsubfolders(name)`6061Возвращает список прямых подпапок указанной папки.6263#### `MH.listallsubfolders(name)`6465Возвращает список всех подпапок указанной папки.6667#### `MH.makefolder(name)`6869Создаёт новую папку.7071#### `MH.deletefolder(name)`7273Удаляет папку – не должно быть подпапок.7475#### `MH.openfolder(name)`7677Возвращает новый открытый объект папки.7879## 18.5.2. Объекты папок8081Экземпляры [`Folder`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Folder) представляют открытые папки и имеют следующие методы:8283#### `Folder.error(format[, ...])`8485Выводит сообщение об ошибке – можно переопределить.8687#### `Folder.getfullname()`8889Возвращает полный путь к папке.9091#### `Folder.getsequencesfilename()`9293Возвращает полный путь к файлу последовательностей папки.9495#### `Folder.getmessagefilename(n)`9697Возвращает полный путь к сообщению *n* из папки.9899#### `Folder.listmessages()`100101Возвращает список сообщений в папке (в виде чисел).102103#### `Folder.getcurrent()`104105Возвращает номер текущего сообщения.106107#### `Folder.setcurrent(n)`108109Устанавливает номер текущего сообщения в *n*.110111#### `Folder.parsesequence(seq)`112113Разбирает синтаксис msgs в список сообщений.114115#### `Folder.getlast()`116117Возвращает последнее сообщение или `0`, если в папке нет сообщений.118119#### `Folder.setlast(n)`120121Устанавливает последнее сообщение (только для внутреннего использования).122123#### `Folder.getsequences()`124125Возвращает словарь последовательностей в папке. Имена последовательностей используются в качестве ключей, а значения представляют собой списки номеров сообщений в этих последовательностях.126127#### `Folder.putsequences(dict)`128129Возвращает словарь последовательностей в папке: список.130131#### `Folder.removemessages(list)`132133Удаляет сообщения, указанные в списке, из папки.134135#### `Folder.refilemessages(list, tofolder)`136137Перемещает сообщения из списка в другую папку.138139#### `Folder.movemessage(n, tofolder, ton)`140141Перемещает одно сообщение в заданный пункт назначения в другой папке.142143#### `Folder.copymessage(n, tofolder, ton)`144145Копирует одно сообщение в заданный пункт назначения в другой папке.146147## 18.5.3. Объекты сообщений148149Класс [`Message`](https://python-all.ru/2.7/library/mhlib.html#mhlib.Message) добавляет один метод к методам [`mimetools.Message`](https://python-all.ru/2.7/library/mimetools.html#mimetools.Message):150151#### `Message.openmessage(n)`152153Возвращает новый открытый объект сообщения (занимает файловый дескриптор).154