uL d Z ddlZn
# e$ r dZY nw xY wddlZddlZddlmZmZ ddlmZ ddl m
Z
m Z m Z m
Z
mZmZ ddlmZmZmZmZmZ ddlmZ ddlmZ dd lmZ dd
l m Z G d d Z G d
d Z dS )zo
maxminddb.reader
~~~~~~~~~~~~~~~~
This module contains the pure Python database reader and related classes.
N) IPv4Address IPv6Address)PathLike)AnyAnyStrIOOptionalTupleUnion) MODE_AUTO MODE_MMAP MODE_FILE MODE_MEMORYMODE_FD)Decoder)InvalidDatabaseError)
FileBuffer)Recordc ^ e Zd ZU dZdZdZeeedf e d< dZ
e e e d< e
fdeee eef d e d
dfd Zd d
Zdeeeef d
e e fdZdeeeef d
ee e e f fdZded
ee e f fdZde d
e fdZ de de d
e fdZ de d
efdZ d dZ d dZ d d Z!dS ) Readerz
Instances of this class provide a reader for the MaxMind DB format. IP
addresses can be looked up using the ``get`` method.
s MaxMind.comz mmap.mmap_bufferN _ipv4_startdatabasemodereturnc n |t k rt s |t k rt |d 5 }t j | dt j | _ | j | _ ddd n # 1 swxY w Y |}n|t t fv r5t | | _ | j | _ |}n|t k rZt |d 5 }| }|| _ t | | _ ddd n # 1 swxY w Y |}nX|t k r:| | _ t | j | _ |j }nt! d| d | j | j t' d| j dz
}|dk r'| t+ d | d
|t | j z
}t- | j | }| | \ }} t1 |t2 st+ d | d t5 di || _ t- | j | j j | j z | _ d
| _ dS )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 )accessNzUnsupported 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
openfileno ACCESS_READr size _buffer_sizer r r readlenr name
ValueErrorrfind_METADATA_START_MARKERmaxcloser r decode
isinstancedictMetadata _metadatasearch_tree_size _DATA_SECTION_SEPARATOR_SIZE_decoderclosed)
selfr r db_filefilenamebufmetadata_startmetadata_decodermetadata_s
p/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/maxminddb/reader.py__init__zReader.__init__' s$ "
I $ 49+<+<h%%
8 #y )9)91TEU V V V $(L$5$5$7$7!
8
8
8
8
8
8
8
8
8
8
8
8
8
8
8 HH
i+
+
+%h//DL $ 1 1 3 3D HH
[
h%%
- llnn " $'HH!
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- HH
W__#==??DL #DL 1 1D }HH $
++ 'Q0AJ0N)O)O
R JJLLL&3 3 3 3
#d 9:::"4< @@(//??
1(D)) &HHHHH
"--H-- L N +d.O O
s$ ABBB 0D<<E E r3 c | j S )z7Return the metadata associated with the MaxMind DB file)r4 r9 s rA r? zReader.metadatan s
~
ip_addressc 6 | | \ }}|S )zReturn 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)r9 rF recordr@ s rA getz
Reader.getr s ..z::
rE c t |t rt j | }n|} t |j }n"# t $ r}t d |d}~ww xY w|j dk r#| j j
dk rt d| d | | \ }}|r|
| |fS d|fS )zReturn 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 objectN zError looking up zD. You attempted to look up an IPv6 address in an IPv4-only database.)r1 str ipaddressrF bytearraypackedAttributeError TypeErrorversionr4
ip_versionr+ _find_address_in_tree_resolve_data_pointer)r9 rF addresspacked_addressexpointer
prefix_lens rA rH zReader.get_with_prefix_len| s j# & & ! *:66GG G W &w~ 6 6NN W W W MNNTV V W ?a DN$=$B$B J J * C--g66
B BZ s A
A"
A A"rQ c F t | dz }| | }| j j }d}||k rD||k r>d||dz d|dz z
z z }| || }|dz }||k r||k >||k rd|fS ||k r||fS t d )N r zInvalid node in search tree)r) _start_noder4
node_count
_read_noder )r9 rQ bit_countnoderc ibits rA rV z Reader._find_address_in_tree s KK!O **^.
)mmz 1 1va1f~a!e45C??4--DAA )mmz 1 1
: a4K * 7N"#@AAArE lengthc | j j dk s|dk rdS | j r| j S d}t d D ]*}|| j j k r n| |d }+|| _ |S )NrL r ` )r4 rU r rangerc rd )r9 ri rf r@ s rA rb zReader._start_node s > $ ) )Vs]]1 $# #r , ,At~000??4++DD rE node_numberindexc || j j z }| j j }|dk r ||dz z }d| j ||dz z }n|dk ri|d|z z }t | j ||dz }|rd|d z |d< ndd| z dz }| d| n3|d k r||dz z }| j ||dz }nt d
| t j d | d S ) N r` rM r zUnknown record size: s !I)
r4 node_byte_size record_sizer rP popinsertr structunpack)r9 rn ro base_offsetrx offset
node_bytesmiddles rA rd zReader._read_node s2 !DN$AA n0 " 519,F 4<!0C#DDJJ
B
1u9,F"4<!0C#DEEJ
- $z!} 4
1
!1!11a7!!!V,,,,
B
519,F fvz&9:JJ&'L{'L'LMM M}UJ//22rE r[ c || j j z
| j j z }|| j k rt d | j | \ }}|S )Nz,The MaxMind DB file's search tree is corrupt)r4 rc r5 r' r r7 r0 )r9 r[ resolveddatar@ s rA rW z Reader._resolve_data_pointer sV T^ 66 9XX t( ( (&'UVV VM((22 q rE c j | j n# t $ r Y nw xY wd| _ dS )zBCloses the MaxMind DB file and returns the resources to the systemTN)r r/ rR r8 rD s rA r/ z Reader.close sI L D s
))c . | d S )N)r/ r9 argss rA __exit__zReader.__exit__ s
rE c 2 | j rt d | S )Nz%Attempt to reopen a closed MaxMind DB)r8 r+ rD s rA __enter__zReader.__enter__ s! ; F DEE E rE )r r3 r N)r r )"__name__
__module__ __qualname____doc__r6 r- r bytesr __annotations__r r intr r r r rB r? rN r r r rJ r
rH rP rV rb rd rW r/ r r r! rE rA r r s
$& 7
5*k1
2222!%K# %%% GPE E fc8R 78E @CE
E E E E N eCk$A B xPVGW [+ => x $ % >BI B%S/ B B B B&# # "3c 3# 3# 3 3 3 3,S V rE r c X e Zd ZdZddZedefd Zedefd Zd Z dS ) r3 a Metadata for the MaxMind DB reader
.. attribute:: binary_format_major_version
The major version number of the binary format used when creating the
database.
:type: int
.. attribute:: binary_format_minor_version
The minor version number of the binary format used when creating the
database.
:type: int
.. attribute:: build_epoch
The Unix epoch for the build time of the database.
:type: int
.. attribute:: database_type
A string identifying the database type, e.g., "GeoIP2-City".
:type: str
.. attribute:: description
A map from locales to text descriptions of the database.
:type: dict(str, str)
.. attribute:: ip_version
The IP version of the data in a database. A value of "4" means the
database only supports IPv4. A database with a value of "6" may support
both IPv4 and IPv6 lookups.
:type: int
.. attribute:: languages
A list of locale codes supported by the databse.
:type: list(str)
.. attribute:: node_count
The number of nodes in the database.
:type: int
.. attribute:: record_size
The bit size of a record in the search tree.
:type: int
r Nc |d | _ |d | _ |d | _ |d | _ |d | _ |d | _ |d | _ |d | _ |d | _ d
S ) zACreates new Metadata object. kwargs are key/value pairs from specrc rx rU
database_type languagesbinary_format_major_versionbinary_format_minor_version build_epoch descriptionN) rc rx rU r r r r r r )r9 kwargss rA rB zMetadata.__init__0 s~ ! .!-0 . #O 4 ,+12O+P(+12O+P(!-0!-0rE c | j dz S )z8The size of a node in bytes
:type: int
rM )rx rD s rA rw zMetadata.node_byte_size> s 1$$rE c | j | j z S )z8The size of the search tree
:type: int
)rc rw rD s rA r5 zMetadata.search_tree_sizeF s !444rE c d d | j D }| j d| j j d| dS )Nz, c 3 * K | ]\ }}| d |V dS )=Nr! ).0kvs rA z$Metadata.__repr__..O s0 HH$!QA HHHHHHrE .())join__dict__itemsr __class__r r s rA __repr__zMetadata.__repr__N sV yyHH$-2E2E2G2GHHHHH/EEDN$;EEdEEEErE r )
r r r r rB propertyr rw r5 r r! rE rA r3 r3 s = =@ 1 1 1 1 % % % % X% 5# 5 5 5 X5F F F F FrE r3 ) r r" ImportErrorrO r{ r r osr typingr r r r r
r maxminddb.constr r
r r r maxminddb.decoderr maxminddb.errorsr maxminddb.filer maxminddb.typesr r r3 r! rE rA r s KKKK DDD
. . . . . . . . : : : : : : : : : : : : : : : : Q Q Q Q Q Q Q Q Q Q Q Q Q Q % % % % % % 1 1 1 1 1 1 % % % % % % " " " " " "Q Q Q Q Q Q Q QhaF aF aF aF aF aF aF aF aF aFs