U Fc&@sdZddlZddlZddlmZz(ddlmZddlm Z ddl m Z Wn4e k r|ddl Zddl m Z ddlm Z YnXeeZGdddeZGd 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)selfresponser=/tmp/pip-unpacked-wheel-itnlelph/python_http_client/client.py__init__s  zResponse.__init__cCs|jS)z; :return: integer, status code of API call )rr rrr status_code!szResponse.status_codecCs|jS)z0 :return: response from the API )r rrrrbody(sz Response.bodycCs|jS)z3 :return: dict of response headers )r rrrrheaders/szResponse.headerscCs |jrt|jdSdSdS)z8 :return: dict of response from the API utf-8N)rjsonloadsdecoderrrrto_dict6szResponse.to_dictN) __name__ __module__ __qualname____doc__rpropertyrrrrrrrrrs    rc@steZdZdZdddddhZdd d Zd d Zd dZddZdddZ dddZ ddZ ddZ ddZ ddZdS) Clientz4Quickly and easily access any REST or REST-like API.deletegetpatchpostputNFcCs0||_|p i|_||_|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|jkr4|d|j|7}|d7}q|jrB|d7}|rdtt|d}d||}|jrv||}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{}{}) lenr)r.r*rsorteditemsr(r1r&)r query_paramsr0countZ 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 Csr|p|j}z|j||dWStk rl}z4t|}d|_tdj||j |j d|W5d}~XYnXdS)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___loggerdebugr. 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._csL|dkrfdd}|S|jkr>|dfdd }|S|SdS)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||dkrd}nBdjkr@jddkr@|d}njddt|d}t}tj |j|d}fdd|_ t dj |d |jrt 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)rArr z:Client.__getattr__..http_request..z{method} Request: {url})rAr0zPAYLOAD: {data})rQzHEADERS: {headers})rr>r?r@)r;r'encode setdefaultrdumpsurllib build_openerRequestr9rGrErFr. get_full_urlrQrrrLrr) request_bodyr7r'r+rMrQrHrIrrAr rr http_requestsT   z(Client.__getattr__..http_request)NNNN)methodsupperrM)r r<rPr^rr]r __getattr__s   AzClient.__getattr__cCs|jSrR__dict__rrrr __getstate__$szClient.__getstate__cCs ||_dSrRrb)r staterrr __setstate__'szClient.__setstate__)NNNFN)N)N)rrrrr_rr1r9r;r=rLrMrardrfrrrrr As"     ^r )rrlogging exceptionsrurllib.requestrIrX urllib.parser urllib.errorr ImportErrorurllib2 getLoggerrrEobjectrr rrrrs     -