Lc f d Z g dZddlZddlZddlZddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
ej dde Z e ej G d d
Zd Z e
j d Zd2dZd Z e
j de
j Zd 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& Z/d' Z0e1 e2e"e e!( e3 e2e0e(e/( iZ4de2d)d*Z5de2d)d+Z6e1d,d-d.d/Z7e1d-d,d0d1Z8dS )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)modulec 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 5/opt/alt/python-internal/lib64/python3.11/plistlib.py__init__z UID.__init__N s^ $$$ 3 122 2 7?? 677 7 !88 455 5 c | j S N)r r s r __index__z
UID.__index__W s
yr c J | j j dt | j dS )N()) __class____name__reprr r s r __repr__z UID.__repr__Z 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__` s) %%% "! !yEJ&&r c * t | j S r )hashr r s r __hash__z UID.__hash__e s DI r N) r%
__module__ __qualname__r r r' r) r- r0 r r r r M 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 y 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_element- 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.writeln5 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__B sJ $ JJ{ # # # dL&AAA#!r c | d | | | d d S )Nzz)r write_valuer s r r z_PlistWriter.writeL 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_valueQ 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_bytess 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 D | j |z t v r%t j d| t S rt |z k rt
t fdt d|z D S )Nre c 3 d K | ]*}t ||z d V +dS )bigN)r
from_bytes).0rB r sizes r z0_BinaryPlistParser._read_ints.. sR < < QD[(95AA < < < < < ! !=!>Q!>t(!>EE E
-3t99q00*,,, < < < < <"'4!8T":":< < < < <
t j d|z d |d
k }n|dk r5t j d j d d }nP|dk r5t j d j d d }n|dk rat j d j d d }t j
ddd t j | z }n|dk rR | } j | }t | |k rt nV|dk rg | } j | } t | |k rt | d }n|dk rj | dz } j | } t | |k rt | 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 r3 r7 signed" z>fr6 # z>d3 )seconds@ P r ` r utf-16be c 3 B K | ]} | V d S r )r! )r5 xr s r r7 z2_BinaryPlistParser._read_object..O s1 AA1$++A..AAAAAAr )r r r r r r r r4 r r rV timedeltar0 r9 r r r r: extendrr zipr! r )r refresultoffsettokentokenHr. r/ r> r obj_refskey_refskos ` r r! z _BinaryPlistParser._read_object sF 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&&AX]]1%%F6{{a *,,, t^^v&&A8==##D4yyA~~*,,,[[))FF
t^^v&&*A8==##D4yyA~~*,,,[[,,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
6AP8 8QN)
r% r1 r2 __doc__r r r0 r r: r! r3 r r r r s} $ $ $) ) )2 < < <2 2 2c c c c cr r c 6 | dk rdS | dk rdS | dk rdS dS )N r r r6 r r3 )counts r _count_to_sizer` h 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__x 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 r` 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 rg idrh r9 rf r: r r r r rG r r itertoolschainri r r ) r r refnumkeysvaluesr rX vrY s r ri 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 rs rg r rh rt r s r rl 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>Br\ z>BBBr r] z>BBH r^ z>BBL z>BBQ )r r r rn )r rT r6 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 r\ z>BBr r] z>BHr} r^ z>BLr~ l z>BQr r3 r> z>BdrA rC r rB rE r rF rH rG r r rI c : g | ]} | S r3 )rl )r5 rY r s r
z4_BinaryPlistWriter._write_object..- s% 6661DOOA&&666r rJ re r rM )#rl r rm r r r r r rn r$ r to_bytesr rV
total_secondsr r r r9 rG rI UnicodeEncodeErrorr r r r r rj r r r r r r r: ) r r rQ r/ trefsr> keyRefsvalRefs rootItemsrX rz s ` r rk 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 ri rl r rk r3 r r rb rb w sx " " "
+; +; +;Z(! (! (!T/ / / I I I ^# ^# ^# ^# ^#r rb c | d d dk S )Nr re r3 )r s r _is_fmt_binaryr K 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 _FORMATSry r r )r% r rt r infoPps r r r a 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 w 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 )9rZ __all__r; r rV enumior ru r rer xml.parsers.expatr Enumr% r
globalsupdate __members__r r compilerf rD rJ ASCIIrS r\ r_ rk rm r r r r r r- objectr r r` rG r r r rs rb 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
^ ^ ^ ^ ^ ^ ^ ^@
eX . 6Q# Q# Q# Q# Q#& Q# Q# Q#h% % % TT
!!
D , 2 2 2 2 2 #dU %4 r