�
�� f�9 c @ sw d Z 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 � Z d d � Z d
d � Z d d � Z
Gd d � d � Z e j d e j
� Z d d � Z d d � Z e j d � Z d d � Z d Z Gd d � d e � Z Gd d � d e � Z Gd d � d e � Z Gd d � d e � Z d d! d" � Z Gd# d � d � Z Gd$ d% � d% � Z d S(& u plistlib.py -- a tool to generate and parse MacOSX .plist files.
The property list (.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 bytes objects, you can use readPlistFromBytes()
and writePlistToBytes().
Values can be strings, integers, floats, booleans, tuples, lists,
dictionaries (but only with string keys), Data or datetime.datetime objects.
String values (including dictionary keys) have to 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 bytes object. Use 'Data' if your strings
contain control characters.
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 = "M\xe4ssig, Ma\xdf",
aTrueValue = True,
aFalseValue = False,
),
someData = Data(b"<binary gunk>"),
someMoreData = Data(b"<lots of binary gunk>" * 10),
aDate = datetime.datetime.fromtimestamp(time.mktime(time.gmtime())),
)
writePlist(pl, fileName)
Parse Plist example:
pl = readPlist(pathOrFile)
print pl["aKey"]
u readPlistu
writePlistu readPlistFromBytesu writePlistToBytesu Plistu Datau Dicti N( u BytesIOc
C sd d } zC t | t � r0 t | d � } d } n t � } | j | � } Wd | r_ | j � n X| S( u� 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).
u rbNFT( u Falseu
isinstanceu stru openu Trueu PlistParseru parseu close( u
pathOrFileu didOpenu pu
rootObject( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu readPlistA s c
C s d } z^ t | t � r0 t | d � } d } n t | � } | j d � | j | � | j d � Wd | rz | j � n Xd S( uq Write 'rootObject' to a .plist file. 'pathOrFile' may either be a
file name or a (writable) file object.
u wbu <plist version="1.0">u </plist>NFT( u Falseu
isinstanceu stru openu Trueu PlistWriteru writelnu
writeValueu close( u
rootObjectu
pathOrFileu didOpenu writer( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
writePlistS s
c C s t t | � � S( uC Read a plist data from a bytes object. Return the root object.
( u readPlistu BytesIO( u data( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu readPlistFromBytese s c C s t � } t | | � | j � S( u; Return 'rootObject' as a plist-formatted bytes object.
( u BytesIOu
writePlistu getvalue( u
rootObjectu f( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu writePlistToBytesk s
c B sY | Ee Z d Z d d d d � Z d d � Z d d � Z d
d d
� Z d d � Z d
S( u
DumbXMLWriteri u c C s( | | _ g | _ | | _ | | _ d S( N( u fileu stacku indentLevelu indent( u selfu fileu indentLevelu indent( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__t s u DumbXMLWriter.__init__c C s4 | j j | � | j d | � | j d 7_ d S( Nu <%s>i ( u stacku appendu writelnu indentLevel( u selfu element( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu beginElementz s u DumbXMLWriter.beginElementc C s$ | j d 8_ | j d | � d S( Ni u </%s>( u indentLevelu writeln( u selfu element( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
endElement s u DumbXMLWriter.endElementc C sJ | d k r5 t | � } | j d | | | f � n | j d | � d S( Nu <%s>%s</%s>u <%s/>( u Noneu _escapeu writeln( u selfu elementu value( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
simpleElement� s u DumbXMLWriter.simpleElementc C sh | rT t | t � r' | j d � } n | j j | j | j � | j j | � n | j j d � d S( Nu utf-8s
( u
isinstanceu stru encodeu fileu writeu indentLevelu indent( u selfu line( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu writeln� s u DumbXMLWriter.writelnN( u __name__u
__module__u __qualname__u __init__u beginElementu
endElementu Noneu
simpleElementu writeln( u
__locals__( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
DumbXMLWriters s
u
DumbXMLWriteru{ (?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( Nu yearu monthu dayu houru minuteu second( u yearu monthu dayu houru minuteu second( u _dateParseru matchu groupdictu Noneu appendu intu datetime( u su orderu gdu lstu keyu val( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu _dateFromString� s
u _dateFromStringc C s, d | j | j | j | j | j | j f S( Nu %04d-%02d-%02dT%02d:%02d:%02dZ( u yearu monthu dayu houru minuteu second( u d( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
_dateToString� s u
_dateToStringuv [\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
� } | S( NuD strings can't contains control characters; use plistlib.Data insteadu
u
u
u &u &u <u <u >u >( u _controlCharPatu searchu Noneu
ValueErroru replace( u textu m( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu _escape� s u _escapes� <?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">
c B sY | Ee Z d Z d d d d d � Z d d � Z d d � Z d
d � Z d d
� Z d S( u PlistWriteri s i c C s0 | r | j t � n t j | | | | � d S( N( u writeu PLISTHEADERu
DumbXMLWriteru __init__( u selfu fileu indentLevelu indentu writeHeader( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__� s u PlistWriter.__init__c C sM t | t � r" | j d | � n't | t � rW | rG | j d � qI| j d � n� t | t � 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 � r3| j | � n t d t | � � � d S( Nu stringu trueu falseu integeru %du realu dateu unsupported type: %s( u
isinstanceu stru
simpleElementu boolu intu floatu repru dictu writeDictu Datau writeDatau datetimeu
_dateToStringu tupleu listu
writeArrayu TypeErroru type( u selfu value( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
writeValue� s& u PlistWriter.writeValuec 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(
Nu datai i iL s s i s
s (
u beginElementu indentLevelu maxu lenu indentu replaceu asBase64u splitu writelnu
endElement( u selfu datau
maxlinelengthu line( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu writeData� s
u PlistWriter.writeDatac C s� | r� | j d � t | j � � } xO | D]G \ } } t | t � sV t d � � n | j d | � | j | � q, W| j d � n
| j d � d S( Nu dictu keys must be stringsu key( u beginElementu sortedu itemsu
isinstanceu stru TypeErroru
simpleElementu
writeValueu
endElement( u selfu du itemsu keyu value( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu writeDict� s
u PlistWriter.writeDictc C sR | rA | j d � x | D] } | j | � q W| j d � n
| j d � d S( Nu array( u beginElementu
writeValueu
endElementu
simpleElement( u selfu arrayu value( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
writeArray� s
u PlistWriter.writeArrayN( u __name__u
__module__u __qualname__u __init__u
writeValueu writeDatau writeDictu
writeArray( u
__locals__( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu PlistWriter� s
u PlistWriterc B s8 | Ee Z d Z d d � Z d d � Z d d � Z d S( u
_InternalDictc C sS y | | } Wn t k
r. t | � � Yn Xd d l m } | d t d � | S( Ni ( u warnuL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( u KeyErroru AttributeErroru warningsu warnu DeprecationWarning( u selfu attru valueu warn( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __getattr__ s
u _InternalDict.__getattr__c C s. d d l m } | d t d � | | | <d S( Ni ( u warnuL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( u warningsu warnu DeprecationWarning( u selfu attru valueu warn( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __setattr__ s
u _InternalDict.__setattr__c C sP y | | =Wn t k
r+ t | � � Yn Xd d l m } | d t d � d S( Ni ( u warnuL Attribute access from plist dicts is deprecated, use d[key] notation insteadi ( u KeyErroru AttributeErroru warningsu warnu DeprecationWarning( u selfu attru warn( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __delattr__ s
u _InternalDict.__delattr__N( u __name__u
__module__u __qualname__u __getattr__u __setattr__u __delattr__( u
__locals__( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
_InternalDict s
u
_InternalDictc s& | Ee Z d Z � f d d � Z � S( u Dictc s4 d d l m } | d t d � t � j | � d S( Ni ( u warnu? The plistlib.Dict class is deprecated, use builtin dict insteadi ( u warningsu warnu DeprecationWarningu superu __init__( u selfu kwargsu warn( u __class__( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__' s
u
Dict.__init__( u __name__u
__module__u __qualname__u __init__( u
__locals__( ( u __class__u- /opt/alt/python33/lib64/python3.3/plistlib.pyu Dict% s c sP | Ee Z d Z d Z � f d d � Z d d � Z e e � Z d d � Z � S( u Plistu� This class has been deprecated. Use readPlist() and writePlist()
functions instead, together with regular dict objects.
c s4 d d l m } | d t d � t � j | � d S( Ni ( u warnuU The Plist class is deprecated, use the readPlist() and writePlist() functions insteadi ( u warningsu warnu DeprecationWarningu superu __init__( u selfu kwargsu warn( u __class__( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__4 s
u Plist.__init__c C s& t | � } | � } | j | � | S( u1 Deprecated. Use the readPlist() function instead.( u readPlistu update( u clsu
pathOrFileu
rootObjectu plist( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu fromFile: s
u Plist.fromFilec C s t | | � d S( u2 Deprecated. Use the writePlist() function instead.N( u
writePlist( u selfu
pathOrFile( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu writeB s u Plist.write( u __name__u
__module__u __qualname__u __doc__u __init__u fromFileu classmethodu write( u
__locals__( ( u __class__u- /opt/alt/python33/lib64/python3.3/plistlib.pyu Plist. s
iL c C sn | d d } g } xJ t d t | � | � D]0 } | | | | � } | j t j | � � q- Wd j | � S( Ni i i s ( u rangeu lenu appendu binasciiu
b2a_base64u join( u su
maxlinelengthu
maxbinsizeu piecesu iu chunk( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
_encodeBase64G s u
_encodeBase64c B s_ | Ee Z d Z d Z d d � Z e d d � � Z d d d � Z d d
� Z d d � Z d
S( u Datau Wrapper for binary data.c C s+ t | t � s t d � � n | | _ d S( Nu data must be as bytes( u
isinstanceu bytesu TypeErroru data( u selfu data( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__T s u
Data.__init__c C s | t j | � � S( N( u binasciiu
a2b_base64( u clsu data( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
fromBase64Y s u Data.fromBase64iL c C s t | j | � S( N( u
_encodeBase64u data( u selfu
maxlinelength( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu asBase64_ s u
Data.asBase64c C sX t | | j � r" | j | j k St | t � r> | j | k St | � t | � k Sd S( N( u
isinstanceu __class__u datau stru id( u selfu other( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __eq__b s
u Data.__eq__c C s d | j j t | j � f S( Nu %s(%s)( u __class__u __name__u repru data( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __repr__j s u
Data.__repr__N(
u __name__u
__module__u __qualname__u __doc__u __init__u classmethodu
fromBase64u asBase64u __eq__u __repr__( u
__locals__( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu DataP s c B s� | Ee Z d Z d d � Z d d � Z d d � Z d d � Z d d
� Z d d � Z d
d � Z d d � Z
d d � Z d d � Z d d � Z
d d � Z d d � Z d d � Z d d � Z d d � Z d! d" � Z d# d$ � Z d% d& � Z d' S(( u PlistParserc C s g | _ d | _ d | _ d S( N( u stacku Noneu
currentKeyu root( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu __init__o s u PlistParser.__init__c C s` d d l m } | � | _ | j | j _ | j | j _ | j | j _ | j j | � | j
S( Ni ( u ParserCreate( u xml.parsers.expatu ParserCreateu parseru handleBeginElementu StartElementHandleru handleEndElementu EndElementHandleru
handleDatau CharacterDataHandleru ParseFileu root( u selfu fileobju ParserCreate( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu parset s u PlistParser.parsec C s< g | _ t | d | d � } | d k r8 | | � n d S( Nu begin_( u datau getattru None( u selfu elementu attrsu handler( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu handleBeginElement} s u PlistParser.handleBeginElementc C s0 t | d | d � } | d k r, | � n d S( Nu end_( u getattru None( u selfu elementu handler( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu handleEndElement� s u PlistParser.handleEndElementc C s | j j | � d S( N( u datau append( u selfu data( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
handleData� s u PlistParser.handleDatac C s� | j d k rd t | j d t i � � sD t d | j j � � n | | j d | j <d | _ n^ | j sy | | _ nI t | j d t g � � s� t d | j j � � n | j d j | � d S( Ni u unexpected element at line %di����i����i����i����(
u
currentKeyu Noneu
isinstanceu stacku typeu
ValueErroru parseru CurrentLineNumberu rootu append( u selfu value( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu addObject� s u PlistParser.addObjectc C s d j | j � } g | _ | S( Nu ( u joinu data( u selfu data( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu getData� s u PlistParser.getDatac C s* t � } | j | � | j j | � d S( N( u
_InternalDictu addObjectu stacku append( u selfu attrsu d( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
begin_dict� s
u PlistParser.begin_dictc C s< | j r+ t d | j | j j f � � n | j j � d S( Nu% missing value for key '%s' at line %d( u
currentKeyu
ValueErroru parseru CurrentLineNumberu stacku pop( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_dict� s u PlistParser.end_dictc C sR | j s& t | j d t i � � r? t d | j j � � n | j � | _ d S( Ni u unexpected key at line %di����( u
currentKeyu
isinstanceu stacku typeu
ValueErroru parseru CurrentLineNumberu getData( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_key� s &u PlistParser.end_keyc C s' g } | j | � | j j | � d S( N( u addObjectu stacku append( u selfu attrsu a( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu begin_array� s
u PlistParser.begin_arrayc C s | j j � d S( N( u stacku pop( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_array� s u PlistParser.end_arrayc C s | j d � d S( NT( u addObjectu True( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_true� s u PlistParser.end_truec C s | j d � d S( NF( u addObjectu False( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_false� s u PlistParser.end_falsec C s | j t | j � � � d S( N( u addObjectu intu getData( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_integer� s u PlistParser.end_integerc C s | j t | j � � � d S( N( u addObjectu floatu getData( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_real� s u PlistParser.end_realc C s | j | j � � d S( N( u addObjectu getData( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu
end_string� s u PlistParser.end_stringc C s) | j t j | j � j d � � � d S( Nu utf-8( u addObjectu Datau
fromBase64u getDatau encode( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_data� s u PlistParser.end_datac C s | j t | j � � � d S( N( u addObjectu _dateFromStringu getData( u self( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu end_date� s u PlistParser.end_dateN( u __name__u
__module__u __qualname__u __init__u parseu handleBeginElementu handleEndElementu
handleDatau addObjectu getDatau
begin_dictu end_dictu end_keyu begin_arrayu end_arrayu end_trueu end_falseu end_integeru end_realu
end_stringu end_datau end_date( u
__locals__( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu PlistParserm s& u PlistParser( u __doc__u __all__u binasciiu datetimeu iou BytesIOu reu readPlistu
writePlistu readPlistFromBytesu writePlistToBytesu
DumbXMLWriteru compileu ASCIIu _dateParseru _dateFromStringu
_dateToStringu _controlCharPatu _escapeu PLISTHEADERu PlistWriteru dictu
_InternalDictu Dictu Plistu
_encodeBase64u Datau PlistParser( ( ( u- /opt/alt/python33/lib64/python3.3/plistlib.pyu <module>2 s2 & B