o
    /hO                     @   s  d Z dZdZddlZddlZddlZddlZddlZddlZddl	m
Z
 G dd dZG d	d
 d
ejjZG dd deZG dd deZG dd deZG dd deZG dd deZG dd deZG dd deZedg dZe
jdddfddZe
jddfddZdS ) z0Extensible memoizing collections and decorators.)	Cache	FIFOCacheLFUCacheLRUCacheRRCache	TLRUCacheTTLCachecachedcachedmethodz6.1.0    N   )keysc                   @   s(   e Zd ZdZdd Zdd Zdd ZdS )	_DefaultSize c                 C      dS Nr   r   self_r   r   G/var/www/html/myenv/lib/python3.10/site-packages/cachetools/__init__.py__getitem__      z_DefaultSize.__getitem__c                 C   s   |dksJ d S r   r   )r   r   valuer   r   r   __setitem__!      z_DefaultSize.__setitem__c                 C   r   r   r   r   r   r   r   pop$   r   z_DefaultSize.popN)__name__
__module____qualname__	__slots__r   r   r   r   r   r   r   r      s
    r   c                   @   s   e Zd ZdZe Ze Zd!ddZdd Z	dd Z
d	d
 Zdd Zdd Zdd Zdd Zdd Zd!ddZefddZd!ddZedd Zedd Zedd  ZdS )"r   z?Mutable mapping to serve as a simple cache or cache base class.Nc                 C   s6   |r|| _ | j tj urt | _t | _d| _|| _d S Nr
   )	getsizeofr   dict_Cache__size_Cache__data_Cache__currsize_Cache__maxsizer   maxsizer    r   r   r   __init__/   s   
zCache.__init__c                 C   s   d| j jt| j| j| jf S )Nz%s(%s, maxsize=%r, currsize=%r))	__class__r   reprr#   r%   r$   r   r   r   r   __repr__8   s   zCache.__repr__c                 C   s*   z| j | W S  ty   | | Y S w N)r#   KeyError__missing__r   keyr   r   r   r   @   s
   zCache.__getitem__c                 C   s   | j }| |}||krtd|| jvs| j| |k r.| j| |kr.|   | j| |ks#|| jv r;|| j|  }n|}|| j|< || j|< |  j|7  _d S )Nzvalue too large)r%   r    
ValueErrorr#   r"   r$   popitem)r   r1   r   r'   sizediffsizer   r   r   r   F   s   



zCache.__setitem__c                 C   s&   | j |}| j|= |  j|8  _d S r-   )r"   r   r#   r$   )r   r1   r4   r   r   r   __delitem__V   s   zCache.__delitem__c                 C   s
   || j v S r-   )r#   r0   r   r   r   __contains__[      
zCache.__contains__c                 C   s   t |r-   )r.   r0   r   r   r   r/   ^   s   zCache.__missing__c                 C   
   t | jS r-   )iterr#   r+   r   r   r   __iter__a   r8   zCache.__iter__c                 C   r9   r-   )lenr#   r+   r   r   r   __len__d   r8   zCache.__len__c                 C   s   || v r| | S |S r-   r   )r   r1   defaultr   r   r   getg   s   z	Cache.getc                 C   s4   || v r| | }| |= |S || j u rt||}|S r-   )_Cache__markerr.   r   r1   r>   r   r   r   r   r   m   s   
z	Cache.popc                 C   s$   || v r
| | }|S | | |< }|S r-   r   rA   r   r   r   
setdefaultw   s
   zCache.setdefaultc                 C      | j S )zThe maximum size of the cache.)r%   r+   r   r   r   r'   ~      zCache.maxsizec                 C   rC   )zThe current size of the cache.)r$   r+   r   r   r   currsize   rD   zCache.currsizec                 C   r   )z+Return the size of a cache element's value.r   r   )r   r   r   r   r       s   zCache.getsizeofr-   )r   r   r   __doc__objectr@   r   r"   r(   r,   r   r   r6   r7   r/   r;   r=   r?   r   rB   propertyr'   rE   staticmethodr    r   r   r   r   r   (   s,    
	




r   c                   @   s>   e Zd ZdZdddZejfddZejfddZd	d
 ZdS )r   z/First In First Out (FIFO) cache implementation.Nc                 C      t | || t | _d S r-   )r   r(   collectionsOrderedDict_FIFOCache__orderr&   r   r   r   r(         zFIFOCache.__init__c                 C   s>   || || z	| j | W d S  ty   d | j |< Y d S w r-   )rM   move_to_endr.   r   r1   r   cache_setitemr   r   r   r      s   zFIFOCache.__setitem__c                 C      || | | j |= d S r-   )rM   r   r1   cache_delitemr   r   r   r6         
zFIFOCache.__delitem__c                 C   D   z	t t| j}W n ty   tdt| j dw || |fS )z9Remove and return the `(key, value)` pair first inserted.%s is emptyN)nextr:   rM   StopIterationr.   typer   r   r0   r   r   r   r3         zFIFOCache.popitemr-   )	r   r   r   rF   r(   r   r   r6   r3   r   r   r   r   r      s    
r   c                   @   sb   e Zd ZdZG dd dZdddZejfddZejfd	d
Zej	fddZ	dd Z
dd ZdS )r   z1Least Frequently Used (LFU) cache implementation.c                   @   s    e Zd ZdZdd Zdd ZdS )zLFUCache._Link)countr   rX   prevc                 C   s   || _ t | _d S r-   )r\   setr   )r   r\   r   r   r   r(      s   zLFUCache._Link.__init__c                 C      | j }| j}||_ ||_d S r-   rX   r]   r   rX   r]   r   r   r   unlink      
zLFUCache._Link.unlinkN)r   r   r   r   r(   rb   r   r   r   r   _Link   s    rd   Nc                 C   s4   t | || td | _}| |_|_i | _d S r   )r   r(   r   rd   _LFUCache__rootr]   rX   _LFUCache__links)r   r'   r    rootr   r   r   r(      s   
zLFUCache.__init__c                 C       || |}|| v r|  | |S r-   )_LFUCache__touchr   r1   cache_getitemr   r   r   r   r         

zLFUCache.__getitem__c                 C   sv   || || || j v r| |S | j}|j}|jdkr.td}|j|_| |_|j_||_|j	| || j |< d S r   )
rf   ri   re   rX   r\   r   rd   r]   r   add)r   r1   r   rQ   rg   linkr   r   r   r      s   



zLFUCache.__setitem__c                 C   s8   || | | j |}|j| |js|  d S d S r-   )rf   r   r   removerb   r   r1   rT   rn   r   r   r   r6      s   
zLFUCache.__delitem__c                 C   sD   | j }|j}||u rtdt| j dtt|j}|| |fS )z@Remove and return the `(key, value)` pair least frequently used.rW   N)re   rX   r.   rZ   r   r:   r   r   )r   rg   currr1   r   r   r   r3      s   zLFUCache.popitemc                 C   s   | j | }|j}|j|jd kr6t|jdkr | jd7  _dS t|jd }|j|_| |_|j_||_|j| |j	| |jsI|
  || j |< dS )zIncrement use countr   N)rf   rX   r\   r<   r   r   rd   r]   rm   ro   rb   )r   r1   rn   rq   r   r   r   __touch   s   
zLFUCache.__touchr-   )r   r   r   rF   rd   r(   r   r   r   r6   r3   ri   r   r   r   r   r      s    
	r   c                   @   sT   e Zd ZdZdddZejfddZejfddZejfd	d
Zdd Z	dd Z
dS )r   z/Least Recently Used (LRU) cache implementation.Nc                 C   rJ   r-   )r   r(   rK   rL   _LRUCache__orderr&   r   r   r   r(      rN   zLRUCache.__init__c                 C   rh   r-   _LRUCache__touchrj   r   r   r   r      rl   zLRUCache.__getitem__c                 C   s   || || |  | d S r-   rt   rP   r   r   r   r     s   zLRUCache.__setitem__c                 C   rR   r-   )rs   rS   r   r   r   r6     rU   zLRUCache.__delitem__c                 C   rV   )z>Remove and return the `(key, value)` pair least recently used.rW   N)rX   r:   rs   rY   r.   rZ   r   r   r0   r   r   r   r3     r[   zLRUCache.popitemc                 C   s2   z	| j | W dS  ty   d| j |< Y dS w )zMark as recently usedN)rs   rO   r.   r0   r   r   r   rr     s
   zLRUCache.__touchr-   )r   r   r   rF   r(   r   r   r   r6   r3   ru   r   r   r   r   r      s    
	r   c                   @   s4   e Zd ZdZejdfddZedd Zdd ZdS )	r   z-Random Replacement (RR) cache implementation.Nc                 C   s   t | || || _d S r-   )r   r(   _RRCache__choice)r   r'   choicer    r   r   r   r(      s   
zRRCache.__init__c                 C   rC   )z(The `choice` function used by the cache.)rv   r+   r   r   r   rw   $  rD   zRRCache.choicec                 C   sD   z	|  t| }W n ty   tdt| j dw || |fS )z/Remove and return a random `(key, value)` pair.rW   N)rv   list
IndexErrorr.   rZ   r   r   r0   r   r   r   r3   )  r[   zRRCache.popitem)	r   r   r   rF   randomrw   r(   rH   r3   r   r   r   r   r     s    
r   c                       s   e Zd ZdZG dd dZejdfddZej	fddZ	ej
fd	d
Z
e fddZedd Zdd Zdd Zdd Zdd Z  ZS )_TimedCachez0Base class for time aware cache implementations.c                   @   s<   e Zd Zdd Zdd Zdd Zdd Zd	d
 Zdd ZdS )z_TimedCache._Timerc                 C   s   || _ d| _d S r   )_Timer__timer_Timer__nesting)r   timerr   r   r   r(   7     
z_TimedCache._Timer.__init__c                 C   s   | j dkr	|  S | jS r   r}   r|   _Timer__timer+   r   r   r   __call__;  s   
z_TimedCache._Timer.__call__c                 C   s2   | j dkr|   | _}n| j}|  j d7  _ |S )Nr
   r   r   r   timer   r   r   	__enter__A  s
   
z_TimedCache._Timer.__enter__c                 G   s   |  j d8  _ d S r   )r}   )r   excr   r   r   __exit__I     z_TimedCache._Timer.__exit__c                 C   s   t j| jffS r-   )r{   _Timerr|   r+   r   r   r   
__reduce__L     z_TimedCache._Timer.__reduce__c                 C   s   t | j|S r-   )getattrr|   )r   namer   r   r   __getattr__O     z_TimedCache._Timer.__getattr__N)	r   r   r   r(   r   r   r   r   r   r   r   r   r   r   6  s    r   Nc                 C   s   t | || t|| _d S r-   )r   r(   r{   r   _TimedCache__timer)r   r'   r~   r    r   r   r   r(   R  s   z_TimedCache.__init__c                 C   <   | j }| | || W  d    S 1 sw   Y  d S r-   r   expire)r   
cache_reprr   r   r   r   r,   V     
$z_TimedCache.__repr__c                 C   r   r-   r   )r   	cache_lenr   r   r   r   r=   [  r   z_TimedCache.__len__c                    s<   | j }| | t jW  d    S 1 sw   Y  d S r-   )r   r   superrE   r   r)   r   r   rE   `  s   
$z_TimedCache.currsizec                 C   rC   )z%The timer function used by the cache.)r   r+   r   r   r   r~   f  rD   z_TimedCache.timerc                 C   s@   | j }| | t|  W d    d S 1 sw   Y  d S r-   )r   r   r   clearr   r   r   r   r   k  s   
"z_TimedCache.clearc                 O   B   | j  tj| g|R i |W  d    S 1 sw   Y  d S r-   )r   r   r?   r   argskwargsr   r   r   r?   p     $z_TimedCache.getc                 O   r   r-   )r   r   r   r   r   r   r   r   t  r   z_TimedCache.popc                 O   r   r-   )r   r   rB   r   r   r   r   rB   x  r   z_TimedCache.setdefault)r   r   r   rF   r   r   	monotonicr(   r   r,   r=   rH   rE   r~   r   r?   r   rB   __classcell__r   r   r   r   r{   3  s    
r{   c                   @   s   e Zd ZdZG dd dZejdfddZdd Ze	j
fd	d
Z
e	jfddZe	jfddZdd Zdd Zedd ZdddZdd Zdd ZdS )r   z@LRU Cache implementation with per-item time-to-live (TTL) value.c                   @   s*   e Zd ZdZd	ddZdd Zdd ZdS )
zTTLCache._Link)r1   expiresrX   r]   Nc                 C   s   || _ || _d S r-   )r1   r   r   r1   r   r   r   r   r(     r   zTTLCache._Link.__init__c                 C   s   t j| j| jffS r-   )r   rd   r1   r   r+   r   r   r   r     r   zTTLCache._Link.__reduce__c                 C   r_   r-   r`   ra   r   r   r   rb     rc   zTTLCache._Link.unlinkNN)r   r   r   r   r(   r   rb   r   r   r   r   rd     s
    
rd   Nc                 C   s>   t | ||| t  | _}| |_|_t | _	|| _
d S r-   )r{   r(   r   rd   _TTLCache__rootr]   rX   rK   rL   _TTLCache__links_TTLCache__ttl)r   r'   ttlr~   r    rg   r   r   r   r(     s
   

zTTLCache.__init__c                 C   2   z| j | }W n
 ty   Y dS w |  |jk S NF)r   r.   r~   r   )r   r1   rn   r   r   r   r7        zTTLCache.__contains__c                 C   N   z|  |}W n ty   d}Y n	w |  |jk  }|r"| |S || |S r   )_TTLCache__getlinkr.   r~   r   r/   )r   r1   rk   rn   expiredr   r   r   r        

zTTLCache.__getitem__c                 C   s   | j }| | || || W d    n1 sw   Y  z| |}W n ty8   t| | j|< }Y nw |  || j |_	| j
 |_}|j |_}| |_|_d S r-   )r~   r   r   r.   r   rd   r   rb   r   r   r   rX   r]   )r   r1   r   rQ   r   rn   rg   r]   r   r   r   r     s   
zTTLCache.__setitem__c                 C   s8   || | | j |}|  |  |jk st|d S r-   )r   r   rb   r~   r   r.   rp   r   r   r   r6     s   
zTTLCache.__delitem__c                 c   sd    | j }|j}||ur0| j}||jk r|jV  W d    n1 s"w   Y  |j}||usd S d S r-   )r   rX   r~   r   r1   )r   rg   rq   r   r   r   r   r;     s   
zTTLCache.__iter__c                 C   sj   | j | | j}| |_|_t| j dd dD ]}||_|j |_}| |_|_q| | 	  d S )Nc                 S   rC   r-   r   )objr   r   r   <lambda>  s    z'TTLCache.__setstate__.<locals>.<lambda>)r1   )
__dict__updater   r]   rX   sortedr   valuesr   r~   )r   staterg   rn   r]   r   r   r   __setstate__  s   zTTLCache.__setstate__c                 C   rC   )z,The time-to-live value of the cache's items.)r   r+   r   r   r   r     rD   zTTLCache.ttlc           	      C   s   |du r|   }| j}|j}| j}g }tj}tj}||urJ||jk sJ||j	|| |j	f || |j	 ||j	= |j}|
  |}||urJ||jk r"|S )qRemove expired items from the cache and return an iterable of the
        expired `(key, value)` pairs.

        N)r~   r   rX   r   r   r6   r   r   appendr1   rb   )	r   r   rg   rq   linksr   rT   rk   rX   r   r   r   r     s"   zTTLCache.expirec              	   C   sx   | j /}| | z	tt| j}W n ty#   tdt| j dw || 	|fW  d   S 1 s5w   Y  dS zmRemove and return the `(key, value)` pair least recently used that
        has not already expired.

        rW   N)
r~   r   rX   r:   r   rY   r.   rZ   r   r   r   r   r1   r   r   r   r3     s   
$zTTLCache.popitemc                 C      | j | }| j | |S r-   )r   rO   r   r1   r   r   r   r   	__getlink     
zTTLCache.__getlinkr-   )r   r   r   rF   rd   r   r   r(   r7   r   r   r   r6   r;   r   rH   r   r   r3   r   r   r   r   r   r   }  s    



r   c                   @   s   e Zd ZdZejG dd dZejdfddZ	dd Z
ejfd	d
ZejfddZejfddZdd Zedd ZdddZdd Zdd ZdS )r   z;Time aware Least Recently Used (TLRU) cache implementation.c                   @   s"   e Zd ZdZdddZdd ZdS )zTLRUCache._Itemr1   r   removedNc                 C   s   || _ || _d| _d S r   r   r   r   r   r   r(     s   
zTLRUCache._Item.__init__c                 C   s   | j |j k S r-   r   )r   otherr   r   r   __lt__  r   zTLRUCache._Item.__lt__r   )r   r   r   r   r(   r   r   r   r   r   _Item  s    
r   Nc                 C   s*   t | ||| t | _g | _|| _d S r-   )r{   r(   rK   rL   _TLRUCache__items_TLRUCache__order_TLRUCache__ttu)r   r'   ttur~   r    r   r   r   r(     s   

zTLRUCache.__init__c                 C   r   r   )r   r.   r~   r   )r   r1   itemr   r   r   r7     r   zTLRUCache.__contains__c                 C   r   r   )_TLRUCache__getitemr.   r~   r   r/   )r   r1   rk   r   r   r   r   r   r   !  r   zTLRUCache.__getitem__c                 C   s   | j '}| |||}||k s	 W d    d S | | || || W d    n1 s-w   Y  zd| |_W n	 tyC   Y nw t|| | j|< }t	
| j| d S NT)r~   r   r   r   r   r.   r   r   r   heapqheappushr   )r   r1   r   rQ   r   r   r   r   r   r   r   -  s   
zTLRUCache.__setitem__c                 C   sX   | j }|| | W d    n1 sw   Y  | j|}d|_||jk s*t|d S r   )r~   r   r   r   r   r.   )r   r1   rT   r   r   r   r   r   r6   =  s   
zTLRUCache.__delitem__c              	   c   sP    | j D ]!}| j}||jk r|js|jV  W d    n1 s w   Y  qd S r-   )r   r~   r   r   r1   )r   rq   r   r   r   r   r;   F  s   
zTLRUCache.__iter__c                 C   rC   )z1The local time-to-use function used by the cache.)r   r+   r   r   r   r   M  rD   zTLRUCache.ttuc                 C   s   |du r|   }| j}| j}t|t|d kr'dd |D  | _}t| g }tj}tj}|ri|d j	s=||d j
k sit|}|j	s[||j|| |jf || |j ||j= |ri|d j	s=||d j
k r=|S )r   N   c                 S   s   g | ]}|j s|qS r   )r   ).0r   r   r   r   
<listcomp>]  s    z$TLRUCache.expire.<locals>.<listcomp>r
   )r~   r   r   r<   r   heapifyr   r6   r   r   r   heappopr   r1   )r   r   itemsorderr   rT   rk   r   r   r   r   r   R  s$   

zTLRUCache.expirec              	   C   sv   | j .}| | z	tt| j}W n ty"   td| jj dw || 	|fW  d   S 1 s4w   Y  dS r   )
r~   r   rX   r:   r   rY   r.   r)   r   r   r   r   r   r   r3   j  s   
$zTLRUCache.popitemc                 C   r   r-   )r   rO   r   r   r   r   	__getitemx  r   zTLRUCache.__getitemr-   )r   r   r   rF   	functoolstotal_orderingr   r   r   r(   r7   r   r   r   r6   r;   rH   r   r   r3   r   r   r   r   r   r     s    	

r   	CacheInfo)hitsmissesr'   rE   Fc                    sR   ddl m  ttrddlm} |dtdd d fd	d
}|S )z_Decorator to wrap a function with a memoizing callable that saves
    results in a cache.

    r   _wrapperr
   )warnz4passing `info` as positional parameter is deprecatedr   )
stacklevelNc                    sd   r*t trfdd}nt tjjrfdd}ndd } | |dS  | S )Nc                    s   t | | j jS r-   )
_CacheInfor'   rE   r   r   cacher   r   	make_info  r   z,cached.<locals>.decorator.<locals>.make_infoc                    s   t | |d t S r-   )r   r<   r   r   r   r   r     r   c                 S   s   t | |ddS r   )r   r   r   r   r   r     r   )info)
isinstancer   rK   abcMapping)funcr   r   r   	conditionr   r1   lockr   r   	decorator  s   
zcached.<locals>.decorator)_cachedr   r   boolwarningsr   DeprecationWarning)r   r1   r   r   r   r   r   r   r   r   r     s   
r   c                    s$   ddl m   fdd}|S )zoDecorator to wrap a class or instance method with a memoizing
    callable that saves results in a cache.

    r   r   c                    s    | S r-   r   )methodr   r   r   r1   r   r   r   r     r   zcachedmethod.<locals>.decorator)_cachedmethodr   )r   r1   r   r   r   r   r   r   r	     s   r	   )rF   __all____version__rK   collections.abcr   r   rz   r    r   r   r   MutableMappingr   r   r   r   r   r{   r   r   
namedtupler   hashkeyr   	methodkeyr	   r   r   r   r   <module>   s2    fM&J z*