a
    ˜ëjþ2 ã                   @   sš  d dl Z d dlZd dlZd dlmZ d dlmZmZ d dl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 ejdkr�d d	lmZ nd d	lmZ d
dlmZ d
dlmZmZ d
dl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*m+Z+ d
dl,m-Z. d
dl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5 d
dl6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZD d
dlEmFZF e�r†d
dlGmHZH G dd„ deƒZIdS )é    N)ÚIterable)ÚBytesIOÚUnsupportedOperation)Ú
itemgetter)ÚPath)ÚTracebackType)ÚTYPE_CHECKINGÚAnyÚCallableÚOptionalÚUnionÚcast)é   é   )ÚSelfé   )Úapply_legacy_configuration)ÚPdfDocCommonÚconvert_to_int)Ú
EncryptionÚPasswordType)ÚWHITESPACES_AS_BYTESÚStrByteTypeÚ
StreamTypeÚget_stream_dataÚget_stream_sizeÚlogger_warningÚread_non_whitespaceÚread_previous_lineÚread_until_whitespaceÚskip_over_commentÚskip_over_whitespace)ÚTrailerKeys)ÚEmptyFileErrorÚFileNotDecryptedErrorÚLimitReachedErrorÚPdfReadErrorÚPdfStreamErrorÚWrongPasswordError)ÚArrayObjectÚByteStringObjectÚDestinationÚDictionaryObjectÚEncodedStreamObjectÚIndirectObjectÚ
NameObjectÚ
NullObjectÚNumberObjectÚ	PdfObjectÚStreamObjectÚTextStringObjectÚis_null_or_noneÚread_object)ÚXmpInformation)Ú
PageObjectc                	       sÐ  e Zd ZU dZeeeeef f ed< eed< dzdddœe	e
ef ee	eedf ee edd	œd
d„Ze	e
ef ddœdd„Zee	eef  ddœdd„Zedœdd„Zeee  ee ee ddœdd„Zddœdd„Z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!„ƒZeee  dœd"d#„ƒZ!e	ee"e#df ee d$œd%d&„Z$e#e%d$œd'd(„Z&e	ee#f ee% d$œd)d*„Z'e(e)eef dœd+d,„Z*eeee% d-œd.d/„Z+eeee% ee% d0œd1d2„Z,e#e%e%d3œd4d5„Z-e(ddœd6d7„Z.e(ddœd8d9„Z/e(ddœd:d;„Z0e(edœd<d=„Z1d>Z2e3eed?œd@dA„ƒZ4e5e(edœdBdC„ƒZ6eeee)eef f dDœdEdF„Z7e(ee dœdGdH„Z8e(ddœdIdJ„Z9e(ee eddKœdLdM„Z:e;j<e;j=e;j>e;j?e;j@fZAeddNœdOdP„ZBe(ee dœdQdR„ZCe(eee dSœdTdU„ZDeEe eEe eFeEe dVœdWdX„ZGe(eFdœdYdZ„ZHe3e(eedSœd[d\„ƒZIe5eeJe)eeef  dDœd]d^„ƒZKe5eeJe dDœd_d`„ƒZLe(ddœdadb„ZMeEe eNege	ee)edcf f f eNee	ee)edcf f gef dddœdedf„ZOeEe eJe)eef  dgœdhdi„ZPe	eef eQdœdjdk„ZReedœdldm„ƒZSeee dnœdodp„ZTeee dnœdqdr„ZUd{e	eJe df e	eJe df eeef dsœdtdu„ZVddddvœee eeeeWf  eeXe  eeeWf dwœ‡ fdxdy„ZY‡  ZZS )|Ú	PdfReadera  
    Initialize a PdfReader object.

    This operation can take some time, as the PDF stream's cross-reference
    tables are read into memory.

    Args:
        stream: A File object or an object that supports the standard read
            and seek methods similar to a File object. Could also be a
            string representing a path to a PDF file.
        strict: Determines whether user should be warned of all
            problems and also causes some correctable problems to be fatal.
            Defaults to ``False``.
        password: Decrypt PDF file at initialization. If the
            password is None, the file will not be decrypted.
            Defaults to ``None``.
        root_object_recovery_limit: The maximum number of objects to query
            for recovering the Root object in non-strict mode. To disable
            this security measure, pass ``None``.
        xref_stream_maximum_entries: The maximum number of entries which are
            allowed inside a stream-based cross-reference stream.

    ÚxrefÚtrailerFNi'  i€„ )Úroot_object_recovery_limitÚxref_stream_maximum_entries)ÚstreamÚstrictÚpasswordr<   r=   Úreturnc                C   s¼   || _ d | _i | _d| _d| _i | _i | _i | _tƒ | _	t
|tƒrF|ntj| _|| _d| _tƒ  d | _d | _|  |¡ tƒ | _d| _d | _| jrœ|  |¡ n|d ur¬tdƒ‚d | _g | _d S )Nr   FzNot an encrypted file)r?   Úflattened_pagesÚresolved_objectsÚ
_startxrefÚ
xref_indexr:   Úxref_free_entryÚxref_objStmr,   r;   Ú
isinstanceÚintÚsysÚmaxsizeÚ_root_object_recovery_limitÚ_xref_stream_maximum_entriesÚ_xref_stream_entry_countr   Ú_page_id2numÚ_validated_rootÚ_initialize_streamÚsetÚ_known_objectsÚ_override_encryptionÚ_encryptionÚis_encryptedÚ_handle_encryptionr&   Ú_named_destinations_cacheÚ_object_stream_resolution_stack)Úselfr>   r?   r@   r<   r=   © r[   úL/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/pypdf/_reader.pyÚ__init__   s4    	ÿ
zPdfReader.__init__)r>   rA   c                 C   s„   t |dƒr d|jvr tdtd� d| _t|ttfƒrpt|dƒ�}t	| 
¡ ƒ}W d   ƒ n1 s`0    Y  d| _|  
|¡ || _d S )NÚmodeÚbzQPdfReader stream/file object is not in binary mode. It may not be read correctly.©ÚsourceFÚrbT)Úhasattrr^   r   Ú__name__Ú_stream_openedrH   Ústrr   Úopenr   Úreadr>   )rZ   r>   Úfhr[   r[   r\   rQ   ¯   s    ý*
zPdfReader._initialize_stream)r@   rA   c                 C   sâ   d| _ | j tjtƒ ¡ ¡ }d}t|tƒr^|r^|d  ¡ }t|t	t
fƒrP|j}qttdtd� nt|tƒsttdtd� | jtj }t|tƒs’tdƒ‚t ||¡| _|d ur¬|nd}| jj|| jd�tjkrØ|d urØtd	ƒ‚d
| _ d S )NTó    r   z2Ignoring non-string first /ID entry of the trailerr`   z+Ignoring malformed /ID entry of the trailerz1/Encrypt entry of the trailer is not a dictionary©r?   zWrong passwordF)rT   r;   ÚgetÚTKÚIDr0   Ú
get_objectrH   r)   r*   r4   Úoriginal_bytesr   rd   ÚENCRYPTr,   r&   r   rh   rU   Úverifyr?   r   ZNOT_DECRYPTEDr(   )rZ   r@   Zid_entryZ	id1_entryZfirst_id_entryZencrypt_entryÚpwdr[   r[   r\   rW   ¾   s*    

ÿþzPdfReader._handle_encryption)rA   c                 C   s   | S ©Nr[   ©rZ   r[   r[   r\   Ú	__enter__Ü   s    zPdfReader.__enter__)Úexc_typeÚexc_valÚexc_tbrA   c                 C   s   |   ¡  d S rt   )Úclose)rZ   rw   rx   ry   r[   r[   r\   Ú__exit__ß   s    zPdfReader.__exit__c                 C   s:   | j r| j ¡  g | _i | _tƒ | _i | _i | _i | _	dS )z8Close the stream if opened in __init__ and clear memory.N)
re   r>   rz   rB   rC   r,   r;   r:   rF   rG   ru   r[   r[   r\   rz   ç   s    
zPdfReader.closec              	   C   sh  | j r| j S | j tjtƒ ¡ ¡ }t|tƒr2|}ntƒ }t	|ƒrNt
dtd� n"| d¡dkrd|| _ nt
dtd� | j du �r,t
dtd� tt| j dd	¡ƒ}t|ƒD ]†}|| jkrºtd
ƒ‚z|  |d ¡}W n( tyà   ‚ Y n tyô   d}Y n0 t|tƒr¤| d¡dkr¤|| _ t
dt|jd�  �q,q¤| j du �rbd|v �rZt
dt|jd� || _ ntdƒ‚| j S )z7Provide access to "/Root". Standardized with PdfWriter.z"Cannot find "/Root" key in trailerr`   ú/Typez/CatalogzInvalid Root object in trailerNz$Searching object with "/Catalog" keyú/Sizer   z+Maximum Root object recovery limit reached.r   zRoot found at %(obj_reference)r)ra   Zobj_referencez/Pagesz=Possible root found at %(root_ref)r, but missing /Catalog key)ra   Zroot_refzCannot find Root object in pdf)rP   r;   rl   rm   ÚROOTr0   ro   rH   r,   r5   r   rd   r   rI   ÚrangerL   r%   ÚMemoryErrorÚ	ExceptionÚindirect_referencer&   )rZ   ÚrootZroot_dictionaryZnumber_of_objectsÚiÚobjr[   r[   r\   Úroot_objectò   sR    


ý
ýzPdfReader.root_objectc                 C   sJ   | j  tjd¡}t|ƒrdS |dus,J dƒ‚| ¡ }t|tƒsFtdƒ‚|S )z›
        Provide access to "/Info". Standardized with PdfWriter.

        Returns:
            /Info Dictionary; None if the entry does not exist

        NÚmypyzHTrailer not found or does not point to a document information dictionary)	r;   rl   rm   ÚINFOr5   ro   rH   r,   r&   )rZ   Úinfor[   r[   r\   Ú_info%  s    	
ÿzPdfReader._infoc                 C   s:   | j  tjd¡}t|ƒrdS |dus,J dƒ‚tt| ¡ ƒS )z’
        Provide access to "/ID". Standardized with PdfWriter.

        Returns:
            /ID array; None if the entry does not exist

        Nr‡   )r;   rl   rm   rn   r5   r   r)   ro   )rZ   Zfile_identifiersr[   r[   r\   Ú_ID9  s
    	zPdfReader._IDc                 C   s>   | j  ¡ }| j  dd¡ | j  d¡ dd¡}| j  |d¡ |S )zÇ
        The first 8 bytes of the file.

        This is typically something like ``'%PDF-1.6'`` and can be used to
        detect if the file is actually a PDF file and which version it is.
        r   é   zutf-8Úbackslashreplace)r>   ÚtellÚseekrh   Údecode)rZ   ÚlocZpdf_file_versionr[   r[   r\   Ú
pdf_headerH  s
    

zPdfReader.pdf_headerc                 C   s:   z,| j duo| j j | _tt| jjƒW d| _S d| _0 dS )z(XMP (Extensible Metadata Platform) data.NF)rU   ZEncryptMetadatarT   r   r7   r†   Úxmp_metadataru   r[   r[   r\   r“   X  s    ÿþzPdfReader.xmp_metadata)r‚   rA   c                 C   sx   | j du r dd„ t| jƒD ƒ| _ t|ƒr,dS t|ttfƒsBJ dƒ‚t|tƒrR|}n|j}| j dusjJ dƒ‚| j  |d¡S )zË
        Retrieve the page number from an indirect reference.

        Args:
            indirect_reference: The indirect reference to locate.

        Returns:
            Page number or None.

        Nc                 S   s   i | ]\}}|j j|“qS r[   )r‚   Úidnum)Ú.0r„   Úxr[   r[   r\   Ú
<dictcomp>s  s   z:PdfReader._get_page_number_by_indirect.<locals>.<dictcomp>r‡   zhint for mypy)	rO   Ú	enumerateZpagesr5   rH   rI   r.   r”   rl   )rZ   r‚   r”   r[   r[   r\   Ú_get_page_number_by_indirecte  s    
ÿ
z&PdfReader._get_page_number_by_indirectc                 C   sÔ  |j }|| jv rJ| j |¡}g | j|d … ¢|‘}tdd tt|ƒ¡ ƒ‚| j |¡ �zj| j|j  \}}t	|d| ƒ 
¡ }tt|d ƒdks�J ‚t| ¡ ƒ}| d¡}	| d¡}
t|	tƒrÄt|
tƒsÔtd|› d	�ƒ‚t|	ƒ}t|
ƒ}t|ƒ}|dk �sd|  k�r|k�sXn | j�r4td
|› d|› d|› d�ƒ‚tdt|||d� tƒ W | j ¡  S |d }| d¡ ||k�r®| j�r˜td|› d|› d|› d�ƒ‚tdt|||d� |}g }t|ƒD ]È}t|ƒ | dd¡ t |¡}t|ƒ | dd¡ t |¡}t|ƒ | dd¡ |dk �s0|dk �s0|| |k�rj| j�rTtd|› d|› d|› d�ƒ‚tdt|||d� �qº| t|ƒt|ƒf¡ �qºtƒ }d}t|ƒD �]\}\}}|  d|¡}|d u�rÒ||j k�r–|}d}�q–| || d¡ t|ƒ | dd¡ zt|| ƒ}W nV t �yZ } z<tdt|||d� | j�r@td |› �ƒ|‚tƒ }W Y d }~n
d }~0 0 | j |d!¡\}}||k�r†|  !d||¡ ||j k�r–|}d}�q–|�s´| j�r´td"ƒ‚|W | j ¡  S | j ¡  0 d S )#Nz+Circular object-stream reference detected: z -> r   r|   ú/ObjStmú/Nz/Firstz"Invalid /ObjStm header for object z&: /N or /First missing or not a numberzInvalid /N (z) or /First (z) in object stream Ú.zZInvalid /N (%(n)d) or /First (%(first)d) in object stream %(stmnum)d; ignoring the stream.)ra   ÚnÚfirstÚstmnumr   z	Value /N z for object z exceeds maximum allowed value zdValue /N %(n)d for object %(stmnum)d exceeds maximum allowed value %(max_n)d. Limiting to %(max_n)d.)ra   r�   rŸ   Úmax_néÿÿÿÿr   zInvalid object number (z) or offset (zjInvalid object number (%(objnum)d) or offset (%(offset)d) in object stream %(stmnum)d; skipping the entry.)ra   ÚobjnumÚoffsetrŸ   FTzEInvalid stream (index %(index)d) within object %(obj_num)d 0: %(exc)s)ra   ÚindexÚobj_numÚexczCannot read object stream: )NNz%This is a fatal error in strict mode.)"r”   rY   r¤   r&   ÚjoinÚmaprf   ÚappendrG   r.   ro   r   r   Úget_datarl   rH   r1   rI   r   r?   r   rd   r0   Úpopr�   r%   r   r   Zread_from_streamr˜   Úcache_get_indirect_objectr6   r'   Úcache_indirect_object)rZ   r‚   Zobj_idÚstartÚcyclerŸ   Z_idxZobj_stmÚstream_dataZn_valueZfirst_valuer�   Zfirst_offsetZstream_lengthr    Z	obj_indexZ_ir¢   r£   Z
target_objÚfoundr„   r¥   Z
obj_offsetÚcachedr…   r¦   Zauthoritative_stmr[   r[   r\   Ú_get_object_from_stream�  sò    
ÿ

ÿ
ÿ$ÿø
m
“

ø


"ÿÿø

ûÿþ
ÿ
þz!PdfReader._get_object_from_streamc           
   
   C   s0  t |tƒrt|d| ƒ}|  |j|j¡}|j|jf}|| jv r@|S |jdkrd|j| jv rd|  |¡}�nœ|j| j	v �rÞ|j| j	|j v �rÞ| j
 |ji ¡ |jd¡r¦tƒ S | j	|j |j }| j |d¡ z0|  | j¡\}}||jksì||jkrôtdƒ‚W n¾ t�y   ‚ Y nª t�y´   t| jƒ}t d|j› d|j› d� ¡ |¡}|d u�r¨tdt|j|jd� | d¡d	 | j	|j |j< | j | d¡d	 ¡ |  | j¡\}}nd
}d
}Y n0 ||jk�rú| j�rú| j�r4td|j› d|j› d|› d|› d�	ƒ‚n:||jk�r4| j�r4td|j› d|j› d|› d|› d�	ƒ‚| j�rL||jk�sLJ ‚|j|jf}	|	| jv �rttd|›d�ƒ‚| j |	¡ t| j| ƒ}| j  |	¡ | j!�s | j"d u�r | j" #¡ �sÀt$dƒ‚| j"j%||j|j| jd�}�n"t| jƒ}t d|j› d|j› d� ¡ |¡}|d u�rÜtdt|j|jd� |j| j	v�rBi | j	|j< | d¡d	 | j	|j |j< | j | &d¡d	 ¡ t'| jƒ | j d
d	¡ t| j| ƒ}| j!�s | j"d u�r | j" #¡ �sÀt$dƒ‚| j"j%||j|j| jd�}n$tdt|j|jd� | j�r tdƒ‚|jdk�r|j| jv �s,|  (|j|j|¡ |S )Nr   Fz&Not matching, we parse the file for itz\sz\s+z\s+objz/Object ID %(idnum)d,%(generation)d ref repaired©ra   r”   Ú
generationr   r¡   zExpected object ID (ú z) does not match actual (z); xref table not zero-indexed.z).z&Detected loop with self reference for rœ   zFile has not been decryptedrk   z%Object %(idnum)d %(generation)d foundz,Object %(idnum)d %(generation)d not defined.zCould not find object.))rH   rI   r.   r¬   rµ   r”   rC   rG   r³   r:   rF   rl   r0   r>   r�   Úread_object_headerr&   r€   r�   r   ÚreÚsearchÚencoder   rd   r®   rE   r?   rS   r%   Úaddr6   ÚremoverT   rU   Zis_decryptedr$   Zdecrypt_objectÚendr!   r­   )
rZ   r‚   ÚretvalÚkeyr®   r”   rµ   ÚbufÚmZcurrent_objectr[   r[   r\   ro   &  s   
ÿþ
ÿ
þ
ÿþÿÿþ
þ
üþ
ÿ
ÿÿÿÿÿÿ
þ

þ
üÿ

þüÿ
þ
ÿzPdfReader.get_objectc              
   C   s  t |ƒ t|ƒ}| dd¡ t|tj| jd�}|t|ƒO }| dd¡ t|tj| jd�}|t|ƒO }| dd¡ | d¡}t|ƒ | dd¡ |r¨| jr¨t	dt
||d� zt|ƒt|ƒfW S  ttf�y  } z(td|›d|›d	|› �ƒ|‚W Y d }~n
d }~0 0 d S )
Nr¡   r   ©Z	max_bytesr?   r   zFSuperfluous whitespace found in object header %(idnum)r %(generation)rr´   z#Invalid indirect object reference (r¶   z R): )r    r!   r�   r   r.   Ú_MAXIMUM_PART_LENGTHr?   rh   r   r   rd   rI   Ú
ValueErrorÚOverflowError)rZ   r>   Úextrar”   rµ   Ú_objÚ	exceptionr[   r[   r\   r·   ¾  s6    

üÿþzPdfReader.read_object_header)rµ   r”   rA   c              
   C   sF   z| j  ||f¡W S  ty@ } ztdƒ|‚W Y d }~n
d }~0 0 d S )Nz Maximum recursion depth reached.)rC   rl   ÚRecursionErrorr&   )rZ   rµ   r”   rÈ   r[   r[   r\   r¬   â  s    z#PdfReader.cache_get_indirect_object)rµ   r”   r…   rA   c                 C   sj   ||f| j v rBd}||dœ}| jr.t|| ƒ‚t|fdti|¤Ž || j ||f< |d urft||| ƒ|_|S )Nz.Overwriting cache for %(generation)d %(idnum)d)rµ   r”   ra   )rC   r?   r&   r   rd   r.   r‚   )rZ   rµ   r”   r…   ÚmsgÚvaluesr[   r[   r\   r­   ê  s    
zPdfReader.cache_indirect_object)r‚   r…   rA   c                 C   sH   |j | krtdƒ‚|j|jf| jvr,tdƒ‚|| j|j|jf< ||_|S )Nz,Cannot update PdfReader with external objectzCannot find referenced object)ZpdfrÄ   rµ   r”   rC   r‚   )rZ   r‚   r…   r[   r[   r\   Ú_replace_objectø  s    
zPdfReader._replace_objectc                 C   sþ  |   |¡ |  |¡ |  |¡}|dk r8tdt|d� d}|| _|  ||¡}|dkrr| jrd|rdtdƒ‚tdt|d� |  	|||¡ | j
�rR| j�sR| ¡ }| j ¡ D ]¢\}}|dkr´q¢t| ¡ ƒ}|D ]~}| || d¡ z|  |¡\}	}
W n$ t�y   |  |¡ Y  q¢Y n0 |	|| j
 krÄ| j| | | j| |	< | j| |= qÄq¢| |d¡ | j�sú| ¡ }| j ¡ D ]€\}}|dk�r‚�qlt| ¡ ƒ}|D ]V}| || d¡ z|  |¡ W n0 t�yä   tdt|||| d	� ||= Y n0 �q’�ql| |d¡ d
S )z†
        Read and process the PDF stream, extracting necessary data.

        Args:
            stream: The PDF file stream.

        r   z@Negative startxref pointer (%(startxref)d), treating it as zero.©ra   Ú	startxrefzBroken xref tablez.incorrect startxref pointer(%(xref_issue_nr)d))ra   Úxref_issue_nréÿÿ  zAIgnoring wrong pointing object %(id)d %(gen)d (offset %(offset)d))ra   ÚidÚgenr£   N)Ú_basic_validationÚ_find_eof_markerÚ_find_startxref_posr   rd   rD   Ú_get_xref_issuesr?   r&   Ú_read_xref_tables_and_trailersrE   rŽ   r:   ÚitemsÚsortedÚkeysr�   r·   rÄ   Ú_rebuild_xref_tableÚlist)rZ   r>   rÎ   rÏ   r‘   rÒ   Z
xref_entryZxref_kZxref_idÚpidZ_pgenÚidsr[   r[   r\   rh     sx    


ý
ýÿ

ûzPdfReader.readc              
   C   s    |  dtj¡ z| d¡}W n. tyJ } ztdƒ|‚W Y d}~n
d}~0 0 |dkr\tdƒ‚|dkrŽ| jr€td| 	d	¡› d
�ƒ‚t
dt|d� |  dtj¡ dS )z)Ensure the stream is valid and not empty.r   é   zcannot read headerNrj   zCannot read an empty files   %PDF-zPDF starts with 'Úutf8z', but '%PDF-' expectedz#invalid pdf header: %(header_byte)r)ra   Úheader_byte)r�   ÚosÚSEEK_SETrh   ÚUnicodeDecodeErrorr   r#   r?   r&   r�   r   rd   ÚSEEK_END)rZ   r>   rá   rÈ   r[   r[   r\   rÓ   U  s     ÿzPdfReader._basic_validationc                    sî   d}d‰ d}|  ¡ }ˆ  d¡}|dkr(qê|dkrj|rjˆ d|…  t¡rêtdtd� | |tˆ ƒ | ¡ qêˆ dkrž|ržt‡ fd	d
„dD ƒƒrštdtd� qêd}dˆ v r²tdtd� |  ¡ |k rØ| j	rÌt
dƒ‚tdtd� |  ¡ }t|ƒ‰ qdS )aŽ  
        Jump to the %%EOF marker.

        According to the specs, the %%EOF marker should be at the very end of
        the file. Hence for standard-compliant PDF documents this function will
        read only the last part (DEFAULT_BUFFER_SIZE).

        Producers that omit the line break before the marker (``startxref
        256%%EOF`` or ``256%%EOF``) are accepted as well (#4127).
        rŒ   rj   Tó   %%EOFr   NzEOF marker not at start of liner`   c                 3   s   | ]}ˆ   ¡  |¡V  qd S rt   )ÚstripÚendswith)r•   Útr©Úliner[   r\   Ú	<genexpr>‰  s   z-PdfReader._find_eof_marker.<locals>.<genexpr>)s   %%EOs   %%Es   %%ó   %zEOF marker seems truncatedFó	   startxrefzpCAUTION: startxref found while searching for %%EOF. The file might be truncated and some data might not be read.zEOF marker not found)rŽ   ÚfindÚlstripr   r   rd   r�   ÚlenÚanyr?   r&   r   )rZ   r>   Úheader_sizerž   Zend_positionZmarker_indexr[   rê   r\   rÔ   g  sB    
þÿýzPdfReader._find_eof_markerc              
   C   sü   t |ƒ}d}| d¡r@| ¡ dkr@|| jkr.q@t |ƒ}|d7 }q|rPtdtd� zt|ƒ}W np tyÌ } zX| d¡s€tdƒ|‚|dd	…  	¡ }|  
|¡s¤tdƒ|‚t|ƒ}td
td� W Y d	}~n4d	}~0 0 t |ƒ}| d¡sø| jrîtdƒ‚|  |¡}|S )z›
        Find startxref entry - the location of the xref table.

        Args:
            stream:

        Returns:
            The bytes offset

        r   ræ   r   z.Duplicate %%EOF marker(s) found, skipping themr`   rî   ústartxref not foundé	   Nz startxref on same line as offset)r   Ú
startswithrŽ   Ú_MAX_STARTXREF_RECOVERY_LINESr   rd   rI   rÄ   r&   rç   Ú_is_valid_startxref_valuer?   Ú_find_previous_startxref_pos)rZ   r>   rë   Zduplicate_markersrÎ   rÈ   Úvaluer[   r[   r\   rÕ   ž  s6    

ÿ



"

zPdfReader._find_startxref_posiè  )rú   rA   c                 C   sJ   t  d| ¡d u rdS ttddd„ ƒƒ }|  d¡ dd¡}| pHt|ƒ|kS )	Ns   [+-]?[0-9]+(?:_[0-9]+)*FZget_int_max_str_digitsc                   S   s   dS )Nr   r[   r[   r[   r[   r\   Ú<lambda>Þ  rj   z5PdfReader._is_valid_startxref_value.<locals>.<lambda>s   +-ó   _rj   )r¸   Ú	fullmatchÚgetattrrJ   rð   Úreplacerñ   )rú   Z
max_digitsÚdigitsr[   r[   r\   rø   Ù  s
    z#PdfReader._is_valid_startxref_valuec              	   C   s¼   d}t | jƒD ] }| ¡ dkr" q°t|ƒ}| d¡sZzt|ƒ}W q tyV   d}Y q0 qt|ƒdkrŽ|dd…  ¡ }|  	|¡s‚qt|ƒ  S |durªt
dtd� |  S  q°qtdƒ‚dS )aÊ  
        Recover the most recent intact ``startxref`` pointer by scanning
        backwards from the current position.

        This is used as a fallback when the ``startxref`` keyword belonging to
        the final ``%%EOF`` is corrupt (#3238). The offset always appears on
        the line directly below the keyword, so the value read immediately
        before encountering ``startxref`` (while moving backwards) is returned.
        At most ``_MAX_STARTXREF_RECOVERY_LINES`` lines are inspected.

        Args:
            stream: The PDF byte stream, positioned just above the corrupt
                trailing pointer.

        Returns:
            The bytes offset of the recovered ``startxref``.

        Nr   rî   rõ   zCfound startxref pointing to a previous revision after a corrupt oner`   rô   )r   r÷   rŽ   r   rö   rI   rÄ   rñ   rç   rø   r   rd   r&   )Úclsr>   r£   Ú_rë   rú   r[   r[   r\   rù   â  s0    


ýz&PdfReader._find_previous_startxref_pos)ÚdatarA   c                 C   s4   i }|   |¡D ] \}}}||v r"q||f||< q|S rt   )Ú_find_pdf_objects)rZ   r  ÚcacheÚobject_numberÚgeneration_numberÚobject_startr[   r[   r\   Ú_load_recovery_cache  s    zPdfReader._load_recovery_cachec                 C   sj   t tt|| ƒƒ}t|tƒs<tdtd� |  |¡ | ¡  d S t|ƒd }||krft	d|› d|› d�ƒ‚|S )Nz,Invalid/Truncated xref table. Rebuilding it.r`   é   zDeclared size z exceeds allowed limit of ú!)
r   rI   r6   rH   r   rd   rÛ   rh   r   r%   )rZ   r>   ÚsizeZ
size_limitr[   r[   r\   Ú&_read_standard_xref_table__handle_size  s    
þ
z0PdfReader._read_standard_xref_table__handle_sizec                 C   sv  |  d¡}|dkrtdƒ‚t|ƒ | dd¡ d}d }d }ttt|| ƒƒ}|rn|dkrn|| _| jrnt	dt
d	� d
}t|ƒ | dd¡ |  |¡}|d u rœd S t|ƒ | dd¡ d}||k �rÆ|  d¡}	|	sÔtdƒ‚|	d dv �r| dd¡ |  d¡}	t|	ƒdkrÔtdƒ‚qÔ|	d dv �r(| dd¡ z8|	d d…  d¡\}
}|	dd… }t|
ƒt|ƒ }}W nˆ t�yv   ‚ Y nt t�yè   |d u �r t|ƒ}|  |¡}||v�rÆt	dt
|d� d}d}d}nt	dt
|d� || \}}d}Y n0 || jv�r
i | j|< i | j|< || j| v �rn˜|dk�r4|| j| |< z|dk| j| |< W n( t�y`   ‚ Y n t�yr   Y n0 z|dk| jd |< W n( t�y    ‚ Y n t�y²   Y n0 |d7 }|d7 }q´t|ƒ | dd¡ |  d¡dk�r| dd¡ t|ƒ t|ƒ | dd¡ �qÚ| dd¡ |  d¡}|dk�r:�qr| dd¡ | ¡ }||k�rltd|› d |›�ƒ‚|}q:d S )!Nr   s   refzxref table read errorr¡   r   Tr   zFXref table not zero-indexed. ID numbers for objects will be corrected.r`   Fr
  z$Unexpected empty line in Xref table.ó   
iíÿÿÿzUnexpected EOF in Xref table.s   0123456789té   ó    é   é   z5entry %(num)d in Xref table invalid; object not found)ra   ÚnumrÐ   ó   fz4entry %(num)d in Xref table invalid but object foundó   nrí   é   ó   traileriùÿÿÿzXref parsing stuck at position z: )rh   r&   r   r�   r   rI   r6   rE   r?   r   rd   r  rñ   Úsplitr€   r�   r   r	  r:   rF   r    rŽ   )rZ   r>   ÚrefZ
first_timeZrecovery_cacheZprevious_positionr  r  Zcntrë   Zoffset_bZgeneration_bZentry_type_br£   rµ   rÀ   Ztrailer_tagZrewound_positionr[   r[   r\   Ú_read_standard_xref_table*  sÊ    
þ







ýý







ÿz#PdfReader._read_standard_xref_table)r>   rÎ   rÏ   rA   c              
   C   sŒ  i | _ i | _i | _d| _tƒ | _tƒ }|du�rˆ||v rJtdt|d� �qˆ| 	|¡ | 
|d¡ | d¡}|dv r|| d¡}|dkr�|  |¡}q&|rÔz|  |¡ W �qˆW n( ty¼   ‚ Y n tyÐ   d}Y n0 q&| ¡ �rzz|  |¡}W nb t�yN } zHtj| jv �r*tdt|jd	� W Y d}~�qˆtd
|›�ƒ|‚W Y d}~n
d}~0 0 |  |¡ d|v �rˆtt|d ƒ}n�qˆq&|  ||¡}q&dS )z?Read the cross-reference tables and trailers in the PDF stream.r   Nz>Circular xref chain detected at offset %(startxref)d, stoppingrÍ   r   r  ó   xz)Previous trailer cannot be read: %(args)s)ra   ÚargszTrailer cannot be read: ú/Prev)r:   rF   rG   rN   r,   r;   rR   r   rd   r»   r�   rh   Ú
_read_xrefrÛ   r€   r�   ÚisdigitÚ_read_pdf15_xref_streamrm   r~   r  r&   Ú_process_xref_streamr   rI   Ú_read_xref_other_error)rZ   r>   rÎ   rÏ   Zvisited_xref_offsetsr–   Ú
xrefstreamrÈ   r[   r[   r\   r×   ´  s\    
ý





ý&

z(PdfReader._read_xref_tables_and_trailers)r#  rA   c                 C   s~   | j D ]*}||v r|| jvr| |¡| jt|ƒ< qd|v rz| j ¡ }| j tt|d ƒd d¡ |  	| j¡ | j |d¡ dS )z#Process and handle the xref stream.ú/XRefStmr   r   N)
Ú_XREF_STREAM_TRAILER_KEYSr;   Úraw_getr/   r>   rŽ   r�   r   rI   r   )rZ   r#  r¿   Úpr[   r[   r\   r!  ï  s    

zPdfReader._process_xref_streamc              	   C   s  |   |¡ | d¡dkrd S | dd¡ t|ƒ | dd¡ ttttf t|| ƒƒ}| 	¡ D ]\}}|| j
vr\|| j
|< q\d|v rú| ¡ }| tt|d ƒd d¡ z|  |¡ W n: tyÆ   ‚ Y n( tyì   tdtt|d ƒd� Y n0 | |d¡ d|v �rtt|d ƒS d S )	Nr   rj   r¡   r$  r   zGXRef object at %(xref_stm)d can not be read, some object may be missing)ra   Zxref_stmr  )r  rh   r�   r   r   Údictrf   r	   r6   rØ   r;   rŽ   rI   r   r€   r�   r   rd   )rZ   r>   Únew_trailerr¿   rú   r'  r[   r[   r\   r  ú  s6    


ý
zPdfReader._read_xref)r>   rÎ   rA   c              
   C   s   |dkr&| j rtdƒ‚tdtd� d S | dd¡ | d¡}| d¡}|d	kr^|d
| 8 }|S | |d¡ tdƒD ]"}| d¡ ¡ rr||7 }|  S qrd| j	v rô| j sôtdtd� z|  
|¡ W n. tyî } ztdƒ|‚W Y d }~n
d }~0 0 d S tdƒ‚d S )Nr   z6/Prev=0 in the trailer (try opening with strict=False)zA/Prev=0 in the trailer - assuming there is no previous xref tabler`   iõÿÿÿr   r
  ó   xrefr¡   é
   é   z/Rootz"Invalid parent xref., rebuild xrefzCannot rebuild xrefz/Could not find xref table at specified location)r?   r&   r   rd   r�   rh   rï   r   r  r;   rÛ   r�   )rZ   r>   rÎ   ÚtmpZxref_locZlookrÈ   r[   r[   r\   r"    s:    ÿþ


 z PdfReader._read_xref_other_error)Úindex_pairsÚentry_sizesÚxref_streamrA   c                    s(  t ‡ fdd„tttˆ ƒdƒƒD ƒƒ}|dkrNd}| jr>t|ƒ‚t|td� g S t| ¡ ƒ| d }g }d}t	|ƒD ]°\}	}
t
|
ƒ}|	d dk�r|dk rÀ| jr®td	|› d
�ƒ‚tdt|d� d}|| |k�r| jrîtd|| › d|› d
�ƒ‚td|| ƒ}tdt||d� |}||7 }| |¡ qr|S )Nc                 3   s   | ]}t ˆ | ƒV  qd S rt   )rI   )r•   r„   ©r/  r[   r\   rì   E  rj   zDPdfReader._sanitize_pdf15_xref_stream_index_pairs.<locals>.<genexpr>r   r   z-Cross-reference stream encodes no entry data.r`   r   é   zNegative XRef count rœ   z'Negative XRef count %(count)d, using 0.)ra   ÚcountzTotal XRef entries z exceed maximum allowed value zKClamping XRef count from %(old_count)d to %(new_count)d to fit stream size.)ra   Z	old_countZ	new_count)Úsumr   Úminrñ   r?   r'   r   rd   rª   r˜   rI   r%   Úmaxr©   )rZ   r.  r/  r0  Zmin_entry_bytesÚmessageZmax_entriesÚresultÚtotalr¤   Z
pair_valueZpair_value_intZnew_vr[   r1  r\   Ú'_sanitize_pdf15_xref_stream_index_pairs@  sL    $ýÿüz1PdfReader._sanitize_pdf15_xref_stream_index_pairsc                    sŠ  |  dd¡ ˆ |¡\}}ttt|ˆƒƒ}tt|d ƒdkrNtd|d ›�ƒ‚ˆ |||¡ d|vrttd|›d�ƒ‚| d	d
|d g¡}tt	t
 | d¡ƒ‰ tˆ ƒdks¬J ‚ˆjrÌtˆ ƒdkrÌtdˆ › �ƒ‚ˆj|ˆ |d�}ˆ jt|ddd… ƒ7  _ˆjˆjk�r tdˆj› dˆj› d�ƒ‚t| ¡ ƒ‰t
tt
tt
df f dœ‡ ‡fdd„}t
tt
tt
df f tdœ‡fdd„}ˆ |||¡ |S )z-Read the cross-reference stream for PDF 1.5+.r¡   r   r|   ú/XRefzUnexpected type r}   zSize missing from XRef stream r  z/Indexr   z/Wr   zToo many entry sizes: )r.  r/  r0  Nr2  z)Maximum XRef stream entry limit reached: z > rœ   .)r„   rA   c                    s8   ˆ |  dkr(ˆ  ˆ |  ¡}t|ˆ |  ƒS | dkr4dS dS )Nr   r   )rh   r   )r„   Úd)r/  r°   r[   r\   Ú	get_entry˜  s    z4PdfReader._read_pdf15_xref_stream.<locals>.get_entry)r  rµ   rA   c                    s   | ˆ j  |g ¡v p| ˆ jv S rt   )r:   rl   rG   )r  rµ   ru   r[   r\   Úused_before¥  s    z6PdfReader._read_pdf15_xref_stream.<locals>.used_before)r�   r·   r   r3   r6   rf   r&   r­   rl   rÜ   rI   rñ   r?   r:  rN   r4  rM   r%   r   rª   r   ÚtupleÚboolÚ_read_xref_subsections)rZ   r>   Zstream_idnumZstream_generationr0  r.  r=  r>  r[   )r/  rZ   r°   r\   r   w  s<    ÿÿÿÿ&&z!PdfReader._read_pdf15_xref_streamc                 C   sœ   |dkrdS |   |d d¡ |  d¡}|dkr8|  d¡}|dvrDdS |  d¡}|dkr˜d}|dv rz|  d¡}|dkrZd	S qZ||  d	¡7 }| ¡ d
kr˜dS dS )zç
        Return an int which indicates an issue. 0 means there is no issue.

        Args:
            stream:
            startxref:

        Returns:
            0 means no issue, other values represent specific issues.

        r   é   r   ó   js   
 	r*  rj   s   0123456789 	r2  s   objr   )r�   rh   Úlower)r>   rÎ   rë   r[   r[   r\   rÖ   ­  s&    



zPdfReader._get_xref_issuesc                 c   s:  d}t dƒ}t dƒ}| d|¡}|dkr,d S |d }|dkrR|| tv rR|d8 }q4|d }|dkrˆ|||   krz|krˆn n
|d8 }qZ|d }|dkr®|| tv r®|d8 }q�|d }|dkrä|||   krÖ|krän n
|d8 }q¶|d }	|	|k �r,||k �r,t||	|… ƒ}
t|||… ƒ}|
||	fV  |d7 }qd S )Nr   Ú0Ú9s    objr¡   r   rB  )Úordrï   r   rI   )r  r  r¤   Zord_0Zord_9Zindex_before_spaceZgeneration_endZgeneration_startZ
object_endr  r  r  r[   r[   r\   r  Ð  s0    
$

$
zPdfReader._find_pdf_objectsc                 c   s~   d}t |ƒ}| d|¡}|dkr$d S |d }||k rJ|| tv rJ|d7 }q,|d |k rp|||d … dkrp|V  |d7 }qd S )Nr   r  r¡   r  r   r2  s   <<)rñ   rï   r   )r  r  r¤   Zdata_lengthZindex_after_trailerr[   r[   r\   Ú_find_pdf_trailersù  s    
 zPdfReader._find_pdf_trailersc              
   C   sª  i | _ | dd¡ | d¡}|  |¡D ],\}}}|| j vrDi | j |< || j | |< q&tdtd� g }| j D �]ª}| j | D �]˜}| j | | }| |d¡ �z:|  |¡}ttt	|| ƒƒ}| 
dd¡}	|	dk�rtƒ }
| jD ]}||v rÚ| |¡|
t|ƒ< qÚ| ||
f¡ W qz|	dk�rW qzt| ¡ ƒ}d}t|tj| jd	�}| ¡ �sJ�q¨t|ƒ}t|ƒ | dd
¡ t|tj| jd	�}| ¡ �s†�q¨t|ƒ}||f| j|< |d
7 }�q*tt|d ƒ}||k�rÔtdt||||d� W qz t�yì   ‚ Y qz t�y    ‚ Y qz t�y   Y qz0 qzqj| dd¡ t|ƒ}|  |¡D ]4}| |d¡ | |ttt t f t	|| ƒƒf¡ �q6t!|t"dƒd�D ](\}}| #¡ D ]\}}|| j$|< �qŒ�q|d S )Nr   r¡   zparsing for Object Streamsr`   r|   Ú r;  rš   rÂ   r   r›   zsfound %(actual_count)d objects within Object(%(object_number)d,%(generation_number)d) whereas %(expected)d expected)ra   Úactual_countr  r  Úexpected)r¿   )%r:   r�   rh   r  r   rd   r·   r   r3   r6   rl   r,   r%  r&  r/   r©   r   rª   r   r.   rÃ   r?   r  rI   r!   rG   r%   r€   r�   rÜ   rH  r(  r	   rÙ   r   rØ   r;   )rZ   r>   r°   r  r  r  Zxref_stream_trailersr  r…   Zobject_typer;   r¿   Zobject_streamrJ  ÚcurrentZinner_object_numberZinner_offsetZexpected_countZtrailersÚpositionr)  rú   r[   r[   r\   rÛ     sˆ    







ÿ

ÿ

ö

&zPdfReader._rebuild_xref_table.)Ú	idx_pairsr=  r>  rA   c                 C   sÞ   |   |¡D ]Î\}}t||| ƒD ]¶}|dƒ}|dkrF|dƒ}|dƒ}	q |dkrŒ|dƒ}
|dƒ}|| jvrri | j|< |||ƒsÖ|
| j| |< q |dkrÂ|dƒ}|dƒ}d}|||ƒsÖ||f| j|< q | jr td|› �ƒ‚q q
dS )z-Read and process the subsections of the xref.r   r   r2  zUnknown xref type: N)Ú_pairsr   r:   rG   r?   r&   )rZ   rN  r=  r>  r®   r  r  Z	xref_typeZnext_free_objectZnext_generationZbyte_offsetrµ   Z
objstr_numZ	obstr_idxr[   r[   r\   rA  c  s*    




z PdfReader._read_xref_subsections)ÚarrayrA   c                 c   s8   d}|d t |ƒk r4|| ||d  fV  |d7 }qdS )z Iterate over pairs in the array.r   r   r2  N)rñ   )rZ   rP  r„   r[   r[   r\   rO  †  s    zPdfReader._pairsc                 C   s    | j stdƒ‚| j j|| jd�S )aÞ  
        When using an encrypted / secured PDF file with the PDF Standard
        encryption handler, this function will allow the file to be decrypted.
        It checks the given password against the document's user password and
        owner password, and then stores the resulting decryption key if either
        password is correct.

        It does not matter which password was matched. Both passwords provide
        the correct decryption key that will allow the document to be used with
        this library.

        Args:
            password: The password to match.

        Returns:
            An indicator if the document was decrypted and whether it was the
            owner password or the user password.

        zNot encrypted filerk   )rU   r&   rr   r?   )rZ   r@   r[   r[   r\   Údecrypt�  s    zPdfReader.decryptc                 C   s   t j| jv S )zè
        Read-only boolean property showing whether this PDF file is encrypted.

        Note that this property, if true, will remain true even after the
        :meth:`decrypt()<pypdf.PdfReader.decrypt>` method is called.
        )rm   rq   r;   ru   r[   r[   r\   rV   ¦  s    zPdfReader.is_encrypted)ÚnamerA   c           	      C   s8  | j }d|vst|d tƒs dS tt|tdƒ ƒ}d|vr>dS tƒ }t|ƒ|tdƒ< |tdƒ |tdƒ< ttt| j 	dd¡ƒd td	d
„ | j
 ¡ D ƒdd�t| jdd�tdd
„ | jD ƒdd�ƒd }|  d||¡ tƒ }| |j¡ ||tdƒ< tt|d ƒD ]4}| ¡ }d|v �r$tdt|jd� |j|tdƒ< qþ|S )zþ
        Add a top level form that groups all form fields below it.

        Args:
            name: text string of the "/T" Attribute of the created object

        Returns:
            The created object. ``None`` means no object was created.

        ú	/AcroFormNú/Fieldsú/Tz/Kidsr}   r   r   c                 s   s   | ]}|D ]
}|V  q
qd S rt   r[   )r•   Úentriesr„   r[   r[   r\   rì   Ì  rj   z-PdfReader.add_form_topname.<locals>.<genexpr>)Údefaultc                 s   s   | ]\}}|V  qd S rt   r[   )r•   r  r„   r[   r[   r\   rì   Î  rj   z/Parentz:Top Level Form Field %(obj_ref)s has a non-expected parent)ra   Zobj_ref)r†   rH   r,   r   r/   r4   r6  rI   r;   rl   r:   rË   rG   rC   r­   r)   r©   r‚   ro   r   rd   )	rZ   rR  ÚcatalogÚacroformÚinterimZ	object_idZarrÚor…   r[   r[   r\   Úadd_form_topname°  sB    
ÿüû
ýzPdfReader.add_form_topnamec                 C   sr   | j }d|vst|d tƒs dS tt|tdƒ ƒ}d|vr>dS tttt|tdƒ ƒd  ¡ ƒ}t|ƒ|tdƒ< |S )zü
        Rename top level form field that all form fields below it.

        Args:
            name: text string of the "/T" field of the created object

        Returns:
            The modified object. ``None`` means no object was modified.

        rS  NrT  r   rU  )r†   rH   r,   r   r/   r)   ro   r4   )rZ   rR  rX  rY  rZ  r[   r[   r\   Úrename_form_topnameß  s    
ÿþzPdfReader.rename_form_topname)ÚincludeÚexcluderA   c                    s^   | j  d¡ | j  ¡ }d|i}ˆdur<‡fdd„| ¡ D ƒ}ˆ durZ‡ fdd„| ¡ D ƒ}|S )zø
        Integration into Jupyter Notebooks.

        This method returns a dictionary that maps a mime-type to its
        representation.

        .. seealso::

            https://ipython.readthedocs.io/en/stable/config/integrating.html
        r   zapplication/pdfNc                    s   i | ]\}}|ˆ v r||“qS r[   r[   ©r•   ÚkÚv)r^  r[   r\   r—     rj   z/PdfReader._repr_mimebundle_.<locals>.<dictcomp>c                    s   i | ]\}}|ˆ vr||“qS r[   r[   r`  )r_  r[   r\   r—     rj   )r>   r�   rh   rØ   )rZ   r^  r_  Zpdf_datar  r[   )r_  r^  r\   Ú_repr_mimebundle_û  s    
ÿzPdfReader._repr_mimebundle_©Útreer¾   Úvisited)re  r¾   rf  rA   c                   s6   |s|rt ƒ j|||d�S | jdu r0t ƒ  ¡ | _| jS )zoOverride from PdfDocCommon. In the reader we can assume this is
        static, but not in the writer.
        rd  N)ÚsuperÚ_get_named_destinationsrX   )rZ   re  r¾   rf  ©Ú	__class__r[   r\   rh    s
    

z!PdfReader._get_named_destinations)FN)NN)[rd   Ú
__module__Ú__qualname__Ú__doc__r(  rI   r	   Ú__annotations__r,   r   r   r   r@  rf   Úbytesr   r]   rQ   rW   r   rv   ÚtypeÚBaseExceptionr   r{   rz   Úpropertyr†   rŠ   r)   r‹   r’   r7   r“   r0   r.   r™   r2   r³   ro   r   r?  r·   r¬   r­   rÌ   rh   rÓ   rÔ   rÕ   r÷   Ústaticmethodrø   Úclassmethodrù   r	  r  r  r×   rm   r~   rq   rˆ   rn   ZSIZEr%  r!  r  r"  rÜ   r3   r:  r   rÖ   r   r  rH  rÛ   r
   rA  rO  r   rQ  rV   r\  r]  rc  r+   rR   rh  Ú__classcell__r[   r[   ri  r\   r9   c   sä   
  üù
ø0
û2þþ '
þ %þ	
þ
S79. 	 
þ9þ*þ76" (Wû# 	/  ý
ü"û

úr9   )Jrâ   r¸   rJ   Úcollections.abcr   Úior   r   Úoperatorr   Úpathlibr   Útypesr   Útypingr   r	   r
   r   r   r   Úversion_infor   Ztyping_extensionsZ_configurationr   Z_doc_commonr   r   rU   r   r   Ú_utilsr   r   r   r   r   r   r   r   r   r    r!   Ú	constantsr"   rm   Úerrorsr#   r$   r%   r&   r'   r(   Zgenericr)   r*   r+   r,   r-   r.   r/   r0   r1   r2   r3   r4   r5   r6   Úxmpr7   Z_pager8   r9   r[   r[   r[   r\   Ú<module>   s,    	
4 @