]j" d Z ddlZddlmZmZmZmZmZmZ ddl Z ddl m
Z
m Z m Z m
Z
mZmZ ddlZddlZddlZddlmZ ddlmZmZmZmZmZmZmZm Z G d d Z dS ) zG
======================
GeoIP2 Database Reader
======================
N)AnycastListOptionalTypeUnion) MODE_AUTO MODE_MMAP
MODE_MMAP_EXT MODE_FILE MODE_MEMORYMODE_FD) IPAddress)ASN AnonymousIPCityConnectionTypeCountryDomain
EnterpriseISPc
e Zd ZdZdefdedeee deddfdZ d dZ
d d Z d
e de
fdZd
e defdZd
e defdZd
e defdZd
e defdZd
e defdZd
e defdZd
e defdZ ded
e de fdZ de e e
e e e e f ded
e de e
eef fdZ!de e e e e e e e e e e f ded
e de eeeeef fdZ"de#j$ j% fd Z&d d Z'dS )!Readera
GeoIP2 database Reader object.
Instances of this class provide a reader for the GeoIP2 database format.
IP addresses can be looked up using the ``country`` and ``city`` methods.
The basic API for this class is the same for every database. First, you
create a reader object, specifying a file name or file descriptor.
You then call the method corresponding to the specific database, passing
it the IP address you want to look up.
If the request succeeds, the method call will return a model class for the
method you called. This model in turn contains multiple record classes,
each of which represents part of the data returned by the database. If the
database does not contain the requested information, the attributes on the
record class will have a ``None`` value.
If the address is not in the database, an
``geoip2.errors.AddressNotFoundError`` exception will be thrown. If the
database is corrupt or invalid, a ``maxminddb.InvalidDatabaseError`` will
be thrown.
Nfileishlocalesmodereturnc |dg}t j || | _ | j j | _ || _ dS )ag Create GeoIP2 Reader.
:param fileish: The string path to the GeoIP2 database, or an existing
file descriptor pointing to the database. Note that this latter
usage is only valid when mode is MODE_FD.
:param locales: This is list of locale codes. This argument will be
passed on to record classes to use when their name properties are
called. The default value is ['en'].
The order of the locales is significant. When a record class has
multiple names (country, city, etc.), its name property will return
the name in the first locale that has one.
Note that the only locale which is always present in the GeoIP2
data is "en". If you do not include this locale, the name property
may end up returning None even when the record has an English name.
Currently, the valid locale codes are:
* de -- German
* en -- English names may still include accented characters if that
is the accepted spelling in English. In other words, English does
not mean ASCII.
* es -- Spanish
* fr -- French
* ja -- Japanese
* pt-BR -- Brazilian Portuguese
* ru -- Russian
* zh-CN -- Simplified Chinese.
:param mode: The mode to open the database with. Valid mode are:
* MODE_MMAP_EXT - use the C extension with memory map.
* MODE_MMAP - read from memory map. Pure Python.
* MODE_FILE - read database as standard file. Pure Python.
* MODE_MEMORY - load database into memory. Pure Python.
* MODE_FD - the param passed via fileish is a file descriptor, not a
path. This mode implies MODE_MEMORY. Pure Python.
* MODE_AUTO - try MODE_MMAP_EXT, MODE_MMAP, MODE_FILE in that order.
Default.
Nen) maxminddb
open_database
_db_readermetadata
database_type_db_type_locales)selfr r r s o/builddir/build/BUILD/imunify360-venv-2.6.3/opt/imunify360/venv/lib/python3.11/site-packages/geoip2/database.py__init__zReader.__init__= sH V ?fG#1'4@@ 0022@
c | S N r' s r( __enter__zReader.__enter__n s r* exc_type exc_value tracebackc . | d S r, )close)r' r0 r1 r2 s r( __exit__zReader.__exit__q s
r*
ip_addressc t t t | t j j d| S )zGet the Country object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.Country` object
r )r r
_model_forgeoip2modelsr' r6 s r( countryzReader.countryt s0 T__V]%:IzRR
r* c t t t | t j j d| S )zGet the City object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.City` object
r )r r r8 r9 r: r; s r( cityz Reader.city s) D$//&-*<fjQQRRRr* c t t t | t j j d| S )zGet the AnonymousIP object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.AnonymousIP` object
zGeoIP2-Anonymous-IP)r r _flat_model_forr9 r: r; s r( anonymous_ipzReader.anonymous_ip s9
)+@*
r* c t t t | t j j d| S )zGet the ASN object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.ASN` object
z GeoLite2-ASN)r r r@ r9 r: r; s r( asnz
Reader.asn s2 %%fm&7 TT
r* c t t t | t j j d| S )zGet the ConnectionType object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.ConnectionType` object
zGeoIP2-Connection-Type)r r r@ r9 r: r; s r( connection_typezReader.connection_type s9
,.F
r* c t t t | t j j d| S )zGet the Domain object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.Domain` object
z
GeoIP2-Domain)r r r@ r9 r: r; s r( domainz
Reader.domain s3 !5
S S
r* c t t t | t j j d| S )zGet the Enterprise object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.Enterprise` object
r )r r r8 r9 r: r; s r(
enterprisezReader.enterprise s1 OOFM 4lJ O O
r* c t t t | t j j d| S )zGet the ISP object for the IP address.
:param ip_address: IPv4 or IPv6 address as a string.
:returns: :py:class:`geoip2.models.ISP` object
z
GeoIP2-ISP)r r r@ r9 r: r; s r( ispz
Reader.isp s2 %%fm&7 zRR
r* r$ c || j vr:t j d d }t d| d| j d | j | \ }}|#t j d| d ||fS )N zThe z method cannot be used with the z databasez The address z is not in the database.) r% inspectstack TypeErrorr" get_with_prefix_lenr9 errorsAddressNotFoundError)r' r$ r6 callerrecord
prefix_lens r( _getz Reader._get s
- - ]__Q'*FWvWWt}WWW
$ B B: N N >-44CzCCC
z!!r* model_classtypesc | || \ }}| di }||d< ||d< ||| j S )Ntraitsr6 rW )r )rX
setdefaultr& )r' rY rZ r6 rV rW r\ s r( r8 zReader._model_for s\ $yy
; ; ""8R00 )| )| {64=9999r* c ^ | || \ }}||d< ||d< || S )Nr6 rW )rX )r' rY rZ r6 rV rW s r( r@ zReader._flat_model_for s@ $yy
; ; )| )| {6"""r* c 4 | j S )zlThe metadata for the open database.
:returns: :py:class:`maxminddb.reader.Metadata` object
)r" r# r. s r( r# zReader.metadata s
'')))r* c 8 | j dS )zCloses the GeoIP2 database.N)r" r4 r. s r( r4 z Reader.close s
r* )r r )r0 Nr1 Nr2 Nr N)r N)(__name__
__module__ __qualname____doc__r strr r intr) r/ r5 r r r< r r> r rA r rC r rE r rG r rI r rK r rX r r r8 r@ r readerMetadatar# r4 r- r* r( r r & s . <@Y/ / / %-d3i%8/ GJ/
/ / / / b
)
Sy ST S S S S
y
[
i
C
)
v
Y
:
i
C
"# "9 " " " " "
:4=$z*:DJFG
:
:
:
w
D( )
:
:
:
: # L$s)T.%949d;FW W
#
#
#
~sK< = # # # #*)*3 * * * * r* r ) rd rO typingr r r r r r r r r
r r r
r r9
geoip2.models
geoip2.errors geoip2.typesr r r r r r r r r r r- r* r( <module>rm s{ 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9
" " " " " " e e e e e e e e e e r*