*jHu S r / SQrSSKrSSKrSSKrSSKrSSKJr SSKrSSK r SSK
r
SSK r SSK J
r
\R " SS\S9r\" 5 R% \R& 5 S r " S
S 5 rS r\
R. " S
5 rS2S jrS r\
R. " S\
R6 5 r S r S r S r " S S5 r " S S5 r! " S S\!5 r"S r# " S S \$5 r%S S S S S!.r&\'" 5 r( " S" S#5 r)S$ r*\+\,\-\R \.4r/ " S% S&\'5 r0S' r1\2\3" \#\ \"S(9\4\3" \1\)\0S(90r5S\3S)S*.S+ jr6S\3S)S*.S, jr7\2S-S)S)S..S/ jr8\2S)S-S)S0.S1 jr9g)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 as dt
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 = dt.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 8 \ rS rSrS rS rS rS rS rS r Sr
g )
r P c [ U[ 5 ( d [ S5 eUS: a [ S5 eUS: a [ S5 eXl g )Nzdata must be an int zUIDs cannot be >= 2**64r
UIDs must be positive)
isinstanceint TypeError
ValueErrordataselfr s //opt/alt/python313/lib64/python3.13/plistlib.py__init__ UID.__init__Q sF $$$ 12 2 7? 67 7 !8 45 5 c U R $ Nr r s r __index__
UID.__index__Z s yyr c d U R R < S[ U R 5 < S3$ )N()) __class____name__reprr r" s r __repr__ UID.__repr__] s >>22DODDr c 4 U R U R 44$ r )r( r r" s r
__reduce__UID.__reduce__` s ~~ |++r c j [ U[ 5 ( d [ $ U R UR :H $ r )r r NotImplementedr )r others r __eq__
UID.__eq__c s( %%%! !yyEJJ&&r c , [ U R 5 $ r )hashr r" s r __hash__ UID.__hash__h s DII r r! N) r)
__module__ __qualname____firstlineno__r r# r+ r. r3 r7 __static_attributes__ 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 US- S- n/ n[ S[ U 5 U5 H. nXXB- nUR [ R " U5 5 M0 SR U5 $ )N r
r )rangelenappendbinascii
b2a_base64join)s
maxlinelength
maxbinsizepiecesichunks r _encode_base64rM | sa "A%J
F
1c!fj
)an%
h))%01 * 88F r c [ U [ 5 ( a% [ R " U R S5 5 $ [ R " U 5 $ )Nutf-8)r strrD
a2b_base64encode)rG s r _decode_base64rS s< !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 $ Sn[ R U 5 R 5 n/ nU H& nX5 nUc O UR [ U5 5 M( U( a$ [
R
" US[
R 06$ [
R
" U6 $ )N)yearmonthdayhourminutesecondtzinfo) _dateParsermatch groupdictrC r datetimeUTC)rG aware_datetimeordergdlstkeyvals r _date_from_stringrg s~ @E 1 ' ' )B
Cg ;
3s8
#;hll;; c ""r c U( a U R [ R 5 n SU R U R U R
U R U R U R 4- $ )Nz %04d-%02d-%02dT%02d:%02d:%02dZ)
astimezoner_ r` rU rV rW rX rY rZ )dra s r _date_to_stringrk sO
LL & + !((/ r c [ R U 5 nUb [ S5 eU R SS5 n U R SS5 n U R SS5 n U R SS5 n U R S S
5 n U $ ) Nz;strings can't contain control characters; use bytes insteadz
&z&z>)_controlCharPatsearchr replace)textms r _escaperw s~ t$A} - . . << %D <<d #D <<W %D <<V $D <<V $D Kr c \ rS rSrSS jrS rS rS rS rS r S r
S r S
r S r
S rS
rS rS rS rS rS rS rS rS rSrg) _PlistParser c F / U l S U l S U l Xl X l g r )stack current_keyroot
_dict_type_aware_datetimer dict_typera s r r _PlistParser.__init__ s#
# - r c F [ 5 U l U R U R l U R U R l U R U R l U R U R l U R R U5 U R $ r ) r parserhandle_begin_elementStartElementHandlerhandle_end_elementEndElementHandler handle_dataCharacterDataHandlerhandle_entity_declEntityDeclHandler ParseFiler~ )r fileobjs r parse_PlistParser.parse so "n *.*C*C '(,(?(? %+/+;+; ((,(?(? % g&yyr c [ S5 e)Nz8XML entity declarations are not supported in plist files)r )r entity_nameis_parameter_entityvaluebase system_id public_id
notation_names r r _PlistParser.handle_entity_decl s ##]^^r c J / U l [ U SU- S 5 nUb U" U5 g g )Nbegin_)r getattr)r elementattrshandlers r r !_PlistParser.handle_begin_element s. $7 2D9 EN r c : [ U SU- S 5 nUb U" 5 g g )Nend_)r )r r r s r r _PlistParser.handle_end_element s% $ 0$7 I r c : U R R U5 g r )r rC r s r r _PlistParser.handle_data s r c U R bg [ U R S [ 5 ( d" [ SU R
R - 5 eXR S U R ' S U l g U R ( d Xl g [ U R S [ 5 ( d" [ SU R
R - 5 eU R S R U5 g )Nz unexpected element at line %d)
r} r r| dictr r CurrentLineNumberr~ listrC r r s r
add_object_PlistParser.add_object s ' djjnd33 !@!%!>!>"? @ @/4JJrN4++ , #D I djjnd33 !@!%!>!>"? @ @ JJrN ! !% (r c J SR U R 5 n/ U l U$ )N )rF r r s r get_data_PlistParser.get_data s wwtyy! r c | U R 5 nU R U5 U R R U5 g r )r r r| rC )r r rj s r
begin_dict_PlistParser.begin_dict s, OO
! r c U R ( a. [ SU R U R R 4- 5 eU R R 5 g )Nz%missing value for key '%s' at line %d)r} r r r r| popr" s r end_dict_PlistParser.end_dict sI D " . .t{{/L/L M N O
O
r c U R ( d" [ U R S [ 5 ( d" [ SU R
R - 5 eU R 5 U l g )Nr zunexpected key at line %d)r} r r| r r r r r r" s r end_key_PlistParser.end_key sO :djjnd#C#C 8 ![[ : : ; <
< ==?r c ` / nU R U5 U R R U5 g r )r r| rC )r r as r begin_array_PlistParser.begin_array s%
! r c 8 U R R 5 g r )r| r r" s r end_array_PlistParser.end_array s
r c & U R S5 g )NTr r" s r end_true_PlistParser.end_true s r c & U R S5 g )NFr r" s r end_false_PlistParser.end_false s r c U R 5 nUR S5 ( d UR S5 ( a U R [ US5 5 g U R [ U5 5 g )N0x0X )r
startswithr r )r raws r end_integer_PlistParser.end_integer sL mmo >>$ 3>>$#7#7 OOCRL ) OOCH %r c T U R [ U R 5 5 5 g r )r floatr r" s r end_real_PlistParser.end_real s dmmo./r c B U R U R 5 5 g r )r r r" s r
end_string_PlistParser.end_string s
(r c T U R [ U R 5 5 5 g r )r rS r r" s r end_data_PlistParser.end_data s t}}78r c f U R [ U R 5 U R S95 g )N)ra )r rg r r r" s r end_date_PlistParser.end_date s) )$--/9=9M9MO Pr )r r r} r r r~ r| NF)r) r9 r: r; r r r r r r r r r r r r r r r r r r r r r< r= r r ry ry sh ._
)
+
&0)9Pr ry c : \ rS rSrS S jrS rS rS
S jrS rSr g) _DumbXMLWriteri$ c 6 Xl / U l X l X0l g r )filer|
_indent_levelindent)r r indent_levelr s r r _DumbXMLWriter.__init__% s
) r c U R R U5 U R SU- 5 U =R S-
sl g )Nz<%s> )r| rC writelnr r r s r
begin_element _DumbXMLWriter.begin_element+ s6
'" Vg%& a r c V U =R S- sl U R SU- 5 g )Nr z)r r r s r end_element_DumbXMLWriter.end_element0 s&
a Ww&'r Nc Ub* [ U5 nU R SU< SU< SU< S35 g U R SU- 5 g )Nrp rq z)rw r )r r r s r simple_element _DumbXMLWriter.simple_element6 s7 ENE LL'5'B C
LL7* +r c . U( as [ U[ 5 ( a UR S5 nU R R U R
U R - 5 U R R U5 U R R S5 g )NrO
)r rP rR r writer r )r lines r r _DumbXMLWriter.writeln> sa $$${{7+ IIOOD . . < = IIOOD ! r )r r r r| )r
r )
r) r9 r: r; r r r r r r< r= r r r r $ s
( , r r c @ \ rS rSr S
S jrS rS rS rS rS r Sr
g ) _PlistWriteriJ c U( a UR [ 5 [ R XX#5 XPl X`l Xpl g r )r PLISTHEADERr r
_sort_keys _skipkeysr )r r r r writeHeader sort_keysskipkeysra s r r _PlistWriter.__init__K s3 JJ{ # LA#! - r c j U R S5 U R U5 U R S5 g )Nzz)r write_valuer s r r _PlistWriter.writeV s) ./ Z r c V [ U[ 5 ( a U R SU5 g USL a U R S5 g USL a U R S5 g [ U[ 5 ( a1 SUs=:: a S: a O OU R SS U- 5 g [ U5 e[ U[
5 ( a U R S
[
U5 5 g [ U[ 5 ( a U R U5 g [ U[ [ 45 ( a U R U5 g [ U[ R 5 ( a& U R S [ XR 5 5 g [ U[ [ 45 ( a U R# U5 g [% S [' U5 - 5 e)
NstringTtrueFfalsel r integerz%drealdatezunsupported type: %s)r rP r r
OverflowErrorr r* r
write_dictbytes bytearray write_bytesr_ rk r tupler write_arrayr typer s r r _PlistWriter.write_value[ sF eS ! ! % 0
d] '
e^ (
s
#
#5*7*##Ite|<#E**
u
%
% U 4
t
$
$ OOE "
y 1
2
2 U #
x 0 0
1
1 /7K7K L
N t}
-
- U # 2T%[ @A Ar c U R S5 U =R S- sl [ SS[ U R U R - R 5 5 -
5 n[
X5 R S5 H nU( d M U R U5 M U =R S-
sl U R S5 g )Nr r r L r )
r r maxrB r
expandtabsrM splitr r )r r rH r s r r _PlistWriter.write_bytes~ s 6" a dkkD$6$66BBDE EG
#47==eDDt T" E
a r c U( a U R S5 U R ( a [ UR 5 5 nOUR 5 nU H[ u p4[ U[
5 ( d U R ( a M- [ S5 eU R SU5 U R U5 M] U R S5 g U R S5 g )Nr keys must be stringsre ) r r sorteditemsr rP r r r r r )r rj r! re r s r r _PlistWriter.write_dict s v & qwwy) #
!#s++~~ #$:;;##E3/ '
$
V $
'r c U( a= U R S5 U H nU R U5 M U R S5 g U R S5 g )Narray)r r r r )r r$ r s r r _PlistWriter.write_array sI w ' ' W %
(r )r r r N)r
r TFF) r) r9 r: r; r r r r r r r< r= r r r r J s( BC;@ .!
!BF !(()r r c v SnU H nU R U5 ( d M g [ R S4[ R S4[ R S44 H] u p4U R U5 ( d M U H: nX5R S5 R
U5 - nU S [ U5 U:X d M9 g M_ g)N)s 6xBBQQQ)_fpseekosSEEK_ENDreadrB 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 _BinaryPlistParser.parse s ) H HHMM#r{{ +hhmmB'G7|r!*,,
j'2
^[# HHMM- .#'??;#LD 'L; 6DM$$Z0 0V\\= )&( ( )s CC 4D c US:X ad U R R S5 S S- nSU- nS[ U - n[ R " X@R R U5 5 S $ U$ )z#return the size of the next object. r r
r@ rq )rG rK _BINARY_FORMATrL rM )r tokenLrv rG fs r _get_size _BinaryPlistParser._get_size sc S=
a #c)AQAnQ''A==HHMM!$45a8 8
r c [ U[ 5 nU R R U5 n [ U5 U:w a [
eX!:X a U$ [ X!U-
5 nX0R R U5 -
nX$-
nMM r )min_MIN_READ_BUF_SIZErG rK rB r )r sizecursizer deltas r _read_BinaryPlistParser._read sp d ./xx}}W%4yG#** 0E HHMM%( (D G r c ^^ U R TU- 5 mT[ ; a# [ R " SU [ T 3T5 $ T( d
[ 5 e[ UU4S j[
STU- T5 5 5 $ )Nrq c 3 Z ># U H n[ R TXT- S 5 v M" g7f)bigN)r
from_bytes).0rK r rh s r 0_BinaryPlistParser._read_ints.. s/ <":Q QD(95AA":s (+r
)rk r` rL rM r r rA )r nrh r s `@r rO _BinaryPlistParser._read_ints sr zz$(# > !==1QCt(<'=!>E E*,, <"'4!8T":< <
fr? # z>d3 r[ )seconds@ r r( ` r> utf-16be )rR rQ rP rG rH rK r rp rL rM rC r_ r` timedeltarc rk r- r rw rC rS r zipr r )r refresultoffsettokentokenHra rb epochrG r obj_refsxkey_refskos r rS _BinaryPlistParser._read_object sV 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 !! ))$1X\\J ))$15X / / ::F
t^v&AZZ]F
t^v&A::a=D[[)F
t^v&*A::a=D[[,F
t^
a&j(A5IJF
t^v&Aq)HF!'MM#
d / / 23 t^v&Aq)Hq)H__&F!'MM#
- 3DA373D3DQ3GF,,Q/0 4
'( ( #
c
-*,,
-s 6O O,)rC r rG rP rR rN Nr )
r) r9 r: r; __doc__r r rc rk rO rw rS r< r= r r rA rA s+ ,)2
<2ar rA c . U S: a gU S: a gU S: a gg)N r r> r? r? r= )counts r _count_to_sizer ~ s% v~ r c < \ rS rSrS
S jrS rS rS rS rS r Sr
g ) _BinaryPlistWriteri c 4 Xl X l X0l X@l g r )rG r r r )r rW r r ra s r r _BinaryPlistWriter.__init__ s #! - r c / U l 0 U l 0 U l U R U5 [ U R 5 nS/U- U l [
U5 U l [ U R U l U R R S5 U R H nU R U5 M U R U5 nU R R 5 n[
U5 nS[ U U- - nU R R [ R " U/U R
Q76 5 SnXU R UXE4n U R R [ R " S/U Q76 5 g )Nr
bplist00rq z >5xBBBQQQ)_objlist _objtable _objidtable_flattenrB rP r rN r` _ref_formatrG r
_write_object
_getrefnumtellrL pack)
r r rZ objr[ r\ rY
offset_format sort_versionrX s
r r _BinaryPlistWriter.write s4
e $--( !s; ' 4)$..9
{# ==C s # ! __U+
"hhmmo$%89 n[ 9K GG
v{{=H43G3GHI t~~{
v{{;99:r c [ U[ 5 ( a [ U5 U4U R ; a g O[ U5 U R
; a g [
U R 5 nU R R U5 [ U[ 5 ( a X R [ U5 U4' OX R
[ U5 ' [ U[ 5 ( a / n/ nUR 5 nU R ( a [ U5 nU HZ u pg[ U[ 5 ( d U R ( a M- [ S5 eUR U5 UR U5 M\ [ R" " X45 H nU R% U5 M g [ U[& [( 45 ( a U H nU R% U5 M g g )Nr )r _scalarsr r idr rB r rC r r! r r rP r r itertoolschainr r r ) r r refnumkeysvaluesr! r vr s r r _BinaryPlistWriter._flatten sd eX & &U U#t~~5 6 Y$**
* T]]#
U# eX & &39NNDK/ 0*0 RY ' eT " "DFKKME u
!!S))~~ #$:;; A
a
__T2
a 3 e}
-
-
a .r c [ U[ 5 ( a U R [ U5 U4 $ U R [ U5 $ r )r r r r r r r s r r _BinaryPlistWriter._getrefnum s< eX & &>>4;"67 7##BuI. .r c H US: a3 U R R [ R " SX- 5 5 g US: a6 U R R [ R " SUS- SU5 5 g US: a6 U R R [ R " SUS- SU5 5 g US : a6 U R R [ R " S
US- S U5 5 g U R R [ R " S US- S
U5 5 g )Nr_ z>Br z>BBBr r z>BBH r z>BBL z>BBQ )rG r rL r )r r rh s r _write_size _BinaryPlistWriter._write_size s "9 HHNN6;;tU\: ;
F] HHNN6;;vus{D$G H
G^ HHNN6;;vus{D$G H
G^ HHNN6;;vus{D$G H
HHNN6;;vus{D$G Hr c F U R U5 nU R R 5 U R U' Uc U R R S5 g USL a U R R S5 g USL a U R R S5 g [ U[ 5 ( GaX US: a3 U R R [ R " SSU5 5 g US : a2 U R R [ R " S
S U5 5 g US : a2 U R R [ R " S
SU5 5 g US: a2 U R R [ R " SSU5 5 g US: a2 U R R [ R " SSU5 5 g US: a. U R R SUR S SSS9- 5 g [ U5 e[ U[ 5 ( a2 U R R [ R " SSU5 5 g [ U[ R 5 ( a U R ( aX UR [ R 5 nU[ R " SSS[ R S 9-
nUR# 5 nO)U[ R " SSS5 -
R# 5 nU R R [ R " SS U5 5 g [ U[$ [& 45 ( a7 U R) S [+ U5 5 U R R U5 g [ U[, 5 ( aI UR/ S 5 nU R) S [+ U5 5 U R R U5 g [ U[2 5 ( Ga. UR4 S: a [7 S$5 eUR4 S : a2 U R R [ R " S
S%U5 5 g UR4 S : a2 U R R [ R " S
S&U5 5 g UR4 S: a2 U R R [ R " SS'U5 5 g UR4 S: a2 U R R [ R " SS(U5 5 g [ U5 e[ U[8 [: 45 ( a~ U Vs/ s H opR U5 PM nn[+ U5 n U R) S)U 5 U R R [ R " S*U R< U - - /UQ76 5 g [ U[> 5 ( GaZ / / pU R@ ( a [C URE 5 5 n OURE 5 n U Hx u p[ U
[, 5 ( d U RF ( a M- [I S+5 eU
RK U R U
5 5 U RK U R U5 5 Mz [+ U
5 n U R) S,U 5 U R R [ R " S*U R< U - - /U
Q76 5 U R R [ R " S*U R< U - - /U Q76 5 g [I U5 e! [ R a
[ U5 S ef = f! [0 a3 UR/ S!5 nU R) S"[+ U5 S#- 5 GNf = fs snf )-N F Tr& r
z>Bqr r z>BBr r z>BHr r z>BLr l z>BQr ro r| z>Bdr r r r r r r( r r r r> r r r rq r r )&r rG r rP r r r rL r rV r to_bytesr r_ r ri r`
total_secondsr r r rB rP rR UnicodeEncodeErrorr r r r r r r r r r! r r rC )r r r dtr rb tr refsrG keyRefsvalRefs rootItemsr r s r r _BinaryPlistWriter._write_object sd 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
1##%%hll3h / /a8<< PP((*X . .tQ ::IIK HHNN6;;udA6 7
y 1
2
2 T3u: . HHNN5 !
s
#
#
4LL) s5z2
HHNN1
s
#
#zzA~ !899f$v{{5$ >?g%v{{5$ >?g%v{{5$ >?g%v{{5$ >?#E**
e}
-
-0561OOA&D6D A T1 % HHNN6;;sT-=-=-A'AIDI J
t
$
$ !2W "5;;= 1 !KKM !!!S))~~ #$:;;tq 12tq 12
" G A T1 % HHNN6;;sT-=-=-A'ALGL M HHNN6;;sT-=-=-A'ALGL M E" "g || 9'.D89F &
4LL, s1v{3
4* 7s$ 71\: ,] ^ :!] 9^^)
r rG rP r r r r rN r r Nr ) r) r9 r: r; r r r r r r r< r= r r r r s$ . +;Z(!T/ I c#r r c U S S S:H $ )Nr? r r= )r. s r _is_fmt_binaryr g s "1: $$r )detectr writerFfmtr ra c
Uc^ U R S5 nU R S5 [ R 5 H nUS " U5 ( d M US n O [ 5 e[ U S nU" X#S9nUR U 5 $ )zRead a .plist file. 'fp' should be a readable and binary file object.
Return the unpacked root object (which usually is a dictionary).
rF r
r r )r ra )rK rH _FORMATSr r r )rW r r ra r. infoPps r r r } s {
OO%DH~f%%N & '( (
SM( # I=A 772;r c [ U [ 5 ( a% U[ :X a [ S5 eU R 5 n [ U 5 n[
XAX#S9$ )ziRead a .plist file from a bytes object.
Return the unpacked root object (which usually is a dictionary).
z6value must be bytes-like object when fmt is FMT_BINARYr )r rP r r rR r r )r r r ra rW s r r r sL % * ) *
* B y PPr T)r r r ra c | U[ ; a [ SU< 35 e[ U S " XUUS9nUR U 5 g)zOWrite 'value' to a .plist file. 'fp' should be a writable,
binary file object.
zUnsupported format: r )r r ra N)r r r )r rW r r r ra r s r r r sA
(3899
c]8
$Rx4BDF
LLr r r r ra c N [ 5 n[ XXUUS9 UR 5 $ )z?Return a bytes object with the contents for a .plist file.
r )r r getvalue)r r r r ra rW s r r r s(
B)&(
;;=r )r ):r __all__rD r) r_ enumior r rI rerL xml.parsers.expatr Enumr) r
globalsupdate __members__rg r r compilerr rM rS ASCIIr\ rg rk rw ry r r r5 r r r` objectrQ rA r rP r r r r r r r r r r r r r r r= r r r s 7p
* ii
';HM (( ) B **IJ & jj X Z\ Zb Zb c #
mP mP`# # L])> ])@B+J + SSS1
X
i iV
eX . . 6W#& W#t% T
!!
D , U
Q #dU
%4 r