o

�N�gs	�@s<dZd
dl
Z
d
dlZd
dlZd
dd�
Zddd�
Zdd	�ZdS)z$
Helpful generators and other tools
�Nccs��t�
|
d
ur	dnt�|
�
�
}d}t|�
}	|�||�}|s3||ks&|
d
u
r1||d
�}|r1|V
d
S||��ks=|
d
u
rF|||���V
|��}q)z�
    Generator function for iterating through large strings, particularly useful
    as a replacement for str.splitlines().

    See http://stackoverflow.com/a/3865367
    Nz\s+r
)�re�compile�escape�len�search�start�end)�orig�sep�exp�pos�length�match�val�r�H/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/itertools.py�splits �











�r�ccs��z
|
t|
�
kr
t
�
Wnt
y


t
d
�
�
wz9	z|�|
�
}Wnty6


tjj�|d�}|�|
�
}Yn
w|s:n|V
qWz|��
WdStyP


YdSwz|��
Wwty`


Yww)zc
    Generator that reads chunk_size bytes at a time from a file/filehandle and
    yields it.
    zchunk_size must be an integerT�rbN)	�int�
ValueError�read�AttributeError�salt�utils�filesZfopen�close)Zfh_Z
chunk_size�chunkrrr�	read_file%s>�

�
�




�

�


��


�rc	Cs\zt|�
}Wn
t
y


Yd
Sw|D]}z
t�||
�r!|W
SWqt
y+


Yqwd
S)z�
    Convenience function which runs fnmatch.fnmatch() on each element of passed
    iterable. The first matching candidate is returned, or None if there is no
    matching candidate.
    N)�iter�	TypeError�fnmatch)Z
candidates�patternZcandidates_iter�	candidaterrr�fnmatch_multipleAs


�



�
�r$)
N)
r)�__doc__r!rZsalt.utils.filesrrrr$rrrr�<module>
s