o
6��f�n � @ s� d Z g d�ZddlZddlZddlZddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
ejdded�Ze� �ej� G d d
� d
�Zd Ze
�d �Zd>dd�Zdd� Ze
�de
j�Zdd� Z dd� Z dd� Z G dd� d�Z G dd � d �Z G d d � d e �Z!d d � Z"G d!d"� d"e#�Z$d#d$d%d&d'�Z%e&� Z'G d(d)� d)�Z(d*d+� Z)e*e+e,eje-fZ.G d,d-� d-e&�Z/d.d/� Z0e1e2e"e e!d0�e3e2e0e(e/d0�iZ4de2d1�d2d3�Z5de2d1�d4d5�Z6e1d6d7d8�d9d:�Z7e1d7d6d;�d<d=�Z8dS )?a> 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"])
)�InvalidFileException�FMT_XML�
FMT_BINARY�load�dump�loads�dumps�UID� N)�BytesIO)� ParserCreate� PlistFormatzFMT_XML FMT_BINARY)�modulec @ �< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )r c C s< t |t�s td��|dkrtd��|dk rtd��|| _d S )Nzdata must be an int� zUIDs cannot be >= 2**64r �UIDs must be positive)�
isinstance�int� TypeError�
ValueError�data��selfr � r �//opt/alt/python310/lib64/python3.10/plistlib.py�__init__N s
z UID.__init__c C s | j S �N)r �r r r r � __index__W s z
UID.__index__c C s d| j jt| j�f S )Nz%s(%s))� __class__�__name__�reprr r r r r �__repr__Z � z UID.__repr__c C s | j | jffS r )r r r r r r �
__reduce__] � zUID.__reduce__c C s t |t�stS | j|jkS r )r r �NotImplementedr )r �otherr r r �__eq__` s
z
UID.__eq__c C s
t | j�S r )�hashr r r r r �__hash__e �
z UID.__hash__N) r �
__module__� __qualname__r r r! r# r' r) r r r r r M s 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]�L c C sP |d d }g }t dt| �|�D ]}| ||| � }|�t�|�� qd�|�S )N� � r � )�range�len�append�binasciiZ
b2a_base64�join)�s�
maxlinelengthZ
maxbinsize�pieces�i�chunkr r r �_encode_base64y s
r; c C s$ t | t�r
t�| �d��S t�| �S )N�utf-8)r �strr4 Z
a2b_base64�encode)r6 r r r �_decode_base64� s
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 C sL d}t �| ��� }g }|D ]}|| }|d u r n|�t|�� q
tj|� S )N�ZyearZmonthZdayZhourZminute�second)� _dateParser�match� groupdictr3 r �datetime)r6 ZorderZgdZlst�key�valr r r �_date_from_string� s
rH c C s d| j | j| j| j| j| jf S )Nz %04d-%02d-%02dT%02d:%02d:%02dZr@ )�dr r r �_date_to_string� s �rJ c C sZ t �| �}|d ur
td��| �dd�} | �dd�} | �dd�} | �dd�} | �d d
�} | S ) Nz;strings can't contain control characters; use bytes insteadz
�
�
�&z&�<z<�>z>)�_controlCharPat�searchr �replace)�text�mr r r �_escape� s
rU c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)S )*� _PlistParserc C s g | _ d | _d | _|| _d S r )�stack� current_key�root�
_dict_type�r � dict_typer r r r � �
z_PlistParser.__init__c C sB t � | _| j| j_| j| j_| j| j_| j| j_ | j�
|� | j S r ) r �parser�handle_begin_elementZStartElementHandler�handle_end_elementZEndElementHandler� handle_dataZCharacterDataHandler�handle_entity_declZEntityDeclHandlerZ ParseFilerY )r Zfileobjr r r �parse� s
z_PlistParser.parsec C s t d��)Nz8XML entity declarations are not supported in plist files)r )r Z entity_nameZis_parameter_entity�value�baseZ system_idZ public_idZ
notation_namer r r rb � s z _PlistParser.handle_entity_declc C s. g | _ t| d| d �}|d ur||� d S d S )NZbegin_)r �getattr)r �element�attrs�handlerr r r r_ � s
�z!_PlistParser.handle_begin_elementc C s& t | d| d �}|d ur|� d S d S )NZend_)rf )r rg ri r r r r` � s
�z _PlistParser.handle_end_elementc C s | j �|� d S r )r r3 r r r r ra � � z_PlistParser.handle_datac C s� | j d ur$t| jd ti ��std| jj ��|| jd | j < d | _ d S | js,|| _d S t| jd tg ��s>td| jj ��| jd �|� d S )N���z unexpected element at line %d) rX r rW �typer r^ �CurrentLineNumberrY r3 �r rd r r r �
add_object� s
�
�z_PlistParser.add_objectc C s d� | j�}g | _|S )N� )r5 r r r r r �get_data� s z_PlistParser.get_datac C s" | � � }| �|� | j�|� d S r )rZ ro rW r3 )r rh rI r r r �
begin_dict� s
z_PlistParser.begin_dictc C s* | j rtd| j | jjf ��| j�� d S )Nz%missing value for key '%s' at line %d)rX r r^ rm rW �popr r r r �end_dict� s
�z_PlistParser.end_dictc C s8 | j s
t| jd ti ��std| jj ��| �� | _ d S )Nrk zunexpected key at line %d)rX r rW rl r r^ rm rq r r r r �end_key� s
�z_PlistParser.end_keyc C s g }| � |� | j�|� d S r )ro rW r3 )r rh �ar r r � begin_array� s
z_PlistParser.begin_arrayc C s | j �� d S r )rW rs r r r r � end_array� r$ z_PlistParser.end_arrayc C � | � d� d S )NT�ro r r r r �end_true r$ z_PlistParser.end_truec C ry )NFrz r r r r � end_false r$ z_PlistParser.end_falsec C sB | � � }|�d�s|�d�r| �t|d�� d S | �t|�� d S )NZ0xZ0X� )rq �
startswithro r )r �rawr r r � end_integer s z_PlistParser.end_integerc C � | � t| �� �� d S r )ro �floatrq r r r r �end_real r" z_PlistParser.end_realc C s | � | �� � d S r )ro rq r r r r �
end_string s z_PlistParser.end_stringc C r� r )ro r? rq r r r r �end_data r" z_PlistParser.end_datac C r� r )ro rH rq r r r r �end_date r" z_PlistParser.end_dateN)r r+ r, r rc rb r_ r` ra ro rq rr rt ru rw rx r{ r| r� r� r� r� r� r r r r rV � s* rV c @ s8 e Zd Zddd�Zdd� Zdd� Zdd
d �Zd d
� Zd S )�_DumbXMLWriterr � c C s || _ g | _|| _|| _d S r )�filerW �
_indent_level�indent)r r� � indent_levelr� r r r r r] z_DumbXMLWriter.__init__c C s, | j �|� | �d| � | jd7 _d S )Nz<%s>� )rW r3 �writelnr� �r rg r r r �
begin_element" s z _DumbXMLWriter.begin_elementc C s@ | j dksJ �| j�� |ksJ �| j d8 _ | �d| � d S )Nr r� z</%s>)r� rW rs r� r� r r r � end_element' s z_DumbXMLWriter.end_elementNc C s: |d urt |�}| �d|||f � d S | �d| � d S )Nz <%s>%s</%s>z<%s/>)rU r� )r rg rd r r r �simple_element- s z _DumbXMLWriter.simple_elementc C sH |r t |t�r |�d�}| j�| j| j � | j�|� | j�d� d S )Nr< �
)r r= r> r� �writer� r� )r �liner r r r� 5 s
z_DumbXMLWriter.writeln)r r� r )r r+ r, r r� r� r� r� r r r r r� s
r� c @ sB e Zd Z ddd�Zdd � Zd
d � Zd d
� Zdd� Zdd� ZdS )� _PlistWriterr � r� TFc C s. |r|� t� t�| |||� || _|| _d S r )r� � PLISTHEADERr� r �
_sort_keys� _skipkeys)r r� r� r� Z writeHeader� sort_keys�skipkeysr r r r B s
z_PlistWriter.__init__c C s" | � d� | �|� | � d� d S )Nz<plist version="1.0">z</plist>)r� � write_valuern r r r r� L s
z_PlistWriter.writec C s( t |t�r
| �d|� d S |du r| �d� d S |du r#| �d� d S t |t�rEd| kr2dk rAn t|��| �dd | � d S t|��t |t�rT| �d
t|�� d S t |t�r`| �|� d S t |t t
f�rn| � |� d S t |t j �r~| �d t
|�� d S t |ttf�r�| �|� d S td t|� ��)
N�stringT�trueFZfalsel���� r Zintegerz%d�real�datezunsupported type: %s)r r= r� r �
OverflowErrorr� r �dict�
write_dict�bytes� bytearray� write_bytesrE rJ �tuple�list� write_arrayr rl rn r r r r� Q s,
�
z_PlistWriter.write_valuec C sz | � d� | jd8 _tddt| j�dd�| j � �}t||��d�D ] }|r.| �|� q%| jd7 _| � d� d S )Nr r� r} r- r� s r� )
r� r� �maxr2 r� rR r; �splitr� r� )r r r7 r� r r r r� s s
�
�z_PlistWriter.write_bytesc C s� |r;| � d� | jrt|�� �}n|�� }|D ] \}}t|t�s(| jr$qtd��| �d|� | � |� q| �
d� d S | �d� d S )Nr� �keys must be stringsrF ) r� r� �sorted�itemsr r= r� r r� r� r� )r rI r� rF rd r r r r� � s
z_PlistWriter.write_dictc C s> |r| � d� |D ]}| �|� q | �d� d S | �d� d S )N�array)r� r� r� r� )r r� rd r r r r� � s
z_PlistWriter.write_arrayN)r r� r� TF) r r+ r, r r� r� r� r� r� r r r r r� A s
�
"
r� c C s� d}|D ]
}| � |�r dS qtjdftjdftjdffD ]'\}}| � |�s'q |D ]}||�d��|� }| d t|�� |krC dS q)q dS )N)s <?xmls <plistTr< z utf-16-bez utf-16-le�asciiF)r~ �codecs�BOM_UTF8� BOM_UTF16_BE� BOM_UTF16_LE�decoder> r2 )�header�prefixesZpfxZbom�encoding�start�prefixr r r � _is_fmt_xml� s$
� �
��r� c @ s e Zd Zddd�ZdS )r � Invalid filec C s t �| |� d S r )r r )r �messager r r r � rj z InvalidFileException.__init__N)r� )r r+ r, r r r r r r � s r �B�H�L�Q)r� � r. � c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�_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 C s
|| _ d S r )rZ r[ r r r r � r* z_BinaryPlistParser.__init__c C s� z?|| _ | j �dtj� | j �d�}t|�dkrt� �t�d|�\}| _ }}}| j �|� | �
||�| _ t g| | _
| �|�W S tttjttfyO t� �w )Ni��� z>6xBBQQQ)�_fp�seek�os�SEEK_END�readr2 r �struct�unpack� _ref_size�
_read_ints�_object_offsets�
_undefined�_objects� _read_object�OSError�
IndexError�errorr� r )r �fp�trailer� offset_size� num_objects�
top_object�offset_table_offsetr r r rc � s&
�
��z_BinaryPlistParser.parsec C sL |dkr$| j �d�d d@ }d|> }dt| }t�|| j �|��d S |S )z$ return the size of the next object.� r� r r/ rO )r� r� �_BINARY_FORMATr� r� )r �tokenLrT r6 �fr r r � _get_size� s z _BinaryPlistParser._get_sizec sp | j ��| �� �tv rt�d|� t� � �� �S �r#t� ��| kr&t� �t� �fdd�td�| ��D ��S )NrO c 3 s( � | ]}t �� ||� � d �V qdS )�bigN)r �
from_bytes)�.0r9 �r �sizer r � <genexpr>� s � �z0_BinaryPlistParser._read_ints.<locals>.<genexpr>r ) r� r� r� r� r� r2 r r� r1 )r �nr� r r� r r� � s �z _BinaryPlistParser._read_intsc C s | � || j�S r )r� r� )r r� r r r �
_read_refs r$ z _BinaryPlistParser._read_refsc s� � j | }|tur |S � j| }� j�|� � j�d�d }|d@ |d@ }}|dkr/d}�n@|dkr7d}�n8|dkr?d }�n0|dkrGd
}�n(|d kr]tj� j�d|> �d |d
kd�}�n|dkrot� d� j�d��d }�n |dkr�t� d� j�d��d }n�|dkr�t� d� j�d��d }t
�
ddd�t
j |d� }n�|dkr�� � |�}� j�|�}t
|�|kr�t� �n�|dkrՈ � |�}� j�|�} t
| �|kr�t� �| �d�}n�|dkr�� � |�d }� j�|�} t
| �|kr�t� �| �d �}nz|d k�r tt�� j�d| �d ��}nf|d k�r,� � |�}� �|�}
g }|� j |< |�� fd d �|
D �� nC|d!k�rl� � |�}� �|�} � �|�}
� �� }|� j |< zt| |
�D ]\} }
� �|
�|� �| �< �qOW n t�yk t� �w t� �|� j |< |S )"zx
read the object by reference.
May recursively read sub-objects (content of an array/dict/set)
r� r �� r� Nr� F� Tr0 r} r� r/ �Zsigned�" z>fr. �# z>d�3 �� )Zseconds�@ �P r� �` r� �utf-16be� � c 3 s � | ]}� � |�V qd S r )r� )r� �xr r r r� O s � z2_BinaryPlistParser._read_object.<locals>.<genexpr>�� )r� r� r� r� r� r� r r� r� r� rE Z timedeltar� r2 r r� r r� �extendrZ �zipr� r )r �ref�result�offset�tokenZtokenHr� r� r6 r Zobj_refsZkey_refs�k�or r r r� s�
�
�
�
��
z _BinaryPlistParser._read_objectN)
r r+ r, �__doc__r rc r� r� r� r� r r r r r� � s
r� c C s( | dk rdS | dk r dS | dk rdS dS )N� r� � r� � r. r� r )�countr r r �_count_to_sizeh s r c @ r )�_BinaryPlistWriterc C s || _ || _|| _d S r )r� r� r� )r r� r� r� r r r r x s
z_BinaryPlistWriter.__init__c
C s� g | _ i | _i | _| �|� t| j �}dg| | _t|�| _t| j | _ | j
� d� | j D ]}| � |� q-| �
|�}| j
�� }t|�}dt| | }| j
� tj|g| j�R � � d}||| j|||f} | j
� tjdg| �R � � d S )Nr � bplist00rO z >5xBBBQQQ)�_objlist� _objtable� _objidtable�_flattenr2 r� r r� r� � _ref_formatr� r� �
_write_object�
_getrefnum�tellr� �pack)
r rd r� �objr� r� r� Z
offset_formatZ sort_versionr� r r r r� } s*
� z_BinaryPlistWriter.writec C s$ t |t�rt|�|f| jv rd S n t|�| jv rd S t| j�}| j�|� t |t�r4|| jt|�|f< n|| jt|�< t |t �r}g }g }|�
� }| j rOt |�}|D ]\}}t |t
�sb| jr^qQtd��|�|� |�|� qQt�||�D ]}| �|� qsd S t |ttf�r�|D ] }| �|� q�d S d S )Nr� )r �_scalarsrl r
�idr r2 r r3 r� r� r� r� r= r� r � itertools�chainr r� r� ) r rd Zrefnum�keys�valuesr� r� �vr r r r r � s@
�
� �z_BinaryPlistWriter._flattenc C s* t |t�r| jt|�|f S | jt|� S r )r r r
rl r r rn r r r r � s
z _BinaryPlistWriter._getrefnumc C s� |dk r| j �t�d||B �� d S |dk r&| j �t�d|dB d|�� d S |dk r:| j �t�d|dB d|�� d S |d k rN| j �t�d
|dB d |�� d S | j �t�d |dB d
|�� d S )Nr� z>Br z>BBBr} r z>BBH� r z>BBL� z>BBQ� )r� r� r� r )r r� r� r r r � _write_size� s z _BinaryPlistWriter._write_sizec sj � � |�}� j�� � j|< |d u r� j�d� d S |du r%� j�d� d S |du r1� j�d� d S t|t�r�|dk rVz� j�t�dd|�� W d S tj yU t
|�d �w |d k rg� j�t�d
d |�� d S |d k rx� j�t�d
d|�� d S |dk r�� j�t�dd|�� d S |dk r�� j�t�dd|�� d S |dk r�� j�d|j d ddd� � d S t
|��t|t �rĈ j�t�dd|�� d S t|t
j
�r�|t
�
ddd� �� }� j�t�dd |�� d S t|ttf�r�� �d t|�� � j�|� d S t|t��r0z|�d �}� �d t|�� W n t�y' |�d �}� �d!t|�d" � Y nw � j�|� d S t|t��r�|jdk �r@td#��|jd k �rS� j�t�d
d$|�� d S |jd k �rf� j�t�d
d%|�� d S |jdk �ry� j�t�dd&|�� d S |jdk �r�� j�t�dd'|�� d S t
|��t|ttf��r�� fd(d)�|D �}t|�}� �d*|� � j�tjd+� j| g|�R � � d S t|t ��r1g g }}� j �r�t |� � �} n|� � } | D ]%\}
} t|
t��s� j �r�q�t!d,��|�"� � |
�� |�"� � | �� �q�t|�}� �d-|� � j�tjd+� j| g|�R � � � j�tjd+� j| g|�R � � d S t!|��).N� F� Tr� r z>Bqr r z>BBr} r z>BHr r z>BLr l z>BQr � r� r� z>Bdr� r� r� r� r� r� r� r� r� r� r r� � � � c s g | ]}� � |��qS r )r )r� r r r r �
<listcomp>- s z4_BinaryPlistWriter._write_object.<locals>.<listcomp>r� rO r� r� )#r r� r r� r� r r r� r r� r� �to_bytesr� rE Z
total_secondsr� r� r r2 r= r> �UnicodeEncodeErrorr r r r� r� r
r� r� r� r� r� r r3 ) r rd r� r� �tZrefsr6 ZkeyRefsZvalRefsZ rootItemsr� r r r r r � s�
�
� (
$(z _BinaryPlistWriter._write_objectN) r r+ r, r r� r r r r r r r r r w s -* r c C s | d d� dkS )Nr� r r )r� r r r �_is_fmt_binaryK rj r( )�detectr^ �writer��fmtr\ c C sj |du r%| � d�}| �d� t�� D ]}|d |�r |d } nqt� �nt| d }||d�}|�| �S )z�Read 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) r^ )r\ )r� r� �_FORMATSr r rc )r� r, r\ r� �info�P�pr r r r a s
��
r c C s t | �}t|||d�S )zqRead a .plist file from a bytes object.
Return the unpacked root object (which usually is a dictionary).
r+ )r
r )rd r, r\ r� r r r r w s r TF)r, r� r� c C s: |t vr td|f ��t | d |||d�}|�| � dS )zWWrite 'value' to a .plist file. 'fp' should be a writable,
binary file object.
zUnsupported format: %rr* )r� r� N)r- r r� )rd r� r, r� r� r* r r r r s r �r, r� r� c C s t � }t| ||||d� |�� S )z?Return a bytes object with the contents for a .plist file.
r1 )r
r �getvalue)rd r, r� r� r� r r r r � s r )r- )9r �__all__r4 r� rE �enum�ior
r r� �rer� Zxml.parsers.expatr �Enumr r �globals�update� __members__r r� �compilerP r; r? �ASCIIrB rH rJ rU rV r� r� r� r r r� �objectr� r� r r= r r� r� r r r( r r� r r- r r r r r r r r �<module> sl 8 !�
n&^! !
U ���