ó O'—^c@sÔdZddlmZddlZddlmZddlmZddl m Z ddl m Z de fd „ƒYZd efd „ƒYZd efd „ƒYZdefd„ƒYZdefd„ƒYZdS(u' Provides various throttling policies. iÿÿÿÿ(tunicode_literalsN(tcache(tImproperlyConfigured(tis_authenticated(t api_settingst BaseThrottlecBs)eZdZd„Zd„Zd„ZRS(u& Rate throttling of requests. cCstdƒ‚dS(uT Return `True` if the request should be allowed, `False` otherwise. u#.allow_request() must be overriddenN(tNotImplementedError(tselftrequesttview((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyt allow_requestscCs¥|jjdƒ}|jjdƒ}tj}|dk rˆ|dksQ|dkrU|S|jdƒ}|t|t|ƒƒ }|jƒS|r¡dj |jƒƒS|S(uå Identify the machine making the request by parsing HTTP_X_FORWARDED_FOR if present and number of proxies is > 0. If not use all of HTTP_X_FORWARDED_FOR if it is available, if not use REMOTE_ADDR. uHTTP_X_FORWARDED_FORu REMOTE_ADDRiu,uN( tMETAtgetRt NUM_PROXIEStNonetsplittmintlentstriptjoin(RRtxfft remote_addrt num_proxiestaddrst client_addr((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyt get_idents   cCsdS(um Optionally, return a recommended number of seconds to wait before the next request. N(R(R((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pytwait-s(t__name__t __module__t__doc__R RR(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyRs  tSimpleRateThrottlecBszeZdZeZejZdZd Z e j Z d„Z d„Zd„Zd„Zd„Zd„Zd„Zd „ZRS( u¡ A simple cache implementation, that only requires `.get_cache_key()` to be overridden. The rate (requests / seconds) is set by a `throttle` attribute on the View class. The attribute is a string of the form 'number_of_requests/period'. Period should be one of: ('s', 'sec', 'm', 'min', 'h', 'hour', 'd', 'day') Previous request information used for throttling is stored in the cache. uthrottle_%(scope)s_%(ident)scCsFt|ddƒs$|jƒ|_n|j|jƒ\|_|_dS(Nurate(tgetattrRtget_ratetratet parse_ratet num_requeststduration(R((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyt__init__GscCstdƒ‚dS(u³ Should return a unique cache-key which can be used for throttling. Must be overridden. May return `None` if the request should not be throttled. u#.get_cache_key() must be overriddenN(R(RRR ((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyt get_cache_keyLscCstt|ddƒs1d|jj}t|ƒ‚ny|j|jSWn*tk rod|j}t|ƒ‚nXdS(uR Determine the string representation of the allowed request rate. uscopeu9You must set either `.scope` or `.rate` for '%s' throttleu+No default throttle rate set for '%s' scopeN(RRt __class__RRtTHROTTLE_RATEStscopetKeyError(Rtmsg((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR Us   cCse|d krd S|jdƒ\}}t|ƒ}idd6dd6dd6dd 6|d }||fS( u‰ Given the request rate string, return a two tuple of: , u/iusi<umiuhi€QudiN(NN(RRtint(RR!tnumtperiodR#R$((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR"ds   *cCsË|jdkrtS|j||ƒ|_|jdkr;tS|jj|jgƒ|_|jƒ|_ x7|jrž|jd|j |j krž|jj ƒqhWt |jƒ|j krÁ|jƒS|jƒS(u« Implement the check to see if the request should be throttled. On success calls `throttle_success`. On failure calls `throttle_failure`. iÿÿÿÿN(R!RtTrueR&tkeyRR thistoryttimertnowR$tpopRR#tthrottle_failuretthrottle_success(RRR ((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR ps) cCs9|jjd|jƒ|jj|j|j|jƒtS(ud Inserts the current request's timestamp along with the key into the cache. i(R1tinsertR3RtsetR0R$R/(R((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR6‰scCstS(uP Called when a request to the API has failed due to throttling. (tFalse(R((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR5’scCsh|jr'|j|j|jd}n |j}|jt|jƒd}|dkrZdS|t|ƒS(uG Returns the recommended next request time in seconds. iÿÿÿÿiiN(R1R$R3R#RRtfloat(Rtremaining_durationtavailable_requests((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR˜s   N(RRRt default_cacheRttimeR2t cache_formatRR)RtDEFAULT_THROTTLE_RATESR(R%R&R R"R R6R5R(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR5s       tAnonRateThrottlecBseZdZdZd„ZRS(u– Limits the rate of API calls that may be made by a anonymous users. The IP address of the request will be used as the unique cache key. uanoncCs8t|jƒrdS|ji|jd6|j|ƒd6S(Nuscopeuident(RtuserRR?R)R(RRR ((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR&°s   (RRRR)R&(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyRA¨stUserRateThrottlecBseZdZdZd„ZRS(uç Limits the rate of API calls that may be made by a given user. The user id will be used as a unique cache key if the user is authenticated. For anonymous requests, the IP address of the request will be used. uusercCsIt|jƒr|jj}n|j|ƒ}|ji|jd6|d6S(Nuscopeuident(RRBtpkRR?R)(RRR tident((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR&Äs   (RRRR)R&(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyRCºstScopedRateThrottlecBs/eZdZdZd„Zd„Zd„ZRS(u, Limits the rate of API calls by different amounts for various parts of the API. Any view that has the `throttle_scope` property set will be throttled. The unique cache key will be generated by concatenating the user id of the request, and the scope of the view being accessed. uthrottle_scopecCsdS(N((R((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR%ÙscCskt||jdƒ|_|js%tS|jƒ|_|j|jƒ\|_|_ t t |ƒj ||ƒS(N( Rt scope_attrRR)R/R R!R"R#R$tsuperRFR (RRR ((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR Þs  cCsIt|jƒr|jj}n|j|ƒ}|ji|jd6|d6S(uØ If `view.throttle_scope` is not set, don't apply this throttle. Otherwise generate the unique cache key by concatenating the user id with the '.throttle_scope` property of the view. uscopeuident(RRBRDRR?R)(RRR RE((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyR&îs   (RRRRGR%R R&(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyRFÐs   (Rt __future__RR>tdjango.core.cacheRR=tdjango.core.exceptionsRtrest_framework.compatRtrest_framework.settingsRtobjectRRRARCRF(((s;/tmp/pip-unpacked-wheel-62FVgP/rest_framework/throttling.pyts &s