�
z fc @ s� d Z d d d d d d d d d g Z d
d l Z d
d l Z d
d l m Z d
d l Z d
d l Z d
� Z d � Z d � Z
d � Z d d d � Z d d d � Z
d d* d � � YZ e j d � Z d � Z d � Z e j 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& e f 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 <data> 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="<hello & hi there!>",
aUnicodeValue=u'M\xe4ssig, Ma\xdf',
aTrueValue=True,
aFalseValue=False,
),
someData=Data("<binary gunk>"),
someMoreData=Data("<lots of binary gunk>" * 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 Dicti����N( t StringIOc C s_ d } t | t t f � r0 t | � } d } n t � } | j | � } | r[ | j � 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.7/plistlib.pyR D s
c C s} d } t | t t f � r3 t | d � } d } n t | � } | j d � | j | � | j d � | ry | j � 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 <plist version="1.0">s </plist>N( R
R R R
t PlistWritert writelnt
writeValueR ( R R R t writer( ( s /usr/lib64/python2.7/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.7/plistlib.pyR d s c C s t � } t | | � | j � S( s5 Return 'rootObject' as a plist-formatted string.
( R R t getvalue( R t f( ( s /usr/lib64/python2.7/plistlib.pyR j s
t plsti c
C s� t j d d d �d d l m } m } d d l m } d d l m } | | � } | j | | � | � } | j
| � | j | | � j } | j
| � 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.7/plistlib.pyR r s
c C s� t j d d d �d d l m } m } d d l m } d d l m } t | � } | | � } | j
| | � | � }
| j |
� y | j | | � j
� Wn | j k
r� n X| j | � } | j | | d � | j � | j |
� 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.7/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.7/plistlib.pyt __init__� s c C s4 | j j | � | j d | � | j d 7_ d S( Ns <%s>i ( R< t appendR R= ( R? t element( ( s /usr/lib64/python2.7/plistlib.pyt beginElement� s c C s$ | j d 8_ | j d | � d S( Ni s </%s>( R= R ( R? RB ( ( s /usr/lib64/python2.7/plistlib.pyt
endElement� s c C sJ | d k r5 t | � } | j d | | | f � n | j d | � d S( Ns <%s>%s</%s>s <%s/>( t Nonet _escapeAndEncodeR ( R? RB t value( ( s /usr/lib64/python2.7/plistlib.pyt
simpleElement� s c C s? | r+ | j j | j | j | d � n | j j d � d S( Ns
( R; t writeR= R> ( R? t line( ( s /usr/lib64/python2.7/plistlib.pyR � s %N( t __name__t
__module__R@ RC RD RE RH R ( ( ( s /usr/lib64/python2.7/plistlib.pyR: � s
s{ (?P<year>\d\d\d\d)(?:-(?P<month>\d\d)(?:-(?P<day>\d\d)(?:T(?P<hour>\d\d)(?::(?P<minute>\d\d)(?::(?P<second>\d\d))?)?)?)?)?Zc C sl d } t j | � j � } g } x; | D]3 } | | } | d k rH Pn | j t | � � q( Wt j | � S( Nt yeart montht dayt hourt minutet second( RM RN RO RP RQ RR ( t _dateParsert matcht groupdictRE RA t intt datetime( t st ordert gdt lstt keyt val( ( s /usr/lib64/python2.7/plistlib.pyt _dateFromString� s
c C s, d | j | j | j | j | j | j f S( Ns %04d-%02d-%02dT%02d:%02d:%02dZ( RM RN RO RP RQ RR ( t d( ( s /usr/lib64/python2.7/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 j | � } | d k r* t d � � n | j d d � } | j d d � } | j d d � } | j d d � } | j d d
� } | j d � S( NsD strings can't contains control characters; use plistlib.Data insteads
s
s
t &s &t <s <t >s >s utf-8( t _controlCharPatt searchRE t
ValueErrort replacet encode( t textt m( ( s /usr/lib64/python2.7/plistlib.pyRF � s s� <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
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 s0 | r | j t � n t j | | | | � d S( N( RI t PLISTHEADERR: R@ ( R? R; R= R> t writeHeader( ( s /usr/lib64/python2.7/plistlib.pyR@ � s c C sY t | t t f � r( | j d | � n-t | t � r] | rM | j d � qU| j d � n� t | t t f � r� | j d d | � n� t | t � r� | j d t | � � n� t | t � r� | j
| � n� t | t � r� | j | � nf t | t
j
� r| j d t | � � n; t | t t f � r?| j | � 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.7/plistlib.pyR � s& c C s� | j d � | j d 8_ t d d t | j j d d � | j � � } x6 | j | � j d � D] } | rd | j | � qd qd W| j d 7_ | j d � d S(
NR i i iL s t i s
s (
RC R= t maxt lenR> Rg t asBase64t splitR RD ( R? R t
maxlinelengthRJ ( ( s /usr/lib64/python2.7/plistlib.pyRy s
c C s� | j d � | j � } | j � xU | D]M \ } } t | t t f � sZ t d � � n | j d | � | j | � q* W| j 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.7/plistlib.pyRx s
c C s< | j d � x | D] } | j | � q W| j d � d S( Nt array( RC R RD ( R? R� RG ( ( s /usr/lib64/python2.7/plistlib.pyR| s
( RK RL R@ R Ry Rx R| ( ( ( s /usr/lib64/python2.7/plistlib.pyR � s
t
_InternalDictc B s# e Z d � Z d � Z d � Z RS( c C sO y | | } Wn t k
r* t | � n Xd d l m } | 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.7/plistlib.pyt __getattr__) s
c C s. d d l m } | d t d � | | | <d S( Ni����( R� sL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( R# R� R� ( R? R� RG R� ( ( s /usr/lib64/python2.7/plistlib.pyt __setattr__3 s
c C sL y | | =Wn t k
r' t | � n Xd d l m } | d t d � d S( Ni����( R� sL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( R� R� R# R� R� ( R? R� R� ( ( s /usr/lib64/python2.7/plistlib.pyt __delattr__9 s
( RK RL R� R� R� ( ( ( s /usr/lib64/python2.7/plistlib.pyR� # s
c B s e Z d � Z RS( c K s: d d l m } | d t d � t t | � j | � d S( Ni����( R� s? The plistlib.Dict class is deprecated, use builtin dict insteadi ( R# R� R� t superR R@ ( R? t kwargsR� ( ( s /usr/lib64/python2.7/plistlib.pyR@ D s
( RK RL R@ ( ( ( s /usr/lib64/python2.7/plistlib.pyR B s c B s5 e Z d Z d � Z d � Z e e � Z d � Z RS( s� This class has been deprecated. Use readPlist() and writePlist()
functions instead, together with regular dict objects.
c K s: d d l m } | d t d � t t | � j | � d S( Ni����( R� sU The Plist class is deprecated, use the readPlist() and writePlist() functions insteadi ( R# R� R� R� R R@ ( R? R� R� ( ( s /usr/lib64/python2.7/plistlib.pyR@ Q s
c C s& t | � } | � } | j | � | S( s1 Deprecated. Use the readPlist() function instead.( R t update( t clsR R t plist( ( s /usr/lib64/python2.7/plistlib.pyt fromFileW s
c C s t | | � d S( s2 Deprecated. Use the writePlist() function instead.N( R ( R? R ( ( s /usr/lib64/python2.7/plistlib.pyRI _ s ( RK RL t __doc__R@ R� t classmethodRI ( ( ( s /usr/lib64/python2.7/plistlib.pyR K s
iL c C sk | d d } g } xG t d t | � | � D]- } | | | | !} | j t j | � � q- Wd j | � S( Ni i i R3 ( t rangeR� RA t binasciit
b2a_base64t join( RX R� t
maxbinsizet piecest it chunk( ( s /usr/lib64/python2.7/plistlib.pyt
_encodeBase64d s c B sJ e Z d Z d � Z d � Z e e � Z d d � Z d � Z d � Z RS( s Wrapper for binary data.c C s
| | _ d S( N( R ( R? R ( ( s /usr/lib64/python2.7/plistlib.pyR@ q s c C s | t j | � � S( N( R� t
a2b_base64( R� R ( ( s /usr/lib64/python2.7/plistlib.pyt
fromBase64t s iL c C s t | j | � S( N( R� R ( R? R� ( ( s /usr/lib64/python2.7/plistlib.pyR� z s c C sa t | | j � r% t | j | j � St | t � rD t | j | � St t | � t | � � Sd S( N( R
t __class__t cmpR R t id( R? t other( ( s /usr/lib64/python2.7/plistlib.pyt __cmp__} s
c C s d | j j t | j � f S( Ns %s(%s)( R� RK Rv R ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt __repr__� s ( RK RL R� R@ R� R� R� R� R� ( ( ( s /usr/lib64/python2.7/plistlib.pyR m s t InvalidFileExceptionc B s e Z d d � Z RS( s Invalid filec C s t j | | � d S( N( Rf R@ ( R? t message( ( s /usr/lib64/python2.7/plistlib.pyR@ � s ( RK RL R@ ( ( ( s /usr/lib64/python2.7/plistlib.pyR� � s R c B s� e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d
� Z d � Z
d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z RS( c C s g | _ d | _ d | _ d S( N( R< RE t
currentKeyt root( R? ( ( s /usr/lib64/python2.7/plistlib.pyR@ � s c C s] d d l m } | � } | j | _ | j | _ | j | _ | j | _ | j
| � | j S( Ni����( t ParserCreate( t xml.parsers.expatR� t handleBeginElementt StartElementHandlert handleEndElementt EndElementHandlert
handleDatat CharacterDataHandlert handle_entity_declt EntityDeclHandlert ParseFileR� ( R? t fileobjR� t parser( ( s /usr/lib64/python2.7/plistlib.pyR � s
c C s t d � � d S( Ns8 XML entity declarations are not supported in plist files( R� ( R? t entity_namet is_parameter_entityRG t baset system_idt public_idt
notation_name( ( s /usr/lib64/python2.7/plistlib.pyR� � s c C s< g | _ t | d | d � } | d k r8 | | � n d S( Nt begin_( R t getattrRE ( R? RB t attrst handler( ( s /usr/lib64/python2.7/plistlib.pyR� � s c C s0 t | d | d � } | d k r, | � n d S( Nt end_( R� RE ( R? RB R� ( ( s /usr/lib64/python2.7/plistlib.pyR� � s c C s | j j | � d S( N( R RA ( R? R ( ( s /usr/lib64/python2.7/plistlib.pyR� � s c C s\ | j d k r/ | | j d | j <d | _ n) | j sD | | _ n | j d j | � d S( Ni����( R� RE R< R� RA ( R? RG ( ( s /usr/lib64/python2.7/plistlib.pyt addObject� s c C sF d j | j � } y | j d � } Wn t k
r8 n Xg | _ | S( NR3 t ascii( R� R Rh t UnicodeError( R? R ( ( s /usr/lib64/python2.7/plistlib.pyt getData� s
c C s* t � } | j | � | j j | � d S( N( R� R� R< RA ( R? R� R_ ( ( s /usr/lib64/python2.7/plistlib.pyt
begin_dict� s
c C s | j j � d S( N( R< t pop( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_dict� s c C s | j � | _ d S( N( R� R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_key� s c C s' g } | j | � | j j | � d S( N( R� R< RA ( R? R� t a( ( s /usr/lib64/python2.7/plistlib.pyt begin_array� s
c C s | j j � d S( N( R< R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_array� s c C s | j t � d S( N( R� t True( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_true� s c C s | j t � d S( N( R� t False( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_false� s c C s | j t | j � � � d S( N( R� RV R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_integer� s c C s | j t | j � � � d S( N( R� Ru R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_real� s c C s | j | j � � d S( N( R� R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt
end_string� s c C s | j t j | j � � � d S( N( R� R R� R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_data� s c C s | j t | j � � � d S( N( R� R^ R� ( R? ( ( s /usr/lib64/python2.7/plistlib.pyt end_date� s ( RK RL R@ R R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� ( ( ( s /usr/lib64/python2.7/plistlib.pyR � s(
( ( ( ( R� t __all__R� RW t cStringIOR t reR# R R R R R R R: t compileRS R^ R` Rd RF Rk R Rw R� R R R� R Rf R� R ( ( ( s /usr/lib64/python2.7/plistlib.pyt <module>3 s< $ =