ic
ic - 访问Mac OS X Internet配置
此模块提供对通过系统偏好设置
或Finder
设置的各种与互联网有关的偏好的访问。
注意
此模块已在Python 3.x中删除。
有一个低级协同模块icglue
提供基本的Internet配置访问功能。这个低级模块没有记录,但是例程的文档字符串记录了参数和例程名称与Pascal或C API到Internet配置的相同,所以如果此模块是标准IC程序员的文档需要。
ic模块为Internet Config可以生成的所有错误代码定义错误例外和符号名称; 详情请参阅源文件。
exception ic.error
ic
模块中的错误引发异常。
该ic
模块定义了以下类和功能:
class ic.IC([signature[, ic]])
创建一个Internet配置对象。签名是当前应用程序的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传递给它。可选的提示
可以是一个方案名称,例如'mailto:'
,在这种情况下,不完整的URL将通过此方案完成。如果未提供提示
,则不完整的URL无效。
IC.parseurl(data[, start[, end[, hint]]])
在数据的
某处查找网址,并返回起始位置,结束
位置和网址。可选的开始
和结束
可用于限制搜索,例如,如果用户在长文本字段中单击,则可以在开始时
传递整个文本字段和单击位置,并且此例程将返回整个URL,其中用户点击。如上所述,提示
是用于完成不完整URL的可选方案。
IC.mapfile(file)
返回给定文件
的映射条目,该条目可以作为文件
名或FSSpec()
结果传递,也可以不存在。
映射条目作为元组(version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname)返回,其中version是条目版本号,type是4个字符的文件类型,creator是4 - 字符创建者类型,postcreator是可选应用程序的4个字符的创建者代码,用于在下载后对文件进行后处理,标志是用于指定是以二进制还是ASCII格式传输的各种位,扩展名是此文件类型的文件扩展名 ,appname是此文件所属应用程序的可打印名称,postappname是后处理应用程序的名称,mimetype是此文件的MIME类型,entryname是此条目的名称。
IC.maptypecreator(type, creator[, filename])
返回给定4字符类型
和创建者
代码的文件的映射条目。可以指定可选的文件名
以进一步帮助找到正确的条目(例如,如果创建者
代码是'????'
)。
映射条目以与mapfile
相同的格式返回。
IC.settypecreator(file)
给定一个现有的文件
,指定为文件
名或FSSpec()
结果,根据其扩展名设置其创建者和类型。查找器会被告知有关更改,因此查找器图标将会很快更新。