a
    8öj1  ã                   @  s  d Z ddlmZ zddlZW n ey2   dZY n0 ddlZddlZddlZddlmZm	Z	 ddl
mZmZmZmZ ddlmZmZmZmZmZ ddlmZ ddlmZ dd	lmZ erèdd
lmZ ddlmZ ddlm Z  ddl!m"Z" dZ#G dd„ dƒZ$G dd„ dƒZ%dS )z2Pure-Python reader for the MaxMind DB file format.é    )ÚannotationsN)ÚIPv4AddressÚIPv6Address)ÚIOÚTYPE_CHECKINGÚAnyÚAnyStr)Ú	MODE_AUTOÚMODE_FDÚ	MODE_FILEÚMODE_MEMORYÚ	MODE_MMAP)ÚDecoder)ÚInvalidDatabaseError)Ú
FileBuffer)ÚIterator)ÚPathLike)ÚSelf)ÚRecordl        c                   @  s  e Zd ZU dZdZdZded< ded< ded	< d
ed< ded< ded< efddddœdd„Zddœdd„Z	dddœdd„Z
dddœdd„Zddœd d!„Zddddd"œd#d$„Zd%d&d'œd(d)„Zddd*œd+d,„Zdddd-œd.d/„Zdd0d1œd2d3„Zddœd4d5„Zddœd6d7„Zd8dœd9d:„Zd;S )<ÚReaderz…A pure Python implementation of a reader for the MaxMind DB format.

    IP addresses can be looked up using the ``get`` method.
    é   s   «ÍïMaxMind.comz bytes | FileBuffer | 'mmap.mmap'Ú_bufferÚintÚ_buffer_sizeÚboolÚclosedr   Ú_decoderÚMetadataÚ	_metadataÚ_ipv4_startzAnyStr | int | PathLike | IOÚNone)ÚdatabaseÚmodeÚreturnc                 C  s(  |t krts|tkrht|dƒ�4}tj| ¡ dtjd�| _| j ¡ | _W d  ƒ n1 sX0    Y  |}n´|t t	fv r�t
|ƒ| _| j ¡ | _|}nŒ|tkràt|dƒ�(}| ¡ }|| _t|ƒ| _W d  ƒ n1 sÐ0    Y  |}n<|tk�r| ¡ | _t| jƒ| _|j}nd|› d�}t|ƒ‚| j | jtd| jd ƒ¡}|dk�r^|  ¡  d	|› d
�}t|ƒ‚|t| jƒ7 }t| j|ƒ}| |¡\}	}
t|	tƒ�s¦d|› d�}t|ƒ‚tf i |	¤Ž| _t| j| jj| j ƒ| _d| _d}| jj dk�rd}t!dƒD ]&}
|| jj"k�r
 �q|  #|d¡}�qò|}|| _$dS )a¼  Reader for the MaxMind DB file format.

        Arguments:
            database: A path to a valid MaxMind DB file such as a GeoIP2 database
                      file, or a file descriptor in the case of MODE_FD.
            mode: mode to open the database with. Valid mode are:
                  * MODE_MMAP - read from memory map.
                  * MODE_FILE - read database as standard file.
                  * MODE_MEMORY - load database into memory.
                  * MODE_AUTO - tries MODE_MMAP and then MODE_FILE. Default.
                  * MODE_FD - the param passed via database is a file descriptor, not
                              a path. This mode implies MODE_MEMORY.

        Úrbr   )ÚaccessNzUnsupported open mode (z]). Only MODE_AUTO, MODE_FILE, MODE_MEMORY and MODE_FD are supported by the pure Python Readeri   éÿÿÿÿzError opening database file (z#). Is this a valid MaxMind DB file?z)Error reading metadata in database file (z).Fé   é`   )%r	   Úmmapr   ÚopenÚfilenoÚACCESS_READr   Úsizer   r   r   r   ÚreadÚlenr
   ÚnameÚ
ValueErrorÚrfindÚ_METADATA_START_MARKERÚmaxÚcloser   r   ÚdecodeÚ
isinstanceÚdictr   r   Úsearch_tree_sizeÚ_DATA_SECTION_SEPARATOR_SIZEr   r   Ú
ip_versionÚrangeÚ
node_countÚ
_read_noder   )Úselfr!   r"   Zdb_fileÚfilenameÚbufÚmsgZmetadata_startZmetadata_decoderÚmetadataÚ_Z
ipv4_startÚnode© rF   úO/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/maxminddb/reader.pyÚ__init__0   st    *
(


ÿÿþ

ÿÿÿþzReader.__init__©r#   c                 C  s   | j S )z8Return the metadata associated with the MaxMind DB file.)r   ©r?   rF   rF   rG   rC   �   s    zReader.metadatazstr | IPv6Address | IPv4AddresszRecord | None)Ú
ip_addressr#   c                 C  s   |   |¡\}}|S )z›Return the record for the ip_address in the MaxMind DB.

        Arguments:
            ip_address: an IP address in the standard string notation

        )Úget_with_prefix_len)r?   rK   ÚrecordrD   rF   rF   rG   Úget“   s    z
Reader.getztuple[Record | None, int]c              
   C  s®   t |tƒrt |¡}n|}zt|jƒ}W n2 tyZ } zd}t|ƒ|‚W Y d}~n
d}~0 0 |jdkr†| j	j
dkr†d|› d�}t|ƒ‚|  |¡\}}|r¦|  |¡|fS d|fS )z¤Return a tuple with the record and the associated prefix length.

        Arguments:
            ip_address: an IP address in the standard string notation

        z/argument 1 must be a string or ipaddress objectNr'   é   zError looking up zD. You attempted to look up an IPv6 address in an IPv4-only database.)r7   ÚstrÚ	ipaddressrK   Ú	bytearrayÚpackedÚAttributeErrorÚ	TypeErrorÚversionr   r;   r1   Ú_find_address_in_treeÚ_resolve_data_pointer)r?   rK   ÚaddressZpacked_addressÚexrB   ÚpointerÚ
prefix_lenrF   rF   rG   rL   �   s$    

 
ÿÿzReader.get_with_prefix_lenr   c                 C  s   |   ddd¡S )Nr   )Ú_generate_childrenrJ   rF   rF   rG   Ú__iter__Á   s    zReader.__iter__)rE   ÚdepthÚip_accr#   c                 c  sÚ   |dkr|| j krd S | jj}||krz| jjdkr6dnd}||| K }|tkr^|dkr^|d8 }t ||f¡|  |¡fV  n\||k rÖ|  |d¡}|dK }|d7 }|  	|||¡E d H  |  |d¡}|  	|||dB ¡E d H  d S )Nr   r'   é€   é    r(   é   )
r   r   r=   r;   Ú_IPV4_MAX_NUMrQ   Ú
ip_networkrX   r>   r]   )r?   rE   r_   r`   r=   ÚbitsÚleftÚrightrF   rF   rG   r]   Ä   s(    ÿþzReader._generate_childrenrR   ztuple[int, int])rS   r#   c                 C  s”   t |ƒd }|  |¡}| jj}d}||k rd||k rdd||d?  d|d  ? @ }|  ||¡}|d }q"||krtd|fS ||kr„||fS d}t|ƒ‚d S )Né   r   rc   é   é   zInvalid node in search tree)r/   Ú_start_noder   r=   r>   r   )r?   rS   Z	bit_countrE   r=   ÚiÚbitrB   rF   rF   rG   rW   Ý   s    

zReader._find_address_in_tree)Úlengthr#   c                 C  s   | j jdkr|dkr| jS dS )Nr'   rb   r   )r   r;   r   )r?   ro   rF   rF   rG   rl   ñ   s    zReader._start_node)Únode_numberÚindexr#   c           	      C  sè   || j j }| j j}|dkr@||d  }d| j||d …  }n˜|dkrž|d|  }t| j||d … ƒ}|r€d|d @ |d< qØd| ¡ @ d? }| d|¡ n:|d	krÆ||d  }| j||d … }nd
|› �}t|ƒ‚t 	d|¡d S )Né   rj   ó    é   rO   é   r   éð   rb   zUnknown record size: s   !I)
r   Únode_byte_sizeÚrecord_sizer   rR   ÚpopÚinsertr   ÚstructÚunpack)	r?   rp   rq   Zbase_offsetrx   ÚoffsetZ
node_bytesÚmiddlerB   rF   rF   rG   r>   ö   s$    
zReader._read_noder   )r[   r#   c                 C  s>   || j j | j j }|| jkr*d}t|ƒ‚| j |¡\}}|S )Nz,The MaxMind DB file's search tree is corrupt)r   r=   r9   r   r   r   r6   )r?   r[   ZresolvedrB   ÚdatarD   rF   rF   rG   rX     s    
zReader._resolve_data_pointerc                 C  s>   t  t¡� | j ¡  W d  ƒ n1 s*0    Y  d| _dS )zBClose the MaxMind DB file and returns the resources to the system.NT)Ú
contextlibÚsuppressrT   r   r5   r   rJ   rF   rF   rG   r5     s    (zReader.closec                 G  s   |   ¡  d S )N)r5   )r?   rD   rF   rF   rG   Ú__exit__  s    zReader.__exit__r   c                 C  s   | j rd}t|ƒ‚| S )Nz%Attempt to reopen a closed MaxMind DB)r   r1   )r?   rB   rF   rF   rG   Ú	__enter__!  s    zReader.__enter__N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r:   r3   Ú__annotations__r	   rH   rC   rN   rL   r^   r]   rW   rl   r>   rX   r5   r‚   rƒ   rF   rF   rF   rG   r       s.   
ý_
$
r   c                   @  sš   e Zd ZU dZded< ded< ded< ded< ded	< ded
< ded< ded< ded< ddœdd„Zeddœdd„ƒZeddœdd„ƒZddœdd„Z	dS )r   z#Metadata for the MaxMind DB reader.r   Úbinary_format_major_versionÚbinary_format_minor_versionÚbuild_epochrP   Údatabase_typezdict[str, str]Údescriptionr;   z	list[str]Ú	languagesr=   rx   r    rI   c                 K  s^   |d | _ |d | _|d | _|d | _|d | _|d | _|d | _|d | _|d	 | _d
S )zACreate new Metadata object. kwargs are key/value pairs from spec.r=   rx   r;   rŒ   rŽ   r‰   rŠ   r‹   r�   N)	r=   rx   r;   rŒ   rŽ   r‰   rŠ   r‹   r�   )r?   ÚkwargsrF   rF   rG   rH   \  s    







zMetadata.__init__c                 C  s
   | j d S )z9The size of a node in bytes.

        :type: int
        rO   )rx   rJ   rF   rF   rG   rw   j  s    zMetadata.node_byte_sizec                 C  s   | j | j S )z9The size of the search tree.

        :type: int
        )r=   rw   rJ   rF   rF   rG   r9   r  s    zMetadata.search_tree_sizec                 C  s6   d  dd„ | j ¡ D ƒ¡}| j› d| jj› d|› d�S )Nz, c                 s  s    | ]\}}|› d |›�V  qdS )ú=NrF   )Ú.0ÚkÚvrF   rF   rG   Ú	<genexpr>{  ó    z$Metadata.__repr__.<locals>.<genexpr>Ú.ú(ú))ÚjoinÚ__dict__Úitemsr…   Ú	__class__r„   )r?   ÚargsrF   rF   rG   Ú__repr__z  s    zMetadata.__repr__N)
r„   r…   r†   r‡   rˆ   rH   Úpropertyrw   r9   rž   rF   rF   rF   rG   r   (  s    
r   )&r‡   Ú
__future__r   r)   ÚImportErrorr€   rQ   r{   r   r   Útypingr   r   r   r   Zmaxminddb.constr	   r
   r   r   r   Zmaxminddb.decoderr   Zmaxminddb.errorsr   Zmaxminddb.filer   Úcollections.abcr   Úosr   Ztyping_extensionsr   Zmaxminddb.typesr   rd   r   r   rF   rF   rF   rG   Ú<module>   s0   
  
