aetools — Поддержка клиента OSA

Модуль aetools содержит основную функциональность, на которой построена поддержка Python AppleScript-клиента. Он также импортирует и повторно экспортирует основную функциональность модулей aetypes и aepack. Сгенерированные модулем gensuitemodule заглушки пакетов импортируют соответствующие части модуля aetools, поэтому обычно вам не нужно импортировать его самостоятельно. Исключением является случай, когда вы не можете использовать сгенерированный пакет suite и нуждаетесь в доступе к более низкому уровню программирования.

Сам модуль aetools использует поддержку AppleEvent, предоставляемую модулем Carbon.AE. Это имеет один недостаток: вам нужен доступ к диспетчеру окон, см. раздел Запуск скриптов с графическим интерфейсом для получения подробностей. Это ограничение может быть снято в будущих версиях.

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

aetools.packevent(ae, parameters, attributes)

Хранит параметры и атрибуты в предварительно созданном объекте Carbon.AE.AEDesc. parameters и attributes являются словарями, сопоставляющими ключи параметров OSA длиной 4 символа с объектами Python. Объекты упаковываются с помощью aepack.pack().

aetools.unpackevent(ae[, formodulename])

Рекурсивно распаковывает событие Carbon.AE.AEDesc в объекты Python. Функция возвращает словарь параметров и словарь атрибутов. Аргумент formodulename используется сгенерированными пакетами заглушек для управления тем, где ищутся классы AppleScript.

aetools.keysubst(arguments, keydict)

Преобразует словарь аргументов ключевых слов Python arguments в формат, требуемый packevent, заменяя ключи, которые являются идентификаторами Python, на ключи OSA длиной 4 символа в соответствии с отображением, указанным в keydict.

aetools.enumsubst(arguments, key, edict)

Если словарь arguments содержит запись для key, преобразует значение этой записи в соответствии со словарем edict. Это преобразует имена перечислений Python, понятные человеку, в 4-символьные коды OSA. Используется сгенерированными пакетами заглушек.

Модуль aetools определяет следующие классы:

class aetools.TalkTo([signature=None, start=0, timeout=0])

Базовый класс для прокси, используемого для связи с приложением. signature переопределяет атрибут класса _signature (который обычно устанавливается подклассами) и является 4-символьным кодом создателя, определяющим приложение, с которым нужно общаться. start можно установить в значение true, чтобы включить запуск приложения при создании экземпляра класса. timeout можно указать, чтобы изменить значение таймаута по умолчанию, используемого при ожидании ответа AppleEvent.

TalkTo._start()

Проверяет, запущено ли приложение, и пытается запустить его, если нет.

TalkTo.send(code, subcode[, parameters, attributes])

Создает AppleEvent Carbon.AE.AEDesc для глагола с обозначением OSA code, subcode (которые обычно являются строками из 4 символов), упаковывает parameters и attributes в него, отправляет его целевому приложению, ожидает ответа, распаковывает ответ с помощью unpackevent и возвращает ответ appleevent, распакованные возвращаемые значения в виде словаря и атрибуты возврата.