> **Источник:** https://python-all.ru/2.7/library/aepack.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 38.3. [`aepack`](https://python-all.ru/2.7/library/aepack.html#module-aepack) – Преобразование между переменными Python и контейнерами данных AppleEvent

Модуль [`aepack`](https://python-all.ru/2.7/library/aepack.html#module-aepack) определяет функции для преобразования (упаковки) переменных Python в дескрипторы AppleEvent и обратно (распаковки). В Python дескриптор AppleEvent представлен объектами встроенного типа `AEDesc`, определённого в модуле [`Carbon.AE`](https://python-all.ru/2.7/library/carbon.html#module-Carbon.AE).

> **Примечание**
>
> Этот модуль был удалён в Python 3.x.

Модуль [`aepack`](https://python-all.ru/2.7/library/aepack.html#module-aepack) определяет следующие функции:

#### `aepack.pack(x[, forcetype])`

Возвращает объект `AEDesc`, содержащий преобразование значения Python x. Если указан *forcetype*, он задаёт тип дескриптора результата. В противном случае используется отображение типов Python на типы дескрипторов Apple Event по умолчанию, как показано ниже:

| Тип Python | тип дескриптора |
| --- | --- |
| `FSSpec` | typeFSS |
| `FSRef` | typeFSRef |
| `Alias` | typeAlias |
| целое число | typeLong (32-битное целое) |
| float | typeFloat (64-битное число с плавающей запятой) |
| строка | typeText |
| unicode | typeUnicodeText |
| список | typeAEList |
| словарь | typeAERecord |
| экземпляр | *см. ниже* |

Если *x* является экземпляром Python, то эта функция пытается вызвать метод `__aepack__()`. Этот метод должен возвращать объект `AEDesc`.

Если преобразование *x* не определено выше, эта функция возвращает строковое представление значения в Python (функция repr()), закодированное как текстовый дескриптор.

#### `aepack.unpack(x[, formodulename])`

*x* должен быть объектом типа `AEDesc`. Эта функция возвращает представление данных из дескриптора Apple Event *x* в виде объекта Python. Простые типы данных AppleEvent (целое, текст, число с плавающей запятой) возвращаются как соответствующие типы Python. Списки Apple Event возвращаются как списки Python, а элементы списка рекурсивно распаковываются. Ссылки на объекты (например, `line 3 of document 1`) возвращаются как экземпляры [`aetypes.ObjectSpecifier`](https://python-all.ru/2.7/library/aetypes.html#aetypes.ObjectSpecifier), если не указан `formodulename`. Дескрипторы AppleEvent с типом дескриптора typeFSS возвращаются как объекты `FSSpec`. Дескрипторы записей AppleEvent возвращаются как словари Python с 4-символьными строковыми ключами и рекурсивно распакованными элементами.

Необязательный аргумент `formodulename` используется пакетами-заглушками, сгенерированными [`gensuitemodule`](https://python-all.ru/2.7/library/gensuitemodule.html#module-gensuitemodule), и гарантирует, что классы OSA для спецификаторов объектов будут найдены в правильном модуле. Это гарантирует, что если, скажем, Finder возвращает спецификатор объекта для окна, вы получите экземпляр `Finder.Window`, а не универсальный `aetypes.Window`. Первый знает обо всех свойствах и элементах, которые окно имеет в Finder, в то время как второй ничего такого не знает.

> **См. также**
>
> **Модуль [`Carbon.AE`](https://python-all.ru/2.7/library/carbon.html#module-Carbon.AE)**
>
> Встроенный доступ к процедурам Apple Event Manager.
>
> **Модуль [`aetypes`](https://python-all.ru/2.7/library/aetypes.html#module-aetypes)**
>
> Определения Python для кодов типов дескрипторов Apple Event.