wt z d Z ddlZddlZddlmZmZmZmZmZm Z m
Z
ddl Z ddl Z ddl
Z
ddlZ
ddlZddlZddlmZmZmZmZmZmZmZ ddlmZmZmZ ddl m Z dej de j j Z!dej de
j" # Z$ G d d
Z% G d d e% Z& G d
de% Z'dS )a{
============================
WebServices Client API
============================
This class provides a client API for all the GeoIP2 Precision web service end
points. The end points are Country, City, and Insights. Each end point returns
a different set of data about an IP address, with Country returning the least
data and Insights the most.
Each web service end point is represented by a different model class, and
these model classes in turn contain multiple record classes. The record
classes have attributes which contain data about the IP address.
If the web service does not return a particular piece of data for an IP
address, the associated attribute is not populated.
The web service may not return any information for an entire record, in which
case all of the attributes for that record class will be empty.
SSL
---
Requests to the web service are always made with SSL.
N)AnyDictcastListOptionalTypeUnion)AddressNotFoundErrorAuthenticationError GeoIP2Error HTTPErrorInvalidRequestErrorOutOfQueriesErrorPermissionRequiredError)CityCountryInsights) IPAddresszGeoIP2-Python-Client/ c e Zd ZU eed< eed< eed< ee ed< eed< dededed eee d
ed d f d
Z dede
d efdZ e deded e
fd Zdedededed ef
dZdedededed ef
dZe dedededed eeeeeef f
d Ze dededee d efd Ze dededee d efd Zd S )
BaseClient _account_id_host _license_key_locales_timeout
account_id license_keyhostlocalestimeoutreturnNc |dg}|| _ t |t r|nt | | _ || _ d| d| _ || _ dS )zConstruct a Client.Nenzhttps://z /geoip/v2.1)r
isinstancebytesstrr r _base_urir )selfr r r r r! s q/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/geoip2/webservice.py__init__zBaseClient.__init__C sd ?fG
%Z77 LJJS__
(5D555
path
ip_addressc |dk rt j | }d | j |t | g S )Nme/) ipaddressr. joinr( r' )r) r- r. s r* _urizBaseClient._uriZ s> "-j99Jxx s:?@@@r, bodyuric t j | S # t $ r6}t d| dd |j z d| |d }~ww xY w)Nz Received a 200 response for z, but could not decode the response as JSON: , )jsonloads
ValueErrorr r3 args)r5 r6 exs r* _handle_successzBaseClient._handle_success_ s :d## # s 99RW--.
s
A1AAstatus content_typec d|cxk rdk rn n| |||| S d|cxk rdk rn n| ||| S | ||| S )Ni i iX )_exception_for_4xx_status_exception_for_5xx_status _exception_for_non_200_status)r) r@ rA r5 r6 s r* _exception_for_errorz BaseClient._exception_for_errorl s & 3 11&,cRR R & 3 11&#tDD D11&#tDDDr, c |st d| d| d||| S | d dk rt d| d| d| ||| S t j | }d|v rBd |v r>| | d | d || S t d
||| S # t $ rA}t d| d| d d z d
|j z ||| cY d }~S d }~ww xY w)Nz Received a z error for z with no body.r: z for z with the following body: codeerrorzAResponse contains JSON but it does not specify code or error keysz but it did not include zthe expected JSON body: r8 ) r
findr: r; _exception_for_web_service_errorgetr< r3 r= )r) r@ rA r5 r6 decoded_bodyr> s r* rC z$BaseClient._exception_for_4xx_statusu s DfDDDDD
V $ $ * * PfPP3PP$PP
:d++L %%'\*A*A<< $$W--|/?/?/G/GQT S
NfNNNNN,-))BG$$%
s B= =
D6D=DDmessagerI c |dv rt | S |dv rt | S |dv rt | S |dk rt | S t | ||| S )N)IP_ADDRESS_NOT_FOUNDIP_ADDRESS_RESERVED)ACCOUNT_ID_REQUIREDACCOUNT_ID_UNKNOWNAUTHORIZATION_INVALIDLICENSE_KEY_REQUIREDUSER_ID_REQUIREDUSER_ID_UNKNOWN)INSUFFICIENT_FUNDSOUT_OF_QUERIESPERMISSION_REQUIRED)r
r r r r )rO rI r@ r6 s r* rL z+BaseClient._exception_for_web_service_error s B B B'00 0
'w// / ; ; ;$W-- - ( ( (*733 3"7D&#>>>r, c 2 t d| d| | || S )NzReceived a server error () for r
r@ r6 r5 s r* rD z$BaseClient._exception_for_5xx_status s2 ; ; ;c ; ;
r, c 2 t d| d| | || S )Nz(Received a very surprising HTTP status (r] r^ r_ s r* rE z(BaseClient._exception_for_non_200_status s2 Jv J JS J J
r, ) __name__
__module__ __qualname__r' __annotations__r floatintr r+ r r4 staticmethodr r? r rF rC r r r
r r r rL r
rD rE r, r* r r < sw JJJ3iOOO
$s)$
.A A) A A A A A
c
\
EE),E47E>AE E E E E&&),&47&>A& & & & &P ?? ?),?36?
? ? ? \?6
%-c]
\
%-c]
\
r, r c \ e Zd ZU dZej ed< ee ed< d de ded ed
ee
e d e d ee d
df fd
Z d de
d
efdZd de
d
efdZd de
d
efdZd
ej fdZdedeee ee ee f de
d
eeeef fdZd Zd dZd!d Z xZS )" AsyncClientaU An async GeoIP2 client.
It accepts the following required arguments:
:param account_id: Your MaxMind account ID.
:param license_key: Your MaxMind license key.
Go to https://www.maxmind.com/en/my_license_key to see your MaxMind
account ID and license key.
The following keyword arguments are also accepted:
:param host: The hostname to make a request against. This defaults to
"geoip.maxmind.com". To use the GeoLite2 web service instead of GeoIP2
Precision, set this to "geolite.info".
: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 timeout: The timeout in seconds to use when waiting on the request.
This sets both the connect timeout and the read timeout. The default is
60.
:param proxy: The URL of an HTTP proxy to use. It may optionally include
a basic auth username and password, e.g.,
``http://username:password@host:port``.
_existing_session_proxygeoip.maxmind.comN< r r r r r! proxyr" c ` t ||||| || _ d S N)superr+ rl r) r r r r r! ro __class__s r* r+ zAsyncClient.__init__ s=
r, r0 r. c K t t | dt j j | d{V S ) Call City endpoint with the specified IP.
:param ip_address: IPv4 or IPv6 address as a string. If no
address is provided, the address that the web service is
called from will be used.
:returns: :py:class:`geoip2.models.City` object
cityNr r
_response_forgeoip2modelsr) r. s r* rw zAsyncClient.city sH **66=3EzRRRRRRRR
r, c K t t | dt j j | d{V S )( Call the GeoIP2 Country endpoint with the specified IP.
:param ip_address: IPv4 or IPv6 address as a string. If no address
is provided, the address that the web service is called from will
be used.
:returns: :py:class:`geoip2.models.Country` object
countryNr r ry rz r{ r| s r* r zAsyncClient.country$ sI $$Y
0EzRR R R R R R R
r, c K t t | dt j j | d{V S ) Call the Insights endpoint with the specified IP.
Insights is only supported by GeoIP2 Precision. The GeoLite2 web
service does not support it.
:param ip_address: IPv4 or IPv6 address as a string. If no address
is provided, the address that the web service is called from will
be used.
:returns: :py:class:`geoip2.models.Insights` object
insightsNr r ry rz r{ r| s r* r zAsyncClient.insights3 sI $$Z 1GTT T T T T T T
r, c K t | d sYt j t j | j | j dt dt j | j | _ | j S )Nrk application/json)Accept
User-Agent)total)authheadersr! )
hasattraiohttp
ClientSession BasicAuthr r _AIOHTTP_UA
ClientTimeoutr rk r) s r* _sessionzAsyncClient._sessionE sr t 011 %,%: &t'79JKK#5[QQ -DMBBB& & &D " %%r, r- model_classc K | || }| d {V }| || j d {V 4 d {V }|j }|j }| d {V } |dk r| ||| | | | | }
||
| j cd d d d {V S # 1 d {V swxY w Y d S )N)ro r9 r )
r4 r rM rl r@ rA textrF r? r ) r) r- r r. r6 sessionresponser@ rA r5 rN s r* ry zAsyncClient._response_forO s iij))
'''''' S <<<<<<<< D D D D D D D _F#0L! ((((((D}}// dCPPP //c::L ;|T]CCC D D D D D D D D D D D D D D D D D D D D D D D D D D D D D Ds A.C
C&)C&c l K t | d r!| j d{V dS dS )fClose underlying session
This will close the session and any associated connections.
rk N)r rk closer s r* r zAsyncClient.close` sR
4, - - 1(..00 0 0 0 0 0 0 0 0 0 1 1r, c
K | S rq rh r s r*
__aenter__zAsyncClient.__aenter__h s r, exc_type exc_value tracebackc > K | d {V d S rq r r) r r r s r* __aexit__zAsyncClient.__aexit__k s, jjllr, rm Nrn Nr0 )r" rj r Nr Nr Nr" N) ra rb rc __doc__r r rd r r' rf r re r+ r r rw r r r r r r r ry r r r
__classcell__rt s @r* rj rj s . .` ,,,, SM ('+ #
$s)$
}
$
Y
$
W
h
$& 5 & & & &DD 4>4:tG}DED D
wh& ' D D D D"1 1 1 r, rj c V e Zd ZU dZej ed< eee e f ed< d de
de d e d
ee e d e d ee d
df fd
Z
d ded
efdZd ded
efdZd ded
efdZde deee ee ee f ded
eeeef fdZd Zd dZd d Z xZS )!Clienta[ A synchronous GeoIP2 client.
It accepts the following required arguments:
:param account_id: Your MaxMind account ID.
:param license_key: Your MaxMind license key.
Go to https://www.maxmind.com/en/my_license_key to see your MaxMind
account ID and license key.
The following keyword arguments are also accepted:
:param host: The hostname to make a request against. This defaults to
"geoip.maxmind.com". To use the GeoLite2 web service instead of GeoIP2
Precision, set this to "geolite.info".
: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 timeout: The timeout in seconds to use when waiting on the request.
This sets both the connect timeout and the read timeout. The default is
60.
:param proxy: The URL of an HTTP proxy to use. It may optionally include
a basic auth username and password, e.g.,
``http://username:password@host:port``.
r _proxiesrm Nrn r r r r r! ro r" c t ||||| t j | _ | j | j f| j _ d| j j d< t | j j d< | d | _
d S d|i| _
d S )Nr r r https) rr r+ requestsSessionr r r r r _REQUEST_UAr rs s r* r+ zClient.__init__ s [$III (**
" .0A B
*<
h'.9
l+ = DMMM $e ,DMMMr, r0 r. c t t t | dt j j | S )rv rw rx r| s r* rw z Client.city s+ D$,,VV]5GTTUUUr, c t t t | dt j j | S )r~ r r r| s r* r zClient.country s2 T'' 6=3H*UU
r, c t t t | dt j j | S )r r r r| s r* r zClient.insights s2 d((V]5KZXX
r, r- r c > | || }| j || j | j }|j }|j d }|j }|dk r| |||| | || } || | j
S )N)proxiesr! z Content-Typer9 r ) r4 r rM r r status_coder r rF r? r )
r) r- r r. r6 r r@ rA r5 rN s
r* ry zClient._response_for s iij))=$$S$- $WW% '7 } S==++FL$LL L++D#66 {< ????r, c 8 | j dS )r N)r r r s r* r z Client.close s
r, c | S rq rh r s r* __enter__zClient.__enter__ s r, r r r c . | d S rq r r s r* __exit__zClient.__exit__ s
r, r r )r" r r ) ra rb rc r r r rd r r r' rf r re r+ r r rw r r r r r r ry r r r r r s @r* r r o s / /b tCH~&&&& ('+ #- -- - -
$s)$ -
- }-
- - - - - -&
V
Vy
VD
V
V
V
V
)
w
9
"@@ 4>4:tG}DE@ @
wh& ' @ @ @ @ r, r )(r r2 r: typingr r r r r r r r aiohttp.httpr requests.utilsrz
geoip2.models
geoip2.errorsr
r r r
r r r r r r geoip2.typesr __version__httpSERVER_SOFTWAREr utilsdefault_user_agentr r rj r rh r, r* r s 6 ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?
2 1 1 1 1 1 1 1 1 1 " " " " " " PF .OO 1MOO
WF .VV 1R1R1T1TVV
Q
Q
Q
Q
Q
Q
Q
Q
h\ \ \ \ \* \ \ \~N N N N NZ N N N N Nr,