aepack — Преобразование между переменными Python и контейнерами данных AppleEvent

Модуль aepack определяет функции для преобразования (упаковки) переменных Python в дескрипторы AppleEvent и обратно (распаковки). Внутри Python дескриптор AppleEvent обрабатывается объектами Python встроенного типа AEDesc, определённого в модуле Carbon.AE.

Модуль aepack определяет следующие функции:

aepack.pack(x[, forcetype])

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

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

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

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

aepack.unpack(x[, formodulename])

x должен быть объектом типа AEDesc. Эта функция возвращает представление объекта Python данных в дескрипторе Apple Event x. Простые типы данных AppleEvent (целое число, текст, вещественное число) возвращаются как соответствующие им объекты Python. Списки Apple Event возвращаются как списки Python, а элементы списка распаковываются рекурсивно. Ссылочные объекты (например, line 3 of document 1) возвращаются как экземпляры aetypes.ObjectSpecifier, если не указан параметр formodulename. Дескрипторы AppleEvent с типом дескриптора typeFSS возвращаются как объекты FSSpec. Дескрипторы записей AppleEvent возвращаются как словари Python, с ключами из четырёх символов и рекурсивной распаковкой элементов.

Необязательный параметр formodulename используется модулями-заглушками, сгенерированными с помощью gensuitemodule, и гарантирует, что классы OSA для указателей на объекты подгружаются из правильного модуля. Это обеспечивает, что, например, если Finder возвращает указатель на объект окна, вы получите экземпляр Finder.Window, а не общий экземпляр aetypes.Window. Первый знает обо всех свойствах и элементах окна в Finder, тогда как второй — нет.