Current File : //usr/lib/python2.7/site-packages/salt/utils/stringutils.pyo
�
���^c @@ s d Z d d l m Z m Z 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 m Z d d l m Z d d l m Z e j e � Z e d � d d d � � Z d d e d
� Z d d e d � Z e d � e d
� d � � � Z d � Z d � Z d � Z e d � d � � Z! d � Z" e d � d d � � Z# e d � d � � Z$ d � Z% d � Z& d � Z' e d � d d d � � Z( d d d � Z) d d! d" � Z* d# d d$ � Z+ d% � Z, d S(& u<
Functions for manipulating or otherwise processing strings
i ( t absolute_importt print_functiont unicode_literalsN( t jinja_filter( t six( t rangeu to_bytesu strictc C@ s | d k r d t f } n t | t t f � s< | f } n | sQ t d � � n d } t j r� t | t � rs | St | t � r� t | � St | t j
� r� xA | D]9 } y | j | | � SWq� t k
r� } | } q� q� Xq� W| � n t
d � � n t | | | � Sd S( ua
Given bytes, bytearray, str, or unicode (python 2), return bytes (str for
python 2)
u utf-8u encoding cannot be emptyu! expected bytes, bytearray, or strN( t Nonet __salt_system_encoding__t
isinstancet tuplet listt
ValueErrorR t PY3t bytest bytearrayt string_typest encodet UnicodeEncodeErrort TypeErrort to_str( t st encodingt errorst exct enct err( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt to_bytes s,
c @ s� � f d � } | d k r* d t f } n t | t t f � sK | f } n | s` t d � � n t | t � ry | | � Sd } t j rt | t t
f � r� xG | D]? } y | | j | | � � SWq� t k
r� } | } q� q� Xq� W| � n t
d j t | � � � � n� t | t
� r't | � St | t � r�xG | D]? } y | | � j | | � SWq=t k
r{} | } q=q=Xq=W| � n t
d � � d S( uC
Given str, bytes, bytearray, or unicode (py2), return str
c @ s7 y � r t j d | � S| SWn t k
r2 | SXd S( Nu NFC( t unicodedatat normalizeR ( R ( R ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt
_normalizeF s
u utf-8u encoding cannot be emptyu( expected str, bytes, or bytearray not {}u# expected str, bytearray, or unicodeN( R R R R R
R t strR R R
R t decodet UnicodeDecodeErrorR t formatt typet unicodeR R ( R R R R R R R R ( ( R s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyR B s>
c @ sS � f d � } | d k r* d t f } n t | t t f � sK | f } n | s` t d � � n d } t j r� t | t � r� | | � St | t t
f � r� | t | | | � � St d � � n� t | t
� r� | | � St | t t
f � rCxG | D]? } y | | j | | � � SWq� t k
r5} | } q� q� Xq� W| � n t d � � d S( uA
Given str or unicode, return unicode (str for python 3)
c @ s � r t j d | � S| S( Nu NFC( R R ( R ( R ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyR } s u utf-8u encoding cannot be emptyu! expected str, bytes, or bytearrayu expected str or bytearrayN( R R R R R
R R R R R
R R R R# R R ( R R R R R R R R ( ( R s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt
to_unicodey s2
u
str_to_numu to_numc C@ sI y t | � SWn4 t k
rD y t | � SWqE t k
r@ | SXn Xd S( u�
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.
N( t intR t float( t text( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt to_num� s
c C@ s t j | � j � r | Sd S( uR
Convert a string to None if the string is empty or contains only spaces.
N( R t text_typet stripR ( R' ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt to_none� s c C@ sL d } t | t j � rH | d | d k rH | j d � rH | d } n | S( ux
Return a single or double quote, if a string is wrapped in extra quotes.
Otherwise return an empty string.
u i i����u 'u "( u 'u "( R R R t
startswith( t valuet ret( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt is_quoted� s
c C@ s t | � r | d d !S| S( u.
Remove extra quotes around a string.
i i����( R/ ( R- ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt dequote� s u is_hexc C@ s4 y t | d � t SWn t t f k
r/ t SXd S( uP
Returns True if value is a hexidecimal string, otherwise returns False
i N( R% t TrueR R t False( R- ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt is_hex� s
c C@ s� | s# t | t j t j f � r' t St | t j � rL d | k rb t Sn t d � | k rb t Sd j g t d d � D] } t | � ^ qx t
d � � } t j rt | t j � r� d d l } | j
d | j j j | � � } qXd j d d | � } | j
| � } nI t | t j � r7d � | D� f } n d t | � f } | j
| � } t t | � � t | � d
k r~t St S( u@
Detects if the passed string of data is binary or text
t u u i i u
i Nc S@ s i | ] } d t | � � q S( N( R t ord( t .0t x( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pys
<dictcomp>� s g333333�?( R R R t binary_typeR2 R1 R t joinR t chrR
R t salt.utils.datat translateR t utilst dataR t maketransR) R& t len( R> R7 t text_characterst saltt nontextt transt
trans_args( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt is_binary� s* # ; $"u
random_stri c C@ s2 t j | � } t t j | � j d d � | � S( Ns
t ( t ost urandomR$ t base64t b64encodet replace( t sizet key( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt random s u contains_whitespacec C@ s t d � | D� � S( uK
Returns True if there are any whitespace characters in the string
c s@ s | ] } | j � Vq d S( N( t isspace( R6 R7 ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pys <genexpr> s ( t any( R' ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt contains_whitespace s c C@ s� | d } | d } | j � r� t | � } | d k rE | d 9} q� | d k r^ | d 9} q� | d k rw | d 9} q� | d k r� | d 9} q� d
} n d
} | S( u�
Given a human-readable byte string (e.g. 2G, 30M),
return the number of bytes. Will return 0 if the argument has
unexpected form.
.. versionadded:: 2018.3.0
i����u PI u TI u Gi @u Mi i ( t isdigitR% ( RM t sbytest unit( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt human_to_bytes s
c C@ sw d � } d } xX | j � D]J } g | | � D] } t j | � ^ q/ } | d j d j | � � 7} q Wd j | � S( uz
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@ ss t j | � } t | _ d | _ d | k r9 d | _ n0 d | k rQ d | _ n d | k ri d | _ n t | � S( Nu u '\"u 'u "( t shlexR1 t whitespace_splitt
commenterst quotesR
( R' t lexer( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt
__build_partsL s u u (?:[\s]+)?{0}(?:[\s]+)?u
(?:[\s]+)?u (?m)^{0}$( t
splitlinest ret escapeR! R9 ( R' R\ t regext lineR t parts( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt build_whitespace_split_regex/ s ( c C@ s yT t j | | � r t Sy# t j d j | � | � r; t SWn t j k
rR n XWn$ t k
rz t j d | | � n Xt S( u
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
u \A{0}\Zu) Value %r or expression %r is not a string(
t fnmatchR1 R^ t matchR! t errorR t logt exceptionR2 ( Ra t expr( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt
expr_match_ s
u check_whitelist_blacklistc @ s: | rZ t | t j � r$ | g } n t | d � s` t d j t | � j | � � � q` n g } | r� t | t j � r� | g } n t | d � s� t d j t | � j | � � � q� n g } t � f d � | D� � } t � f d � | D� � } | r
| r
| S| r| r| S| r2| r2| o1| St Sd S( u&
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``.
u __iter__u/ Expecting iterable blacklist, but got {0} ({1})u/ Expecting iterable whitelist, but got {0} ({1})c 3@ s | ] } t � | � Vq d S( N( Rj ( R6 Ri ( R- ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pys <genexpr>� s c 3@ s | ] } t � | � Vq d S( N( Rj ( R6 Ri ( R- ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pys <genexpr>� s N(
R R R t hasattrR R! R" t __name__RQ R1 ( R- t whitelistt blacklistt _blacklist_matcht _whitelist_match( ( R- s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt check_whitelist_blacklist{ s2
c C@ s t } | rd t j d | � rC t j | d | � r: t n t } qd t j | | � r[ t n t } n | r� t j d | � r� t j | d | � r� t n t } q� t j | | � r� t n t } n | r� | r� | } n7 | r� | r� | } n! | r | r | o| } n t } | S( u
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
u E@i ( R1 R^ Re t searchR2 Rd ( t path_strt include_patt exclude_patR. t retchk_includet retchk_exclude( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt check_include_exclude� s:
i
g{�G�z�?c C@ s� x� | r� y9 y t | � Wn$ t k
r@ t | j d � � n XWn~ t k
r� } d j | � } | j t j k r� d | k s� | j t j f k r� | r� t j | � | d 8} q q� � q� n XPq Wd S( u�
Wrapper around print() that suppresses tracebacks on broken pipes (i.e.
when salt output is piped to less and less is stopped prematurely).
u utf-8u {0}u temporarily unavailablei N(
t printR R t IOErrorR! t errnot EPIPEt EAGAINt timet sleep( t msgt retriest stepR R ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt print_cli� s"
i c
C@ s� | j � } t | � } | | k r( | St d | | d � } t | | | � } | | d } g } | d k r� | j d � | d 7} n | j | | | !� | | k r� | j d � n | r� | | c | 7<n d j d j | � � S( uY
Returns debugging context around a line in a given string
Returns:: string
i i u [...]u ---
{0}
---u
( R] R@ t maxt mint appendt extendR! R9 (
t templateRa t num_linest markert template_linest num_template_linest
context_startt context_endt error_line_in_contextt buf( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt get_context s"
c O@ sd d d t f } d d l } d j t j | j j j | d | �| j j j | d | �| | � � S( u�
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.
u utf-8u latin-1i Nu R ( R R; R9 t difflibt unified_diffR= R> t decode_list( t at bt argst kwargsR RB ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt get_diff, s (- t __doc__t
__future__R R R RJ R� R{ Rd t loggingRH RW R^ R~ R t salt.utils.decorators.jinjaR t salt.extR t salt.ext.six.movesR t getLoggerRl Rg R R R2 R R$ R( R+ R/ R0 R3 RF RO RR RV Rc Rj Rq Rx R� R� R� ( ( ( s: /usr/lib/python2.7/site-packages/salt/utils/stringutils.pyt <module> sL $7+
% 0 @2#
Mini Shell