| Server IP : 198.38.94.13 / Your IP : 216.73.217.33 Web Server : Apache System : Linux d4744.dxb1.stableserver.net 5.14.0-611.49.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Apr 21 16:39:08 EDT 2026 x86_64 User : revivere ( 1140) PHP Version : 8.2.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/ |
Upload File : |
o
;j�C � @ sz d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl m Z e�
e�Ze d�d9dd��Zd:dd �Zd:d
d �Ze d �e d
�dd
� ��Zdd� Zdd� Zdd� Ze d�dd� �Zdd� Ze d�d;dd ��Ze d �d d � �Ze d �d<d!d ��Zd"d#� Z d$d%� Z e d&�d=d'd&��Z d=d(d)�Z d>d,d-�Z d?d/d0�Z!d1d2� Z"e d3�d4d5� �Z#e d6�d@d7d8��Z$dS )Az<
Functions for manipulating or otherwise processing strings
� N)� jinja_filter�to_bytes�strictc C s� |du rdt f}t|ttf�s|f}|std��d}t| t�r!| S t| t�r*t| �S t| t�rS|D ] }z | �||�W S t yP } z|}W Y d}~q1d}~ww |�t
dt | �� ���)za
Given bytes, bytearray, str, or unicode (python 2), return bytes (str for
python 2)
N�utf-8�encoding cannot be empty�&expected str, bytes, or bytearray not ) �__salt_system_encoding__�
isinstance�tuple�list�
ValueError�bytes� bytearray�str�encode�UnicodeEncodeError� TypeError�type)�s�encoding�errors�exc�enc�err� r �J/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/stringutils.pyr s,
��Fc s� � fdd�}|du rdt f}t|ttf�s|f}|s td��t| t�r'|| �S d}t| ttf�rV|D ]!}z || �||��W S t yS } z|}W Y d}~q2d}~ww |�t
dt | �� ���)zC
Given str, bytes, bytearray, or unicode (py2), return str
c s0 z � r
t �d| �W S | W S ty | Y S w �NZNFC)� unicodedata� normalizer �r �r r r �
_normalize< s
�zto_str.<locals>._normalizeNr r r ) r r r
r r r r
r �decode�UnicodeDecodeErrorr r )r r r r r! r r r r r r �to_str7 s*
��r$ c s~ � fdd�}|du rdt f}t|ttf�s|f}|s td��t| t�r'|| �S t| ttf�r6|t| ||��S t dt
| �� ���)zA
Given str or unicode, return unicode (str for python 3)
c s � rt �d| �S | S r )r r r r r r r! b s z to_unicode.<locals>._normalizeNr r r ) r r r
r r r r
r r$ r r )r r r r r! r r r �
to_unicode] s
r% Z
str_to_num�to_numc C sD zt | �W S ty! zt| �W Y S ty | Y Y S w w )z�
Convert a string to a number.
Returns an integer if the string represents an integer, a floating
point number if the string is a real number, or the string unchanged
otherwise.
)�intr �float��textr r r r& u s
��c C s t | ��� r| S dS )zR
Convert a string to None if the string is empty or contains only spaces.
N)r �stripr) r r r �to_none� s r, c C s4 d}t | t�r| d | d kr| �d�r| d }|S )zx
Return a single or double quote, if a string is wrapped in extra quotes.
Otherwise return an empty string.
� r ���)�'�")r r �
startswith)�value�retr r r � is_quoted� s ��r4 c C s t | �r
| dd� S | S )z.
Remove extra quotes around a string.
� r. )r4 �r2 r r r �dequote� s r7 �is_hexc C s* zt | d� W dS ttfy Y dS w )zP
Returns True if value is a hexadecimal string, otherwise returns False
� TF)r' r r r6 r r r r8 � s
�c C s� | r
t | tftf�s dS t | t�rd| v rdS nd| v r dS d�dd� tdd �D �td
� �}t | t�rDd d l}| �d |jj �
|��}n d� dd|�}| �|�}t t
|��t
| � d
kr^dS dS )z@
Detects if the passed string of data is binary or text
F� T� r- c S s g | ]}t |��qS r )�chr��.0�xr r r �
<listcomp>� s z is_binary.<locals>.<listcomp>� � z
r Ng333333�?)r r r
�join�ranger �salt.utils.data� translate�utils�datar � maketransr( �len)rH Ztext_characters�saltZnontextZtransr r r � is_binary� s"
�"
rL Z
random_strrA c C s( t �| �}tt�|��dd�d | � �S )N�
� )�os�urandomr% �base64� b64encode�replace)�size�keyr r r �random� s
rV �contains_whitespacec C s t dd� | D ��S )zK
Returns True if there are any whitespace characters in the string
c s � � | ]}|� � V qd S �N)�isspacer= r r r � <genexpr>� � � z&contains_whitespace.<locals>.<genexpr>)�anyr) r r r rW � s �human_to_bytes�Bc C s� t �dt| ��� �}|�d�}|�d��� p|�� }zt|�}W n ty; zt|�}W n ty8 Y Y dS w Y nw d}t �d|�rK|rHdnd}nt �d|�sSdS d � |d �}||rcd
|d nd |d
9 }t|�S )
z�
Given a human-readable byte string (e.g. 2G, 30MB, 64KiB),
return the number of bytes. Will return 0 if the argument has
unexpected form.
.. versionadded:: 2018.3.0
.. versionchanged:: 3005
z"(?P<value>[0-9.]*)\s*(?P<unit>.*)$r2 �unitr Fz [kmgtpezy]b$Tz(b|[kmgtpezy](ib)?)$Z bkmgtpezy�
� � )
�re�matchr r+ �group�lowerr' r r( �index)rT Z default_unitZ
handle_metric�mr2 r` �dec�pr r r r^ � s*
��� c C sL dd� }d}| � � D ]}dd� ||�D �}|d�d�|��7 }q
d|� d �S )
az
Create a regular expression at runtime which should match ignoring the
addition or deletion of white space or line breaks, unless between commas
Example:
.. code-block:: python
>>> import re
>>> import salt.utils.stringutils
>>> regex = salt.utils.stringutils.build_whitespace_split_regex(
... """if [ -z "$debian_chroot" ] && [ -r /etc/debian_chroot ]; then"""
... )
>>> regex
'(?:[\s]+)?if(?:[\s]+)?\[(?:[\s]+)?\-z(?:[\s]+)?\"\$debian'
'\_chroot\"(?:[\s]+)?\](?:[\s]+)?\&\&(?:[\s]+)?\[(?:[\s]+)?'
'\-r(?:[\s]+)?\/etc\/debian\_chroot(?:[\s]+)?\]\;(?:[\s]+)?'
'then(?:[\s]+)?'
>>> re.search(
... regex,
... """if [ -z "$debian_chroot" ] && [ -r /etc/debian_chroot ]; then"""
... )
<_sre.SRE_Match object at 0xb70639c0>
>>>
c S sX t � | �}d|_d|_d| v rd|_t|�S d| v r!d|_t|�S d| v r(d|_t|�S )NTr- z'\"r/ r0 )�shlexZwhitespace_splitZ
commenters�quotesr )r* Zlexerr r r �
__build_parts s
��z3build_whitespace_split_regex.<locals>.__build_partsr- c S s g | ]}t �|��qS r )rd �escape)r> r r r r r@ - s z0build_whitespace_split_regex.<locals>.<listcomp>z(?:[\s]+)?{}(?:[\s]+)?z
(?:[\s]+)?z(?m)^�$)�
splitlines�formatrC )r* rn Zregex�line�partsr r r � build_whitespace_split_regex s ru c C st z(t � | |�r
W dS zt�d|� d�| �rW W dS W W dS tjy( Y W dS w ty9 t�d| |� Y dS w )a
Checks whether or not the passed value matches the specified expression.
Tries to match expr first as a glob using fnmatch.fnmatch(), and then tries
to match expr as a regular expression. Originally designed to match minion
IDs for whitelists/blacklists.
Note that this also does exact matches, as fnmatch.fnmatch() will return
``True`` when no glob characters are used and the string is an exact match:
.. code-block:: python
>>> fnmatch.fnmatch('foo', 'foo')
True
Tz\Az\Zz)Value %r or expression %r is not a stringF)�fnmatchrd re �errorr �log� exception)rs �exprr r r �
expr_match2 s ��� �r{ �check_whitelist_blacklistc s� |rt |t�r
|g}t|d�std�t|�j|���ng }|r8t |t�r'|g}t|d�s7td�t|�j|���ng }t� fdd�|D ��}t� fdd�|D ��}|rW|sW| S |r]|s]|S |rf|rf| oe|S dS )a&
Check a whitelist and/or blacklist to see if the value matches it.
value
The item to check the whitelist and/or blacklist against.
whitelist
The list of items that are white-listed. If ``value`` is found
in the whitelist, then the function returns ``True``. Otherwise,
it returns ``False``.
blacklist
The list of items that are black-listed. If ``value`` is found
in the blacklist, then the function returns ``False``. Otherwise,
it returns ``True``.
If both a whitelist and a blacklist are provided, value membership
in the blacklist will be examined first. If the value is not found
in the blacklist, then the whitelist is checked. If the value isn't
found in the whitelist, the function returns ``False``.
�__iter__z-Expecting iterable blacklist, but got {} ({})z-Expecting iterable whitelist, but got {} ({})c 3 � � | ]}t � |�V qd S rY �r{ �r> rz r6 r r r[ ~ � � z,check_whitelist_blacklist.<locals>.<genexpr>c 3 r~ rY r r� r6 r r r[ r� T)r r �hasattrr rr r �__name__r] )r2 Z whitelistZ blacklistZ_blacklist_matchZ_whitelist_matchr r6 r r| N s>
���
���
c C s� dd� }d}|r!t |t�r |D ] }|| |�}|r nqn|| |�}|r>t |t�r8|D ] }|| |� }|s6 nq*n|| |� }|rF|sF|}|S |rN|sN|}|S |rX|rX|oU|}|S d}|S )a
Check for glob or regexp patterns for include_pat and exclude_pat in the
'path_str' string and return True/False conditions as follows.
- Default: return 'True' if no include_pat or exclude_pat patterns are
supplied
- If only include_pat or exclude_pat is supplied: return 'True' if string
passes the include_pat test or fails exclude_pat test respectively
- If both include_pat and exclude_pat are supplied: return 'True' if
include_pat matches AND exclude_pat does not match
c S s< t �d|�rt �|dd � | �rdS dS t�| |�r dS dS )NzE@rc TF)rd re �searchrv )�path_strZ check_patr r r �
_pat_check� s z)check_include_exclude.<locals>._pat_checkT)r r ) r� Z include_patZ exclude_patr� r3 Z include_lineZretchk_includeZ exclude_lineZretchk_excluder r r �check_include_exclude� s>
��
�� ���r� ra �{�G�z�?c
C s� |rXz zt | � W W dS ty t | �d�� Y nw W dS tyW } z-|� }|jtjkrLd|v s:|jtjfv rK|rKt�|� |d8 }W Y d}~q � W Y d}~dS d}~ww dS )z�
Wrapper around print() that suppresses tracebacks on broken pipes (i.e.
when salt output is piped to less and less is stopped prematurely).
r ztemporarily unavailabler5 N) �printr r �OSError�errnoZEPIPE�EAGAIN�time�sleep)�msgZretries�stepr r r r r � print_cli� s2 �� � �
� ���r� � c
C s� | � � }t|�}||kr| S td|| d �}t||| �}|| d }g } |dkr3| �d� |d7 }| �|||� � ||k rE| �d� |rO| | |7 < d�d�| ��S )zY
Returns debugging context around a line in a given string
Returns:: string
r r5 z[...]z
---
{}
---�
)rq rJ �max�min�append�extendrr rC )
�templaters Z num_lines�markerZtemplate_linesZnum_template_linesZ
context_startZ context_endZerror_line_in_context�bufr r r � get_context� s"
r� c O sN ddt f}ddl}d�tj|jjj| |d�|jjj||d�g|�R i |���S )z�
Perform diff on two iterables containing lines from two files, and return
the diff as as string. Lines are normalized to str types to avoid issues
with unicode on PY2.
r zlatin-1r Nr- )r )r rE rC �difflibZ unified_diffrG rH Z decode_list)�a�b�args�kwargsr rK r r r �get_diff� s
����r� Z
to_snake_casec C sx | d � � }t| dd� d�D ]*\}}|�� r3| |d �� s/|t| �d kr3| |d �� r3|d7 }||� � 7 }q|S )a
Converts camelCase (or CamelCase) to snake_case.
From https://codereview.stackexchange.com/questions/185966/functions-to-convert-camelcase-strings-to-snake-case
:param str camel_input: The camelcase or CamelCase string to convert to snake_case
:return str
r r5 N�_)rg � enumerate�isupper�islowerrJ )Z camel_input�res�iZletterr r r �camel_to_snake_case s
r� Z to_camelcasec C sB | � d�}|r|d �� |d< |d d�dd� |dd� D �� S )ah
Converts snake_case to camelCase (or CamelCase if uppercamel is ``True``).
Inspired by https://codereview.stackexchange.com/questions/85311/transform-snake-case-to-camelcase
:param str snake_input: The input snake_case string to convert to camelCase
:param bool uppercamel: Whether or not to convert to CamelCase instead
:return str
r� r r- c s rX rY )�
capitalize)r> �wordr r r r[ 5 r\ z&snake_to_camel_case.<locals>.<genexpr>r5 N)�splitr� rC )Z snake_inputZ
uppercamel�wordsr r r �snake_to_camel_case' s
$r� )Nr )Nr F)rA )r_ F)NN)ra r� )r� N)F)%�__doc__rQ r� r� rv �loggingrO rd rl r� r Zsalt.utils.decorators.jinjar � getLoggerr� rx r r$ r% r& r, r4 r7 r8 rL rV rW r^ ru r{ r| r� r� r� r� r� r� r r r r �<module> sX
!
&
1
@
3
#