֦io d Z g dZddlZddlZddlZddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
ej dde Z e j% ej& d Z G d
d Zd Z e
j. d
Zd2dZd Z e
j. de
j6 Z d Z d Z d Z G d d Z G d d Z! G d de! Z"d Z# G d d e$ Z%d d d d d!Z& e' Z( G d" d# Z)d$ Z*e+e,e-ej e.fZ/ G d% d&e' Z0d' Z1e2 e3e#e e"( e4 e3e1e)e0( iZ5de3d)d*Z6de3d)d+Z7e2d,d-d.d/Z8e2d-d,d0d1Z9y)3a> 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 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_BINARYloaddumploadsdumpsUID N)BytesIO) ParserCreate PlistFormatzFMT_XML FMT_BINARY)modulei c 0 e Zd Zd Zd Zd Zd Zd Zd Zy)r c t |t s t d |dk\ r t d |dk r t d || _ y )Nzdata must be an int zUIDs cannot be >= 2**64r
UIDs must be positive)
isinstanceint TypeError
ValueErrordataselfr s !/usr/lib64/python3.12/plistlib.py__init__z UID.__init__Q sE $$ 12 2 7? 67 7 !8 45 5 c | j S N)r r s r __index__z
UID.__index__Z s yyr c ` | j j dt | j dS )N()) __class____name__reprr r s r __repr__z UID.__repr__] s >>22DODDr c 4 | j | j ffS r )r$ r r s r
__reduce__zUID.__reduce__` s ~~ |++r c ` t |t st S | j |j k( S r )r r NotImplementedr )r others r __eq__z
UID.__eq__c s% %%! !yyEJJ&&r c , t | j S r )hashr r s r __hash__z UID.__hash__h s DII r N) r%
__module__ __qualname__r r r' r) r- r0 r r r r P s! E,'
r r s
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]c |dz dz }g }t dt | | D ]. }| |||z }|j t j | 0 dj | S )N r
r )rangelenappendbinascii
b2a_base64join)s
maxlinelength
maxbinsizepiecesichunks r _encode_base64rC | se "A%J
F
1c!fj
)!a*n%
h))%01 * 88F r c t | t r$t j | j d S t j | S )Nutf-8)r strr:
a2b_base64encode)r= s r _decode_base64rI s9 !S""188G#455 ""1%%r z{(?P\d\d\d\d)(?:-(?P\d\d)(?:-(?P\d\d)(?:T(?P\d\d)(?::(?P\d\d)(?::(?P\d\d))?)?)?)?)?Zc d}t j | j }g }|D ]% }|| }| n |j t | ' t j
| S )Nyearmonthdayhourminutesecond) _dateParsermatch groupdictr9 r datetime)r= ordergdlstkeyvals r _date_from_stringr[ sc @E 1 ' ' )B
Cg ;
3s8
c ""r c d| j | j | j | j | j | j
fz S )Nz %04d-%02d-%02dT%02d:%02d:%02dZrK )ds r _date_to_stringr^ s: + !((/ r c t j | }| t d | j dd } | j dd } | j dd } | j dd } | j d d
} | S ) Nz;strings can't contain control characters; use bytes insteadz
&z&z>)_controlCharPatsearchr replace)textms r _escaperj s~ t$A} - . . << %D <<d #D <<W %D <<V $D <<V $D Kr c e Zd Zd Zd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zd Zd Zd Zd Zd Zd Zy) _PlistParserc < g | _ d | _ d | _ || _ y r )stack current_keyroot
_dict_typer dict_types r r z_PlistParser.__init__ s
#r c F t | _ | j | j _ | j | j _ | j | j _ | j | j _ | j j | | j S r ) r parserhandle_begin_elementStartElementHandlerhandle_end_elementEndElementHandler handle_dataCharacterDataHandlerhandle_entity_declEntityDeclHandler ParseFilerp )r fileobjs r parsez_PlistParser.parse so "n *.*C*C '(,(?(? %+/+;+; ((,(?(? % g&yyr c t d )Nz8XML entity declarations are not supported in plist files)r )r entity_nameis_parameter_entityvaluebase system_id public_id
notation_names r r| z _PlistParser.handle_entity_decl s ##]^^r c H g | _ t | d|z d }| || y y )Nbegin_)r getattr)r elementattrshandlers r rv z!_PlistParser.handle_begin_element s. $7 2D9 EN r c 8 t | d|z d }| | y y )Nend_)r )r r r s r rx z _PlistParser.handle_end_element s% $ 0$7 I r c : | j j | y r )r r9 r s r rz z_PlistParser.handle_data s r c | j ct | j d t s"t d| j
j z || j d | j < d | _ y | j s|| _ y t | j d t s"t d| j
j z | j d j | y )Nz unexpected element at line %d)
ro r rn dictr ru CurrentLineNumberrp listr9 r r s r
add_objectz_PlistParser.add_object s ' djjnd3 !@!%!>!>"? @ @/4DJJrN4++ , #D DI djjnd3 !@!%!>!>"? @ @ JJrN ! !% (r c J dj | j }g | _ |S )N )r< r r s r get_dataz_PlistParser.get_data s wwtyy! r c | | j }| j | | j j | y r )rq r rn r9 )r r r] s r
begin_dictz_PlistParser.begin_dict s, OO
! r c | j r.t d| j | j j fz | j j y )Nz%missing value for key '%s' at line %d)ro r ru r rn popr s r end_dictz_PlistParser.end_dict sI D " . .t{{/L/L M N O
O
r c | j s t | j d t s"t d| j
j z | j | _ y )Nr zunexpected key at line %d)ro r rn r r ru r r r s r end_keyz_PlistParser.end_key sL :djjnd#C 8 ![[ : : ; <
< ==?r c ` g }| j | | j j | y r )r rn r9 )r r as r begin_arrayz_PlistParser.begin_array s%
! r c 8 | j j y r )rn r r s r end_arrayz_PlistParser.end_array s
r c & | j d y )NTr r s r end_truez_PlistParser.end_true s r c & | j d y )NFr r s r end_falsez_PlistParser.end_false s r c | j }|j d s|j d r | j t |d y | j t | y )N0x0X )r
startswithr r )r raws r end_integerz_PlistParser.end_integer
sF mmo >>$ 3>>$#7 OOCRL ) OOCH %r c T | j t | j y r )r floatr r s r end_realz_PlistParser.end_real s dmmo./r c B | j | j y r )r r r s r
end_stringz_PlistParser.end_string s
(r c T | j t | j y r )r rI r r s r end_dataz_PlistParser.end_data s t}}78r c T | j t | j y r )r r[ r r s r end_datez_PlistParser.end_date s )$--/:;r N)r% r1 r2 r r r| rv rx rz r r r r r r r r r r r r r r r3 r r rl rl sg $ _
)
+
&0)9 )rn r9 writelnr r r s r
begin_elementz _DumbXMLWriter.begin_element% s6
'" Vg%& a r c V | xj dz c_ | j d|z y )Nr z)r r r s r end_elementz_DumbXMLWriter.end_element* s&
a Ww&'r Nc ~ |'t | }| j d|d|d|d y | j d|z y )Nrc rd z)rj r )r r r s r simple_elementz _DumbXMLWriter.simple_element0 s7 ENE LL'5'B C
LL7* +r c |rnt |t r|j d }| j j | j
| j z | j j | | j j d y )NrE
)r rF rH r writer r )r lines r r z_DumbXMLWriter.writeln8 s^ $${{7+ IIOOD . . < = IIOOD ! r )r
r )r% r1 r2 r r r r r r3 r r r r s
( , r r c 6 e Zd Z ddZd Zd Zd Zd Zd Zy) _PlistWriterc ~ |r|j t t j | ||| || _ || _ y r )r PLISTHEADERr r
_sort_keys _skipkeys)r r r r writeHeader sort_keysskipkeyss r r z_PlistWriter.__init__E s5 JJ{ # dL&A#!r c j | j d | j | | j d y )Nzz)r write_valuer s r r z_PlistWriter.writeO s) ./ Z r c t |t r| j d| y |du r| j d y |du r| j d y t |t r9d|cxk rdk r#n t | | j dd |z y t | t |t
r | j d
t
| y t |t r| j | y t |t t f r| j | y t |t j r | j d t | y t |t t f r| j! | y t# d t% | z )
NstringTtrueFfalsel r integerz%drealdatezunsupported type: %s)r rF r r
OverflowErrorr r& r
write_dictbytes bytearray write_bytesrU r^ tupler write_arrayr typer s r r z_PlistWriter.write_valueT s4 eS ! % 0
d] '
e^ (
s
#5*7* $E** ##Ite|<#E**
u
% U 4
t
$ OOE "
y 1
2 U #
x 0 0
1 (> ?
t}
- U # 2T%[ @A Ar c
| j d | xj dz c_ t ddt | j j dd | j z z
}t
|| j d D ] }|s| j | | xj dz
c_ | j d y )Nr r r L s r )
r r maxr8 r rg rC splitr r )r r r> r s r r z_PlistWriter.write_bytesv s 6" a T[[((9D6xBBQQQ)_fpseekosSEEK_ENDreadr8 r structunpack _ref_size
_read_ints_object_offsets
_undefined_objects _read_objectOSError
IndexErrorerrorr r )r fptrailer offset_size num_objects
top_objectoffset_table_offsets r r z_BinaryPlistParser.parse s ) DH HHMM#r{{ +hhmmB'G7|r!*,,
j'2
T^[*# HHMM- .#'??; #LD 'L; 6DM$$Z0 0V\\= )&( ( )s CC 3D c |dk( rd| j j d d dz }d|z }dt | z }t j || j j | d S |S )z$ return the size of the next object. r r
r6 rd )r r _BINARY_FORMATr r )r tokenLri r= fs r _get_sizez _BinaryPlistParser._get_size se S=
a #c)AQAnQ''A==DHHMM!$45a8 8
r c t |t }| j j | } t | |k7 rt
||k( r|S t |||z
}|| j j | z
}||z
}Nr )min_MIN_READ_BUF_SIZEr r r8 r )r sizecursizer deltas r _readz_BinaryPlistParser._read sx d ./xx}}W%4yG#**$ 0E DHHMM%( (D u G r c | j |z t v r"t j d| t S s
t t fdt
d|z D S )Nrd c 3 V K | ] }t j ||z d " yw)bigN)r
from_bytes).0rA r r3 s r z0_BinaryPlistParser._read_ints.. s/ <":Q QD(95A":s &)r
)r6 r, r r r r r7 )r nr3 r s `@r r z _BinaryPlistParser._read_ints sr zz$(# > !==1QCt(<'=!>E E*,, <"'4!8T":< <
fr5 # z>d3 )seconds@ P r ` r
utf-16be c 3 @ K | ] }j | y wr )r )r; xr s r r< z2_BinaryPlistParser._read_object..X s A1$++A.s )r r r r r r r r: r r rU timedeltar/ r6 r r r? extendrq zipr r r )r refresultoffsettokentokenHr- r. r= r obj_refskey_refskos ` r r z _BinaryPlistParser._read_object s3 s# #M%%c*
f
a # ut| D=F
d]F
d]F
d]F
t^^^DHHMM!v+$>$)&A+ $ ?F d]]]4 q)9:1=F
d]]]4 q)9:1=F
d]
dDHHMM!$45a8A ''a3 ((34F t^v&AZZ]F
t^v&A::a=D[[)F
t^v&*A::a=D[[,F
t^
a&j(A5IJF
t^v&Aq)HF!'DMM# MMAA A t^v&Aq)Hq)H__&F!'DMM#
- ( 3DAq373D3DQ3GF4,,Q/0 4
'( ( #
c
-*,,
-s 47N NN) r% r1 r2 __doc__r r r/ r6 r r? r r3 r r r r s+ $)2
<2]r r c ( | dk ry| dk ry| dk ryy)N r r
r5 r r3 )counts r _count_to_sizere q s% v~ r c 0 e Zd Zd Zd Zd Zd Zd Zd Zy)_BinaryPlistWriterc . || _ || _ || _ y r )r r r )r r$ r r s r r z_BinaryPlistWriter.__init__ s #!r c g | _ i | _ i | _ | j | t | j }dg|z | _ t
| | _ t | j | _ | j j d | j D ] }| j | | j | }| j j }t
| }dt | |z z }| j j t j |g| j
d}||| j |||f} | j j t j dg| y )Nr
bplist00rd z >5xBBBQQQ)_objlist _objtable _objidtable_flattenr8 r re r r, _ref_formatr r
_write_object
_getrefnumtellr pack)
r r r' objr( r) r&
offset_format sort_versionr% s
r r z_BinaryPlistWriter.write s9
e $--( !s; ' 4)$..9
{# ==C s # ! __U+
"hhmmo$%89 n[ 9K GG
v{{=H43G3GHI +t~~{ +
v{{;99:r c D t |t rt | |f| j v ry t | | j
v ry t
| j }| j j | t |t r|| j t | |f< n|| j
t | < t |t rg }g }|j }| j r t | }|D ]O \ }}t |t s| j r#t d |j | |j | Q t! j" || D ] }| j% | y t |t& t( f r|D ] }| j% | y y )Nr )r _scalarsr rl idrm r8 rk r9 r r r r rF r r itertoolschainrn r r ) r r refnumkeysvaluesr r] vr^ s r rn z_BinaryPlistWriter._flatten sV eX &U U#t~~5
Y$**
* T]]#
U# eX &39DNNDK/ 0*0D RY ' eT "DFKKME u
1!!S)~~ #$:;; A
a
__T62
a 3 e}
-
a .r c t |t r| j t | |f S | j t | S r )r rx rl r rm ry r s r rq z _BinaryPlistWriter._getrefnum s9 eX &>>4;"67 7##BuI. .r c 8 |dk r3| j j t j d||z y |dk r5| j j t j d|dz d| y |dk r5| j j t j d|dz d| y |d k r5| j j t j d
|dz d | y | j j t j d |dz d
| y )Nr+ z>Bra z>BBBr rb z>BBH rc z>BBL z>BBQ )r r r rs )r rY r3 s r _write_sizez _BinaryPlistWriter._write_size s "9 HHNN6;;tUT\: ;
F] HHNN6;;vus{D$G H
G^ HHNN6;;vus{D$G H
G^ HHNN6;;vus{D$G H
HHNN6;;vus{D$G Hr c
| j | }| j j | j |< | | j j d y |du r | j j d y |du r | j j d y t |t rP|dk r2 | j j t j dd| y |d k r1| j j t j d
d | y |d k r1| j j t j d
d| y |dk r1| j j t j dd| y |dk r1| j j t j dd| y |dk r1| j j d|j d dd z y t | t |t r1| j j t j dd| y t |t j rY|t j ddd z
j }| j j t j dd | y t |t t f r7| j# d t% | | j j | y t |t& rI |j) d }| j# d t% | | j j | y t |t, r%|j. dk r t1 d# |j. d k r1| j j t j d
d$| y |j. d k r1| j j t j d
d%| y |j. dk r1| j j t j dd&| y |j. dk r1| j j t j dd'| y t | t |t2 t4 f r{|D cg c] }| j | }}t% | }| j# d(| | j j t j d)| j6 |z z g| y t |t8 rHg g } }| j: rt= |j? }
n|j? }
|
D ]m \ } } t | t& s| j@ r#tC d* |jE | j | | jE | j | o t% | }| j# d+| | j j t j d)| j6 |z z g| | j j t j d)| j6 |z z g| y tC | # t j $ r
t | d w xY w# t* $ r3 |j) d }| j# d!t% | d"z Y w xY wc c}w ),N F Tr r
z>Bqr ra z>BBr rb z>BHr rc z>BLr l z>BQr r9 rC z>BdrF rH r rG rJ r rK rM rL r
r rN rO rd r rR )#rq r rr r r r r r rs r# r to_bytesr rU
total_secondsr r r r8 rF rH UnicodeEncodeErrorr r r r r ro r r r r r r r9 )
r r rV r. tr^ refsr= keyRefsvalRefs rootItemsr] r s
r rp z _BinaryPlistWriter._write_object s ooe$$(HHMMO S! = HHNN7 #
e^ HHNN7 #
d] HHNN7 #
s
#qy9HHNN6;;udE#BC v{{5$ >? v{{5$ >? v{{5$ >? v{{5$ >? w E$ )O OP#E**
u
% HHNN6;;udE: ;
x 0 0
1**4A66EEGA HHNN6;;udA6 7
y 1
2 T3u: . HHNN5 !
s
#
4LL) s5z2
HHNN1
s
#zzA~ !899f$v{{5$ >?g%v{{5$ >?g%v{{5$ >?g%v{{5$ >?#E**
e}
-0561DOOA&D6D A T1 % HHNN6;;sT-=-=-A'AIDI J
t
$ !2WG "5;;= 1 !KKM !1!!S)~~ #$:;;tq 12tq 12
" G A T1 % HHNN6;;sT-=-=-A'ALGL M HHNN6;;sT-=-=-A'ALGL M E" "] || 9'.D89< &
4LL, s1v{3
4* 7s$ .0Y=
,Z "[ = Z 8[ [ N) r% r1 r2 r r rn rq r rp r3 r r rg rg s$ "
+;Z(!T/ I ^#r rg c | d d dk( S )Nr rj r3 )r s r _is_fmt_binaryr T s "1: $$r )detectru writerfmtrs c |W| j d }| j d t j D ] } |d | s|d } n t t | d } || }|j | S )zRead a .plist file. 'fp' should be a readable and binary file object.
Return the unpacked root object (which usually is a dictionary).
r r
r ru )rs )r r _FORMATSr~ r r )r$ r rs r infoPps r r r j s {
OO%D tH~f%N & '( (
SM( # I A 772;r c 4 t | }t ||| S )zqRead a .plist file from a bytes object.
Return the unpacked root object (which usually is a dictionary).
r )r r )r r rs r$ s r r r s
B y 11r TF)r r r c z |t vrt d| t | d ||| }|j | y)zWWrite 'value' to a .plist file. 'fp' should be a writable,
binary file object.
zUnsupported format: r )r r N)r r r )r r$ r r r r s r r r s= (3899
c]8
$R9x
PF
LLr r r r c V t }t | |||| |j S )z?Return a bytes object with the contents for a .plist file.
r )r r getvalue)r r r r r$ s r r r s'
Bh)D
;;=r )r ):r_ __all__r: r rU enumior rz r rer xml.parsers.expatr Enumr% r
globalsupdate __members__r2 r r compilere rC rI ASCIIrR r[ r^ rj rl r r r r r r, objectr r re rF r r r rx rg r r r r r r r r r r3 r r r s 7p
* dii
';HM (( ) B "**IJ & bjj X Z\ Zb Zb c #
k< k<\# # L[)> [)|B+J + SSS1
X
d dL
eX . . 6Q#& Q#h% T
!!
D , 2 #dU %4 r