File: //opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/lazy.cpython-310.pyc
o
�N�g5 � @ sF d Z ddlZddlmZ ddlZe�e�Zdd� Z G dd� de�Z
dS )zC
Lazily-evaluated data structures, primarily used by Salt's loader
� N)�MutableMappingc C s. |st j�d��|| vrt j�| �|���dS )z6
Check that the function passed really exists
z-Must specify a function to run!
ex: manage.upN)�salt�
exceptionsZSaltInvocationErrorZCommandExecutionError�missing_fun_string)Zlazy_objZfun� r �C/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/lazy.py�
verify_fun
s ��r c @ sx e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd S ) �LazyDicta
A base class of dict which will lazily load keys once they are needed
TODO: negative caching? If you ask for 'foo' and it doesn't exist it will
look EVERY time unless someone calls load_all()
As of now this is left to the class which inherits from this base
c C s | � � d S �N)�clear��selfr r r �__init__# � zLazyDict.__init__c C s t | jp| j �S r
)�bool�_dict�loadedr r r r � __nonzero__& s zLazyDict.__nonzero__c C s | � � S r
)r r r r r �__bool__* s zLazyDict.__bool__c C s t | dt�� | _d| _dS )z
Clear the dict
Zmod_dict_classFN)�getattr�dictr r r r r r r . s
zLazyDict.clearc C � t � �)z3
Load a single item if you have it
��NotImplementedError�r
�keyr r r �_load8 � zLazyDict._loadc C r )z"
Load all of them
r r r r r � _load_all> r zLazyDict._load_allc C s dS )zT
Whether or not the key is missing (meaning we know it's not there)
Fr r r r r �_missingD s zLazyDict._missingc C s d|� d�S )z�
Return the error string for a missing function.
Override this to return a more meaningfull error message if possible
�'z' is not available.r )r
Z
function_namer r r r J s zLazyDict.missing_fun_stringc C s || j |< d S r
�r )r
r �valr r r � __setitem__R s zLazyDict.__setitem__c C s | j |= d S r
r! r r r r � __delitem__U r zLazyDict.__delitem__c C sh | � |�r t|��|| jvr/| js/| �|�r!t�d|� | j| S t�d|| �|�� t|��| j| S )z?
Check if the key is ttld out, then do the get
z
LazyLoaded %szCould not LazyLoad %s: %s)r �KeyErrorr r r �log�debugr r r r r � __getitem__X s
�
zLazyDict.__getitem__c C � | j s| �� t| j�S r
)r r �lenr r r r r �__len__l s
zLazyDict.__len__c C r) r
)r r �iterr r r r r �__iter__r s
zLazyDict.__iter__N)�__name__�
__module__� __qualname__�__doc__r r r r r r r r r# r$ r( r+ r- r r r r r s
r ) r1 �logging�collections.abcr Zsalt.exceptionsr � getLoggerr. r& r r r r r r �<module> s