ic — Доступ к настройкам интернета Mac OS X

Этот модуль предоставляет доступ к различным настройкам, связанным с интернетом, установленным через Системные настройки или Finder.

Существует вспомогательный модуль нижнего уровня icglue, который предоставляет базовые функции доступа к настройкам интернета. Этот модуль нижнего уровня не документирован, но строки документации функций описывают параметры, а имена функций такие же, как в Pascal или C API для настройки интернета, поэтому для использования этого модуля можно использовать стандартную документацию по программированию IC.

Модуль ic определяет исключение error и символьные имена всех кодов ошибок, которые может генерировать настройка интернета; см. исходный код для получения подробностей.

exception ic.error

Исключение, генерируемое при ошибках в модуле ic.

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

class ic.IC([signature[, ic]])

Создаёт объект настройки интернета. Подпись — 4-символьный код создателя текущего приложения (по умолчанию 'Pyth'), который может повлиять на некоторые настройки IC. Необязательный аргумент ic — объект icglue.icinstance нижнего уровня, созданный предварительно; это может быть полезно, если вы хотите получить настройки из другого файла конфигурации и т. п.

ic.launchurl(url[, hint])

ic.parseurl(data[, start[, end[, hint]]])

ic.mapfile(file)

ic.maptypecreator(type, creator[, filename])

ic.settypecreator(file)

Эти функции являются «ярлыками» к методам с тем же именем, описанным ниже.

1. Объекты IC

IC объекты имеют интерфейс отображения, поэтому для получения адреса электронной почты достаточно получить ic['MailAddress']. Присваивание также работает и изменяет параметр в файле конфигурации.

Модуль знает о различных типах данных и преобразует внутреннее представление IC в логическую структуру данных Python. Запуск модуля ic автономно запустит тестовую программу, которая отобразит все ключи и значения в вашей базе данных IC. Эта программа должна служить документацией.

Если модуль не знает, как представить данные, он возвращает экземпляр типа ICOpaqueData, с исходными данными в его атрибуте data. Объекты этого типа также являются допустимыми значениями для присваивания.

Помимо интерфейса словаря, объекты IC имеют следующие методы:

IC.launchurl(url[, hint])

Парсит заданный URL, запускает соответствующее приложение и передаёт ему URL. Необязательный параметр hint может быть именем схемы, например 'mailto:', в этом случае неполные URL дополняются этой схемой. Если hint не указан, неполные URL являются недопустимыми.

IC.parseurl(data[, start[, end[, hint]]])

Находит URL где-то в data и возвращает начальную и конечную позиции и сам URL. Необязательные параметры start и end могут быть использованы для ограничения поиска, например, если пользователь нажимает в длинном текстовом поле, вы можете передать всё текстовое поле и позицию щелчка в start, и эта функция вернёт весь URL, в котором пользователь кликнул. Как и выше, hint — это необязательная схема, используемая для заполнения неполных URL.

IC.mapfile(file)

Возвращает запись отображения для заданного file, которое может быть передано как имя файла или результат FSSpec(), и которое необязательно должно существовать.

Запись отображения возвращается как кортеж (version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname), где version — номер версии записи, type — 4-символьный тип файла, creator — 4-символьный тип создателя, postcreator — 4-символьный код создателя необязательного приложения для последующей обработки файла после загрузки, flags — различные биты, определяющие, передавать ли в бинарном или ASCII формате и т. п., extension — расширение имени файла для этого типа файла, appname — читаемое имя приложения, которому принадлежит этот файл, postappname — имя приложения для последующей обработки, mimetype — MIME-тип этого файла и entryname — имя этой записи.

IC.maptypecreator(type, creator[, filename])

Возвращает запись отображения для файлов с заданными 4-символьными кодами типа type и создателя creator. Необязательный параметр filename может быть указан, чтобы дополнительно помочь в поиске правильной записи (например, если код создателя '????').

Запись отображения возвращается в том же формате, что и для mapfile.

IC.settypecreator(file)

Устанавливает создателя и тип заданного файла file, указанного либо как имя файла, либо как результат FSSpec() , правильно, исходя из его расширения. Finder получает информацию об изменении, поэтому значок Finder будет обновлён быстро.