python (3.12.0)
ˑen d Z g dZddlZddlZddlZddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
ej dde Z e j% ej& G d d
Zd Z e
j, d Zd1d
Zd Z e
j, de
j4 Zd Z d Z d Z G d d Z G d d Z G d de Z!d Z" G d de# 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+d/d0Z8y)2a> 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 = "<hello & hi there!>",
aThirdString = "M\xe4ssig, Ma\xdf",
aTrueValue = True,
aFalseValue = False,
),
someData = b"<binary gunk>",
someMoreData = b"<lots of binary gunk>" * 10,
aDate = datetime.datetime.now()
)
print(plistlib.dumps(pl).decode())
Parse Plist example:
import plistlib
plist = b'''<plist version="1.0">
<dict>
<key>foo</key>
<string>bar</string>
</dict>
</plist>'''
pl = plistlib.loads(plist)
print(pl["foo"])
)InvalidFileExceptionFMT_XML
FMT_BINARYloaddumploadsdumpsUID N)BytesIO) ParserCreate PlistFormatzFMT_XML FMT_BINARY)modulec 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 </BuggyBox/python/3.12.0/bootstrap/lib/python3.12/plistlib.py__init__z UID.__init__N sE $$ 12 2 7? 67 7 !8 45 5 c | j S N)r r s r __index__z
UID.__index__W s yyr c ` | j j dt | j dS )N()) __class____name__reprr r s r __repr__z UID.__repr__Z 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__` s% %%! !yyEJJ&&r c , t | j S r )hashr r s r __hash__z UID.__hash__e s DII r N) r%
__module__ __qualname__r r r' r) r- r0 r r r r M s! E,'
r r s <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
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 y sj "A%J
F
1c!fj
) 2!a*n%
h))%012 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<year>\d\d\d\d)(?:-(?P<month>\d\d)(?:-(?P<day>\d\d)(?:T(?P<hour>\d\d)(?::(?P<minute>\d\d)(?::(?P<second>\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[ sh @E 1 ' ' )B
C g ;
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<>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<r rl c . e Zd ZddZd Zd ZddZd Zy) _DumbXMLWriterc < || _ g | _ || _ || _ y r )filern
_indent_levelindent)r r indent_levelr s r r z_DumbXMLWriter.__init__ s
) r c | j j | | j d|z | xj dz
c_ y )Nz<%s> )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</%s>)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</z<%s/>)rj r )r r r s r simple_elementz _DumbXMLWriter.simple_element- 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.writeln5 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__B s5 JJ{ # dL&A#!r c j | j d | j | | j d y )Nz<plist version="1.0">z</plist>)r write_valuer s r r z_PlistWriter.writeL 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_valueQ 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_bytess s 6" a T[[((9D<N<NNO OQ
#4 7==eD #D T" #
a r c |r| j d | j rt |j }n|j }|D ]P \ }}t |t
s| j r#t d | j d| | j | R | j d y | j d y )Nr keys must be stringsrY ) r r sorteditemsr rF r r r r r )r r] r rY r s r r z_PlistWriter.write_dict s v & qwwy) #
(
U!#s+~~ #$:;;##E3/ '
(
V $
'r c |r;| j d |D ] }| j | | j d y | j d y )Narray)r r r r )r r r s r r z_PlistWriter.write_array sN w '
( '
( W %
(r N)r
r r TF) r% r1 r2 r r r r r r r3 r r r r A s( BC%*"!
BD !(()r r c V d}|D ] }| j | s y t j dft j dft j dffD ]U \ }}| j | s|D ]9 }||j d j
| z }| d t | |k( s8 y W y)N)s <?xmls <plistTrE z utf-16-bez utf-16-leasciiF)r codecsBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LEdecoderH r8 )headerprefixespfxbomencodingstartprefixs r _is_fmt_xmlr s $H S ! '*$$k2$$k2
X % E5<<077AAFls6{#v- r c e Zd ZddZy)r c 0 t j | | y r )r r )r messages r r z InvalidFileException.__init__ s D'*r N)z Invalid file)r% r1 r2 r r3 r r r r s +r r BHLQ)r r5 c 4 e Zd ZdZd Zd Zd Zd Zd Zd Z y) _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
c || _ y r )rq rr s r r z_BinaryPlistParser.__init__ s #r c || _ | j j dt j | j j d }t | dk7 r
t
t j d| \ }| _ }}}| j j | | j || | _ t g|z | _
| j | S # t t t j" t$ t& f$ r t
w xY w)Ni z>6xBBQQQ)_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 | j j |z t v r"t j d| t S rt |z k7 r
t
t fdt d|z D S )Nrd c 3 V K | ] }t j ||z d " yw)bigN)r
from_bytes).0rA r sizes r <genexpr>z0_BinaryPlistParser._read_ints.<locals>.<genexpr> s/ < QD(95A <s &)r
) r r r, r r r8 r r r7 )r nr5 r s `@r r z _BinaryPlistParser._read_ints s xx}}TAX& > !==1QCt(<'=!>E E3t9q0*,, <"'4!8T":< <
<r c : | j || j S r )r r )r r7 s r
_read_refsz _BinaryPlistParser._read_refs s q$..11r c j | }|t ur|S j | } j j | j j d d }|dz |dz }}|dk( rd}ne|dk( rd}n\|dk( rd }nS|dk( rd
}nJ|d k( r9t j j j d|z d |d
k\ }n |dk( r4t j d j j d d }n|dk( r4t j d j j d d }n|dk( rbt j d j j d d }t j ddd t j | z }n3|dk( rE j | } j j | }t | |k7 rt |dk( rW j | } j j | } t | |k7 r
t | j d }n|dk( rZ j | dz } j j | } t | |k7 r
t | j d }n.|d k( r<t! t j j j d|z d }n|d k( rN j | } j# | }
g }| j |< |j% fd |
D n|d k( r j | } j# | } j# | }
j' }| j |< t) | |
D ]( \ } }
j+ |
| j+ | < * n
t | j |< |S # t, $ r t w xY w)!zx
read the object by reference.
May recursively read sub-objects (content of an array/dict/set)
r r
r+ Nr F Tr r r2 r6 signed" z>fr5 # z>d3 )seconds@ P r ` r
utf-16be c 3 @ K | ] }j | y wr )r )r4 xr s r r6 z2_BinaryPlistParser._read_object.<locals>.<genexpr>O s A1$++A.As )r r r r r r r r3 r r rU timedeltar/ r8 r r r r9 extendrq zipr r )r refresultoffsettokentokenHr- r. r= r obj_refskey_refskos ` r r z _BinaryPlistParser._read_object s 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&AXX]]1%F6{a *,,
t^v&A88==#D4yA~*,,[[)F
t^v&*A88==#D4yA~*,,[[,F
t^
a&j(A5IJF
t^v&Aq)HF!'DMM# MMAA A t^v&Aq)Hq)H__&F!'DMM#
- ( 3 HDAq373D3DQ3GF4,,Q/0H
'( ( #
c
-*,,
-s 7O, ,P N)
r% r1 r2 __doc__r r r/ r r9 r r3 r r r r s& $)2<2cr r c ( | dk ry| dk ry| dk ryy)N r r
r5 r r3 )counts r _count_to_sizer_ h 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__x 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 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} s>
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 rf idrg r8 re r9 r r r r rF r r itertoolschainrh r r ) r r refnumkeysvaluesr rW vrX s r rh z_BinaryPlistWriter._flatten se eX &U U#t~~5
Y$**
* T]]#
U# eX &39DNNDK/ 0*0D RY ' eT "DFKKME u
!1!!S)~~ #$:;; A
a
! __T62
!
a
! e}
-
!
a
! .r c t |t r| j t | |f S | j t | S r )r rr rf r rg rs r s r rk 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>Br[ z>BBBr r\ z>BBH r] z>BBL z>BBQ )r r r rm )r rS r5 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~ r[ z>BBr r\ z>BHr| r] z>BLr} l z>BQr r2 r= z>Bdr@ rB r rA rD r rE rG rF r
r rH rI rd r rL )#rk r rl r r r r r rm r# r to_bytesr rU
total_secondsr r r r8 rF rH UnicodeEncodeErrorr r r r r ri r r r r r r r9 )
r r rP r. trX refsr= keyRefsvalRefs rootItemsrW ry s
r rj 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&6D6D A T1 % HHNN6;;sT-=-=-A'AIDI J
t
$ !2WG "5;;= 1 !KKM !
31!!S)~~ #$:;;tq 12tq 12
3 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 rh rk r rj r3 r r ra ra w s$ "
+;Z(!T/ I ^#r ra c | d d dk( S )Nr rd r3 )r s r _is_fmt_binaryr K 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 _FORMATSrx r r )r$ r rs r infoPps r r r a 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 w 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 )9rY __all__r: r rU enumior rt r rer xml.parsers.expatr Enumr% r
globalsupdate __members__r r compilere rC rI ASCIIrR r[ r^ rj rl r r r r r r, objectr r r_ rF r r r rr ra r r r r r r r r r r3 r r <module>r s 7p
* dii
';HM (( ) B "**IJ & bjj X Z\ Zb Zb c #
k< k<\# # L[)> [)|B+J + SSS1
X
^ ^@
eX . . 6Q#& Q#h% T
!!
D , 2 #dU %4 r 
Browse
Usage
Versions