ؑJ>'J d Z g dZddlZddlZddlZddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
ej dde Z e ej d Z G d
d Zd Z e
j d
Zd3dZd Z e
j de
j 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/d0Z8e2d.d-d1d2Z9dS )4a> 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 2 e Zd Zd Zd Zd Zd Zd Zd ZdS )r c t |t st d |dk rt d |dk rt d || _ d S )Nzdata must be an int zUIDs cannot be >= 2**64r
UIDs must be positive)
isinstanceint TypeError
ValueErrordataselfr s //opt/alt/python311/lib64/python3.11/plistlib.py__init__z UID.__init__Q s^ $$$ 3 122 2 7?? 677 7 !88 455 5 c | j S N)r r s r __index__z
UID.__index__Z s
yr c J | j j dt | j dS )N()) __class____name__reprr r s r __repr__z UID.__repr__] s$ >222DOOOODDr c | j | j ffS r )r$ r r s r
__reduce__zUID.__reduce__` s ~ |++r c Z t |t st S | j |j k S r )r r NotImplementedr )r others r __eq__z
UID.__eq__c s) %%% "! !yEJ&&r c * t | j S r )hashr r s r __hash__z UID.__hash__h s DI r N) r%
__module__ __qualname__r r r' r) r- r0 r r r r P sq E E 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]L c |dz dz }g }t dt | | D ]6}| |||z }| t j | 7d | S )N r
r )rangelenappendbinascii
b2a_base64join)s
maxlinelength
maxbinsizepiecesichunks r _encode_base64rD | s| "A%J
F
1c!ffj
)
) 2 2!a*n$%
h)%001111 88F r c t | t r't j | d S t j | S )Nutf-8)r strr;
a2b_base64encode)r> s r _decode_base64rJ sD !S &"188G#4#4555 "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 | }g }|D ]0}|| }| n#| t | 1t j | S )Nyearmonthdayhourminutesecond) _dateParsermatch groupdictr: r datetime)r> ordergdlstkeyvals r _date_from_stringr\ sv @E 1 ' ' ) )B
C g ; E
3s88 c ""r c T d| j | j | j | j | j | j fz S )Nz %04d-%02d-%02dT%02d:%02d:%02dZrL )ds r _date_to_stringr_ s. + !(/ r c 8 t | }|t d | dd } | dd } | dd } | dd } | d d
} | S ) Nz;strings can't contain control characters; use bytes insteadz
&z&z>)_controlCharPatsearchr replace)textms r _escaperk 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 ZdS ) _PlistParserc > g | _ d | _ d | _ || _ d S r )stack current_keyroot
_dict_typer dict_types r r z_PlistParser.__init__ s#
#r c t | _ | j | j _ | j | j _ | j | j _ | j | j _ | j
| | j S r ) r parserhandle_begin_elementStartElementHandlerhandle_end_elementEndElementHandler handle_dataCharacterDataHandlerhandle_entity_declEntityDeclHandler ParseFilerq )r fileobjs r parsez_PlistParser.parse s_ "nn *.*C '(,(? %+/+; ((,(? % g&&&yr 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 Z g | _ t | d|z d }|
|| d S d S )Nbegin_)r getattr)r elementattrshandlers r rw z!_PlistParser.handle_begin_element s> $7 2D99 GENNNNN r c J t | d|z d }| | d S d S )Nend_)r )r r r s r ry z _PlistParser.handle_end_element s5 $ 0$77 GIIIII r c : | j | d S r )r r: r s r r{ z_PlistParser.handle_data s r c | j bt | j d t i s t d| j j z || j d | j < d | _ d S | j s || _ d S t | j d t g s t d| j j z | j d | d S )Nz unexpected element at line %d) rp r ro typer rv CurrentLineNumberrq r: r r s r
add_objectz_PlistParser.add_object s ' djnd2hh77
@ !@!%!>"? @ @ @/4DJrN4+ , #D ) DIII djnd2hh77
@ !@!%!>"? @ @ @ JrN ! !% ( ( ( ( (r c H d | j }g | _ |S )N )r= r r s r get_dataz_PlistParser.get_data s! wwty!! r c | }| | | j | d S r )rr r ro r: )r r r^ s r
begin_dictz_PlistParser.begin_dict s? OO
! r c | j r#t d| j | j j fz | j d S )Nz%missing value for key '%s' at line %d)rp r rv r ro popr s r end_dictz_PlistParser.end_dict sT O D " .t{/L M N O O
O
r c | j s(t | j d t i s t d| j j z | | _ d S )Nr zunexpected key at line %d)rp r ro r r rv r r r s r end_keyz_PlistParser.end_key sb <:djnd2hh#G#G < 8 ![ : ; < <
< ==??r c h g }| | | j | d S r )r ro r: )r r as r begin_arrayz_PlistParser.begin_array s5
! r c 8 | j d S r )ro r r s r end_arrayz_PlistParser.end_array s
r c 0 | d d S )NTr r s r end_truez_PlistParser.end_true s r c 0 | d d S )NFr r s r end_falsez_PlistParser.end_false s r c | }| d s| d r%| t |d d S | t | d S )N0x0X )r
startswithr r )r raws r end_integerz_PlistParser.end_integer
st mmoo >>$ &3>>$#7#7 & OOCRLL ) ) ) ) ) OOCHH % % % % %r c n | t | d S r )r floatr r s r end_realz_PlistParser.end_real s* dmmoo../////r c T | | d S r )r r r s r
end_stringz_PlistParser.end_string s"
(((((r c n | t | d S r )r rJ r r s r end_dataz_PlistParser.end_data s* t}}7788888r c n | t | d S r )r r\ r r s r end_datez_PlistParser.end_date s+ )$--//::;;;;;r N)r% r1 r2 r r r} rw ry r{ r r r r r r r r r r r r r r r3 r r rm rm sC $ $ $ _ _ _
) ) )
+ + +
& & &0 0 0) ) )9 9 9< < < < || _ g | _ || _ || _ d S r )filero
_indent_levelindent)r r indent_levelr s r r z_DumbXMLWriter.__init__ s#
) r c | j | | d|z | xj dz
c_ d S )Nz<%s> )ro r: writelnr r r s r
begin_elementz _DumbXMLWriter.begin_element% sI
'""" Vg%&&& a r c V | xj dz c_ | d|z d S )Nr z)r r r s r end_elementz_DumbXMLWriter.end_element* s5
a Ww&'''''r Nc |0t | }| d|d|d|d d S | d|z d S )Nrd re z)rk r )r r r s r simple_elementz _DumbXMLWriter.simple_element0 s_ ENNE LLL'''555'''B C C C C C
LL7* + + + + +r c |rkt |t r| d }| j | j | j z | j | | j d d S )NrF
)r rG rI r writer r )r lines r r z_DumbXMLWriter.writeln8 s{ " $$$
,{{7++ IOOD . < = = = IOOD ! ! ! r )r
r r )r% r1 r2 r r r r r r3 r r r r si
( ( ( , , , , r r c 8 e Zd Z d
dZd Zd Zd Zd
Zd Zd S ) _PlistWriterr
r TFc |r| t t | ||| || _ || _ d S r )r PLISTHEADERr r
_sort_keys _skipkeys)r r r r writeHeader sort_keysskipkeyss r r z_PlistWriter.__init__E sJ $ JJ{ # # # dL&AAA#!r c | d | | | d d S )Nzz)r write_valuer s r r z_PlistWriter.writeO sA ./// Z r c t |t r| d| d S |du r| d d S |du r| d d S t |t r:d|cxk rdk r n n| dd |z d S t | t |t
r%| d
t
| d S t |t r| | d S t |t t f r| | d S t |t j r%| d t | d S t |t t f r| | d S t# d t% | z )
NstringTtrueFfalsel r integerz%drealdatezunsupported type: %s)r rG r r
OverflowErrorr r& dict
write_dictbytes bytearray write_bytesrV r_ tuplelist write_arrayr r r s r r z_PlistWriter.write_valueT s eS ! ! B % 0 0 0 0 0
d]] ' ' ' ' '
e^^ ( ( ( ( (
s
#
# B5****7*****##Ite|<<<<<#E***
u
%
% B U 4 4 4 4 4
t
$
$
B OOE " " " " "
y 1
2
2
B U # # # # #
x 0
1
1 B (>(> ? ? ? ? ?
t}
-
- B U # # # # # 2T%[[ @AA Ar c
| d | xj dz c_ t ddt | j dd | j z z
}t
|| d D ]}|r| | | xj dz
c_ | d d S )Nr r r r4 r s r )
r r maxr9 r rh rD splitr r )r r r? r s r r z_PlistWriter.write_bytesv s 6""" a T[((99D6xBBQQQ)_fpseekosSEEK_ENDreadr9 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 HMM#r{ + + +hmmB''G7||r!!*,,,
j'22
T^[*# HMM- . . .#'??; #L#LD 'L; 6DM$$Z00 0V\= ) ) )&(( ( )s C C# #7Dc |dk rk| j d d dz }d|z }dt | z }t j || j | d S |S )z$ return the size of the next object. r r
r7 re )r r _BINARY_FORMATr r )r tokenLrj r> fs r _get_sizez _BinaryPlistParser._get_size sj S==
a #c)AQAnQ''A=DHMM!$4$455a8 8
r c t |t }| j | } t | |k rt
||k r|S t |||z
}|| j | z
}||z
}Xr )min_MIN_READ_BUF_SIZEr r r9 r )r sizecursizer deltas r _readz_BinaryPlistParser._read s d .//x}}W%% 4yyG##**$ 00E DHMM%(( (D u G r c | |z t v r%t j d| t S st t fdt
d|z D S )Nre c 3 d K | ]*}t ||z d V +dS )bigN)r
from_bytes).0rB r r4 s r z0_BinaryPlistParser._read_ints.. sR < < QD[(95AA < < < < < ! !=!>Q!>t(!>EE E
-*,,, < < < < <"'4!8T":":< < < < <
s r
_read_refsz _BinaryPlistParser._read_refs s q$.111r c j | }|t ur|S j | } j | j d d }|dz |dz }}|dk rd}n{|dk rd}nq|dk rd }ng|dk rd
}n]|d k r>t j d|z d |d
k }n|dk r5t j d j d d }n|dk r5t j d j d d }n|dk rat j d j d d }t j
ddd t j | z }n<|dk r, | }
| }n
|dk rA | }
| } | d }n|dk rD | dz }
| } | d }ny|d k rEt t j d|z d }n.|d k rX | } | }
g }| j |< | fd |
D n|d k r | } | } | }
}| j |< t' | |
D ]0\ } }
|
| | < 1n*# t* $ r t- w xY wt- | j |< |S )!zx
read the object by reference.
May recursively read sub-objects (content of an array/dict/set)
r r
r, Nr F Tr r r: r7 signed" z>fr6 # z>d3 )seconds@ P r ` r utf-16be c 3 B K | ]} | V d S r )r! )r< xr s r r= z2_BinaryPlistParser._read_object..X s1 AA1$++A..AAAAAAr )r r r r r r r r; r r rV timedeltar0 r7 r r r@ extendrr zipr! r r )r refresultoffsettokentokenHr. r/ r> r obj_refskey_refskos ` r r! z _BinaryPlistParser._read_object s s# # #M%c*
f
a # ut| D==FF
d]]FF
d]]FF
d]]FF
t^^^^DHMM!v+$>$>$)&A+ $ ? ?FF d]]]4 q)9)9::1=FF
d]]]4 q)9)9::1=FF
d]]
dDHMM!$4$455a8A 'a33 (3334FF t^^v&&AZZ]]FF
t^^v&&A::a==D[[))FF
t^^v&&*A::a==D[[,,FF
t^^
a&j(A(A5IIJJFF
t^^v&&Aq))HF!'DM# MMAAAAAAA A A A A t^^v&&Aq))Hq))H__&&F!'DM#
- ( 3 3 H HDAq373D3DQ3G3GF4,,Q//00H
-
-
-*,,,
- '(( ( #
c
s
AO O N) r% r1 r2 __doc__r r r0 r7 r r@ r! r3 r r r r s $ $ $) ) )2
< < <2 2 2] ] ] ] ]r r c 6 | dk rdS | dk rdS | dk rdS dS )N r r r6 r r3 )counts r _count_to_sizerf q s3 v~~q q q qr c 2 e Zd Zd Zd Zd Zd Zd Zd ZdS )_BinaryPlistWriterc 0 || _ || _ || _ d S r )r r r )r r% r r s r r z_BinaryPlistWriter.__init__ s #!r c g | _ i | _ i | _ | | t | j }dg|z | _ t
| | _ t | j | _ | j
d | j D ]}| | |
| }| j
}t
| }dt | |z z }| j
t j |g| j R d}||| j |||f} | j
t j dg| R d S )Nr
bplist00re z >5xBBBQQQ)_objlist _objtable _objidtable_flattenr9 r rf 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 sh
e $-(( !s; ' 44)$.9
{### = $ $C s # # # # __U++
"hmmoo$%899 n[ 9K GG
v{=H43GHHHIII +t~{ +
v{;9999:::::r c t |t rt | |f| j v rd S nt | | j v rd S t
| j }| j | t |t r|| j t | |f< n|| j t | < t |t rg }g }|
}| j rt | }|D ][\ }}t |t s| j r"t d | | | | \t! j || D ]}| | d S t |t& t( f r|D ]}| | d S d S )Nr )r _scalarsr rm idrn r9 rl r: r r r r rG r r itertoolschainro r r ) r r refnumkeysvaluesr r^ vr_ s r ro z_BinaryPlistWriter._flatten s eX & & U U#t~55 6 YY$*
*
* F T]##
U### eX & & 139DNDKK/ 0 0*0D RYY ' eT " " !DFKKMME
& u
!
!1!!S)) <~ ! #$:;;; A
a _T622
!
!
a
!
! e}
-
- !
!
!
a ! !
!
!r c t |t r | j t | |f S | j t | S r )r ry rm r rn rz r s r rr z _BinaryPlistWriter._getrefnum s@ eX & & />4;;"67 7#BuII. .r c 6 |dk r2| j t j d||z d S |dk r4| j t j d|dz d| d S |dk r4| j t j d|dz d| d S |d k r4| j t j d
|dz d | d S | j t j d |dz d
| d S )Nr, z>Brb z>BBBr rc z>BBH rd z>BBL z>BBQ )r r r rt )r rZ r4 s r _write_sizez _BinaryPlistWriter._write_size s
"99 HNN6;tUT\:: ; ; ; ; ;
F]] HNN6;vus{D$GG H H H H H
G^^ HNN6;vus{D$GG H H H H H
G^^ HNN6;vus{D$GG H H H H H
HNN6;vus{D$GG H H H H Hr c > | } j j |< | j d d S |du r j d d S |du r j d d S t |t r||dk rT j t j dd| d S # t j $ r t | d w xY w|d k r0 j t j d
d | d S |d k r0 j t j d
d| d S |dk r0 j t j dd| d S |dk r0 j t j dd| d S |dk r5 j d| d dd z d S t | t |t r0 j t j dd| d S t |t j
r[|t j
ddd z
} j t j dd | d S t |t t f r? d t% | j | d S t |t& r | d } d t% | nK# t* $ r> | d } d!t% | d"z Y nw xY w j | d S t |t, r|j dk rt1 d# |j d k r0 j t j d
d$| d S |j d k r0 j t j d
d%| d S |j dk r0 j t j dd&| d S |j dk r0 j t j dd'| d S t | t |t2 t4 f rj fd(|D }t% | } d)| j t j d* j |z z g|R d S t |t8 rVg g }} j r"t= | } n| } | D ]\ }
} t |
t& s j r"tC d+ |" |
|" | t% | } d,| j t j d* j |z z g|R j t j d* j |z z g|R d S tC | )-N F Tr r
z>Bqr rb z>BBr rc z>BHr rd z>BLr l z>BQr r: rD z>BdrG rI r rH rK r rL rN rM r r rO c : g | ]} | S r3 )rr )r< r_ r s r
z4_BinaryPlistWriter._write_object..6 s% 6661DOOA&&666r rP re r rS )#rr r rs r r r r r rt r$ r to_bytesr rV
total_secondsr r r r9 rG rI UnicodeEncodeErrorr r r r r rp r r r r r r r: ) r r rW r/ trefsr> keyRefsvalRefs rootItemsr^ r s ` r rq z _BinaryPlistWriter._write_object s ooe$$$(HMMOO S! = HNN7 # # # # #
e^^ HNN7 # # # # #
d]] HNN7 # # # # #
s
#
# R #qyy9HNN6;udE#B#BCCCCC | 9 9 9'..D89 v{5$ > >????? v{5$ > >????? v{5$ > >????? v{5$ > >????? w E$ )O)O OPPPPP#E***
u
%
% ? # HNN6;udE:: ; ; ; ; ;
x 0
1
1 < #*4A666EEGGA HNN6;udA66 7 7 7 7 7
y 1
2
2 8 # T3u:: . . . HNN5 ! ! ! ! !
s
#
# 4 #
4LL)) s5zz2222%
4
4
4LL,, s1vv{33333
4
HNN1
s
#
# * #zA~~ !8999f$$v{5$ > >?????g%%v{5$ > >?????g%%v{5$ > >?????g%%v{5$ > >?????#E***
e}
-
- #6666666DD A T1 % % % HNN6;sT-=-A'AIDIII J J J J J
t
$
$ # !2WG
* "5;;== 1 1 !KKMM !
3
31!!S)) <~ ! #$:;;;tq 1 1222tq 1 12222G A T1 % % % HNN6;sT-=-A'ALGLLL M M M HNN6;sT-=-A'ALGLLL M M M M M E"" "s 3.C# # D8N AOON) r% r1 r2 r r ro rr r rq r3 r r rh rh sx " " "
+; +; +;Z(! (! (!T/ / / I I I ^# ^# ^# ^# ^#r rh c | d d dk S )Nr rk r3 )r s r _is_fmt_binaryr T s "1": $$r )detectrv writerfmtrt c N |p| d }| d t D ] } |d | r
|d } n t nt | 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).
Nr r
r rv )rt )r r _FORMATSr r r )r% r rt r infoPps r r r j s {
OO%% ) )D tH~f%%
N
'(( (
SM( # I A 772;;r c D 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 rt r% s r r r s$
B y 1 1 11r TF)r r r c |t vrt d| t | d ||| }| | dS )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 sY (j338999
c]8
$R9x
P
P
PF
LLr r r r c n t }t | |||| | 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 s4
Bh)DDDD
;;==r )r4 ):r` __all__r; r rV enumior r{ r rer xml.parsers.expatr Enumr% r
globalsupdate __members__r3 r r compilerf rD rJ ASCIIrS r\ r_ rk rm r r r r r r- objectr r rf rG r r r ry rh r r r r r r r r r r3 r r r s 7 7p
* * * * * * di
';HMMM ( ) ) ) B "*IJ J & & & bj X Z\ Zb c c # # #
k< k< k< k< k< k< k< k<\# # # # # # # # L[) [) [) [) [)> [) [) [)| B+ + + + +J + + + SSS11
VXX
d d d d d d d dL
eX . 6Q# Q# Q# Q# Q#& Q# Q# Q#h% % % TT
!!
D , 2 2 2 2 2 #dU %4 r