a
    ˜ëj[1 ã                
   @   sÚ  d Z dZddlZddlZddlZddlZddlmZmZ ddl	m
Z
 ddlmZ ddlmZmZmZmZmZmZ dd	lmZ dd
lmZmZmZ ddlmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$ ddl%m&Z&m'Z'm(Z(m)Z) ddl%m*Z+ ddl%m,Z- ddl%m.Z/ ddl0m1Z1m2Z2m3Z3m4Z4 ddl5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z? ddl@mAZA ddlBmCZCmDZDmEZEmFZFmGZG ddlmHZHmIZImJZJ ejKdk�ršddlmLZL nddlMmLZL e NeO¡ZPe Qd¡ZReSe6e7e8e:e;e<e>fƒZTG dd„ deUe e=ƒZVG dd„ deWeef e=ƒZXG dd„ deXƒZYeddœd d!„ZZG d"d#„ d#eƒZ[G d$d%„ d%eXƒZ\G d&d'„ d'e\ƒZ]G d(d)„ d)e\ƒZ^d*Z_G d+d,„ d,e]ƒZ`d-Zad6dd.œeee eebeUeb eWecebf df eeH e=d/œd0d1„ZdG d2d3„ d3eYƒZeG d4d5„ d5eYƒZfdS )7zMathieu Fenniakzbiziqe@mathieu.fenniak.neté    N)ÚIterableÚSequence)ÚBytesIO)Úceil)ÚAnyÚCallableÚ
NamedTupleÚOptionalÚUnionÚcasté   ©Úget_configuration)ÚPdfReaderProtocolÚPdfWriterProtocolÚXmpInformationProtocol)
ÚWHITESPACESÚBinaryStreamTypeÚ
StreamTypeÚdeprecation_no_replacementÚlogger_warningÚread_non_whitespaceÚread_until_regexÚread_until_whitespaceÚskip_over_commentÚskip_over_comments)ÚCheckboxRadioButtonAttributesÚFieldDictionaryAttributesÚOutlineFontFlagÚStreamAttributes)ÚFilterTypes)ÚTypArguments)ÚTypFitArguments)ÚSTREAM_TRUNCATED_PREMATURELYÚLimitReachedErrorÚPdfReadErrorÚPdfStreamErroré   )
ÚBooleanObjectÚByteStringObjectÚFloatObjectÚIndirectObjectÚ
NameObjectÚ
NullObjectÚNumberObjectÚ	PdfObjectÚTextStringObjectÚis_null_or_none)ÚFit)Úextract_inline__ascii85_decodeÚ extract_inline__ascii_hex_decodeÚextract_inline__dct_decodeÚ!extract_inline__run_length_decodeÚextract_inline_default)ÚStreamParsingBudgetÚread_hex_string_from_streamÚread_string_from_stream)é   é   )ÚSelfs   [+-]?(\d+)\s+(\d+)\s+R[^a-zA-Z]c                   @   s   e Zd Zed dœdd„Zd"eeeeee	e
f   d dœdd„Ze
d	œd
d„Zee d	œdd„Zeee dœdd„Zed dœdd„Zeedœdd„Zeedœdd„Zd#eee	edf ddœdd„Zee
ee e
dœdd„ƒZed$ddœeee ee	ee	 ee
e	f df ee d dœd d!„ƒZdS )%ÚArrayObject©Úpdf_destÚreturnc                 C   sJ   t d|  tƒ |d¡ƒ}| D ]*}t|dƒr:| | |¡¡ q| |¡ q|S )Nr>   FÚ	replicate)r   Ú_reference_cloner>   ÚhasattrÚappendrB   )Úselfr@   ÚarrÚdata© rI   ú]/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/pypdf/generic/_data_structures.pyrB   p   s    þ
zArrayObject.replicateFrI   ©r@   Úforce_duplicateÚignore_fieldsrA   c                 C   s(  z| j j|kr|s| W S W n$ ty.   ‚ Y n ty>   Y n0 td| jtƒ |dd�ƒ}| D ]Æ}t|ƒtv r‚| 	| 
|||¡¡ q\t|tƒr²| | 
|||¡||¡}| 	|j ¡ q\t|tƒröt| ¡  }tƒrö| |j
|d|d�||¡}| 	|j ¡ q\t|dƒ�r| 	| 
|||¡¡ q\| 	|¡ q\|S )úClone object into pdf_dest.r>   T)rL   )rL   rM   Úclone)Úindirect_referenceÚpdfÚMemoryErrorÚ	Exceptionr   rC   r>   ÚtypeÚ_SCALAR_TYPESrE   rO   Ú
isinstanceÚStreamObjectr+   Ú
get_objectrD   )rF   r@   rL   rM   rG   rH   ÚdupZresolvedrI   rI   rJ   rO      s@    
þ
ýýzArrayObject.clone©rA   c                 C   s   t | jtdd„ | D ƒƒfƒS )úq
        Used to detect modified object.

        Returns:
            Hash considering type and value.

        c                 s   s   | ]}|  ¡ V  qd S ©N©Úhash_bin©Ú.0ÚxrI   rI   rJ   Ú	<genexpr>±   ó    z'ArrayObject.hash_bin.<locals>.<genexpr>)ÚhashÚ	__class__Útuple©rF   rI   rI   rJ   r^   ©   s    zArrayObject.hash_binc                 C   s   t | ƒS )z:Emulate DictionaryObject.items for a list (index, object).)Ú	enumeraterg   rI   rI   rJ   Úitems³   s    zArrayObject.items)ÚlstrA   c                 C   sz   t |tttfƒrt|ƒ}n\t |tƒr,|g}nJt |tƒrZ|d dkrNt|ƒg}qvt|ƒg}nt |tƒrpt	|ƒg}n|g}|S )Nr   ú/)
rV   Úlistrf   Úsetr/   Ústrr,   r0   Úbytesr)   )rF   rj   ÚresultrI   rI   rJ   Ú_to_lst·   s    



zArrayObject._to_lstc                 C   s   t | ƒ}| |  |¡¡ |S )aÇ  
        Allow extension by adding list or add one element only

        Args:
            lst: any list, tuples are extended the list.
            other types(numbers,...) will be appended.
            if str is passed it will be converted into TextStringObject
            or NameObject (if starting with "/")
            if bytes is passed it will be converted into ByteStringObject

        Returns:
            ArrayObject with all elements

        )r>   Úextendrq   )rF   rj   ÚtemprI   rI   rJ   Ú__add__É   s    zArrayObject.__add__c                 C   s   |   |  |¡¡ | S )aŒ  
         Allow extension by adding list or add one element only

        Args:
            lst: any list, tuples are extended the list.
            other types(numbers,...) will be appended.
            if str is passed it will be converted into TextStringObject
            or NameObject (if starting with "/")
            if bytes is passed it will be converted into ByteStringObject

        )rr   rq   )rF   rj   rI   rI   rJ   Ú__iadd__Ü   s    zArrayObject.__iadd__c              	   C   s<   |   |¡D ],}z|  |¡}| |= W q
 ty4   Y q
0 q
| S )zAllow to remove items)rq   ÚindexÚ
ValueError)rF   rj   ra   rv   rI   rI   rJ   Ú__isub__ë   s    

zArrayObject.__isub__N©ÚstreamÚencryption_keyrA   c                 C   sH   |d urt ddƒ | d¡ | D ]}| d¡ | |¡ q | d¡ d S )Nú/the encryption_key parameter of write_to_streamú5.0.0ó   [ó    s    ])r   ÚwriteÚwrite_to_stream)rF   rz   r{   rH   rI   rI   rJ   r�   õ   s    ÿ

zArrayObject.write_to_stream)Úremaining_elementsÚparsing_budgetrA   c                 C   sD   | d8 } | dk rt dƒ‚|d ur@| jd8  _|jdk r@t dƒ‚| S )Nr'   r   z$Reached maximum array element count.ú!Reached maximum number of tokens.©r$   Úremaining_budget©r‚   rƒ   rI   rI   rJ   Ú_check_limits  s    
zArrayObject._check_limits©rƒ   ©rz   rQ   Úforced_encodingrƒ   rA   c          	      C   sð   t ƒ }|  d¡}|dkr tdƒ‚tƒ j}|  d¡}| ¡ sB|tv rN|  d¡}q2|dkrXqì|dkrv|  dd¡ t| ƒ q(|dkr€qìt j	||d�}|d	krÈ|  d
¡}|dkr¶| 
tƒ ¡ q(|  t|ƒ d¡ |  dd¡ | 
t| |||d�¡ q(|S )Nr'   r~   zCould not read arrayrc   ó   %éÿÿÿÿó   ]r‡   ó   nr;   s   ullr‰   )r>   Úreadr%   r   Zarray_maximum_element_countÚisspacer   Úseekr   rˆ   rE   r-   ÚlenÚread_object)	rz   rQ   r‹   rƒ   rG   Útmpr‚   ÚtokÚrestrI   rI   rJ   Úread_from_stream  s8    

ÿ
zArrayObject.read_from_stream)FrI   )N)N)Ú__name__Ú
__module__Ú__qualname__r   rB   Úboolr	   r   r
   rn   ÚintrO   r^   r   r   ri   rl   rq   rt   r=   ru   rx   r   ro   r�   Ústaticmethodr8   rˆ   r   Údictr˜   rI   rI   rI   rJ   r>   o   sF   ý  üû*
 ÿþ
 ýûúr>   c                   @   s²  e Zd Zed dœdd„Zd/eeeeee	e
f   d dœdd„Zd eeeeee	e
f   eee
e
f  d	d
œdd„Ze
dœdd„Zeedœdd„Zd0e	eedœdd„Zeeedœdd„Zd1eee edœdd„Zeedœdd„Zeee dœdd„ƒZd2eee	ed	f d	dœd d!„Zee
e
ee
 ee
d"œd#d$„ƒZ ee!ee
ed%œd&d'„ƒZ"e#d3d	d(œeee ee	ee	 e$e
e	f d	f ee% d d)œd*d+„ƒZ&e#eee e$eef d	d,œd-d.„ƒZ'd	S )4ÚDictionaryObjectr?   c                 C   sP   t d|  |  ¡ |d¡ƒ}|  ¡ D ]*\}}t|dƒr<| |¡n||| |¡< q |S )Nr    FrB   )r   rC   re   ri   rD   rB   )rF   r@   Úd__ÚkÚvrI   rI   rJ   rB   :  s    þÿzDictionaryObject.replicateFrI   rK   c                 C   s�   z| j j|kr|s| W S W n$ ty.   ‚ Y n ty>   Y n0 tƒ }td|  |  ¡ ||¡ƒ}|du rjg }t| 	¡ ƒdkrŒ| 
| ||||¡ |S )rN   r    Nr   )rP   rQ   rR   rS   rm   r   rC   re   r“   ÚkeysÚ_clone©rF   r@   rL   rM   Úvisitedr¡   rI   rI   rJ   rO   H  s"    
þzDictionaryObject.cloneN©Úsrcr@   rL   rM   r§   rA   c              
      sî  ˆ dusJ ‚t ˆ ƒ‰ d}|tˆ ƒk rltˆ | tƒrbttˆ | ƒdkrRˆ |= ˆ |= qˆ |  d8  < |d7 }qt‡ ‡fdd„dD ƒƒ�r@t ˆ ƒ‰ dD �]ª}|D �]ž}g }	|ˆv rœ|| vrœtˆ |¡tƒrœtˆ| tƒrœˆ 	dd¡du �s$ttˆ| ƒ 	dd¡du �s$ˆ 	dd¡ttˆ| ƒ 	dd¡krœtd	ˆ| ƒ}
| }|
du�r|
j
}td	|
 |
 ¡ ||¡ƒ}|du�r˜|j}|j}||f|v �rŠd}
�q| ||f¡ |	 |
|f¡ |du�s´J ‚|j
|t|ƒ< |}z"|
ˆk�rØd}
ntd	|
| ƒ}
W n, t�yþ   ‚ Y n t�y   d}
Y n0 �q6|	D ]\}}| |||ˆ |¡ �qqœq’ˆ ¡ D ] \}}|ˆ v�rHt|ƒtv�r¶t|tƒ�r¶t|d
ƒ�s†d|_
| ||ˆ ¡}|j
du�s¤J ‚|j
| | |¡< n0|| v�rHt|dƒ�rÚ| ||ˆ ¡n|| t|ƒ< �qHdS )z°
        Update the object from src.

        Args:
            src: "DictionaryObject":
            pdf_dest:
            force_duplicate:
            ignore_fields:

        Nr   r'   c                 3   sˆ   | ]€}|ˆ vo~|ˆv o~t ˆ |¡tƒo~t ˆ| tƒo~ˆ d d¡du p~ttˆ| ƒ d d¡du p~ˆ d d¡ttˆ| ƒ d d¡kV  qdS )ú/TypeN)rV   Úraw_getr+   r    Úgetr   )r`   Úfield©rM   r©   rI   rJ   rb   ‚  s   öÿþýÿ
ÿz*DictionaryObject._clone.<locals>.<genexpr>)ú/Nextú/Prevú/Nú/V))r¯   r°   )r±   r²   rª   r    rP   rO   )rl   r“   rV   r�   r   Úanyr«   r+   r    r¬   rP   rC   re   ZidnumÚ
generationÚaddrE   r,   rR   rS   r¥   ri   rT   rU   rW   rD   rO   )rF   r©   r@   rL   rM   r§   ra   rj   r¢   ÚobjsZcur_objZprev_objZsource_referenceZclonZsource_idnumZsource_generationÚsÚcr£   ÚvvrI   r®   rJ   r¥   b  s¤    
õ


ÿþýüø	÷

ÿöÿ

ÿþ


ÿ

ÿýzDictionaryObject._clonerZ   c                 C   s    t | jtdd„ |  ¡ D ƒƒfƒS )r[   c                 s   s   | ]\}}||  ¡ fV  qd S r\   r]   )r`   r¢   r£   rI   rI   rJ   rb   á  rc   z,DictionaryObject.hash_bin.<locals>.<genexpr>)rd   re   rf   ri   rg   rI   rI   rJ   r^   Ø  s    ÿzDictionaryObject.hash_bin)ÚkeyrA   c                 C   s   t  | |¡S r\   )rŸ   Ú__getitem__©rF   rº   rI   rI   rJ   r«   ä  s    zDictionaryObject.raw_get)rº   ÚdefaultrA   c                 C   st   | }t ƒ }t|ƒ}||v r*td|›d�ƒ‚| |¡ ||v rD|| S d|vrP|S |d  ¡ }t|tƒsj|S |}q
dS )a>  
        Returns the value of a key or from the parent if not found.
        If not found returns default.

        Args:
            key: string identifying the field to return

            default: default value to return

        Returns:
            Current key or inherited one, otherwise default value.

        zBDetected cycle in /Parent hierarchy when retrieving value for key Ú.ú/ParentN)rm   Úidr$   rµ   rX   rV   r    )rF   rº   r½   Úcurrentr§   Zobj_idÚparentrI   rI   rJ   Úget_inheritedç  s    

zDictionaryObject.get_inherited)rº   ÚvaluerA   c                 C   s2   t |tƒstdƒ‚t |tƒs$tdƒ‚t | ||¡S ©NzKey must be a PdfObjectzValue must be a PdfObject)rV   r/   rw   rŸ   Ú__setitem__©rF   rº   rÄ   rI   rI   rJ   rÆ     s
    

zDictionaryObject.__setitem__c                 C   s2   t |tƒstdƒ‚t |tƒs$tdƒ‚t | ||¡S rÅ   )rV   r/   rw   rŸ   Ú
setdefaultrÇ   rI   rI   rJ   rÈ     s
    

zDictionaryObject.setdefaultc                 C   s   t tt | |¡ ¡ ƒS r\   )r   r/   rŸ   r»   rX   r¼   rI   rI   rJ   r»     s    zDictionaryObject.__getitem__c                 C   sD   ddl m} |  dd¡}t|ƒr$dS |dus4J dƒ‚| ¡ }||ƒS )u¦  
        Retrieve XMP (Extensible Metadata Platform) data relevant to this
        object, if available.

        See Table 347 â€” Additional entries in a metadata stream dictionary.

        Returns:
          Returns a :class:`~pypdf.xmp.XmpInformation` instance
          that can be used to access XMP metadata from the document. Can also
          return None if no metadata was found on the document root.

        r   )ÚXmpInformationz	/MetadataNÚmypy)ÚxmprÉ   r¬   r1   rX   )rF   rÉ   ÚmetadatarI   rI   rJ   Úxmp_metadata  s    zDictionaryObject.xmp_metadatary   c                 C   sŒ   |d urt ddƒ | d¡ |  ¡ D ]X\}}t|ƒdkrR|d dkrR|d dkrRq$| ||¡ | d¡ | |¡ | d	¡ q$| d
¡ d S )Nr|   r}   ó   <<
r   r'   ú%r�   r   ó   
ó   >>)r   r€   ri   r“   r�   )rF   rz   r{   rº   rÄ   rI   rI   rJ   r�   5  s    ÿ
$

z DictionaryObject.write_to_stream)Úposition_beforeÚposition_endÚgenerationsrQ   rA   c                 C   sH   |}|D ]:}|j |  ¡ D ]&}||  k r2|krn qt||ƒ}qq|S r\   )ÚxrefÚvaluesÚmin)ÚclsrÒ   rÓ   rÔ   rQ   Úoutr´   ra   rI   rI   rJ   Ú_get_next_object_positionF  s    z*DictionaryObject._get_next_object_position)rz   rQ   ÚlengthrA   c          
   	   C   sÀ   |  ¡ }z$| dtj¡ |  ¡ }W | |¡ n| |¡ 0 | j||t|jƒ|d�}|| }||krrtd|› d�ƒ‚| |¡}| 	d¡}	|	dk ržt
d|› d�ƒ‚| ||	 d ¡ |d |	d	 … S )
Nr   )rÒ   rÓ   rÔ   rQ   zRequested length of ú  exceeds maximum allowed length.ó	   endstreamz6Unable to find 'endstream' marker for obj starting at r¾   é	   r'   )Útellr’   ÚosÚSEEK_ENDrÚ   rl   rÕ   r$   r�   Úfindr%   )
rØ   rz   rQ   rÛ   Úcurrent_positionÚstream_lengthZobject_positionZbytes_to_readZ
read_valueZendstream_positionrI   rI   rJ   Ú_read_unsized_from_streamQ  s&    
ÿ


ÿz*DictionaryObject._read_unsized_from_streamr‰   rŠ   c             
   C   sÖ  |   d¡}|dkr*tdt|  ¡ ƒ› d�ƒ‚i }tƒ j}t| ƒ}|dkr\|  dd¡ t| ƒ q6|sht	t
ƒ‚|dkr~|   d¡ �qž|  dd¡ |d8 }|d	k r¢td
ƒ‚|d urÊ| jd8  _|jd	k rÊtdƒ‚z¾z>t| ||d�}t|tƒrîW W �qžt|tƒ�std|›�ƒ‚W nV t�y` }	 z<|d u�r0|j�r0‚ tdt|	d� W Y d }	~	W q6W Y d }	~	n
d }	~	0 0 t| ƒ}|  dd¡ t| |||d�}
W n¶ t�yž   ‚ Y n¢ ttf�yÐ }	 ztdƒ|	‚W Y d }	~	nxd }	~	0  t�y> }	 zV|d u�rü|j�rütdƒ|	‚tdtt|	ƒd d… d� tƒ }| |¡ |W  Y d }	~	S d }	~	0 0 ||v�rT|
||< q6d}t|  ¡ ƒ|dœ}|d u�rˆ|j�rˆt|| ƒ‚t|fdti|¤Ž q6tj| ||d� d|v �rÂt |¡S tƒ }| |¡ |S )Nr   ó   <<zDictionary read error at byte z: stream must begin with '<<'rŒ   r�   r'   ó   >r   z-Reached maximum number of dictionary entries.r„   r‰   z)Expecting a NameObject for key but found z%(exception)r)ÚsourceÚ	exceptionzError reading PDF file.z%(exception)siô  zGMultiple definitions in dictionary at byte %(position)s for key %(key)s)Úpositionrº   rè   )rz   rQ   rH   Ú__streamdata__)r�   r%   Úhexrß   r   Ú dictionary_maximum_element_countr   r’   r   r&   r#   r$   r†   r”   rV   r-   r,   Ústrictr   r™   rR   ÚRecursionErrorrS   Úreprr    ÚupdateÚ_read_stream_datarW   Úinitialize_from_dictionary)rz   rQ   r‹   rƒ   r•   rH   Úremaining_countr–   rº   ÚexcrÄ   ÚretvalÚmsgrÖ   rI   rI   rJ   r˜   q  s†    
ÿ


ÿ$



ÿ


z!DictionaryObject.read_from_stream)rz   rQ   rH   rA   c                 C   sX  |   ¡ }t| ƒ}|dk�rH|  d¡dk�rH|  d¡}|dkrH|  d¡}q4|dvrXtdƒ‚|dkrz|  d¡d	krz|  d
d¡ tj|vr¾|d urš|jrštdƒ‚tdt	|   ¡ d� t
d
ƒ|ttjƒ< |tj }t|tƒ�r|   ¡ }|d usìJ dƒ‚| |¡}|  |d¡ |d u �rd
}|   ¡ }ddlm}	 |	ƒ }
|dk�r`||
jk�rPtd|› d�ƒ‚|  |¡|d< nt| t d¡|
jd�|d< t| ƒ}|  d¡}|| dk�rT|   ¡ }|  dd¡ |  d¡}|dk�rØ|d d d
… |d< nn|d u�r|j�s|  |d¡ tj| ||
jd�|d< |   ¡ }n0|  |d¡ tdt|   ¡ ƒ› d|›d|›d�ƒ‚n|  |d¡ d S )Nó   sé   s   treamr'   r   )rÐ   ó   z)Stream data must be followed by a newlinerú   rÐ   r�   zStream length not definedz+Stream length not defined @pos=%(position)d)rè   rê   rÊ   r   r   r   zDeclared stream length of rÜ   rë   rÝ   ©rz   ÚregexrÛ   é   iöÿÿÿrÞ   )rz   rQ   rÛ   z7Unable to find 'endstream' marker after stream at byte z (nd='z', end='z').)rß   r   r�   r&   r’   r   ÚLENGTHrî   r   r™   r.   r,   rV   r+   rX   Z_configurationr   Zmaximum_declared_stream_lengthr$   r   ÚreÚcompiler    rå   r%   rì   )rz   rQ   rH   Úposr·   ÚeolrÛ   ÚtZpstartr   ÚconfigurationÚeZndstreamÚendrI   rI   rJ   rò   É  s|    

ý



ÿ



ÿ


ÿÿÿÿz"DictionaryObject._read_stream_data)FrI   )N)N)N)N)(r™   rš   r›   r   rB   rœ   r	   r   r
   rn   r�   rO   rm   rf   r¥   r^   r   r«   rÃ   rÆ   rÈ   r/   r»   Úpropertyr   rÍ   r   ro   r�   Úclassmethodrl   r   rÚ   r   rå   rž   rŸ   r8   r˜   rò   rI   rI   rI   rJ   r    9  sp   ý  üûùv& ÿþþ
þ ýûúW
ûr    c                   @   s   e Zd Zd"ee ddœdd„Zedœdd„Zedœdd	„Z	e
e dœd
d„Zeeddœdd„Zeed df eddœdd„Zeed df eddœdd„Zd#eeeeedef  edœdd„Zeeeeddœdd„Zeddœdd„Zddœdd„Zddœd d!„ZdS )$Ú
TreeObjectN)ÚdctrA   c                 C   s   t  | ¡ |r|  |¡ d S r\   )r    Ú__init__rñ   )rF   r
  rI   rI   rJ   r    s    
zTreeObject.__init__rZ   c                 C   s   d| v S )Nú/FirstrI   rg   rI   rI   rJ   Úhas_children   s    zTreeObject.has_childrenc                 C   s   |   ¡ S r\   )Úchildrenrg   rI   rI   rJ   Ú__iter__#  s    zTreeObject.__iter__c                 c   s˜   |   ¡ sd S | tdƒ }| tdƒ }| ¡ }tƒ }t|ƒ}||v rTtdt|d� d S | |¡ |V  ||krpd S | tdƒ¡}t	|ƒrŠd S | ¡ }q2d S )Nr  ú/Lastz1Detected cycle in outline structure for %(child)s)rè   Úchildr¯   )
r  r,   rX   rm   rÀ   r   r™   rµ   r¬   r1   )rF   Z	child_refÚlastr  r§   Zchild_idrI   rI   rJ   r  &  s$    
zTreeObject.children)r  rQ   rA   c                 C   s   |   |d |¡ d S r\   )Úinsert_child)rF   r  rQ   rI   rI   rJ   Ú	add_child>  s    zTreeObject.add_child)rÂ   ÚnrA   c                 C   sr   t |ƒrd S |d usJ dƒ‚td| ¡ ƒ}d|v rnttdtt|tdƒ ƒ| ƒƒ|tdƒ< |  | dd ¡|¡ d S )NrÊ   r	  ú/Countr   r¿   )	r1   r   rX   r.   Úmaxr�   r,   Úinc_parent_counter_defaultr¬   )rF   rÂ   r  rI   rI   rJ   r  A  s    ÿz%TreeObject.inc_parent_counter_defaultc                 C   sœ   t |ƒrd S |d usJ dƒ‚td| ¡ ƒ}| dd¡dk}tt| dd¡ƒ}|dk r\t|ƒ}t|| |rldnd ƒ|tdƒ< |s„d S |  | d	d ¡|¡ d S )
NrÊ   r	  z
/%is_open%Tr  r   r'   r�   r¿   )	r1   r   rX   r¬   r�   Úabsr.   r,   Úinc_parent_counter_outline)rF   rÂ   r  Zopnr¸   rI   rI   rJ   r  N  s     z%TreeObject.inc_parent_counter_outline.)r  ÚbeforerQ   Úinc_parent_counterrA   c           
      C   s  |d u r| j }| ¡ }|jd us(J dƒ‚|j}d| vrž|| tdƒ< tdƒ| tdƒ< || tdƒ< | j|tdƒ< || | dd¡ƒ d|v rŒ|d= d	|v rš|d	= |S td
| d ƒ}tƒ }|j|k�rXt|ƒ}	|	|v rÖt	dƒ‚| 
|	¡ d|v røtd|d ƒ}q²td|ƒ|tdƒ< |j|td	ƒ< | j|tdƒ< d|v �r6|d= || tdƒ< || | dd¡ƒ |S z8t|d	 tƒ�snJ ‚||d	 tdƒ< |d	 |td	ƒ< W n4 t�y¦   ‚ Y n  t�yÄ   | dd ¡ Y n0 ||tdƒ< ||td	ƒ< | j|tdƒ< || | dd¡ƒ |S )NrÊ   r  r   r  r  r¿   r'   r¯   r°   r    z!Detected cycle in tree structure.r	  )r  rX   rP   r,   r.   r¬   r   rm   rÀ   r$   rµ   rV   r    rR   rS   Úpop)
rF   r  r  rQ   r  Ú	child_objZchild_referenceÚprevr§   Zprev_idrI   rI   rJ   r  _  s^    

zTreeObject.insert_child)ÚpreviousÚprevious_referencerÁ   r  rA   c                C   sÞ   |  dd¡}|du r~|rP| ¡ }|d= || tdƒ< t| tdƒ d ƒ| tdƒ< qÚtdƒ| tdƒ< | d= tdƒ| v rÚ| tdƒ= n\|r¤| ¡ }||tdƒ< ||tdƒ< n||ks°J ‚|d= || tdƒ< t| d d ƒ| tdƒ< dS )	z;Adjust the pointers of the linked list and tree node count.r¯   Nr°   r  r  r'   r   r  )r¬   rX   r,   r.   )rF   r   r!  rÁ   r  Znext_referenceZnext_objectrI   rI   rJ   Ú_remove_node_from_tree›  s*    ÿz!TreeObject._remove_node_from_tree)r  rA   c                 C   sæ   |  ¡ }d|vrtdƒ‚|d | kr,tdƒ‚d}d }d }| d }|  ¡ }| d }|  ¡ }	tƒ }
|d urÎ||krˆtj| ||||	d� d}qÎt|ƒ}||
v r td	ƒ‚|
 |¡ |}|}d
|vr¼qÎ|d
 }|  ¡ }q^|sÚtdƒ‚t|ƒ d S )Nr¿   ú/Removed child does not appear to be a tree itemz*Removed child is not a member of this treeFr  r  )r   r!  rÁ   r  Tz Detected cyclic /Next hierarchy.r¯   z"Removal couldn't find item in tree)	rX   rw   rm   r	  r"  rÀ   r$   rµ   Ú_reset_node_tree_relationship)rF   r  Zchild_objectÚfoundr!  r   Zcurrent_referencerÁ   Zlast_referencer  r§   Z
current_idrI   rI   rJ   Úremove_child½  sB    
ÿ

zTreeObject.remove_childc                 C   s(   d| vrt dƒ‚td| d ƒ | ¡ dS )z)Remove the object from the tree it is in.r¿   r#  r	  N)rw   r   r&  rg   rI   rI   rJ   Úremove_from_treeæ  s    zTreeObject.remove_from_treec                 C   s`   | D ]}|  ¡ }t|ƒ qtdƒ| v r0| tdƒ= tdƒ| v rF| tdƒ= tdƒ| v r\| tdƒ= d S )Nr  r  r  )rX   r$  r,   )rF   r  r  rI   rI   rJ   Ú
empty_treeì  s    


zTreeObject.empty_tree)N)N)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(  rI   rI   rI   rJ   r	    s2   þþ ûú=þ")r	  )r  rA   c                 C   s:   | t dƒ= t dƒ| v r | t dƒ= t dƒ| v r6| t dƒ= dS )zœ
    Call this after a node has been removed from a tree.

    This resets the nodes attributes in respect to that tree.

    Args:
        child_obj:

    r¿   r¯   r°   N)r,   )r  rI   rI   rJ   r$  ù  s
    


r$  c                   @   s6   e Zd ZU dZeed< eeef ed< ee	 ed< dS )Ú_FontFileCharacterMapzOThe character map pypdf._cmap derived from an embedded font program. See #4156.ÚdigestZmap_dictZ	int_entryN)
r™   rš   r›   Ú__doc__ro   Ú__annotations__rŸ   r   rl   r�   rI   rI   rI   rJ   r)  
  s   
r)  c                       s,  e Zd ZU dZee ed< ddœdd„Zed dœdd„Z	e
eeeeeeef   eeeef  dd	œ‡ fd
d„Zedœ‡ fdd„Zedœdd„Zeddœdd„Zedœ‡ fdd„Zd#eeeedf ddœdd„Zeeeef ed dœdd„ƒZd$eddœdd„Zd%eeeef df ed œd!d"„Z‡  Z S )&rW   NÚ_font_file_character_maprZ   c                 C   s   d| _ d | _d S ©Nrc   )Ú_dataÚdecoded_selfrg   rI   rI   rJ   r    s    zStreamObject.__init__r?   c                 C   sª   t d|  |  ¡ |d¡ƒ}| j|_z,| j}|d u r8d | _nt d| |¡ƒ| _W n$ ty`   ‚ Y n typ   Y n0 |  ¡ D ]*\}}t	|dƒr–| |¡n||| |¡< qz|S )NrW   FÚDecodedStreamObjectrB   )
r   rC   re   r/  r0  rB   rR   rS   ri   rD   ©rF   r@   r¡   r0  r¢   r£   rI   rI   rJ   rB     s(    þ
ÿ
ÿzStreamObject.replicater¨   c                    s‚   t d|ƒj| _z6t d|ƒj}|du r,d| _nt d| |||¡ƒ| _W n$ tyX   ‚ Y n tyh   Y n0 tƒ  |||||¡ dS )úœ
        Update the object from src.

        Args:
            src:
            pdf_dest:
            force_duplicate:
            ignore_fields:

        rW   Nr1  )r   r/  r0  rO   rR   rS   Úsuperr¥   )rF   r©   r@   rL   rM   r§   r0  ©re   rI   rJ   r¥   :  s    þ
zStreamObject._clonec                    s   t tƒ  ¡ | jfƒS )r[   )rd   r4  r^   r/  rg   r5  rI   rJ   r^   \  s    	zStreamObject.hash_binc                 C   s   | j S r\   ©r/  rg   rI   rI   rJ   Úget_datag  s    zStreamObject.get_data©rH   rA   c                 C   s
   || _ d S r\   r6  ©rF   rH   rI   rI   rJ   Úset_dataj  s    zStreamObject.set_datac                    s   t ƒ  ¡ }||  ¡ 7 }|S r\   )r4  Úhash_value_datar7  r9  r5  rI   rJ   r;  m  s    
zStreamObject.hash_value_datary   c                 C   sb   |d urt ddƒ tt| jƒƒ| ttjƒ< t | |¡ | tj= | 	d¡ | 	| j¡ | 	d¡ d S )Nr|   r}   s   
stream
s
   
endstream)
r   r.   r“   r/  r,   r   rþ   r    r�   r€   ©rF   rz   r{   rI   rI   rJ   r�   r  s    ÿ
zStreamObject.write_to_stream)ÚEncodedStreamObjectr1  c                 C   sH   t j| v rtƒ }ntƒ }| d |_| d= t j| v r:| t j= | | ¡ |S )Nrë   )r   ÚFILTERr=  r1  r/  rþ   rñ   )rH   rö   rI   rI   rJ   ró   €  s    



z'StreamObject.initialize_from_dictionaryr�   r=  )ÚlevelrA   c              	   C   s  ddl m} tj| v r¼| tj }t|tƒrŽtttjƒg|¢ƒ}z tt	ƒ g|  
tjtƒ ¡¢ƒ}W qº tyŠ   tt	ƒ |  
tjtƒ ¡gƒ}Y qº0 qÊtttjƒ|gƒ}tt	ƒ |  
tjt	ƒ ¡gƒ}nttjƒ}d }tƒ }| | ¡ ||ttjƒ< |d urþ||ttjƒ< | | j|¡|_|S )Nr   ©ÚFlateDecode)ÚfiltersrA  r   r>  rV   r>   r,   ÚFTÚFLATE_DECODEr-   r¬   ÚDECODE_PARMSÚ	TypeErrorr=  rñ   Úencoder/  )rF   r?  rA  ÚfÚparamsrö   rI   rI   rJ   Úflate_encode�  s4    


ÿÿÿ

zStreamObject.flate_encode)Úpillow_parametersrA   c                 C   sr   ddl m} |  dd¡dkrRztdt| jd� W n  tyP   tdt| d	� Y n0 || |ƒ\}}}|d
u rnd
S |S )a  
        Try to decode the stream object as an image

        Args:
            pillow_parameters: parameters provided to Pillow Image.save() method,
                cf. <https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.save>

        Returns:
            a PIL image if proper decoding has been found
        Raises:
            Exception: Errors during decoding will be reported.
                It is recommended to catch exceptions to prevent
                stops in your program.

        r'   )Ú_xobj_to_imagez/SubtypeÚ z/Imagez3%(indirect_reference)s does not seem to be an Image)rè   rP   z+%(obj)r object does not seem to be an Image)rè   ÚobjN)Z_image_xobjectrL  r¬   r   r™   rP   ÚAttributeError)rF   rK  rL  Ú	extensionÚ_ÚimgrI   rI   rJ   Údecode_as_image°  s$    ý
ýzStreamObject.decode_as_image)N)r�   )N)!r™   rš   r›   r-  r	   r)  r,  r  r   rB   r    rœ   r   r
   rn   r�   rm   rf   r¥   r^   ro   r7  r:  r;  r   r�   rž   rŸ   r   ró   rJ  rS  Ú__classcell__rI   rI   r5  rJ   rW     s6   
ýù" ÿþ
þ rW   c                   @   s   e Zd ZdS )r1  N)r™   rš   r›   rI   rI   rI   rJ   r1  Õ  s   r1  c                       s@   e Zd Zddœdd„Zedœdd„Zeddœ‡ fdd	„Z‡  ZS )
r=  NrZ   c                 C   s
   d | _ d S r\   )r0  rg   rI   rI   rJ   r  Ú  s    zEncodedStreamObject.__init__c                 C   sp   ddl m} | jd ur | j ¡ S tƒ }| || ƒ¡ |  ¡ D ]$\}}|tjtj	tj
fvr<|||< q<|| _| ¡ S )Nr   )Údecode_stream_data)rB  rU  r0  r7  r1  r:  ri   r   rþ   r>  rE  )rF   rU  Údecodedrº   rÄ   rI   rI   rJ   r7  Þ  s    


zEncodedStreamObject.get_datar8  c                    sŠ   ddl m} |  tjd¡tjtjgfv r~t|tƒs:t	dƒ‚| j
d u rL|  ¡  | j
d us^J dƒ‚| j
 |¡ tƒ  | |¡¡ ntdƒ‚d S )Nr   r@  rM  zData must be bytesrÊ   zJStreams encoded with a filter different from FlateDecode are not supported)rB  rA  r¬   r   r>  rC  rD  rV   ro   rF  r0  r7  r:  r4  rG  r%   )rF   rH   rA  r5  rI   rJ   r:  ï  s    

ÿzEncodedStreamObject.set_data)r™   rš   r›   r  ro   r7  r:  rT  rI   rI   r5  rJ   r=  Ù  s   r=  i'  c                	       sš  e Zd ZdZdZd+eeeeee e	e
ef df ddœ‡ fdd„Zed dœdd	„Zd,eeeeeee
f   d dœdd„Zeeeeeeee
f   eee
e
f  ddœ‡ fdd„Zeddœee
 ee
ee
 dœdd„ƒZeddœdd„Zeee	eef dœdd„Zedœdd„Zeddœ‡ fd d!„Zeeeeef  dœd"d#„ƒZ e j!eeeef  dd$œd%d#„ƒZ ddœd&d'„Z"d-eeeedf dd(œ‡ fd)d*„Z#‡  Z$S ).ÚContentStreama¥  
    In order to be fast, this data structure can contain either:

    * raw data in ._data
    * parsed stream operations in ._operations.

    At any time, ContentStream object can either have both of those fields defined,
    or one field defined and the other set to None.

    These fields are "rebuilt" lazily, when accessed:

    * when .get_data() is called, if ._data is None, it is rebuilt from ._operations.
    * when .operations is called, if ._operations is None, it is rebuilt from ._data.

    Conversely, these fields can be invalidated:

    * when .set_data() is called, ._operations is set to None.
    * when .operations is set, ._data is set to None.
    é€   N)rz   rQ   r‹   rA   c                    sb  || _ g | _|d u r$tƒ  d¡ �n4| ¡ }t|tƒ�r6ddlm} |ƒ }t	|ƒ }t
krptd|› dt
› d�ƒ‚tƒ }d}|D ]¤}	|	 ¡ }
t|
tƒr–q~t|
tƒs¶tdtt|
ƒjd� n>|
 ¡ }|t	|ƒ7 }||jkrìtd	|› d|j› d
�ƒ‚||7 }t	|ƒdk�s|dd … dkr~|d7 }|d7 }q~tƒ  t|ƒ¡ n"| ¡ }|d u�sLJ ‚tƒ  |¡ || _d S )Nrc   r   r   zArray-based stream has z > z
 elements.zFExpected StreamObject, got %(type_name)s instead. Data might be wrong.)rè   Ú	type_namez Array-based stream has at least z output bytes.r�   rÐ   r'   )rQ   Ú_operationsr4  r:  rX   rV   r>   Zpypdf._configurationr   r“   ÚCONTENT_STREAM_ARRAY_MAX_LENGTHr$   Ú	bytearrayr-   rW   r   r™   rT   r7  Z(array_based_stream_maximum_output_lengthro   r‹   )rF   rz   rQ   r‹   r   r  rä   rH   rÛ   r·   Z
s_resolvedÚnew_dataZstream_datar5  rI   rJ   r    sR    ÿ

ý
ÿÿ
zContentStream.__init__r?   c                 C   s®   t d|  |  d d ¡|d¡ƒ}| j|_z,| j}|d u r<d | _nt d| |¡ƒ| _W n$ tyd   ‚ Y n tyt   Y n0 |  ¡ D ]*\}}t	|dƒrš| |¡n||| |¡< q~|S )NrW  Fr1  rB   )r   rC   re   r/  r0  rB   rR   rS   ri   rD   r:  rQ   rl   rZ  r‹   r2  rI   rI   rJ   rB   R  s2    þ
ÿ
ÿ    zContentStream.replicateFrI   rK   c                 C   s„   z| j j|kr|s| W S W n$ ty.   ‚ Y n ty>   Y n0 tƒ }td|  |  dd¡||¡ƒ}|du rng }| | ||||¡ |S )zÂ
        Clone object into pdf_dest.

        Args:
            pdf_dest:
            force_duplicate:
            ignore_fields:

        Returns:
            The cloned ContentStream

        rW  N)	rP   rQ   rR   rS   rm   r   rC   re   r¥   r¦   rI   rI   rJ   rO   r  s$    
ÿþzContentStream.cloner¨   c                    s6   t d|ƒ}tƒ  |j¡ || _t|jƒ| _|j| _dS )r3  rW  N)r   r4  r:  r/  rQ   rl   rZ  r‹   )rF   r©   r@   rL   rM   r§   Zsrc_csr5  rI   rJ   r¥   ˜  s
    
zContentStream._clone)r‚   )r‚   rƒ   Útoken_decrementrA   c                 C   sD   | d ur | d8 } | dk r t dƒ‚| j|8  _|jdk r@t dƒ‚| S )Nr'   r   r„   z,Reached maximum number of tokens per stream.r…   ©r‚   rƒ   r^  rI   rI   rJ   rˆ   ²  s    
zContentStream._check_limits)rz   rA   c                 C   s  |  dd¡ g }ttƒ jd�}t|ƒ}|dv r2�q|  dd¡ | ¡ sN|dv rÆt|tj| j	d�}|dkr¢|g kstJ ‚| j
|d	d
� | j||d�}| j |df¡ n"| j
|dd
� | j ||f¡ g }q|dkrä|dvrâ| d¡}qÎq| j
|dd
� | t|d | j|d�¡ qd S )Nr   )r†   )rc   r   r�   r'   )ó   'ó   "rû   ó   BIr   )rƒ   r^  r‰   ó   INLINE IMAGErŒ   )rú   rÐ   rc   )r’   r8   r   Z!stream_parsing_work_maximum_countr   Úisalphar   r,   Zdelimiter_patternÚ_OPERATOR_LENGTH_LIMITrˆ   Ú_read_inline_imagerZ  rE   r�   r”   r‹   )rF   rz   Úoperandsrƒ   ÚpeekÚoperatorÚiirI   rI   rJ   Ú_parse_content_streamÂ  s0    
ÿz#ContentStream._parse_content_stream)rz   rƒ   rA   c                 C   sj  t ƒ }tƒ j}t|ƒ}|s"tdƒ‚| dd¡ |dkr8q†| j||dd�}t|| j|d�}t|ƒ}| dd¡ t|| j|d�}|||< q| 	d¡}	|	d d… d	ks¤J ‚| 
d
| 
dd¡¡}
| ¡ }t|
tƒrÚ|
rÖ|
d nd}
t|
tƒsèd}
d|
v súd|
v �rt|ƒ}�nŒd|
v �sd|
v �r&t|ƒ}�nld|
v �s:d|
v �rFt|ƒ}�nLd|
v �sZd|
v �rft|ƒ}�n,|
dk�rŠ| 
dd¡}t|tƒ�rš|�r–|d nd}t|tƒ�sªd}d|v �rºd}nZd|v �rÊd}nJ| 
d|dv �rÞdnd¡}t|ttfƒ�r|dk�r|d }nt|ƒ}d}| 
d¡}| 
d ¡}|dk�rbt|tƒ�rbt|tƒ�rb| 	t|| ƒ| ¡}n|dk�rtt|ƒ}t|ƒ}| dd¡ nt|ƒ}| 	d¡}t|ƒdk�r¶| dd¡ |dd… }|d d… d!k�sè|d"k�r`|tv�r`| |d¡ t|ƒ}| 	d¡}t|ƒdk�r | dd¡ |dd… }|d d… d!k�sR|d"k�r`|tv�r`td#|›�ƒ‚||d$œS )%NzUnexpected end of stream.r�   r'   ó   Ir   r_  r‰   r;   s   IDú/Fz/Filterznot setr   ZAHxZASCIIHexDecodeZA85ZASCII85DecodeZRLZRunLengthDecodeZDCTZ	DCTDecodez/CSrM  ZRGBZCMYKé   z/BPC>   z/DeviceGrayz/Indexedz/Iz/Grý   g       @z/Wz/Hó   EIrc   zHCould not extract inline image, even using fallback. Expected 'EI', got )ÚsettingsrH   )r    r   rí   r   r%   r’   rˆ   r”   rQ   r�   r¬   rß   rV   rl   rn   r4   r3   r6   r5   r�   Úfloatr7   r   r“   r   r&   )rF   rz   rƒ   rp  rô   r–   rº   rQ  rÄ   r•   ZfiltrZsavposrH   ÚcsZlcsÚbitsÚwidthÚheightÚeiZei_trailingrI   rI   rJ   rf  ç  sž    ÿ






þ


"

&
ÿÿÿz ContentStream._read_inline_imagerZ   c                 C   s¾   | j s¸tƒ }| jD ]š\}}|dkrz| d¡ tƒ }|d  |¡ | | ¡ dd… ¡ | d¡ | |d ¡ | d¡ n(|D ]}| |¡ | d	¡ q~| |¡ | d
¡ q| ¡ | _ | j S )Nrc  rb  rp  r   éþÿÿÿs   ID rH   ro  r   rÐ   )r/  r   rZ  r€   r�   Úgetvalue)rF   r]  rg  ri  Z	dict_textÚoprI   rI   rJ   r7  L  s$    




zContentStream.get_datar8  c                    s   t ƒ  |¡ g | _d S r\   )r4  r:  rZ  r9  r5  rI   rJ   r:  b  s    zContentStream.set_datac                 C   s(   | j s"| jr"|  t| jƒ¡ d| _| j S r.  )rZ  r/  rk  r   rg   rI   rI   rJ   Ú
operationsf  s    zContentStream.operations)rz  rA   c                 C   s   || _ d| _d S r.  )rZ  r/  )rF   rz  rI   rI   rJ   rz  m  s    c                 C   sD   | j r*| j  dg df¡ | j  g df¡ n| jr@d| j d | _d S )Nr   ó   qó   Qs   q
s   
Q
)rZ  ÚinsertrE   r/  rg   rI   rI   rJ   Úisolate_graphics_stater  s
    z$ContentStream.isolate_graphics_statery   c                    s&   | j s| jr|  ¡  tƒ  ||¡ d S r\   )r/  rZ  r7  r4  r�   r<  r5  rI   rJ   r�   z  s    zContentStream.write_to_stream)N)FrI   )N)%r™   rš   r›   r+  re  r   r
   rn   rl   rŸ   r�   r  r   rB   rœ   r	   r   rO   r    rm   rf   r¥   rž   r8   rˆ   r   rk  rf  ro   r7  r:  r  rz  Úsetterr~  r�   rT  rI   rI   r5  rJ   rW    sb    üû;ý#  üû(ùþû%e	 ÿþrW  iè  r‰   rŠ   c                C   sB  |   d¡}|  dd¡ |dkr@t| td� |   d¡}|  dd¡ |dkrTt | |¡S |dkr–|   d¡}|  dd¡ |d	krŒtj| |||d
�S t| |ƒS |dkr°tj| |||d
�S |dv rÂt	 | ¡S |dkrÔt
| |ƒS |dkrð|   d¡dkrðtƒ S |dk�rt | ¡S |dv �rô|   d¡}t |¡}|du�r€|du�s>J dƒ‚|  | ¡ d t|ƒ d¡ tt|d| d¡… ƒt|d ƒ|ƒS tj |¡}|du�rØ|d| ¡ … }|  t|ƒt|ƒ d¡ d|v �rÐt|ƒS t|ƒS |  t|ƒ d¡ t | ¡S |  ¡ }	|  dd¡ |   d¡}
|  |	¡ t| ƒ td|›d|	› d|
›�ƒ‚dS )a{  
    Read the next object from the stream.

    Args:
        stream: The stream to read from.
        pdf: The corresponding PDF file.
        forced_encoding: The encoding to enforce, if any.
        parsing_budget: The allowed parsing budget, optional. If set, only applies to dictionaries,
            arrays and content streams.

    Returns:
        The parsed object.
    r'   r�   rŒ   )Úlimitó   /ó   <r   rw  ræ   r‰   r~   )ó   tó   fó   (ó   eé   s   endobjr�   s   0123456789+-.é   NrÊ   ó   .iìÿÿÿéP   z(Invalid Elementary Object starting with z @z: )r�   r’   r   Ú_MAX_LEADING_COMMENTSr,   r˜   r    r9   r>   r(   r:   r-   ÚIndirectPatternÚmatchr  r“   r+   r�   r.   ZNumberPatternÚsearchÚstartr*   rß   r   r%   )rz   rQ   r‹   rƒ   r–   rh  r�  Z
number_endÚnumr  Zstream_extractrI   rI   rJ   r”   †  s`    











&




ÿr”   c                   @   sü   e Zd ZdZeddœdd„Zeee dœdd„ƒZ	eee dœd	d
„ƒZ
eed dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZdS )ÚFieldz‹
    A class representing a field dictionary.

    This class is accessed through
    :meth:`get_fields()<pypdf.PdfReader.get_fields>`
    Nr8  c              	   C   s¸   t  | ¡ t ¡ t ¡  }|j| _|D ],}z|| | t|ƒ< W q& tyP   Y q&0 q&t|  	d¡t
ƒr´tt
| tdƒ ƒ ¡ }t|tƒrŽ| ¡ }n|d u rœd}ntdƒ‚t|ƒ| tdƒ< d S )Nr²   rM  zShould never happen)r    r  r   Ú
attributesr   rP   r,   ÚKeyErrorrV   r¬   r=  r   r7  ro   ÚdecoderS   r0   )rF   rH   Zfield_attributesÚattrÚdZd_strrI   rI   rJ   r  Ú  s&    
ÿÿ

zField.__init__rZ   c                 C   s   |   tj¡S )z4Read-only property accessing the type of this field.)r¬   r   rC  rg   rI   rI   rJ   Ú
field_typeñ  s    zField.field_typec                 C   s   |   tj¡S )z6Read-only property accessing the parent of this field.)r¬   r   ZParentrg   rI   rI   rJ   rÂ   ö  s    zField.parentr>   c                 C   s   |   tj¡S )z4Read-only property accessing the kids of this field.)r¬   r   ZKidsrg   rI   rI   rJ   Úkidsû  s    z
Field.kidsc                 C   s   |   tj¡S )z4Read-only property accessing the name of this field.)r¬   r   ÚTrg   rI   rI   rJ   Úname   s    z
Field.namec                 C   s   |   tj¡S )z>Read-only property accessing the alternate name of this field.)r¬   r   ZTUrg   rI   rI   rJ   Úalternate_name  s    zField.alternate_namec                 C   s   |   tj¡S )zÒ
        Read-only property accessing the mapping name of this field.

        This name is used by pypdf as a key in the dictionary returned by
        :meth:`get_fields()<pypdf.PdfReader.get_fields>`
        )r¬   r   ZTMrg   rI   rI   rJ   Úmapping_name
  s    zField.mapping_namec                 C   s   |   tj¡S )z¢
        Read-only property accessing the field flags, specifying various
        characteristics of the field (see Table 8.70 of the PDF 1.7 reference).
        )r¬   r   ZFfrg   rI   rI   rJ   Úflags  s    zField.flagsc                 C   s   |   tj¡S )zs
        Read-only property accessing the value of this field.

        Format varies based on field type.
        )r¬   r   ÚVrg   rI   rI   rJ   rÄ     s    zField.valuec                 C   s   |   tj¡S )z=Read-only property accessing the default value of this field.)r¬   r   ZDVrg   rI   rI   rJ   Údefault_value%  s    zField.default_valuec                 C   s   |   tj¡S )zÚ
        Read-only property accessing the additional actions dictionary.

        This dictionary defines the field's behavior in response to trigger
        events. See Section 8.5.2 of the PDF 1.7 reference.
        )r¬   r   ZAArg   rI   rI   rJ   Úadditional_actions*  s    zField.additional_actions)r™   rš   r›   r+  r    r  r  r	   r,   r—  rÂ   r˜  rn   rš  r›  rœ  r�   r�  r   rÄ   rŸ  r   rI   rI   rI   rJ   r‘  Ò  s,   	r‘  c                       s‚  e Zd ZU dZdZee ed< ddœ‡ fdd„Ze	e
ef e	eeeef eddœdd	„Zed
dœdd„ƒZd&ee	e
edf ddœdd„Zeee
 dœdd„ƒZeee dœdd„ƒZeee
 dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeee dœdd„ƒZeed
 dœd d!„ƒZeee  dœd"d#„ƒZ!eee dœd$d%„ƒZ"‡  Z#S )'ÚDestinationa®  
    A class representing a destination within a PDF file.

    See section 12.3.2 of the PDF 2.0 reference.

    Args:
        title: Title of this destination.
        page: Reference to the page of this destination. Should
            be an instance of :class:`IndirectObject<pypdf.generic.IndirectObject>`.
        fit: How the destination is displayed.

    Raises:
        PdfReadError: If destination type is invalid.

    NÚnoderZ   c                    sH   | j du rtƒ  ¡  n.d| j vr*tdƒ‚nt td| j d ƒ| j ¡ dS )a/  
        Remove the outline item this destination was built from.

        `reader.outline` and `writer.outline` yield detached copies rather than
        the nodes themselves, so the copy never has a `/Parent` and removing it
        would be a no-op. `node` is the dictionary in the document.
        Nr¿   r#  r	  )r¢  r4  r'  rw   r	  r&  r   rg   r5  rI   rJ   r'  J  s    


ÿzDestination.remove_from_tree)ÚtitleÚpageÚfitrA   c                 C   s\  g | _ |j}|j}t | ¡ t|ƒ| tdƒ< || tdƒ< || tdƒ< |dkrÌt|ƒdk rf| t	dƒ¡ t|ƒdk r€| t	dƒ¡ t|ƒdk rš| t	dƒ¡ |d d… \| tt
jƒ< | tt
jƒ< | td	ƒ< �nŒt|ƒd
krÜ�n||tjk�rrt|ƒdk�r,|\| tt
jƒ< | tt
jƒ< | tt
jƒ< | tt
jƒ< nDtƒ tƒ tƒ tƒ f\| tt
jƒ< | tt
jƒ< | tt
jƒ< | tt
jƒ< næ|tjtjfv �rÔz|\| tt
jƒ< W n8 t�y®   ‚ Y n$ t�yÐ   tƒ | tt
jƒ< Y n0 n„|tjtjfv �r6z|\| tt
jƒ< W n8 t�y   ‚ Y n$ t�y2   tƒ | tt
jƒ< Y n0 n"|tjtjfv �rJntd|›�ƒ‚d S )Nú/Titleú/Pagerª   z/XYZr'   g        r   r;   ú/Zoomr   rn  zUnknown Destination Type: )Z_filtered_childrenZfit_typeZfit_argsr    r  r0   r,   r“   rE   r.   ÚTAÚLEFTZTOPÚTFZFIT_RZBOTTOMÚRIGHTr-   ZFIT_HZFIT_BHrR   rS   ZFIT_VZFIT_BVZFITZFIT_Br%   )rF   r£  r¤  r¥  ÚtypÚargsrI   rI   rJ   r  [  sn    

ü
ýûüûüzDestination.__init__r>   c                    s(   t ˆ  d¡ˆ d g‡ fdd„dD ƒ ƒS )Nr§  rª   c                    s   g | ]}|ˆ v rˆ | ‘qS rI   rI   r_   rg   rI   rJ   Ú
<listcomp>¡  s   þz*Destination.dest_array.<locals>.<listcomp>)ú/Leftú/Bottomú/Rightú/Topr¨  )r>   r«   rg   rI   rg   rJ   Ú
dest_array�  s    
þÿÿzDestination.dest_arrayry   c                 C   sŽ   |d urt ddƒ | d¡ tdƒ}| |¡ | d¡ | j}| |¡ tdƒ}| |¡ | d¡ tdƒ}| |¡ | d¡ | d	¡ d S )
Nr|   r}   rÎ   z/Dr   z/Sz/GoTorÐ   rÑ   )r   r€   r,   r�   r´  )rF   rz   r{   rº   rÄ   Zvalue_srI   rI   rJ   r�   ¨  s"    ÿ







zDestination.write_to_streamc                 C   s
   |   d¡S )z3Read-only property accessing the destination title.r¦  ©r¬   rg   rI   rI   rJ   r£  ¿  s    zDestination.titlec                 C   s
   |   d¡S )zHRead-only property accessing the IndirectObject of the destination page.r§  rµ  rg   rI   rI   rJ   r¤  Ä  s    zDestination.pagec                 C   s
   |   d¡S )z2Read-only property accessing the destination type.rª   rµ  rg   rI   rI   rJ   r­  É  s    zDestination.typc                 C   s   |   dd¡S )z-Read-only property accessing the zoom factor.r¨  Nrµ  rg   rI   rI   rJ   ÚzoomÎ  s    zDestination.zoomc                 C   s   |   dd¡S )z<Read-only property accessing the left horizontal coordinate.r°  Nrµ  rg   rI   rI   rJ   ÚleftÓ  s    zDestination.leftc                 C   s   |   dd¡S )z=Read-only property accessing the right horizontal coordinate.r²  Nrµ  rg   rI   rI   rJ   ÚrightØ  s    zDestination.rightc                 C   s   |   dd¡S )z9Read-only property accessing the top vertical coordinate.r³  Nrµ  rg   rI   rI   rJ   ÚtopÝ  s    zDestination.topc                 C   s   |   dd¡S )z<Read-only property accessing the bottom vertical coordinate.r±  Nrµ  rg   rI   rI   rJ   Úbottomâ  s    zDestination.bottomc              
   C   s(   t d|  dttdƒtdƒtdƒgƒ¡ƒS )zHRead-only property accessing the color in (R, G, B) with values 0.0-1.0.r>   z/Cr   )r   r¬   r>   r*   rg   rI   rI   rJ   Úcolorç  s     þzDestination.colorc                 C   s   t |  dd¡ƒS )z_
        Read-only property accessing the font type.

        1=italic, 2=bold, 3=both
        rm  r   )r   r¬   rg   rI   rI   rJ   Úfont_formatï  s    zDestination.font_formatc                 C   s   |   dd¡S )zÀ
        Read-only property accessing the outline count.

        positive = expanded
        negative = collapsed
        absolute value = number of visible descendants at all levels
        r  Nrµ  rg   rI   rI   rJ   Úoutline_countø  s    	zDestination.outline_count)N)$r™   rš   r›   r+  r¢  r	   r    r,  r'  r
   rn   ro   r.   r+   r-   r2   r  r  r´  r   r�   r£  r¤  r­  r�   r¶  r*   r·  r¸  r¹  rº  r»  r   r¼  r½  rT  rI   rI   r5  rJ   r¡  5  sP   
þÿ
ûB ÿþr¡  )N)gÚ
__author__Ú__author_email__Úloggingrà   rÿ   ÚsysÚcollections.abcr   r   Úior   Úmathr   Útypingr   r   r   r	   r
   r   rM  r   Z
_protocolsr   r   r   Ú_utilsr   r   r   r   r   r   r   r   r   r   Ú	constantsr   r   r   r   r    rC  r!   r©  r"   r«  Úerrorsr#   r$   r%   r&   Ú_baser(   r)   r*   r+   r,   r-   r.   r/   r0   r1   Z_fitr2   Z_image_inliner3   r4   r5   r6   r7   r8   r9   r:   Úversion_infor=   Ztyping_extensionsÚ	getLoggerr™   Úloggerr   rŒ  Ú	frozensetrU   rl   r>   rŸ   r    r	  r$  r)  rW   r1  r=  r[  rW  r‹  rn   r�   r”   r‘  r¡  rI   rI   rI   rJ   Ú<module>   sz    	00

ÿ K   d `	 C'    ýûúLc