a :jHo@sdZgdZddlZddlZddlZddlZddlmZddlZddl Z ddl Z ddl Z ddl m Z ejddedZeejd ZGd d d Zd Ze d Zd?ddZddZe de jZddZddZddZGdddZ GdddZ!Gddde!Z"d d!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'Z0d/d0Z1e2e3e#e e"d1e4e3e1e)e0d1iZ5de3d2d3d4Z6de3d2d5d6Z7e2d7d8d9d:d;Z8e2d8d7d<d=d>Z9dS)@aplistlib.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: pl = dict( aString = "Doodah", aList = ["A", "B", 12, 32.1, [1, 2, 3]], aFloat = 0.1, anInt = 728, aDict = dict( anotherString = "", aUnicodeValue = "M\xe4ssig, Ma\xdf", aTrueValue = True, aFalseValue = False, ), someData = b"", someMoreData = b"" * 10, aDate = datetime.datetime.fromtimestamp(time.mktime(time.gmtime())), ) with open(fileName, 'wb') as fp: dump(pl, fp) Parse Plist example: with open(fileName, 'rb') as fp: pl = load(fp) print(pl["aKey"]) )InvalidFileExceptionFMT_XML FMT_BINARYloaddumploadsdumpsUIDN)BytesIO) ParserCreate PlistFormatzFMT_XML FMT_BINARY)moduleic@s<eZdZddZddZddZddZd d Zd d Zd S)rcCs<t|tstd|dkr"td|dkr2td||_dS)Nzdata must be an intzUIDs cannot be >= 2**64r UIDs must be positive) isinstanceint TypeError ValueErrordataselfrr/usr/lib/python3.9/plistlib.py__init__Hs z UID.__init__cCs|jSN)rrrrr __index__Qsz UID.__index__cCsd|jjt|jfS)Nz%s(%s)) __class____name__reprrrrrr__repr__Tsz UID.__repr__cCs|j|jffSr)rrrrrr __reduce__WszUID.__reduce__cCst|tstS|j|jkSr)rrNotImplementedr)rotherrrr__eq__Zs z UID.__eq__cCs t|jSr)hashrrrrr__hash___sz UID.__hash__N) r __module__ __qualname__rrr r!r$r&rrrrrGs  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|q d|S)Nr )rangelenappendbinasciiZ b2a_base64join)s maxlinelengthZ maxbinsizepiecesichunkrrr_encode_base64ss  r7cCs(t|trt|dSt|SdS)Nutf-8)rstrr0Z a2b_base64encode)r2rrr_decode_base64|s r;z{(?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]&}||}|dur2qB|t|qtj|S)NZyearZmonthZdayZhourZminutesecond) _dateParsermatch groupdictr/rdatetime)r2orderZgdZlstkeyvalrrr_date_from_stringsrEcCs d|j|j|j|j|j|jfS)Nz%04d-%02d-%02dT%02d:%02d:%02dZr<)drrr_date_to_strings  rGcCsZt|}|durtd|dd}|dd}|dd}|dd}|d d }|S) Nzz>)_controlCharPatsearchrreplace)textmrrr_escapes      rRc@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_typerrrrsz_PlistParser.__init__cCsBt|_|j|j_|j|j_|j|j_|j|j_ |j ||j Sr) r parserhandle_begin_elementZStartElementHandlerhandle_end_elementZEndElementHandler handle_dataZCharacterDataHandlerhandle_entity_declZEntityDeclHandlerZ ParseFilerV)rZfileobjrrrparses     z_PlistParser.parsecCs tddS)Nz8XML entity declarations are not supported in plist files)r)rZ entity_nameZis_parameter_entityvaluebaseZ system_idZ public_idZ notation_namerrrr^sz_PlistParser.handle_entity_declcCs*g|_t|d|d}|dur&||dS)NZbegin_)rgetattr)relementattrshandlerrrrr[sz!_PlistParser.handle_begin_elementcCs"t|d|d}|dur|dS)NZend_)rb)rrcrerrrr\sz_PlistParser.handle_end_elementcCs|j|dSr)rr/rrrrr]sz_PlistParser.handle_datacCs|jdurFt|jdtis.td|jj||jd|j<d|_nB|jsT||_n4t|jdtgsxtd|jj|jd|dS)Nzunexpected element at line %d) rUrrTtyperrZCurrentLineNumberrVr/rr`rrr add_objects z_PlistParser.add_objectcCsd|j}g|_|S)N)r1rrrrrget_datas z_PlistParser.get_datacCs"|}|||j|dSr)rWrjrTr/)rrdrFrrr begin_dicts z_PlistParser.begin_dictcCs*|jrtd|j|jjf|jdS)Nz%missing value for key '%s' at line %d)rUrrZrhrTpoprrrrend_dicts  z_PlistParser.end_dictcCs8|jst|jdtis*td|jj||_dS)Nrfzunexpected key at line %d)rUrrTrgrrZrhrlrrrrend_keys z_PlistParser.end_keycCsg}|||j|dSr)rjrTr/)rrdarrr begin_arrays z_PlistParser.begin_arraycCs|jdSr)rTrnrrrr end_arraysz_PlistParser.end_arraycCs|ddS)NTrjrrrrend_truesz_PlistParser.end_truecCs|ddS)NFrtrrrr end_falsesz_PlistParser.end_falsecCs@|}|ds|dr.|t|dn|t|dS)NZ0xZ0X)rl startswithrjr)rrawrrr end_integersz_PlistParser.end_integercCs|t|dSr)rjfloatrlrrrrend_realsz_PlistParser.end_realcCs||dSr)rjrlrrrr end_string sz_PlistParser.end_stringcCs|t|dSr)rjr;rlrrrrend_datasz_PlistParser.end_datacCs|t|dSr)rjrErlrrrrend_datesz_PlistParser.end_dateN)rr'r(rr_r^r[r\r]rjrlrmrorprrrsrurvrzr|r}r~rrrrrrSs( rSc@s8eZdZdddZddZddZdd d Zd d Zd S)_DumbXMLWriterr  cCs||_g|_||_||_dSr)filerT _indent_levelindent)rr indent_levelrrrrrsz_DumbXMLWriter.__init__cCs,|j||d||jd7_dS)Nz<%s>)rTr/writelnrrrcrrr begin_elements z_DumbXMLWriter.begin_elementcCs@|jdksJ|j|ks J|jd8_|d|dS)Nr rz)rrTrnrrrrr end_element!sz_DumbXMLWriter.end_elementNcCs8|dur&t|}|d|||fn|d|dS)Nz <%s>%sz<%s/>)rRr)rrcr`rrrsimple_element'sz_DumbXMLWriter.simple_elementcCsH|r8t|tr|d}|j|j|j|j||jddS)Nr8 )rr9r:rwriterr)rlinerrrr/s    z_DumbXMLWriter.writeln)r r)N)rr'r(rrrrrrrrrrs   rc@s>eZdZdddZdd Zd d Zd d ZddZddZdS) _PlistWriterr  rTFcCs.|r|tt||||||_||_dSr)r PLISTHEADERrr _sort_keys _skipkeys)rrrrZ writeHeader sort_keysskipkeysrrrr<s  z_PlistWriter.__init__cCs"|d|||ddS)Nzz)r write_valuerirrrrFs  z_PlistWriter.writecCst|tr|d|n|dur,|dn|dur@|dnt|tr~d|kr^dkrtnn|dd |nt|nt|tr|d t|nzt|tr||ndt|t t fr| |nJt|t j r|d t |n,t|ttfr||ntd t|dS) NstringTZtrueFZfalselrZintegerz%drealdatezunsupported type: %s)rr9rr OverflowErrorr{rdict write_dictbytes bytearray write_bytesrArGtuplelist write_arrayrrgrirrrrKs*           z_PlistWriter.write_valuecCsz|d|jd8_tddt|jdd|j}t||dD]}|rJ||qJ|jd7_| ddS)Nrrrwr)rs r) rrmaxr.rrOr7splitrr)rrr3rrrrrms  z_PlistWriter.write_bytescCs|rt|d|jr"t|}n|}|D]8\}}t|tsP|jrHq.td|d|| |q.| dn |ddS)Nrkeys must be stringsrC) rrsorteditemsrr9rrrrr)rrFrrCr`rrrrzs      z_PlistWriter.write_dictcCs<|r.|d|D]}||q|dn |ddS)Narray)rrrr)rrr`rrrrs    z_PlistWriter.write_arrayN)r rrTF) rr'r(rrrrrrrrrrr;s " rcCsd}|D]}||rdSqtjdftjdftjdffD]N\}}||sNq:|D]4}||d|}|dt||krRdSqRq:dS)N)s6xBBQQQ)_fpseekosSEEK_ENDreadr.rstructunpack _ref_size _read_ints_object_offsets _undefined_objects _read_objectOSError IndexErrorerrorrr)rfptrailer offset_size num_objects top_objectoffset_table_offsetrrrr_s$         z_BinaryPlistParser.parsecCsL|dkrH|jddd@}d|>}dt|}t||j|dS|S)z$ return the size of the next object.rr r+rL)rr_BINARY_FORMATrr)rtokenLrQr2frrr _get_sizes  z_BinaryPlistParser._get_sizecCs^t|t}|j|}t||kr&t||kr2|St|||}||j|7}||7}qdSr)min_MIN_READ_BUF_SIZErrr.r)rsizeZcursizerZdeltarrr_reads   z_BinaryPlistParser._readcsb||tvr0td|tSs:ttfddtd|DSdS)NrLc3s&|]}t||dVqdS)bigN)r from_bytes).0r5rrrr sz0_BinaryPlistParser._read_ints..r )rrrrrrr-)rnrrrrrsz_BinaryPlistParser._read_intscCs|||jSr)rr)rrrrr _read_refssz_BinaryPlistParser._read_refscsj|}|tur|Sj|}j|jdd}|d@|d@}}|dkr^d}n\|dkrnd}nL|dkr~d }n<|dkrd }n,|d krtjjd|>d |d kd}n|dkrt djdd}n|dkrt djdd}n|dkrDt djdd}t dddt j |d}nv|dkrf |} |}nT|dkr |} |} | d}n(|dkr |d} |} | d}n|dkrttjd|d }n|dkr. |}|} g}|j|<|fdd | Dn|d!kr |}|} |} }|j|<z.t| | D]\} } | || <qtWntytYn0nt|j|<|S)"zx read the object by reference. May recursively read sub-objects (content of an array/dict/set) rr rNrF Tr,rwrr+Zsigned"z>fr*#z>d3)Zseconds@Pr`rutf-16bec3s|]}|VqdSr)r)rxrrrrOr,z2_BinaryPlistParser._read_object..)rrrrrrrrrrrAZ timedeltarrrrrextendrWziprrr)rrefresultoffsettokenZtokenHrrr2rZobj_refsZkey_refskorrrr sz                           z_BinaryPlistParser._read_objectN) rr'r(__doc__rr_rrrrrrrrrrs   rcCs,|dkr dS|dkrdS|dkr$dSdSdS)Nrrr*rr)countrrr_count_to_sizehsrc@s<eZdZddZddZddZddZd d Zd d Zd S)_BinaryPlistWritercCs||_||_||_dSr)rrr)rrrrrrrrxsz_BinaryPlistWriter.__init__c Csg|_i|_i|_||t|j}dg||_t||_t|j|_ |j d|jD]}| |qZ| |}|j }t|}dt||}|j tj|g|jRd}|||j|||f} |j tjdg| RdS)Nr bplist00rLz >5xBBBQQQ)_objlist _objtable _objidtable_flattenr.rrrr _ref_formatrr _write_object _getrefnumtellrpack) rr`robjrrrZ offset_formatZ sort_versionrrrrr}s*           z_BinaryPlistWriter.writec Cs"t|tr"t||f|jvr4dSnt||jvr4dSt|j}|j|t|trh||jt||f<n||jt|<t|t rg}g}| }|j rt |}|D]6\}}t|t s|jrqtd||||qt||D]}||qn&t|ttfr|D]}||q dS)Nr)r_scalarsrgridrr.rr/rrrrr9rr itertoolschainrrr) rr`Zrefnumkeysvaluesrrvrrrrrs8         z_BinaryPlistWriter._flattencCs.t|tr|jt||fS|jt|SdSr)rr rrgrrrirrrr s z_BinaryPlistWriter._getrefnumcCs|dkr"|jtd||Bn|dkrH|jtd|dBd|nh|dkrn|jtd|dBd|nB|d kr|jtd |dBd |n|jtd |dBd |dS)Nrz>Brz>BBBrwrz>BBHrz>BBLz>BBQ)rrrr )rrrrrr _write_sizesz_BinaryPlistWriter._write_sizec st|}jj|<|dur2jdn>|durJjdn&|durbjdnt|trj|dkrzjtdd|Wntj yt |dYn0n|d kr҈jtd d |n|d krjtd d|nt|dkrjtdd|nR|dkr6jtdd|n0|dkr^jd|j d dddnt |nt|t rjtdd|nt|t j r|t ddd}jtdd|nt|ttfrdt|j|nrt|trlz|d}dt|Wn2tyZ|d }d!t|d"Yn0j|nt|tr*|jdkrtd#n|jd krjtd d$|nt|jd krֈjtd d%|nP|jdkrjtdd&|n,|jdkrjtdd'|nt |nFt|ttfrfd(d)|D}t|}d*|jtjd+j|g|Rnt|trhgg}}jrt|} n|} | D]J\} } t| tsj rސqt!d,|"| |"| qt|}d-|jtjd+j|g|Rjtjd+j|g|Rnt!|dS).NFTrr z>Bqrrz>BBrwrz>BHrrz>BLrlz>BQrrrz>Bdrrrrrrrrrrrrcsg|]}|qSr)r )rrrrr -r,z4_BinaryPlistWriter._write_object..rrLrr)#r rr rrrrrr rrto_bytesr{rAZ total_secondsrrrr.r9r:UnicodeEncodeErrorrrrrrrrrrrrrr/) rr`rrtZrefsr2ZkeyRefsZvalRefsZ rootItemsrrrrrrs                   &     $&z _BinaryPlistWriter._write_objectN) rr'r(rrrr rrrrrrrws -*rcCs|dddkS)Nrrr)rrrr_is_fmt_binaryKsr")detectrZwriterfmtrYcCsj|durJ|d}|dtD]}|d|r$|d}qVq$tn t|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 r#rZ)rY)rr_FORMATSrrr_)rr&rYrinfoPprrrras      rcCst|}t|||dS)zqRead a .plist file from a bytes object. Return the unpacked root object (which usually is a dictionary). r%)r r)r`r&rYrrrrrwsrTF)r&rrcCs:|tvrtd|ft|d|||d}||dS)zWWrite 'value' to a .plist file. 'fp' should be a writable, binary file object. zUnsupported format: %rr$)rrN)r'rr)r`rr&rrr$rrrrsrr&rrcCs t}t|||||d|S)z?Return a bytes object with the contents for a .plist file. r+)r rgetvalue)r`r&rrrrrrrsr)r)):r__all__r0rrAenumior rrrerZxml.parsers.expatr Enumrr globalsupdate __members__rrrcompilerMr7r;ASCIIr>rErGrRrSrrrrrrobjectrrrr9rr{rr rr"rrrr'rrrrrrrrsl/  !    n&^!' U