o Xh"@sdZddlZddlmZzddlmZddlmZddl m Z Wne y9ddl Zddl m Z ddlmZYnwGddde ZGd d d e ZdS) zHTTP Client libraryN) handle_error) urlencode) HTTPErrorc@sHeZdZdZddZeddZeddZedd Zed d Z d S) Responsez$Holds the response from an API call.cCs"||_||_||_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)selfresponserK/var/www/html/env/lib/python3.10/site-packages/python_http_client/client.py__init__s  zResponse.__init__cC|jS)z; :return: integer, status code of API call )rr rrr status_codezResponse.status_codecCr)z0 :return: response from the API )r rrrrbody%rz Response.bodycCr)z3 :return: dict of response headers )r rrrrheaders,rzResponse.headerscCs|jr t|jdSdS)z8 :return: dict of response from the API utf-8N)rjsonloadsdecoderrrrto_dict3szResponse.to_dictN) __name__ __module__ __qualname____doc__rpropertyrrrrrrrrrs   rc@speZdZdZ     dddZddZdd Zd d Zdd d ZdddZ ddZ ddZ ddZ ddZ dS)Clientz4Quickly and easily access any REST or REST-like API.NFcCs:||_|pi|_||_|pg|_gd|_||_||_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 )deletegetpatchpostputN)hostrequest_headers_version _url_pathmethods append_slashtimeout)r r(r)versionurl_pathr-r.rrrrAs    zClient.__init__cCsd|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 {0}/v{1}{2})formatr(strr*)r urlrrr_build_versioned_urlaszClient._build_versioned_urlcCsd}d}|t|jkr |d|j|7}|d7}|t|jks |jr'|d7}|r8tt|d}d||}|jrB||}|S|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/{0}r/Tz{0}?{1}) lenr+r1r-rsorteditemsr*r4r()r query_paramsr3count url_valuesrrr _build_urlks    zClient._build_urlcCs|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)r)update)r r)rrr_update_headersszClient._update_headerscCs4|r|j|gn|j}t|j|j|j||j|jdS)zMake a new Client object :param name: Name of the url segment :type name: string :return: A Client object )r(r/r)r0r-r.)r+r"r(r*r)r-r.)r namer0rrr _build_clientszClient._build_clientc CsF|p|j}z|j||dWSty"}z t|}d|_|d}~ww)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 r.N)r.openrr __cause__)r openerrequestr.errexcrrr _make_requests zClient._make_requestcCs ||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 )rA)r r@rrr_s zClient._csF|dkr fdd}|S|jvr|fdd}|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 r/cs|d_S)z :param args: dict of settings :param kwargs: unused :return: string, version r)r*rA)argskwargsrrr get_versions z'Client.__getattr__..get_versionc sd|vr |dd|vrd}n)djvr1jddkr&|dd}nt|dd}n t|dd}d|vrD|d}nd}t}tj||d}jrgj D] \}}| ||q\|rtdjvrt| dd fd d |_ | d d}t j|||d S)zMake the API call :param args: unused :param kwargs: :return: Client object r) request_bodyNz Content-Typez(application /jsonrr:)datazapplication/jsoncsSNrr)methodrrsz:Client.__getattr__..http_request..r.rB)r?r)encoderdumpsurllib build_openerRequestr=r9 add_header get_methodpoprrI) rJrLrOparamsrErFkeyvaluer.rQr rr http_requests<    z(Client.__getattr__..http_request)r,upperrJ)r r@rMr_rr^r __getattr__s  ' zClient.__getattr__cCrrP__dict__rrrr __getstate__szClient.__getstate__cCs ||_dSrPrb)r staterrr __setstate__s zClient.__setstate__)NNNFNrP)rrrr rr4r=r?rArIrJrardrfrrrrr">s"     D r")r r exceptionsrurllib.requestrFrU urllib.parser urllib.errorr ImportErrorurllib2objectrr"rrrrs     -