o
    `^h+A                     @   s  d Z ddlm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	Z	ddl
Z
ddlZddlZddlZddlmZmZ ddlmZ ddlmZmZmZ ddlmZ dd	lmZ ed
dZG dd deZdd ZG dd dedZ G dd de!Z"G dd de e"Z#dS )z.Storage providers backends for Memory caching.    )PicklingErrorN)ABCMetaabstractmethod   )concurrency_safe_rename)mkdirpmemstr_to_bytes
rm_subdirs)format_time)numpy_pickleCacheItemInfozpath size last_accessc                   @   s   e Zd ZdZdS )CacheWarningz:Warning to capture dump failures except for PicklingError.N)__name__
__module____qualname____doc__ r   r   T/home/air/shanriGPT/back/venv/lib/python3.10/site-packages/joblib/_store_backends.pyr      s    r   c                 C   s,   t t }d||t }|| | |S )z>Writes an object into a unique file in a concurrency-safe way.z{}.thread-{}-pid-{})id	threadingcurrent_threadformatosgetpid)object_to_writefilename
write_func	thread_idtemporary_filenamer   r   r   concurrency_safe_write   s   

r   c                   @   sp   e Zd ZdZdZedd Zedd Zedd Zed	d
 Z	edd Z
edd Zede fddZdS )StoreBackendBasezaHelper Abstract Base Class which defines all methods that
       a StorageBackend must implement.Nc                 C      dS )a  Opens an item on the store and return a file-like object.

        This method is private and only used by the StoreBackendMixin object.

        Parameters
        ----------
        f: a file-like object
            The file-like object where an item is stored and retrieved
        mode: string, optional
            the mode in which the file-like object is opened allowed valued are
            'rb', 'wb'

        Returns
        -------
        a file-like object
        Nr   )selffmoder   r   r   
_open_item/       zStoreBackendBase._open_itemc                 C   r!   )a  Checks if an item location exists in the store.

        This method is private and only used by the StoreBackendMixin object.

        Parameters
        ----------
        location: string
            The location of an item. On a filesystem, this corresponds to the
            absolute path, including the filename, of a file.

        Returns
        -------
        True if the item exists, False otherwise
        Nr   r"   locationr   r   r   _item_existsB   r&   zStoreBackendBase._item_existsc                 C   r!   )a-  Moves an item from src to dst in the store.

        This method is private and only used by the StoreBackendMixin object.

        Parameters
        ----------
        src: string
            The source location of an item
        dst: string
            The destination location of an item
        Nr   )r"   srcdstr   r   r   
_move_itemS   r&   zStoreBackendBase._move_itemc                 C   r!   )zCreates a location on the store.

        Parameters
        ----------
        location: string
            The location in the store. On a filesystem, this corresponds to a
            directory.
        Nr   r'   r   r   r   create_locationa   r&   z StoreBackendBase.create_locationc                 C   r!   )zClears a location on the store.

        Parameters
        ----------
        location: string
            The location in the store. On a filesystem, this corresponds to a
            directory or a filename absolute path
        Nr   r'   r   r   r   clear_locationl   r&   zStoreBackendBase.clear_locationc                 C   r!   )zReturns the whole list of items available in the store.

        Returns
        -------
        The list of items identified by their ids (e.g filename in a
        filesystem).
        Nr   r"   r   r   r   	get_itemsw   r&   zStoreBackendBase.get_itemsr   c                 C   r!   )a  Configures the store.

        Parameters
        ----------
        location: string
            The base location used by the store. On a filesystem, this
            corresponds to a directory.
        verbose: int
            The level of verbosity of the store
        backend_options: dict
            Contains a dictionary of named parameters used to configure the
            store backend.
        Nr   )r"   r(   verbosebackend_optionsr   r   r   	configure   r&   zStoreBackendBase.configure)r   r   r   r   r(   r   r%   r)   r,   r-   r.   r0   dictr3   r   r   r   r   r    )   s"    







	r    )	metaclassc                   @   s   e Zd ZdZd&dd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dZdd Zdd Zdd Z	d)ddZ	d)d d!Zd"d# Zd$d% ZdS )*StoreBackendMixina  Class providing all logic for managing the store in a generic way.

    The StoreBackend subclass has to implement 3 methods: create_location,
    clear_location and configure. The StoreBackend also has to provide
    a private _open_item, _item_exists and _move_item methods. The _open_item
    method has to have the same signature as the builtin open and return a
    file-like object.
    r   Nc                 C   sL  t jj| jg|R  }|dkr_|durdtt | nd}t j|d }|durEd|v rEddd	 |d  D }|d
|7 }d||}	|dk rWt	d|	 nt	d|	| t
| dsfdn| j}
t j|d}| |s{td| |
du r| |d}t|}W d   |S 1 sw   Y  |S tj||
d}|S )z:Load an item from the store given its id as a list of str.r   Nz{: <16} r   
input_argsz, c                 s   s    | ]}d j | V  qdS )z{}={}N)r   .0itemr   r   r   	<genexpr>   s    z.StoreBackendMixin.load_item.<locals>.<genexpr>z({})z[Memory]{}: Loading {}
   z{0}...z{0} from {1}	mmap_mode
output.pklzANon-existing item (may have been cleared).
File %s does not existrb)r>   )r   pathjoinr(   r   r
   timebasenameitemsprinthasattrr>   r)   KeyErrorr%   r   load)r"   call_idr1   	timestampmetadata	full_path	ts_string	signaturekwargsmsgr>   r   r#   r;   r   r   r   	load_item   sB   



zStoreBackendMixin.load_itemc              
      s   z6t jj jg|R  } |s | t j|d}|dkr'td|   fdd} ||| W dS  tyS } zt	
d| dt W Y d}~dS d}~ww )	z;Dump an item in the store at the id given as a list of str.r?   r=   zPersisting in %sc                    s     |d9}ztj| | jd W n ty. } ztd| dt W Y d }~nd }~ww W d    d S W d    d S 1 sBw   Y  d S )Nwb)compresszjUnable to cache to disk: failed to pickle output. In version 1.5 this will raise an exception. Exception: .)r%   r   dumprT   r   warningswarnFutureWarning)to_writedest_filenamer#   er/   r   r   r      s    "z/StoreBackendMixin.dump_item.<locals>.write_funcz`Unable to cache to disk. Possibly a race condition in the creation of the directory. Exception: rU   N)r   rA   rB   r(   r)   r-   rF   _concurrency_safe_write	ExceptionrW   rX   r   )r"   rJ   r;   r1   	item_pathr   r   r\   r   r/   r   	dump_item   s$   

zStoreBackendMixin.dump_itemc                 C   2   t jj| jg|R  }| |r| | dS dS )z1Clear the item at the id, given as a list of str.Nr   rA   rB   r(   r)   r.   )r"   rJ   r_   r   r   r   
clear_item      
zStoreBackendMixin.clear_itemc                 C   s.   t jj| jg|R  }t j|d}| |S )z<Check if there is an item at the id, given as a list of str.r?   )r   rA   rB   r(   r)   )r"   rJ   r_   r   r   r   r   contains_item   s   
zStoreBackendMixin.contains_itemc                 C      dt jj| jg|R  iS )zReturn information about item.r(   r   rA   rB   r(   r"   rJ   r   r   r   get_item_info      zStoreBackendMixin.get_item_infoc                 C   s|   z6t jj| jg|R  }t j|d}| |d}t| dW  d   W S 1 s/w   Y  W dS    i  Y S )z"Return actual metadata of an item.metadata.jsonr@   utf-8N)	r   rA   rB   r(   r%   jsonloadsreaddecode)r"   rJ   r_   r   r#   r   r   r   get_metadata   s   (zStoreBackendMixin.get_metadatac                    s\   z't jj jg|R  } | t j|d} fdd} ||| W dS    Y dS )z Store metadata of a computation.rk   c                    sH     |d}|t| d W d    d S 1 sw   Y  d S )NrS   rl   )r%   writerm   dumpsencode)rZ   r[   r#   r/   r   r   r      s   "z4StoreBackendMixin.store_metadata.<locals>.write_funcN)r   rA   rB   r(   r-   r]   )r"   rJ   rL   r_   r   r   r   r/   r   store_metadata   s   
z StoreBackendMixin.store_metadatac                 C   s    t jj| jg|R  }| |S )z,Check cached function is available in store.)r   rA   rB   r(   object_existsr"   rJ   	func_pathr   r   r   contains_path  s   
zStoreBackendMixin.contains_pathc                 C   ra   )z0Clear all items with a common path in the store.Nrb   rw   r   r   r   
clear_path  rd   zStoreBackendMixin.clear_pathc                 C   s   t jj| jg|R  }| |s| | |durAt j|d}| |d}||d W d   dS 1 s:w   Y  dS dS )&Store the code of the cached function.Nfunc_code.pyrS   rl   )	r   rA   rB   r(   r)   r-   r%   rr   rt   )r"   rJ   	func_coderx   r   r#   r   r   r   store_cached_func_code  s   

"z(StoreBackendMixin.store_cached_func_codec                 C   sf   t jj| jg|dR  }z!| |d}| dW  d   W S 1 s'w   Y  W dS     )r{   r|   r@   rl   N)r   rA   rB   r(   r%   ro   rp   )r"   rJ   r   r#   r   r   r   get_cached_func_code  s   (z&StoreBackendMixin.get_cached_func_codec                 C   rf   )z?Return information related to the cached function if it exists.r(   rg   rh   r   r   r   get_cached_func_info&  rj   z&StoreBackendMixin.get_cached_func_infoc                 C   s   |  | j dS )zClear the whole store content.N)r.   r(   r/   r   r   r   clear*  s   zStoreBackendMixin.clearc              	   C   sV   |  |||}|D ]}| jdkrtd| z| |j W q	 ty(   Y q	w dS )zX
        Remove the store's oldest files to enforce item, byte, and age limits.
        r=   zDeleting item {0}N)_get_items_to_deleter1   rF   r   r.   rA   OSError)r"   bytes_limititems_limit	age_limititems_to_deleter;   r   r   r   enforce_store_limits.  s   
z&StoreBackendMixin.enforce_store_limitsc                 C   s&  t |tr	t|}|  }|sg S tdd |D }|dur#|| }nd}|dur0t|| }nd}|durGtdd |D }tj | }	nd}	|dkr[|dkr[|	du sY||	kr[g S |j	t
dd g }
d}d}|D ]$}||kr||kr|	du s|	|jk r |
S |
| ||j7 }|d7 }ql|
S )	zW
        Get items to delete to keep the store under size, file, & age limits.
        c                 s       | ]}|j V  qd S N)sizer9   r   r   r   r<   Q      z9StoreBackendMixin._get_items_to_delete.<locals>.<genexpr>Nr   c                 s   r   r   )last_accessr9   r   r   r   r<   ^  r   r   )keyr   )
isinstancestrr   r0   sumlenmindatetimenowsortoperator
attrgetterr   appendr   )r"   r   r   r   rE   r   to_delete_sizeto_delete_items
older_itemdeadliner   size_so_faritems_so_farr;   r   r   r   r   D  sB   




z&StoreBackendMixin._get_items_to_deletec                 C   s   t |||}| || dS )z7Writes an object into a file in a concurrency-safe way.N)r   r,   )r"   rZ   r   r   r   r   r   r   r]     s   z)StoreBackendMixin._concurrency_safe_writec                 C   s   dj | jj| jdS )z/Printable representation of the store location.z#{class_name}(location="{location}"))
class_namer(   )r   	__class__r   r(   r/   r   r   r   __repr__  s   
zStoreBackendMixin.__repr__)r   NN)r   r   )NN)r   r   r   r   rR   r`   rc   re   ri   rq   ru   ry   rz   r~   r   r   r   r   r   r]   r   r   r   r   r   r6      s*    
	
"

	

;r6   c                   @   sN   e Zd ZdZeeZeejj	Z
eeZdd Zdd Zdd Zdd
dZd	S )FileSystemStoreBackendz7A StoreBackend used with local or network file systems.c                 C   s(   || j krt| dS tj|dd dS )zDelete location on store.T)ignore_errorsN)r(   r	   shutilrmtreer'   r   r   r   r.     s   
z%FileSystemStoreBackend.clear_locationc                 C   s   t | dS )zCreate object location on storeN)r   r'   r   r   r   r-     s   z&FileSystemStoreBackend.create_locationc           	         s   g }t | jD ]j\ }}tdt j }|rrt j d}zt j|}W n t	yD   zt j }W n
 t	yA   Y Y qw Y nw t
j
|}z fdd|D }tdd |D }W n	 t	yh   Y qw |t || q|S )z7Returns the whole list of items available in the store.z[a-f0-9]{32}r?   c                    s   g | ]	}t j |qS r   )r   rA   rB   r:   fndirpathr   r   
<listcomp>  s    z4FileSystemStoreBackend.get_items.<locals>.<listcomp>c                 s   s    | ]	}t j|V  qd S r   )r   rA   getsizer   r   r   r   r<     s    z3FileSystemStoreBackend.get_items.<locals>.<genexpr>)r   walkr(   rematchrA   rD   rB   getatimer   r   fromtimestampr   r   r   )	r"   rE   _	filenamesis_cache_hash_diroutput_filenamer   full_filenamesdirsizer   r   r   r0     sB   


z FileSystemStoreBackend.get_itemsr   Nc                 C   sn   |du ri }|| _ tj| j st| j  |dd| _|d}| jr/|dur/tjddd || _	|| _
dS )zsConfigure the store backend.

        For this backend, valid store options are 'compress' and 'mmap_mode'
        NrT   Fr>   zSCompressed items cannot be memmapped in a filesystem store. Option will be ignored.   )
stacklevel)r(   r   rA   existsr   getrT   rW   rX   r>   r1   )r"   r(   r1   r2   r>   r   r   r   r3     s   


z FileSystemStoreBackend.configure)r   N)r   r   r   r   staticmethodopenr%   r   rA   r   r)   r   r,   r.   r-   r0   r3   r   r   r   r   r     s    $r   )$r   pickler   r   r   os.pathr   rm   r   rC   rW   collectionsr   r   abcr   r   	backportsr   diskr   r   r	   loggerr
   r7   r   
namedtupler   Warningr   r   r    objectr6   r   r   r   r   r   <module>   s6    
i z