a
R�fXn � @ 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:
pl = dict(
aString = "Doodah",
aList = ["A", "B", 12, 32.1, [1, 2, 3]],
aFloat = 0.1,
anInt = 728,
aDict = dict(
anotherString = "<hello & hi there!>",
aUnicodeValue = "M\xe4ssig, Ma\xdf",
aTrueValue = True,
aFalseValue = False,
),
someData = b"<binary gunk>",
someMoreData = b"<lots of binary gunk>" * 10,
aDate = datetime.datetime.fromtimestamp(time.mktime(time.gmtime())),
)
with open(fileName, 'wb') as fp:
dump(pl, fp)
Parse Plist example:
with open(fileName, 'rb') as fp:
pl = load(fp)
print(pl["aKey"])
)�InvalidFileException�FMT_XML�
FMT_BINARY�load�dump�loads�dumps�UID� N)�BytesIO)� ParserCreate� PlistFormatzFMT_XML FMT_BINARY)�modulec @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )r c C s< t |t�std��|dkr"td��|dk r2td��|| _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/python39/lib64/python3.9/plistlib.py�__init__E s
z UID.__init__c C s | j S �N)r �r r r r � __index__N s z
UID.__index__c C s d| j jt| j�f S )Nz%s(%s))� __class__�__name__�reprr r r r r �__repr__Q s z UID.__repr__c C s | j | jffS r )r r r r r r �
__reduce__T s zUID.__reduce__c C s t |t�stS | j|jkS r )r r �NotImplementedr )r �otherr r r �__eq__W s
z
UID.__eq__c C s
t | j�S r )�hashr r r r r �__hash__\ s z UID.__hash__N) r �
__module__� __qualname__r r r r! r$ r& r r r r r D 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�|�� q d�|�S )N� � r � )�range�len�append�binasciiZ
b2a_base64�join)�s�
maxlinelengthZ
maxbinsize�pieces�i�chunkr r r �_encode_base64p s r7 c C s( t | t�rt�| �d��S t�| �S d S )N�utf-8)r �strr0 Z
a2b_base64�encode)r2 r r r �_decode_base64y 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 r2 qB|�t|�� qtj|� S )N�ZyearZmonthZdayZhourZminute�second)� _dateParser�match� groupdictr/ r �datetime)r2 �orderZgdZlst�key�valr r r �_date_from_string� s rE 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 �rG c C sZ t �| �}|d urtd��| �dd�} | �dd�} | �dd�} | �dd�} | �d d
�} | S ) Nz<strings can't contains control characters; use bytes insteadz
�
�
�&z&�<z<�>z>)�_controlCharPat�searchr �replace)�text�mr r r �_escape� s
rR 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 � s 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 ParseFilerV )r Zfileobjr r r �parse� s
z_PlistParser.parsec C s t d��d S )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 r^ � s z _PlistParser.handle_entity_declc C s* g | _ t| d| d �}|d ur&||� 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 )NZend_)rb )r rc re r r r r\ � s z _PlistParser.handle_end_elementc C s | j �|� d S r )r r/ r r r r r] � s z_PlistParser.handle_datac C s� | j d urFt| jd ti ��s.td| jj ��|| jd | j < d | _ nB| jsT|| _n4t| jd tg ��sxtd| jj ��| jd �|� d S )N���z unexpected element at line %d) rU r rT �typer rZ �CurrentLineNumberrV r/ �r r` r r r �
add_object� s
��z_PlistParser.add_objectc C s d� | j�}g | _|S )N� )r1 r r r r r �get_data� s z_PlistParser.get_datac C s" | � � }| �|� | j�|� d S r )rW rj rT r/ )r rd rF r r r �
begin_dict� s
z_PlistParser.begin_dictc C s* | j r td| j | jjf ��| j�� d S )Nz%missing value for key '%s' at line %d)rU r rZ rh rT �popr r r r �end_dict� s
�z_PlistParser.end_dictc C s8 | j st| jd ti ��s*td| jj ��| �� | _ d S )Nrf zunexpected key at line %d)rU r rT rg r rZ rh rl r r r r �end_key� s
�z_PlistParser.end_keyc C s g }| � |� | j�|� d S r )rj rT r/ )r rd �ar r r � begin_array� s
z_PlistParser.begin_arrayc C s | j �� d S r )rT rn r r r r � end_array� s z_PlistParser.end_arrayc C s | � d� d S )NT�rj r r r r �end_true� s z_PlistParser.end_truec C s | � d� d S )NFrt r r r r � end_false� s z_PlistParser.end_falsec C s@ | � � }|�d�s |�d�r.| �t|d�� n| �t|�� d S )NZ0xZ0X� )rl �
startswithrj r )r �rawr r r � end_integer� s z_PlistParser.end_integerc C s | � t| �� �� d S r )rj �floatrl r r r r �end_real s z_PlistParser.end_realc C s | � | �� � d S r )rj rl r r r r �
end_string s z_PlistParser.end_stringc C s | � t| �� �� d S r )rj r; rl r r r r �end_data s z_PlistParser.end_datac C s | � t| �� �� d S r )rj rE rl r r r r �end_date s z_PlistParser.end_dateN)r r' r( r r_ r^ r[ r\ r] rj rl rm ro rp rr rs ru rv rz r| r} r~ r r r r r rS � s( rS c @ s8 e Zd Zddd�Zdd� Zdd� Zdd
d �Zd d
� Zd S )�_DumbXMLWriterr � c C s || _ g | _|| _|| _d S r )�filerT �
_indent_level�indent)r r� � indent_levelr� r r r r s z_DumbXMLWriter.__init__c C s, | j �|� | �d| � | jd7 _d S )Nz<%s>� )rT r/ �writelnr� �r rc r r r �
begin_element s z _DumbXMLWriter.begin_elementc C s@ | j dksJ �| j�� |ks J �| j d8 _ | �d| � d S )Nr r� z</%s>)r� rT rn r� r� r r r � end_element s z_DumbXMLWriter.end_elementNc C s8 |d ur&t |�}| �d|||f � n| �d| � d S )Nz <%s>%s</%s>z<%s/>)rR r� )r rc r` r r r �simple_element$ s z _DumbXMLWriter.simple_elementc C sH |r8t |t�r|�d�}| j�| j| j � | j�|� | j�d� d S )Nr8 �
)r r9 r: r� �writer� r� )r �liner r r r� , s
z_DumbXMLWriter.writeln)r r� )N)r r' r( r r� r� r� r� r r r r r� s
r� c @ s> e Zd Zddd�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 9 s
z_PlistWriter.__init__c C s" | � d� | �|� | � d� d S )Nz<plist version="1.0">z</plist>)r� � write_valueri r r r r� C s
z_PlistWriter.writec C s t |t�r| �d|� n�|du r,| �d� n�|du r@| �d� n�t |t�r~d| kr^dk rtn n| �dd | � nt|��n�t |t�r�| �d
t|�� nzt |t�r�| �|� ndt |t t
f�r�| � |� nJt |t j �r�| �d t
|�� n,t |ttf��r| �|� ntd t|� ��d S )
N�stringT�trueFZfalsel���� r Zintegerz%d�real�datezunsupported type: %s)r r9 r� r �
OverflowErrorr{ r �dict�
write_dict�bytes� bytearray� write_bytesrA rG �tuple�list� write_arrayr rg ri r r r r� H s*
z_PlistWriter.write_valuec C sz | � d� | jd8 _tddt| j�dd�| j � �}t||��d�D ]}|rJ| �|� qJ| jd7 _| � d� d S )Nr r� rw r) r� s r� )
r� r� �maxr. r� rO r7 �splitr� r� )r r r3 r� r r r r� j s
� z_PlistWriter.write_bytesc C s� |rt| � d� | jr"t|�� �}n|�� }|D ]8\}}t|t�sP| jrHq.td��| �d|� | � |� q.| �
d� n
| �d� d S )Nr� �keys must be stringsrC ) r� r� �sorted�itemsr r9 r� r r� r� r� )r rF r� rC r` r r r r� w s
z_PlistWriter.write_dictc C s< |r.| � d� |D ]}| �|� q| �d� n
| �d� d S )N�array)r� r� r� r� )r r� r` 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� 8 s �
"
r� c C s� d}|D ]}| � |�r dS qtjdftjdftjdffD ]N\}}| � |�sNq:|D ]4}||�d��|� }| d t|�� |krR dS qRq:dS )N)s <?xmls <plistTr8 z utf-16-bez utf-16-le�asciiF)rx �codecs�BOM_UTF8� BOM_UTF16_BE� BOM_UTF16_LE�decoder: r. )�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 � s 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 )rW rX r r r r � s z_BinaryPlistParser.__init__c C s� z~|| _ | j �dtj� | j �d�}t|�dkr6t� �t�d|�\}| _ }}}| j �|� | �
||�| _ t g| | _
| �|�W S tttjttfy� t� �Y n0 d S )Ni��� z>6xBBQQQ)�_fp�seek�os�SEEK_END�readr. 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 r_ � s$
�
�
z_BinaryPlistParser.parsec C sL |dkrH| j �d�d d@ }d|> }dt| }t�|| j �|��d S |S )z$ return the size of the next object.� r� r r+ rL )r� r� �_BINARY_FORMATr� r� )r �tokenLrQ r2 �fr r r � _get_size� s z _BinaryPlistParser._get_sizec st | j ��| �� �tv r2t�d|� t� � �� �S �rFt� ��| krLt� �t� �fdd�td�| ��D ��S d S )NrL c 3 s& | ] }t �� ||� � d �V qdS )�bigN)r �
from_bytes)�.0r5 �r �sizer r � <genexpr>� s �z0_BinaryPlistParser._read_ints.<locals>.<genexpr>r ) r� r� r� r� r� r. r r� r- )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� s z _BinaryPlistParser._read_refsc s
� j | }|tur|S � j| }� j�|� � j�d�d }|d@ |d@ }}|dkr^d}�n�|dkrnd}�n�|dkr~d }�n~|dkr�d
}�nn|d kr�tj� j�d|> �d |d
kd�}�nB|dkr�t� d� j�d��d }�n |dk�rt� d� j�d��d }�n�|dk�rDt� d� j�d��d }t
�
ddd�t
j |d� }�n�|dk�r|� � |�}� j�|�}t
|�|k�r�t� ��n�|dk�r�� � |�}� j�|�} t
| �|k�r�t� �| �d�}�n>|dk�r� � |�d }� j�|�} t
| �|k�r�t� �| �d �}n�|d k�r*tt�� j�d| �d ��}n�|d k�rp� � |�}� �|�}
g }|� j |< |�� fd d �|
D �� n�|d!k�r�� � |�}� �|�} � �|�}
� �� }|� j |< z.t| |
�D ] \} }
� �|
�|� �| �< �q�W n t�y� t� �Y n0 nt� �|� 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, rw 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� F r, z2_BinaryPlistParser._read_object.<locals>.<genexpr>�� )r� r� r� r� r� r� r r� r� r� rA Z timedeltar� r. r r� r r� �extendrW �zipr� r )r �ref�result�offset�tokenZtokenHr� r� r2 r Zobj_refsZkey_refs�k�or r r r� � s�
�
�
z _BinaryPlistParser._read_objectN)
r r' r( �__doc__r r_ r� r� r� r� r r r r r� � s
r� c C s, | dk r dS | dk rdS | dk r$dS dS d S )N� r� � r� � r* r� r )�countr r r �_count_to_size_ s r� c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�_BinaryPlistWriterc C s || _ || _|| _d S r )r� r� r� )r r� r� r� r r r r o s z_BinaryPlistWriter.__init__c
C s� g | _ i | _i | _| �|� t| j �}dg| | _t|�| _t| j | _ | j
� d� | j D ]}| � |� qZ| �
|�}| j
�� }t|�}dt| | }| j
� tj|g| j�R � � d}||| j|||f} | j
� tjdg| �R � � d S )Nr � bplist00rL z >5xBBBQQQ)�_objlist� _objtable� _objidtable�_flattenr. r� r� r� r� � _ref_formatr� r� �
_write_object�
_getrefnum�tellr� �pack)
r r` r� �objr� r� r� Z
offset_formatZ sort_versionr� r r r r� t s*
�z_BinaryPlistWriter.writec C s" t |t�r"t|�|f| jv r4d S nt|�| jv r4d S t| j�}| j�|� t |t�rh|| jt|�|f< n|| jt|�< t |t �r�g }g }|�
� }| j r�t |�}|D ]6\}}t |t
�s�| jr�q�td��|�|� |�|� q�t�||�D ]}| �|� q�n&t |ttf��r |D ]}| �|� �q d S )Nr� )r �_scalarsrg r �idr r. r r/ r� r� r� r� r9 r� r � itertools�chainr r� r� ) r r` Zrefnum�keys�valuesr� r� �vr� r r r r � s8
z_BinaryPlistWriter._flattenc C s. t |t�r | jt|�|f S | jt|� S d S r )r r r rg r r
ri r r r r � s
z _BinaryPlistWriter._getrefnumc C s� |dk r"| j �t�d||B �� n�|dk rH| j �t�d|dB d|�� nh|dk rn| j �t�d|dB d|�� nB|d k r�| j �t�d
|dB d |�� n | j �t�d |dB d
|�� d S )Nr� z>Br� z>BBBrw 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 st � � |�}� j�� � j|< |d u r2� j�d� �n>|du rJ� j�d� �n&|du rb� j�d� �nt|t��rj|dk r�z� j�t�dd|�� W n tj y� t
|�d �Y n0 n�|d k r҈ j�t�d
d |�� n�|d k r� j�t�d
d|�� nt|dk �r� j�t�dd|�� nR|dk �r6� j�t�dd|�� n0|dk �r^� j�d|j d ddd� � nt
|���nt|t ��r�� j�t�dd|�� �n�t|t
j
��r�|t
�
ddd� �� }� j�t�dd |�� �n�t|ttf��r�� �d t|�� � j�|� �nrt|t��rlz |�d �}� �d t|�� W n2 t�yZ |�d �}� �d!t|�d" � Y n0 � j�|� �nt|t��r*|jdk �r�td#��n�|jd k �r�� j�t�d
d$|�� nt|jd k �rֈ j�t�d
d%|�� nP|jdk �r�� j�t�dd&|�� n,|jdk �r � j�t�dd'|�� nt
|���nFt|ttf��r�� fd(d)�|D �}t|�}� �d*|� � j�tjd+� j| g|�R � � n�t|t ��rhg g }}� j �r�t |� � �} n|� � } | D ]J\}
} t|
t��s� j �rސq�t!d,��|�"� � |
�� |�"� � | �� �q�t|�}� �d-|� � j�tjd+� j| g|�R � � � j�tjd+� j| g|�R � � nt!|��d S ).N� F� Tr� r z>Bqr r� z>BBrw 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>$ r, z4_BinaryPlistWriter._write_object.<locals>.<listcomp>r� rL r� r� )#r r� r r� r� r r r� r
r� r� �to_bytesr{ rA Z
total_secondsr� r� r r. r9 r: �UnicodeEncodeErrorr r r r� r� r r� r� r� r� r� r r/ ) r r` r� r� �tZrefsr2 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 n s -*r c C s | d d� dkS )Nr� r r )r� r r r �_is_fmt_binaryB s r! )�detectrZ �writer��fmtrY c C sj |du rJ| � d�}| �d� t�� D ] }|d |�r$|d } qVq$t� �n t| 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" rZ )rY )r� r� �_FORMATSr r r_ )r� r% rY r� �info�P�pr r r r X 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 )r` r% rY r� r r r r n s r TF)r% r� r� c C s: |t vrtd|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� )r` r� r% r� r� r# r r r r v s r �r% r� r� c C s t � }t| ||||d� |�� S )z?Return a bytes object with the contents for a .plist file.
r* )r
r �getvalue)r` r% r� r� r� r r r r � s r )r) )9r� �__all__r0 r� rA �enum�ior
r r� �rer� Zxml.parsers.expatr �Enumr r �globals�update� __members__r r� �compilerM r7 r; �ASCIIr> rE rG rR rS r� r� r� r r r� �objectr� r� r� r9 r r{ r� r r r! r r� r r& r r r r r r r r �<module> sj / !�
n&^! !
U ���