This module provides access to various internet-related preferences set through System Preferences or the Finder.
This module is removed in 3.0.
There is a low-level companion module icglue which provides the basic Internet Config access functionality. This low-level module is not documented, but the docstrings of the routines document the parameters and the routine names are the same as for the Pascal or C API to Internet Config, so the standard IC programmers’ documentation can be used if this module is needed.
The ic module defines the error exception and symbolic names for all error codes Internet Config can produce; see the source for details.
The ic module defines the following class and function:
IC objects have a mapping interface, hence to obtain the mail address you simply get ic['MailAddress']. Assignment also works, and changes the option in the configuration file.
The module knows about various datatypes, and converts the internal IC representation to a “logical” Python data structure. Running the ic module standalone will run a test program that lists all keys and values in your IC database, this will have to serve as documentation.
If the module does not know how to represent the data it returns an instance of the ICOpaqueData type, with the raw data in its data attribute. Objects of this type are also acceptable values for assignment.
Besides the dictionary interface, IC objects have the following methods:
Return the mapping entry for the given file, which can be passed as either a filename or an FSSpec() result, and which need not exist.
The mapping entry is returned as a tuple (version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname), where version is the entry version number, type is the 4-character filetype, creator is the 4-character creator type, postcreator is the 4-character creator code of an optional application to post-process the file after downloading, flags are various bits specifying whether to transfer in binary or ascii and such, extension is the filename extension for this file type, appname is the printable name of the application to which this file belongs, postappname is the name of the postprocessing application, mimetype is the MIME type of this file and entryname is the name of this entry.
Return the mapping entry for files with given 4-character type and creator codes. The optional filename may be specified to further help finding the correct entry (if the creator code is '????', for instance).
The mapping entry is returned in the same format as for mapfile.