Lc @ s d Z d d d d d d d d d g Z d
d k Z d
d k Z d
d k l Z d
d k Z d
d k Z d
Z d Z d Z
d Z d d d Z d d d Z
d d( d YZ e i d Z d Z d Z e i d Z d Z d Z d e f d YZ d e f d YZ d e f d! YZ d e f d" YZ d# d$ Z d d) d% YZ d& d* d' YZ d S(+ s plistlib.py -- a tool to generate and parse MacOSX .plist files.
The PropertyList (.plist) file format is a simple XML pickle supporting
basic object types, like dictionaries, lists, numbers and strings.
Usually the top level object is a dictionary.
To write out a plist file, use the writePlist(rootObject, pathOrFile)
function. 'rootObject' is the top level object, 'pathOrFile' is a
filename or a (writable) file object.
To parse a plist from a file, use the readPlist(pathOrFile) function,
with a file name or a (readable) file object as the only argument. It
returns the top level object (again, usually a dictionary).
To work with plist data in strings, you can use readPlistFromString()
and writePlistToString().
Values can be strings, integers, floats, booleans, tuples, lists,
dictionaries, Data or datetime.datetime objects. String values (including
dictionary keys) may be unicode strings -- they will be written out as
UTF-8.
The plist type is supported through the Data class. This is a
thin wrapper around a Python string.
Generate Plist example:
pl = dict(
aString="Doodah",
aList=["A", "B", 12, 32.1, [1, 2, 3]],
aFloat=0.1,
anInt=728,
aDict=dict(
anotherString="",
aUnicodeValue=u'M\xe4ssig, Ma\xdf',
aTrueValue=True,
aFalseValue=False,
),
someData=Data(""),
someMoreData=Data("" * 10),
aDate=datetime.datetime.fromtimestamp(time.mktime(time.gmtime())),
)
# unicode keys are possible, but a little awkward to use:
pl[u'\xc5benraa'] = "That was a unicode key."
writePlist(pl, fileName)
Parse Plist example:
pl = readPlist(pathOrFile)
print pl["aKey"]
t readPlistt
writePlistt readPlistFromStringt writePlistToStringt readPlistFromResourcet writePlistToResourcet Plistt Datat DictiN( t StringIOc C sc d } t | t t f o t | } d } n t } | i | } | o | i n | S( s Read a .plist file. 'pathOrFile' may either be a file name or a
(readable) file object. Return the unpacked root object (which
usually is a dictionary).
i i ( t
isinstancet strt unicodet opent PlistParsert parset close( t
pathOrFilet didOpent pt
rootObject( ( s /usr/lib64/python2.6/plistlib.pyR D s
c C s d } t | t t f o t | d } d } n t | } | i d | i | | i d | o | i n d S( sq Write 'rootObject' to a .plist file. 'pathOrFile' may either be a
file name or a (writable) file object.
i t wi s s N( R
R R R
t PlistWritert writelnt
writeValueR ( R R R t writer( ( s /usr/lib64/python2.6/plistlib.pyR T s
c C s t t | S( s= Read a plist data from a string. Return the root object.
( R R ( t data( ( s /usr/lib64/python2.6/plistlib.pyR d s c C s t } t | | | i S( s5 Return 'rootObject' as a plist-formatted string.
( R R t getvalue( R t f( ( s /usr/lib64/python2.6/plistlib.pyR j s
t plsti c
C s t i d d d d d k l } l } d d k l } d d k l } | | } | i | | | } | i
| | i | | i } | i
| t | S( s7 Read plst resource from the resource fork of path.
s) In 3.x, readPlistFromResource is removed.t
stackleveli i( t FSReft FSGetResourceForkName( t fsRdPerm( t Res( t warningst warnpy3kt Carbon.FileR R t Carbon.FilesR! t CarbonR" t FSOpenResourceFilet
UseResFilet Get1ResourceR t CloseResFileR (
t patht restypet residR R R! R" t fsReft resNumt plistData( ( s /usr/lib64/python2.6/plistlib.pyR r s
c
C s t i d d d d d k l } l } d d k l } d d k l } t | } | | } | i
| | | }
| i |
y | i | | i
Wn | i j
o n X| i | } | i | | d | i | i |
d S(
sH Write 'rootObject' as a plst resource to the resource fork of path.
s( In 3.x, writePlistToResource is removed.R i i( R R ( t
fsRdWrPerm( R" t N( R# R$ R% R R R& R2 R' R" R R( R) R* t RemoveResourcet Errort Resourcet AddResourcet
WriteResourceR+ ( R R, R- R. R R R2 R" R1 R/ R0 t res( ( s /usr/lib64/python2.6/plistlib.pyR s
t
DumbXMLWriterc B s> e Z d d d Z d Z d Z d d Z d Z RS( i s c C s( | | _ g | _ | | _ | | _ d S( N( t filet stackt indentLevelt indent( t selfR; R= R> ( ( s /usr/lib64/python2.6/plistlib.pyt __init__ s c C s4 | i i | | i d | | i d 7_ d S( Ns <%s>i ( R< t appendR R= ( R? t element( ( s /usr/lib64/python2.6/plistlib.pyt beginElement s c C s$ | i d 8_ | i d | d S( Ni s ( R= R ( R? RB ( ( s /usr/lib64/python2.6/plistlib.pyt
endElement s c C sL | d j o* t | } | i d | | | f n | i d | d S( Ns <%s>%ss <%s/>( t Nonet _escapeAndEncodeR ( R? RB t value( ( s /usr/lib64/python2.6/plistlib.pyt
simpleElement s
c C sA | o& | i i | i | i | d n | i i d d S( Ns
( R; t writeR= R> ( R? t line( ( s /usr/lib64/python2.6/plistlib.pyR s &N( t __name__t
__module__R@ RC RD RE RH R ( ( ( s /usr/lib64/python2.6/plistlib.pyR: s
s{ (?P\d\d\d\d)(?:-(?P\d\d)(?:-(?P\d\d)(?:T(?P\d\d)(?::(?P\d\d)(?::(?P\d\d))?)?)?)?)?Zc C sn d } t i | i } g } x= | D]5 } | | } | d j o Pn | i t | q( Wt i | S( Nt yeart montht dayt hourt minutet second( s years months days hours minutes second( t _dateParsert matcht groupdictRE RA t intt datetime( t st ordert gdt lstt keyt val( ( s /usr/lib64/python2.6/plistlib.pyt _dateFromString s
c C s, d | i | i | i | i | i | i f S( Ns %04d-%02d-%02dT%02d:%02d:%02dZ( RM RN RO RP RQ RR ( t d( ( s /usr/lib64/python2.6/plistlib.pyt
_dateToString s sv [\x00\x01\x02\x03\x04\x05\x06\x07\x08\x0b\x0c\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f]c C s t i | } | d j o t d n | i d d } | i d d } | i d d } | i d d } | i d d
} | i d S( NsD strings can't contains control characters; use plistlib.Data insteads
s
s
t &s &t s >s utf-8( t _controlCharPatt searchRE t
ValueErrort replacet encode( t textt m( ( s /usr/lib64/python2.6/plistlib.pyRF s
s
R c B s> e Z d d d d Z d Z d Z d Z d Z RS( i s i c C s2 | o | i t n t i | | | | d S( N( RI t PLISTHEADERR: R@ ( R? R; R= R> t writeHeader( ( s /usr/lib64/python2.6/plistlib.pyR@ s c C sk t | t t f o | i d | n>t | t o) | o | i d qg| i d nt | t t f o | i d d | n t | t o | i d t | n t | t o | i
| n t | t o | i | nk t | t
i
o | i d t | n> t | t t f o | i | n t d t | d S( Nt stringt truet falset integers %dt realt dates unsuported type: %s( R
R R RH t boolRV t longt floatt reprt dictt writeDictR t writeDataRW R` t tuplet listt
writeArrayt TypeErrort type( R? RG ( ( s /usr/lib64/python2.6/plistlib.pyR s& c C s | i d | i d 8_ d t | i i d d | i } x8 | i | i d D] } | o | i | q[ q[ W| i d 7_ | i d d S( NR i iL s t i s
s ( RC R= t lenR> Rg t asBase64t splitR RD ( R? R t
maxlinelengthRJ ( ( s /usr/lib64/python2.6/plistlib.pyRy s
c C s | i d | i } | i xW | D]O \ } } t | t t f p t d n | i d | | i | q* W| i d d S( NRw s keys must be stringsR\ (
RC t itemst sortR
R R R} RH R RD ( R? R_ R R\ RG ( ( s /usr/lib64/python2.6/plistlib.pyRx s
c C s< | i d x | D] } | i | q W| i d d S( Nt array( RC R RD ( R? R RG ( ( s /usr/lib64/python2.6/plistlib.pyR| s
( RK RL R@ R Ry Rx R| ( ( ( s /usr/lib64/python2.6/plistlib.pyR s
t
_InternalDictc B s# e Z d Z d Z d Z RS( c C sQ y | | } Wn t j
o t | n Xd d k l } | d t d | S( Ni( t warnsL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( t KeyErrort AttributeErrorR# R t PendingDeprecationWarning( R? t attrRG R ( ( s /usr/lib64/python2.6/plistlib.pyt __getattr__) s
c C s. d d k l } | d t d | | | g | _ t | d | d } | d j o | | n d S( Nt begin_( R t getattrRE ( R? RB t attrst handler( ( s /usr/lib64/python2.6/plistlib.pyR s
c C s2 t | d | d } | d j o | n d S( Nt end_( R RE ( R? RB R ( ( s /usr/lib64/python2.6/plistlib.pyR s
c C s | i i | d S( N( R RA ( R? R ( ( s /usr/lib64/python2.6/plistlib.pyR s c C s` | i d j o! | | i d | i 3 s: $ =