Документация Python неофициальный перевод

37.2. MacOS – Доступ к функциям интерпретатора Mac OSMacOS – Access to Mac OS interpreter features

Этот модуль предоставляет доступ к специфическим для MacOS функциям интерпретатора Python, например, к работе цикла событий интерпретатора и подобным механизмам. Использовать с осторожностью.

Примечание

Этот модуль был удалён в Python 3.x.

Примечание: заглавная буква в имени модуля – исторический артефакт.

MacOS.runtimemodel

Всегда 'macho', начиная с Python 2.4. В более ранних версиях Python значение также могло быть 'ppc' для классической среды выполнения Mac OS 8 или 'carbon' для среды выполнения Mac OS 9.

MacOS.linkmodel

Способ, которым был слинкован интерпретатор. Поскольку расширения могут быть несовместимы между моделями линковки, пакеты могут использовать эту информацию для выдачи более понятных сообщений об ошибках. Значение может быть одним из следующих: 'static' для статически слинкованного Python, 'framework' для Python в фреймворке Mac OS X, 'shared' для Python в стандартной разделяемой библиотеке Unix. В старых версиях Python также могло быть значение 'cfm' для Python, совместимого с Mac OS 9.

exception MacOS.Error

Это исключение возникает при ошибках, порождаемых MacOS, либо из функций этого модуля, либо из других мак-специфичных модулей, таких как интерфейсы toolbox. Аргументами являются целочисленный код ошибки (значение OSErr) и текстовое описание кода ошибки. Символические имена для всех известных кодов ошибок определены в стандартном модуле macerrors.

MacOS.GetErrorString(errno)

Возвращает текстовое описание кода ошибки MacOS errno.

MacOS.DebugStr(message[, object])

В Mac OS X строка просто выводится в stderr (в более старых системах Mac OS была доступна более сложная функциональность), но это предоставляет удобное место для установки точки останова в низкоуровневом отладчике, таком как gdb.

Примечание

Недоступно в 64-битном режиме.

MacOS.SysBeep()

Воспроизвести звуковой сигнал.

Примечание

Недоступно в 64-битном режиме.

MacOS.GetTicks()

Возвращает количество тактов часов (1/60 секунды) с момента загрузки системы.

MacOS.GetCreatorAndType(file)

Возвращает создателя файла и тип файла в виде двух четырехсимвольных строк. Параметр file может быть именем пути или объектом FSSpec или FSRef.

Примечание

Невозможно использовать FSSpec в 64-битном режиме.

MacOS.SetCreatorAndType(file, creator, type)

Устанавливает создателя файла и тип файла. Параметр file может быть именем пути или объектом FSSpec или FSRef. creator и type должны быть четырехсимвольными строками.

Примечание

Невозможно использовать FSSpec в 64-битном режиме.

MacOS.openrf(name[, mode])

Открывает ресурсную ветвь файла. Аргументы такие же, как для встроенной функции open(). Возвращаемый объект имеет файлоподобную семантику, но не является файловым объектом Python, поэтому могут быть незначительные различия.

MacOS.WMAvailable()

Проверяет, имеет ли текущий процесс доступ к оконному менеджеру. Метод возвращает False, если оконный менеджер недоступен, например при работе на Mac OS X Server или при входе через ssh, или когда текущий интерпретатор запущен не из полноценного пакета приложения. Скрипт выполняется из пакета приложения, если он был запущен с помощью pythonw вместо python или если он работает как апплет.

MacOS.splash([resourceid])

Открывает заставку по идентификатору ресурса. Для закрытия заставки следует использовать resourceid 0.

Примечание

Недоступно в 64-битном режиме.