xh&dZddlZddlZddlmZ ddlmZddlm Z ddl m Z n#e $rddl Zddl m Z ddlm Z YnwxYwejeZGddeZGd d eZdS) zHTTP Client libraryN) handle_error) urlencode) HTTPErrorcpeZdZdZdZedZedZedZedZ dS)Responsez$Holds the response from an API call.c||_||_||_dS)z :param response: The return value from a open call on a urllib.build_opener() :type response: urllib response object N)getcode _status_coderead_bodyinfo_headers)selfresponses L/var/www/html/what/lib/python3.11/site-packages/python_http_client/client.py__init__zResponse.__init__s: %,,..]]__   c|jS)z; :return: integer, status code of API call )r rs r status_codezResponse.status_code!s   rc|jS)z0 :return: response from the API )r rs rbodyz Response.body(s zrc|jS)z3 :return: dict of response headers )rrs rheaderszResponse.headers/s }rcl|jr,tj|jdSdS)z8 :return: dict of response from the API utf-8N)rjsonloadsdecoders rto_dictzResponse.to_dict6s3 9 :di..w7788 84rN) __name__ __module__ __qualname____doc__rpropertyrrrr!rrrrs..(((!!X! X X XrrcfeZdZdZhdZ ddZdZdZdZdd Z dd Z d Z d Z d Z dZdS)Clientz4Quickly and easily access any REST or REST-like API.>getputpostpatchdeleteNFcb||_|pi|_||_|pg|_||_||_dS)a :param host: Base URL for the api. (e.g. https://api.sendgrid.com) :type host: string :param request_headers: A dictionary of the headers you want applied on all calls :type request_headers: dictionary :param version: The version number of the API. Subclass _build_versioned_url for custom behavior. Or just pass the version as part of the URL (e.g. client._("/v3")) :type version: integer :param url_path: A list of the url path segments :type url_path: list of strings N)hostrequest_headers_version _url_path append_slashtimeout)rr0r1versionurl_pathr4r5s rrzClient.__init__Gs=* .4" !R( rc^d|jt|j|S)zSubclass this function for your own needs. Or just pass the version as part of the URL (e.g. client._('/v3')) :param url: URI portion of the full URL being requested :type url: string :return: string z{}/v{}{})formatr0strr2)rurls r_build_versioned_urlzClient._build_versioned_urles(  C ,>,>DDDrcd}d}|t|jkr@|d|j|z }|dz }|t|jk@|jr|dz }|rEt t |d}d||}|jr||}nd|j |}|S) zBuild the final URL to be passed to urllib :param query_params: A dictionary of all the query parameters :type query_params: dictionary :return: string rz/{}r/Tz{}?{}z{}{}) lenr3r9r4rsorteditemsr2r<r0)r query_paramsr;count url_valuess r _build_urlzClient._build_urlosc$.)))) 5<<u 566 6C QJEc$.))))    3JC  2"6,*<*<*>*>#?#?FFJ..j11C = 0++C00CC-- 3//C rc:|j|dS)zUpdate the headers for the request :param request_headers: headers to set for the API call :type request_headers: dictionary :return: dictionary N)r1update)rr1s r_update_headerszClient._update_headerss! ##O44444rc|r |j|gzn|j}t|j|j|j||j|jS)zMake a new Client object :param name: Name of the url segment :type name: string :return: A Client object )r0r6r1r7r4r5)r3r)r0r2r1r4r5)rnamer7s r _build_clientzClient._build_clientsR/3F4>TF**49"m&*&:'#'#4"l ,,, ,rc0|p|j} |||S#t$ri}t|}d|_t d||j |j |d}~wwxYw)aMake the API call and return the response. This is separated into it's own function, so we can mock it easily for testing. :param opener: :type opener: :param request: url payload to request :type request: urllib.Request object :param timeout: timeout value or None :type timeout: float :return: urllib response r5N"{method} Response: {status} {body}methodstatusr) r5openrr __cause___loggerdebugr9 get_methodrr)ropenerrequestr5errexcs r _make_requestzClient._make_requests)T\ ;;w;88 8   s##C CM MM>EE))++XF   I s" BA$BBc,||S)aDAdd variable values to the url. (e.g. /your/api/{variable_value}/call) Another example: if you have a Python reserved word, such as global, in your url, you must use this method. :param name: Name of the url segment :type name: string :return: Client object )rL)rrKs r_zClient._s!!$'''rc|dkrfd}|S|jvr!| dfd }|S|S)aDDynamically add method calls to the url, then call a method. (e.g. client.name.name.method()) You can also add a version number by using .version() :param name: Name of the url segment or method call :type name: string or integer if name == version :return: mixed r6cF|d_S)z :param args: dict of settings :param kwargs: unused :return: string, version r)r2rL)argskwargsrs r get_versionz'Client.__getattr__..get_versions" !%Q ))+++rNc|r ||d}nrd jvr' jddkr|d}nB jddt j|d}t j}t j | j|} fd|_ t d ||jr3t d |j t d |j t# ||| }t d |j|j|S)aMake the API call :param timeout: HTTP request timeout. Will be propagated to urllib client :type timeout: float :param request_headers: HTTP headers. Will be merged into current client object state :type request_headers: dict :param query_params: HTTP query parameters :type query_params: dict :param request_body: HTTP request body :type request_body: string or json-serializable object :param kwargs: :return: Response object Nz Content-Typezapplication/jsonr)rdatacSNr')rQsrz:Client.__getattr__..http_request.. sVrz{method} Request: {url})rQr;zPAYLOAD: {data})rezHEADERS: {headers})rrNrOrP)rIr1encode setdefaultrdumpsurllib build_openerRequestrFrWrUrVr9 get_full_urlrerrr\rr) request_bodyrCr1r5r^rerXrYrrQrs r http_requestz(Client.__getattr__..http_requests(#:((999'DD&)=== 0@.//+227;;,77*,>@@@#z,77>>wGG,.. .OOL11 0 &4^^^" 7>>!,,..?00111<,MM"3":":$\#;#+#+,,, 299#O:--...$&&vw&HH BII!#/!J(()))  r)NNNN)methodsupperr^)rrKrcrqrQs` @r __getattr__zClient.__getattr__s 9   , , , , ,  4<  ZZ\\F"&!%$( ? ? ? ? ? ? ? B 66$<< rc|jSrg__dict__rs r __getstate__zClient.__getstate__$s }rc||_dSrgrv)rstates r __setstate__zClient.__setstate__'s  r)NNNFNrg)r"r#r$r%rrrr<rFrIrLr\r^rtrxr{r'rrr)r)As>>877G"&# <EEE6555 , , , ,0 ( ( (\ \ \ |rr))r%rlogging exceptionsrurllib.requestrYrl urllib.parser urllib.errorr ImportErrorurllib2 getLoggerr"rUobjectrr)r'rrrs; $$$$$$ !######&&&&&&&&&&&&&!!!!!!!!!        ! ' H % %*****v***ZgggggVgggggs %==