`aepack.md`

55 строк · 5.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.6/library/aepack.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 37.3. `aepack` – Преобразование между переменными Python и контейнерами данных AppleEvent89*Платформы:* Mac1011Модуль `aepack` определяет функции для преобразования (упаковки) переменных Python в дескрипторы AppleEvent и обратно (распаковки). В Python дескриптор AppleEvent представляется объектами встроенного типа `AEDesc`, определённого в модуле [`Carbon.AE`](https://python-all.ru/2.6/library/carbon.html#module-Carbon.AE).1213> **Примечание**14>15> Этот модуль был удалён в Python 3.x.1617Модуль `aepack` определяет следующие функции:1819#### `aepack.pack(x[, forcetype])`2021Возвращает объект `AEDesc`, содержащий преобразование значения Python x. Если указан *forcetype*, он задаёт тип дескриптора результата. В противном случае используется стандартное отображение типов Python в типы дескрипторов Apple Event, как показано ниже:2223| Тип Python | тип дескриптора |24| --- | --- |25| `FSSpec` | typeFSS |26| `FSRef` | typeFSRef |27| `Alias` | typeAlias |28| целое число | typeLong (32-битное целое) |29| float | typeFloat (64-битное число с плавающей запятой) |30| строка | typeText |31| unicode | typeUnicodeText |32| список | typeAEList |33| словарь | typeAERecord |34| экземпляр | *см. ниже* |3536Если *x* является экземпляром Python, то эта функция пытается вызвать метод `__aepack__()`. Этот метод должен возвращать объект `AEDesc`.3738Если преобразование *x* не определено выше, эта функция возвращает строковое представление значения в Python (функция repr()), закодированное как текстовый дескриптор.3940#### `aepack.unpack(x[, formodulename])`4142*x* должен быть объектом типа `AEDesc`. Эта функция возвращает представление данных из дескриптора AppleEvent *x* в виде объекта Python. Простые типы данных AppleEvent (целое, текст, число с плавающей запятой) возвращаются в очевидных для Python типах. Списки AppleEvent возвращаются как списки Python, элементы списка рекурсивно распаковываются. Ссылки на объекты (например, `строка 3 из документа 1`) возвращаются как экземпляры [`aetypes.ObjectSpecifier`](https://python-all.ru/2.6/library/aetypes.html#aetypes.ObjectSpecifier), если не указан `formodulename`. Дескрипторы AppleEvent с типом дескриптора typeFSS возвращаются как объекты `FSSpec`. Дескрипторы записей AppleEvent возвращаются как словари Python с четырёхсимвольными строковыми ключами и рекурсивно распакованными элементами.4344Необязательный аргумент `formodulename` используется заглушечными пакетами, сгенерированными [`gensuitemodule`](https://python-all.ru/2.6/library/gensuitemodule.html#module-gensuitemodule), и гарантирует, что классы OSA для спецификаторов объектов ищутся в правильном модуле. Это гарантирует, что если, например, Finder возвращает спецификатор объекта для окна, вы получите экземпляр `Finder.Window`, а не общий `aetypes.Window`. Первый знает обо всех свойствах и элементах, которые есть у окна в Finder, тогда как второй ничего такого не знает.4546> **См. также**47>48> **Модуль [`Carbon.AE`](https://python-all.ru/2.6/library/carbon.html#module-Carbon.AE)**49>50> Встроенный доступ к процедурам Apple Event Manager.51>52> **Модуль [`aetypes`](https://python-all.ru/2.6/library/aetypes.html#module-aetypes)**53>54> Определения Python для кодов типов дескрипторов Apple Event.55