o w+f&@sdZddlZddlZddlmZzddlmZddlm Z ddl m Z Wne y=ddl Zddl m Z ddlm Z YnweeZGdddeZGd d d eZdS) 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)selfresponserL/var/www/html/venv/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_code!zResponse.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_dict6szResponse.to_dictN) __name__ __module__ __qualname____doc__rpropertyrrrrrrrrrs   rc@sxeZdZdZhdZ     dddZddZd d Zd d Zdd dZ dddZ ddZ ddZ ddZ ddZdS)Clientz4Quickly and easily access any REST or REST-like API.>getputpostpatchdeleteNFcCs0||_|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)r r(r)versionurl_pathr,r-rrrrGs    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{}/v{}{})formatr(strr*)r urlrrr_build_versioned_urleszClient._build_versioned_urlcCsd}d}|t|jkr |d|j|7}|d7}|t|jks |jr'|d7}|r8tt|d}d||}|jrB||}|Sd|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{}{}) lenr+r0r,rsorteditemsr*r3r()r query_paramsr2count url_valuesrrr _build_urlos   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)r/r,r-)r+r"r(r*r)r,r-)r namer/rrr _build_clientszClient._build_clientc Csd|p|j}z|j||dWSty1}zt|}d|_tdj||j |j 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"{method} Response: {status} {body}methodstatusr) r-openrr __cause___loggerdebugr0 get_methodrr)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 )r@)r r?rrr_s zClient._csP|dkr fdd}|S|jvr#|    dfdd }|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*r@)argskwargsrrr get_versions z'Client.__getattr__..get_versionNc s|r||durd}n!djvr jddkr |d}njddt|d}t}tj |j|d}fdd|_ t dj |d |jr_t d j |jd t d j |jd tj|||d}t dj |j|jd|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)rdatacsSNrr)rDrr sz:Client.__getattr__..http_request..z{method} Request: {url})rDr2zPAYLOAD: {data})rTzHEADERS: {headers})rrArBrC)r>r)encode setdefaultrdumpsurllib build_openerRequestr<rJrHrIr0 get_full_urlrTrrrOrr) request_bodyr9r)r-rPrTrKrLrrDr rr http_requestsP   z(Client.__getattr__..http_request)NNNN)methodsupperrP)r r?rSr`rr_r __getattr__s  A zClient.__getattr__cCrrU__dict__rrrr __getstate__$szClient.__getstate__cCs ||_dSrUrd)r staterrr __setstate__'s zClient.__setstate__)NNNFNrU)rrrr rarr3r<r>r@rOrPrcrfrhrrrrr"As$    ^ r")r rlogging exceptionsrurllib.requestrLrZ urllib.parser urllib.errorr ImportErrorurllib2 getLoggerrrHobjectrr"rrrrs       -