ó º9—^c@sÅdZddlZddlmZy3ddljZddlmZddl m Z Wn=e k r”ddl Zddl m Z ddlmZnXde fd„ƒYZd e fd „ƒYZdS( sHTTP Client libraryiÿÿÿÿNi(t handle_error(t urlencode(t HTTPErrortResponsecBsSeZdZd„Zed„ƒZed„ƒZed„ƒZed„ƒZRS(s$Holds the response from an API call.cCs1|jƒ|_|jƒ|_|jƒ|_dS(s¨ :param response: The return value from a open call on a urllib.build_opener() :type response: urllib response object N(tgetcodet _status_codetreadt_bodytinfot_headers(tselftresponse((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt__init__scCs|jS(s; :return: integer, status code of API call (R(R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt status_codescCs|jS(s0 :return: response from the API (R(R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pytbody&scCs|jS(s3 :return: dict of response headers (R (R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pytheaders-scCs*|jr"tj|jjdƒƒSdSdS(s8 :return: dict of response from the API sutf-8N(RtjsontloadstdecodetNone(R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pytto_dict4s ( t__name__t __module__t__doc__R tpropertyR RRR(((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyRs  tClientcBs’eZdZdddddhZdddedd„Zd„Zd„Zd „Z dd „Z dd „Z d „Z d „Z d„Zd„ZRS(s4Quickly and easily access any REST or REST-like API.tdeletetgettpatchtposttputcCsF||_|pi|_||_|p*g|_||_||_dS(s‰ :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(thosttrequest_headerst_versiont _url_patht append_slashttimeout(R RR tversionturl_pathR#R$((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyR Es    cCsdj|jt|jƒ|ƒS(sþSubclass 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 s{}/v{}{}(tformatRtstrR!(R turl((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt_build_versioned_urlcscCsÌd}d}x=|t|jƒkrK|dj|j|ƒ7}|d7}qW|jrb|d7}n|r˜tt|jƒƒtƒ}dj||ƒ}n|jr³|j |ƒ}ndj|j |ƒ}|S(s¹Build the final URL to be passed to urllib :param query_params: A dictionary of all the query parameters :type query_params: dictionary :return: string tis/{}it/s{}?{}s{}{}( tlenR"R'R#RtsortedtitemstTrueR!R*R(R t query_paramsR)tcountt url_values((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt _build_urlms   cCs|jj|ƒdS(s²Update the headers for the request :param request_headers: headers to set for the API call :type request_headers: dictionary :return: dictionary N(R tupdate(R R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt_update_headersˆsc CsY|r|j|gn|j}td|jd|jd|jd|d|jd|jƒS(s‹Make a new Client object :param name: Name of the url segment :type name: string :return: A Client object RR%R R&R#R$(R"RRR!R R#R$(R tnameR&((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt _build_client‘s   cCs[|p |j}y|j|d|ƒSWn.tk rV}t|ƒ}d|_|‚nXdS(s„Make 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$topenRRRt __cause__(R topenertrequestR$terrtexc((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt _make_request s   cCs |j|ƒS(sDAdd 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 (R8(R R7((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt_´s csm|dkr‡fd†}|S|ˆjkr\|jƒ‰dddd‡‡fd†}|Sˆj|ƒSdS(sDDynamically 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ˆ_ˆjƒS(sŽ :param args: dict of settings :param kwargs: unused :return: string, version i(R!R8(targstkwargs(R (s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt get_versionÊs csë|rˆj|ƒn|dkr+d}n_dˆjkr_ˆjddkr_|jdƒ}n+ˆjjddƒtj|ƒjdƒ}tjƒ}tj ˆj |ƒdˆjd|ƒ}‡fd†|_ t ˆj ||d|ƒƒS( s…Make 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 s Content-Typesapplication/jsonsutf-8RtdatacsˆS(N(((tmethod(s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pytR+R$N(R6RR tencodet setdefaultRtdumpsturllibt build_openertRequestR4t get_methodRR?(t request_bodyR1R R$R@RDR;R<(RER (s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt http_requestØs&         N(tmethodstupperRR@(R R7RCRO((RER s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt __getattr__Às  ,cCs|jS(N(t__dict__(R ((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt __getstate__ scCs ||_dS(N(RS(R tstate((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyt __setstate__sN(RRRRPRtFalseR R*R4R6R8R?R@RRRTRV(((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyR?s      M (RRt exceptionsRturllib.requestR<RJt urllib.parseRt urllib.errorRt ImportErrorturllib2tobjectRR(((s;/tmp/pip-unpacked-wheel-vZkhRb/python_http_client/client.pyts   -