Viewing File: /usr/lib64/python2.7/plistlib.pyo


sjc	@sdZddddddddd	g	Zd
dlZd
dlZd
dlmZd
dlZd
dlZd
ZdZ	dZ
dZdddZdddZ
dd*dYZejdZdZdZejdZdZdZdefdYZdefd YZd	efd!YZdefd"YZd#d$Zdd+d%YZd&d,d'YZd(efd)YZdS(-splistlib.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
writePlisttreadPlistFromStringtwritePlistToStringtreadPlistFromResourcetwritePlistToResourcetPlisttDatatDictiN(tStringIOcCs_d}t|ttfr0t|}d}nt}|j|}|r[|jn|S(sRead 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).
    ii(t
isinstancetstrtunicodetopentPlistParsertparsetclose(t
pathOrFiletdidOpentpt
rootObject((s /usr/lib64/python2.7/plistlib.pyRDs		
cCs}d}t|ttfr3t|d}d}nt|}|jd|j||jd|ry|jndS(sqWrite 'rootObject' to a .plist file. 'pathOrFile' may either be a
    file name or a (writable) file object.
    itwis<plist version="1.0">s</plist>N(R
RRR
tPlistWritertwritelnt
writeValueR(RRRtwriter((s /usr/lib64/python2.7/plistlib.pyRTs	


cCstt|S(s=Read a plist data from a string. Return the root object.
    (RR	(tdata((s /usr/lib64/python2.7/plistlib.pyRdscCs t}t|||jS(s5Return 'rootObject' as a plist-formatted string.
    (R	Rtgetvalue(Rtf((s /usr/lib64/python2.7/plistlib.pyRjs	
tplstic
Cstjdddddlm}m}ddlm}ddlm}||}|j	|||}|j
||j||j}	|j
|t|	S(s7Read plst resource from the resource fork of path.
    s)In 3.x, readPlistFromResource is removed.t
stacklevelii(tFSReftFSGetResourceForkName(tfsRdPerm(tRes(twarningstwarnpy3ktCarbon.FileRR tCarbon.FilesR!tCarbonR"tFSOpenResourceFilet
UseResFiletGet1ResourceRtCloseResFileR(
tpathtrestypetresidRR R!R"tfsReftresNumt	plistData((s /usr/lib64/python2.7/plistlib.pyRrs

cCstjdddddlm}m}ddlm}ddlm}t	|}||}	|j
|	||}
|j|
y|j||j
Wn|jk
rnX|j|}|j||d|j|j|
d	S(
sHWrite 'rootObject' as a plst resource to the resource fork of path.
    s(In 3.x, writePlistToResource is removed.Rii(RR (t
fsRdWrPerm(R"tN(R#R$R%RR R&R2R'R"RR(R)R*tRemoveResourcetErrortResourcetAddResourcet
WriteResourceR+(RR,R-R.RR R2R"R1R/R0tres((s /usr/lib64/python2.7/plistlib.pyRs 

t
DumbXMLWritercBs>eZdddZdZdZddZdZRS(is	cCs(||_g|_||_||_dS(N(tfiletstacktindentLeveltindent(tselfR;R=R>((s /usr/lib64/python2.7/plistlib.pyt__init__s			cCs4|jj||jd||jd7_dS(Ns<%s>i(R<tappendRR=(R?telement((s /usr/lib64/python2.7/plistlib.pytbeginElementscCs$|jd8_|jd|dS(Nis</%s>(R=R(R?RB((s /usr/lib64/python2.7/plistlib.pyt
endElementscCsJ|dk	r5t|}|jd|||fn|jd|dS(Ns<%s>%s</%s>s<%s/>(tNonet_escapeAndEncodeR(R?RBtvalue((s /usr/lib64/python2.7/plistlib.pyt
simpleElementscCs?|r+|jj|j|j|dn|jjddS(Ns
(R;twriteR=R>(R?tline((s /usr/lib64/python2.7/plistlib.pyRs%N(t__name__t
__module__R@RCRDRERHR(((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))?)?)?)?)?ZcCsld}tj|j}g}x;|D]3}||}|dkrHPn|jt|q(Wtj|S(Ntyeartmonthtdaythourtminutetsecond(syearsmonthsdayshoursminutessecond(t_dateParsertmatcht	groupdictRERAtinttdatetime(tstordertgdtlsttkeytval((s /usr/lib64/python2.7/plistlib.pyt_dateFromStrings

cCs,d|j|j|j|j|j|jfS(Ns%04d-%02d-%02dT%02d:%02d:%02dZ(RMRNRORPRQRR(td((s /usr/lib64/python2.7/plistlib.pyt
_dateToStringssv[\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]cCstj|}|dk	r*tdn|jdd}|jdd}|jdd}|jdd}|jd	d
}|jdS(NsDstrings can't contains control characters; use plistlib.Data insteads
s
s
t&s&amp;t<s&lt;t>s&gt;sutf-8(t_controlCharPattsearchREt
ValueErrortreplacetencode(ttexttm((s /usr/lib64/python2.7/plistlib.pyRFs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">
RcBs>eZddddZdZdZdZdZRS(is	icCs0|r|jtntj||||dS(N(RItPLISTHEADERR:R@(R?R;R=R>twriteHeader((s /usr/lib64/python2.7/plistlib.pyR@scCsYt|ttfr(|jd|n-t|tr]|rM|jdqU|jdnt|ttfr|jdd|nt|tr|jdt|nt|t	r|j
|nt|tr|j|nft|t
j
r|jdt|n;t|ttfr?|j|ntdt|dS(	Ntstringttruetfalsetintegers%dtrealtdatesunsuported type: %s(R
RRRHtboolRVtlongtfloattreprtdictt	writeDictRt	writeDataRWR`ttupletlistt
writeArrayt	TypeErrorttype(R?RG((s /usr/lib64/python2.7/plistlib.pyRs&cCs|jd|jd8_tddt|jjdd	|j}x6|j|jdD]}|rd|j|qdqdW|jd7_|j	ddS(
NRiiiLs	t is
s        (
RCR=tmaxtlenR>RgtasBase64tsplitRRD(R?Rt
maxlinelengthRJ((s /usr/lib64/python2.7/plistlib.pyRys
cCs|jd|j}|jxU|D]M\}}t|ttfsZtdn|jd||j|q*W|j	ddS(NRwskeys must be stringsR\(
RCtitemstsortR
RRR}RHRRD(R?R_RR\RG((s /usr/lib64/python2.7/plistlib.pyRxs

cCs<|jdx|D]}|j|qW|jddS(Ntarray(RCRRD(R?RRG((s /usr/lib64/python2.7/plistlib.pyR|s

(RKRLR@RRyRxR|(((s /usr/lib64/python2.7/plistlib.pyRs
			t
_InternalDictcBs#eZdZdZdZRS(cCsOy||}Wntk
r*t|nXddlm}|dtd|S(Ni(twarnsLAttribute access from plist dicts is deprecated, use d[key] notation insteadi(tKeyErrortAttributeErrorR#RtPendingDeprecationWarning(R?tattrRGR((s /usr/lib64/python2.7/plistlib.pyt__getattr__)s


cCs.ddlm}|dtd|||<dS(Ni(RsLAttribute access from plist dicts is deprecated, use d[key] notation insteadi(R#RR(R?RRGR((s /usr/lib64/python2.7/plistlib.pyt__setattr__3s
cCsLy||=Wntk
r't|nXddlm}|dtddS(Ni(RsLAttribute access from plist dicts is deprecated, use d[key] notation insteadi(RRR#RR(R?RR((s /usr/lib64/python2.7/plistlib.pyt__delattr__9s

(RKRLRRR(((s /usr/lib64/python2.7/plistlib.pyR#s	
	cBseZdZRS(cKs:ddlm}|dtdtt|j|dS(Ni(Rs?The plistlib.Dict class is deprecated, use builtin dict insteadi(R#RRtsuperRR@(R?tkwargsR((s /usr/lib64/python2.7/plistlib.pyR@Ds
(RKRLR@(((s /usr/lib64/python2.7/plistlib.pyRBscBs5eZdZdZdZeeZdZRS(sThis class has been deprecated. Use readPlist() and writePlist()
    functions instead, together with regular dict objects.
    cKs:ddlm}|dtdtt|j|dS(Ni(RsUThe Plist class is deprecated, use the readPlist() and writePlist() functions insteadi(R#RRRRR@(R?RR((s /usr/lib64/python2.7/plistlib.pyR@Qs
cCs&t|}|}|j||S(s1Deprecated. Use the readPlist() function instead.(Rtupdate(tclsRRtplist((s /usr/lib64/python2.7/plistlib.pytfromFileWs	
cCst||dS(s2Deprecated. Use the writePlist() function instead.N(R(R?R((s /usr/lib64/python2.7/plistlib.pyRI_s(RKRLt__doc__R@RtclassmethodRI(((s /usr/lib64/python2.7/plistlib.pyRKs
		iLcCsk|dd}g}xGtdt||D]-}||||!}|jtj|q-Wdj|S(NiiiR3(trangeRRAtbinasciit
b2a_base64tjoin(RXRt
maxbinsizetpiecestitchunk((s /usr/lib64/python2.7/plistlib.pyt
_encodeBase64dscBsJeZdZdZdZeeZddZdZdZRS(sWrapper for binary data.cCs
||_dS(N(R(R?R((s /usr/lib64/python2.7/plistlib.pyR@qscCs|tj|S(N(Rt
a2b_base64(RR((s /usr/lib64/python2.7/plistlib.pyt
fromBase64tsiLcCst|j|S(N(RR(R?R((s /usr/lib64/python2.7/plistlib.pyRzscCsat||jr%t|j|jSt|trDt|j|Stt|t|SdS(N(R
t	__class__tcmpRRtid(R?tother((s /usr/lib64/python2.7/plistlib.pyt__cmp__}s
cCsd|jjt|jfS(Ns%s(%s)(RRKRvR(R?((s /usr/lib64/python2.7/plistlib.pyt__repr__s(	RKRLRR@RRRRR(((s /usr/lib64/python2.7/plistlib.pyRms			RcBseZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZdZdZdZdZdZRS(cCsg|_d|_d|_dS(N(R<REt
currentKeytroot(R?((s /usr/lib64/python2.7/plistlib.pyR@s		cCs]ddlm}|}|j|_|j|_|j|_|j|_	|j
||jS(Ni(tParserCreate(txml.parsers.expatRthandleBeginElementtStartElementHandlerthandleEndElementtEndElementHandlert
handleDatatCharacterDataHandlerthandleEntityDecltEntityDeclHandlert	ParseFileR(R?tfileobjRtparser((s /usr/lib64/python2.7/plistlib.pyRs	
cCstddS(Ns8XML entity declarations are not supported in plist files(tInvalidFileException(R?tentity_nametis_parameter_entityRGtbaset	system_idt	public_idt
notation_name((s /usr/lib64/python2.7/plistlib.pyRscCs<g|_t|d|d}|dk	r8||ndS(Ntbegin_(RtgetattrRE(R?RBtattrsthandler((s /usr/lib64/python2.7/plistlib.pyRs	cCs0t|d|d}|dk	r,|ndS(Ntend_(RRE(R?RBR((s /usr/lib64/python2.7/plistlib.pyRscCs|jj|dS(N(RRA(R?R((s /usr/lib64/python2.7/plistlib.pyRscCs\|jdk	r/||jd|j<d|_n)|jsD||_n|jdj|dS(Ni(RRER<RRA(R?RG((s /usr/lib64/python2.7/plistlib.pyt	addObjects	cCsFdj|j}y|jd}Wntk
r8nXg|_|S(NR3tascii(RRRhtUnicodeError(R?R((s /usr/lib64/python2.7/plistlib.pytgetDatas
	cCs*t}|j||jj|dS(N(RRR<RA(R?RR_((s /usr/lib64/python2.7/plistlib.pyt
begin_dicts	
cCs|jjdS(N(R<tpop(R?((s /usr/lib64/python2.7/plistlib.pytend_dictscCs|j|_dS(N(RR(R?((s /usr/lib64/python2.7/plistlib.pytend_keyscCs'g}|j||jj|dS(N(RR<RA(R?Rta((s /usr/lib64/python2.7/plistlib.pytbegin_arrays
cCs|jjdS(N(R<R(R?((s /usr/lib64/python2.7/plistlib.pyt	end_arrayscCs|jtdS(N(RtTrue(R?((s /usr/lib64/python2.7/plistlib.pytend_truescCs|jtdS(N(RtFalse(R?((s /usr/lib64/python2.7/plistlib.pyt	end_falsescCs|jt|jdS(N(RRVR(R?((s /usr/lib64/python2.7/plistlib.pytend_integerscCs|jt|jdS(N(RRuR(R?((s /usr/lib64/python2.7/plistlib.pytend_realscCs|j|jdS(N(RR(R?((s /usr/lib64/python2.7/plistlib.pyt
end_stringscCs |jtj|jdS(N(RRRR(R?((s /usr/lib64/python2.7/plistlib.pytend_datascCs|jt|jdS(N(RR^R(R?((s /usr/lib64/python2.7/plistlib.pytend_dates(RKRLR@RRRRRRRRRRRRRRRRRRR(((s /usr/lib64/python2.7/plistlib.pyRs(		
					
												RcBseZddZRS(sInvalid filecCstj||dS(N(RfR@(R?tmessage((s /usr/lib64/python2.7/plistlib.pyR@s(RKRLR@(((s /usr/lib64/python2.7/plistlib.pyRs(((( Rt__all__RRWt	cStringIOR	treR#RRRRRRR:tcompileRSR^R`RdRFRkRRwRRRRRRRfR(((s /usr/lib64/python2.7/plistlib.pyt<module>3s<				$				=		[
Back to Directory File Manager