wcRdZddlmZddlmZddlmZmZmZm Z m Z ddl Z ddl m Z mZmZddlmZdd lmZmZeeZd dd dd d ddef dede dedeeefdeededdedede efdZdZedZedZde efdZdefdZd Z d#defd!Z!efde efd"Z"dS)$aUtilities for patching ``requests``. .. warning:: These functions are not thread-safe. Use :py:class:`.CachedSession` if you want to use caching in a multi-threaded environment. .. automodsumm:: requests_cache.patcher :functions-only: :nosignatures: )contextmanager) getLogger)CallableDictIterableOptionalTypeN)BackendSpecifier BaseCache init_backend)ExpirationTime) CachedSessionOriginalSession http_cache))GETHEADF cache_namebackend expire_afterurls_expire_afterallowable_codesallowable_methodsstr filter_fnstale_if_errorsession_factoryc  tfi G f dd|} t| dS)a Install the cache for all ``requests`` functions by monkey-patching :py:class:`requests.Session` Example: >>> requests_cache.install_cache('demo_cache') Accepts all the same parameters as :py:class:`.CachedSession`. Additional parameters: Args: session_factory: Session class to use. It must inherit from either :py:class:`.CachedSession` or :py:class:`.CacheMixin` c 2 eZdZ f dZxZS)/install_cache.._ConfiguredCachedSessionc L tjd  ddS)N)rrrrrrrr)super__init__) self __class__rrrrrrkwargsrrs 8/usr/lib/python3/dist-packages/requests_cache/patcher.pyr&z8install_cache.._ConfiguredCachedSession.__init__3sT EGG  %)"3 /"3#-       )__name__ __module__ __qualname__r& __classcell__) r(rrrrrrr)rrs @r*_ConfiguredCachedSessionr"2sf                  r+r0N)r _patch_session_factory) rrrrrrrrrr)r0s ```````` ` r* install_cacher2s2:w99&99G               ?   344444r+c.ttdS)zHDisable the cache by restoring the original :py:class:`requests.Session`N)r1rr$r+r*uninstall_cacher4Cs?+++++r+c#Ktj}t dVt|dS#t|wxYw)z Context manager for temporarily disabling caching for all ``requests`` functions Example: >>> with requests_cache.disabled(): ... requests.get('http://httpbin.org/get') N)requestsSessionr4r1)previouss r*disabledr9HsSH) x(((((x((((s 3Ac/nKt|i| dVtdS#twxYw)a Context manager for temporarily enabling caching for all ``requests`` functions Accepts the same arguments as :py:func:`.install_cache`. Example: >>> with requests_cache.enabled('cache_db'): ... requests.get('http://httpbin.org/get') N)r2r4)argsr)s r*enabledr<[sM4"6""" s$4returncFttjddS)zUGet the internal cache object from the currently installed ``CachedSession`` (if any)cacheN)getattrr6r7r$r+r* get_cacherAos 8#%%w 5 55r+cNttjtS)z=Indicate whether or not requests-cache is currently installed) isinstancer6r7rr$r+r* is_installedrDts h&((- 8 88r+cftr"tdSdS)z,Clear the currently installed cache (if any)N)rAclearr$r+r*rFrFys4{{ r+ctj}t|tr||dSdS)zRemove expired responses from the cache, optionally with revalidation Args: expire_after: A new expiration time used to revalidate the cache N)r6r7rCrremove_expired_responses)rsessions r*rHrHsH   G'=))7((6666677r+ctd|j|xt_tj_dS)Nz&Patching requests.Session with class: )loggerdebugr,r6r7sessions)rs r*r1r1s9 LLT/:RTTUUU3BBHx(000r+)N)#__doc__ contextlibrloggingrtypingrrrrr r6backendsr r r policyrrIrrr,rKrintboolr2r4r9r<rArDrFrHr1r$r+r*rVsP&%%%%%;;;;;;;;;;;;;;??????????""""""33333333 8  # $#%37%+)8 -:)5)5)5 )5!)5C/0 )5 c] )5   )5)5)5/*)5)5)5)5X,,, )))$&68I&6666 9d9999  77>7777ERCCD,ACCCCCCr+