o w[en@sdZgdZddlZddlZddlZddlZddlmZddlZddl Z ddl Z ddl Z ddl m Z ejddedZeejGd d d Zd Ze d Zd>ddZddZe de jZddZddZddZGdddZGdddZ Gddde Z!dd Z"Gd!d"d"e#Z$d#d$d%d&d'Z%e&Z'Gd(d)d)Z(d*d+Z)e*e+e,eje-fZ.Gd,d-d-e&Z/d.d/Z0e1e2e"ee!d0e3e2e0e(e/d0iZ4de2d1d2d3Z5de2d1d4d5Z6e1d6d7d8d9d:Z7e1d7d6d;dplistlib.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 dump(value, file) function. 'value' is the top level object, 'file' is a (writable) file object. To parse a plist from a file, use the load(file) function, with 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 loads() and dumps(). Values can be strings, integers, floats, booleans, tuples, lists, dictionaries (but only with string keys), Data, bytes, bytearray, or datetime.datetime objects. Generate Plist example: import datetime import plistlib pl = dict( aString = "Doodah", aList = ["A", "B", 12, 32.1, [1, 2, 3]], aFloat = 0.1, anInt = 728, aDict = dict( anotherString = "", aThirdString = "M\xe4ssig, Ma\xdf", aTrueValue = True, aFalseValue = False, ), someData = b"", someMoreData = b"" * 10, aDate = datetime.datetime.now() ) print(plistlib.dumps(pl).decode()) Parse Plist example: import plistlib plist = b''' foo bar ''' pl = plistlib.loads(plist) print(pl["foo"]) )InvalidFileExceptionFMT_XML FMT_BINARYloaddumploadsdumpsUIDN)BytesIO) ParserCreate PlistFormatzFMT_XML FMT_BINARY)modulec@<eZdZddZddZddZddZd d Zd d Zd S)rcCs<t|ts td|dkrtd|dkrtd||_dS)Nzdata must be an intzUIDs cannot be >= 2**64r UIDs must be positive) isinstanceint TypeError ValueErrordataselfrr/usr/lib/python3.10/plistlib.py__init__Ns  z UID.__init__cCs|jSN)rrrrr __index__Wsz UID.__index__cCsd|jjt|jfS)Nz%s(%s)) __class____name__reprrrrrr__repr__Zz UID.__repr__cCs|j|jffSr)rrrrrr __reduce__]zUID.__reduce__cCst|tstS|j|jkSr)rrNotImplementedr)rotherrrr__eq__`s  z UID.__eq__cCs t|jSr)hashrrrrr__hash__e z UID.__hash__N) r __module__ __qualname__rrr!r#r'r)rrrrrMs  rs zv[\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]LcCsP|dd}g}tdt||D]}||||}|t|qd|S)Nr )rangelenappendbinascii b2a_base64join)s maxlinelength maxbinsizepiecesichunkrrr_encode_base64ys  r=cCs$t|tr t|dSt|S)Nutf-8)rstrr4 a2b_base64encode)r7rrr_decode_base64s  rBz{(?P\d\d\d\d)(?:-(?P\d\d)(?:-(?P\d\d)(?:T(?P\d\d)(?::(?P\d\d)(?::(?P\d\d))?)?)?)?)?ZcCsLd}t|}g}|D]}||}|durn|t|q tj|S)Nyearmonthdayhourminutesecond) _dateParsermatch groupdictr3rdatetime)r7ordergdlstkeyvalrrr_date_from_strings rScCs d|j|j|j|j|j|jfS)Nz%04d-%02d-%02dT%02d:%02d:%02dZrC)drrr_date_to_strings  rUcCsZt|}|dur td|dd}|dd}|dd}|dd}|d d }|S) Nz;strings can't contain control characters; use bytes insteadz   &z&z>)_controlCharPatsearchrreplace)textmrrr_escapes      r`c@seZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)S)* _PlistParsercCsg|_d|_d|_||_dSr)stack current_keyroot _dict_typer dict_typerrrr z_PlistParser.__init__cCsBt|_|j|j_|j|j_|j|j_|j|j_ |j ||j Sr) r parserhandle_begin_elementStartElementHandlerhandle_end_elementEndElementHandler handle_dataCharacterDataHandlerhandle_entity_declEntityDeclHandler ParseFilerd)rfileobjrrrparses     z_PlistParser.parsecCstd)Nz8XML entity declarations are not supported in plist files)r)r entity_nameis_parameter_entityvaluebase system_id public_id notation_namerrrrpsz_PlistParser.handle_entity_declcCs.g|_t|d|d}|dur||dSdS)Nbegin_)rgetattr)relementattrshandlerrrrrjs  z!_PlistParser.handle_begin_elementcCs&t|d|d}|dur|dSdS)Nend_)r})rr~rrrrrls z_PlistParser.handle_end_elementcCs|j|dSr)rr3rrrrrnz_PlistParser.handle_datacCs|jdur$t|jdtistd|jj||jd|j<d|_dS|js,||_dSt|jdtgs>td|jj|jd|dS)Nzunexpected element at line %d) rcrrbtyperriCurrentLineNumberrdr3rrwrrr add_objects   z_PlistParser.add_objectcCsd|j}g|_|S)N)r6rrrrrget_datas z_PlistParser.get_datacCs"|}|||j|dSr)rerrbr3)rrrTrrr begin_dicts z_PlistParser.begin_dictcCs*|jrtd|j|jjf|jdS)Nz%missing value for key '%s' at line %d)rcrrirrbpoprrrrend_dicts  z_PlistParser.end_dictcCs8|js t|jdtistd|jj||_dS)Nrzunexpected key at line %d)rcrrbrrrirrrrrrend_keys z_PlistParser.end_keycCsg}|||j|dSr)rrbr3)rrarrr begin_arrays z_PlistParser.begin_arraycCs|jdSr)rbrrrrr end_arrayr$z_PlistParser.end_arraycC|ddS)NTrrrrrend_truer$z_PlistParser.end_truecCr)NFrrrrr end_falser$z_PlistParser.end_falsecCsB|}|ds|dr|t|ddS|t|dS)N0x0X)r startswithrr)rrawrrr end_integersz_PlistParser.end_integercC|t|dSr)rfloatrrrrrend_realr"z_PlistParser.end_realcCs||dSr)rrrrrr end_stringsz_PlistParser.end_stringcCrr)rrBrrrrrend_datar"z_PlistParser.end_datacCrr)rrSrrrrrend_dater"z_PlistParser.end_dateN)rr+r,rrtrprjrlrnrrrrrrrrrrrrrrrrrrras*  rac@s8eZdZdddZddZddZdd d Zd d Zd S)_DumbXMLWriterr  cCs||_g|_||_||_dSr)filerb _indent_levelindent)rr indent_levelrrrrrrhz_DumbXMLWriter.__init__cCs,|j||d||jd7_dS)Nz<%s>)rbr3writelnrrr~rrr begin_element"s z_DumbXMLWriter.begin_elementcCs@|jdksJ|j|ksJ|jd8_|d|dS)Nr rz)rrbrrrrrr end_element'sz_DumbXMLWriter.end_elementNcCs:|durt|}|d|||fdS|d|dS)Nz <%s>%sz<%s/>)r`r)rr~rwrrrsimple_element-sz_DumbXMLWriter.simple_elementcCsH|rt|tr |d}|j|j|j|j||jddS)Nr> )rr?rArwriterr)rlinerrrr5s    z_DumbXMLWriter.writeln)r rr)rr+r,rrrrrrrrrrs    rc@sBeZdZ  dddZdd Zd d Zd d ZddZddZdS) _PlistWriterr  rTFcCs.|r|tt||||||_||_dSr)r PLISTHEADERrr _sort_keys _skipkeys)rrrr writeHeader sort_keysskipkeysrrrrBs   z_PlistWriter.__init__cCs"|d|||ddS)Nzz)r write_valuerrrrrLs  z_PlistWriter.writecCs(t|tr |d|dS|dur|ddS|dur#|ddSt|trEd|kr2dkrAnt||dd |dSt|t|trT|d t|dSt|tr`||dSt|t t frn| |dSt|t j r~|d t |dSt|ttfr||dStd t|) NstringTtrueFfalselrintegerz%drealdatezunsupported type: %s)rr?rr OverflowErrorrr dict write_dictbytes bytearray write_bytesrMrUtuplelist write_arrayrrrrrrrQs,     z_PlistWriter.write_valuecCsz|d|jd8_tddt|jdd|j}t||dD] }|r.||q%|jd7_| ddS)Nrrrr-rs r) rrmaxr2rr]r=splitrr)rrr8rrrrrss  z_PlistWriter.write_bytescCs|r;|d|jrt|}n|}|D]\}}t|ts(|jr$qtd|d|| |q| ddS|ddS)Nrkeys must be stringsrQ) rrsorteditemsrr?rrrrr)rrTrrQrwrrrrs     z_PlistWriter.write_dictcCs>|r|d|D]}||q |ddS|ddS)Narray)rrrr)rrrwrrrrs   z_PlistWriter.write_arrayN)r rrTF) rr+r,rrrrrrrrrrrAs  " rcCsd}|D] }||rdSqtjdftjdftjdffD]'\}}||s'q|D]}||d|}|dt||krCdSq)qdS)N)sz utf-16-bez utf-16-leasciiF)rcodecsBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LEdecoderAr2)headerprefixespfxbomencodingstartprefixrrr _is_fmt_xmls$  rc@seZdZdddZdS)r Invalid filecCst||dSr)rr)rmessagerrrrrzInvalidFileException.__init__N)r)rr+r,rrrrrrsrBHLQ)rr.c@s@eZdZdZddZddZddZdd Zd d Zd d Z dS)_BinaryPlistParsera Read or write a binary plist file, following the description of the binary format. Raise InvalidFileException in case of error, otherwise return the root object. see also: http://opensource.apple.com/source/CF/CF-744.18/CFBinaryPList.c cCs ||_dSr)rerfrrrrr*z_BinaryPlistParser.__init__c Csz?||_|jdtj|jd}t|dkrttd|\}|_ }}}|j|| |||_ t g||_ ||WStttjttfyOtw)Ni z>6xBBQQQ)_fpseekosSEEK_ENDreadr2rstructunpack _ref_size _read_ints_object_offsets _undefined_objects _read_objectOSError IndexErrorerrorrr)rfptrailer offset_size num_objects top_objectoffset_table_offsetrrrrts&         z_BinaryPlistParser.parsecCsL|dkr$|jddd@}d|>}dt|}t||j|dS|S)z$ return the size of the next object.rr r/rZ)rr_BINARY_FORMATrr)rtokenLr_r7frrr _get_sizes  z_BinaryPlistParser._get_sizecsp|j|tvrtd|tSr#t|kr&ttfddtd|DS)NrZc3s(|]}t||dVqdS)bigN)r from_bytes).0r;rsizerr s z0_BinaryPlistParser._read_ints..r ) rrrrrr2rrr1)rnrrrrrsz_BinaryPlistParser._read_intscCs|||jSr)rr)rrrrr _read_refsr$z_BinaryPlistParser._read_refscsj|}|tur |Sj|}j|jdd}|d@|d@}}|dkr/d}n@|dkr7d}n8|dkr?d }n0|dkrGd }n(|d kr]tjjd|>d |d kd}n|dkrot djdd}n|dkrt djdd}n|dkrt djdd}t dddt j |d}n|dkr |}j|}t ||krtn|dkrՈ |}j|} t | |krt| d}n|dkr |d}j|} t | |krt| d}nz|dkr ttjd|d }nf|dkr, |}|} g}|j|<|fdd | DnC|d!krl |}|} |} }|j|<zt| | D]\} } | || <qOWntyktwt|j|<|S)"zx read the object by reference. May recursively read sub-objects (content of an array/dict/set) rr rNrF Tr0rrr/signed"z>fr.#z>d3)seconds@Pr`rutf-16bec3s|]}|VqdSr)r)rxrrrrOsz2_BinaryPlistParser._read_object..)rrrrrrrrrrrM timedeltarr2rrrrextendreziprr)rrefresultoffsettokentokenHrrr7robj_refskey_refskorrrrs                           z_BinaryPlistParser._read_objectN) rr+r,__doc__rrtrrrrrrrrrs  rcCs(|dkrdS|dkr dS|dkrdSdS)Nrrr.rr)countrrr_count_to_sizehsr+c@r)_BinaryPlistWritercCs||_||_||_dSr)rrr)rrrrrrrrxs z_BinaryPlistWriter.__init__c Csg|_i|_i|_||t|j}dg||_t||_t|j|_ |j d|jD]}| |q-| |}|j }t|}dt||}|j tj|g|jRd}|||j|||f} |j tjdg| RdS)Nr bplist00rZz >5xBBBQQQ)_objlist _objtable _objidtable_flattenr2rr+rr _ref_formatrr _write_object _getrefnumtellrpack) rrwrobjrrr offset_format sort_versionrrrrr}s*           z_BinaryPlistWriter.writec Cs$t|trt||f|jvrdSn t||jvrdSt|j}|j|t|tr4||jt||f<n||jt|<t|t r}g}g}| }|j rOt |}|D]\}}t|t sb|jr^qQtd||||qQt||D]}||qsdSt|ttfr|D] }||qdSdS)Nr)r_scalarsrr/idr0r2r.r3rrrrr?rr itertoolschainr1rr) rrwrefnumkeysvaluesrr$vr%rrrr1s@           z_BinaryPlistWriter._flattencCs*t|tr|jt||fS|jt|Sr)rr:r/rr0r;rrrrr4s z_BinaryPlistWriter._getrefnumcCs|dkr|jtd||BdS|dkr&|jtd|dBd|dS|dkr:|jtd|dBd|dS|d krN|jtd |dBd |dS|jtd |dBd |dS)Nrz>Br'z>BBBrr(z>BBHr)z>BBLz>BBQ)rrrr6)rr rrrr _write_sizes    z_BinaryPlistWriter._write_sizec sj|}jj|<|durjddS|dur%jddS|dur1jddSt|tr|dkrVzjtdd|WdStj yUt |dw|d krgjtd d |dS|d krxjtd d|dS|dkrjtdd|dS|dkrjtdd|dS|dkrjd|j d ddddSt |t|t rĈjtdd|dSt|t j r|t ddd}jtdd|dSt|ttfrdt|j|dSt|tr0z|d}dt|Wnty'|d }d!t|d"Ynwj|dSt|tr|jdkr@td#|jd krSjtd d$|dS|jd krfjtd d%|dS|jdkryjtdd&|dS|jdkrjtdd'|dSt |t|ttfrfd(d)|D}t|}d*|jtjd+j|g|RdSt|tr1gg}}jrt|} n|} | D]%\} } t| tsj rqt!d,|"| |"| qt|}d-|jtjd+j|g|Rjtjd+j|g|RdSt!|).NFTrr z>BqrDr'z>BBrr(z>BHrBr)z>BLrClz>BQrrr z>Bdrrrrrrrrrrrrcsg|]}|qSr)r4)rr%rrr -sz4_BinaryPlistWriter._write_object..rrZrr)#r4rr5rrrrrr6rrto_bytesrrM total_secondsrrrEr2r?rAUnicodeEncodeErrorrrrrrr2rrrrrrr3) rrwrrtrefsr7keyRefsvalRefs rootItemsr$rArrrr3s                (     $(z _BinaryPlistWriter._write_objectN) rr+r,rrr1r4rEr3rrrrr,ws-* r,cCs|dddkS)Nrr-r)rrrr_is_fmt_binaryKrrU)detectriwriterfmtrgcCsj|dur%|d}|dtD]}|d|r |d}nqtnt|d}||d}||S)zRead a .plist file. 'fp' should be a readable and binary file object. Return the unpacked root object (which usually is a dictionary). Nrr rVri)rg)rr_FORMATSr@rrt)rrYrgrinfoPprrrras       rcCst|}t|||dS)zqRead a .plist file from a bytes object. Return the unpacked root object (which usually is a dictionary). rX)r r)rwrYrgrrrrrwsrTF)rYrrcCs:|tvr td|ft|d|||d}||dS)zWWrite 'value' to a .plist file. 'fp' should be a writable, binary file object. zUnsupported format: %rrW)rrN)rZrr)rwrrYrrrWrrrrsrrYrrcCs t}t|||||d|S)z?Return a bytes object with the contents for a .plist file. r^)r rgetvalue)rwrYrrrrrrrsr)r-)9r&__all__r4rrMenumior r<rrerxml.parsers.expatr Enumrr globalsupdate __members__rrcompiler[r=rBASCIIrJrSrUr`rarrrrrrobjectrrr+r?rrrr:r,rUrrrrZrrrrrrrrsl8  !     n&^!! U