File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/stringutils.cpython-310.pyc
Back
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 #
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings