Current File : //lib/python2.7/site-packages/salt/utils/path.pyc
�
���^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 Z d d l m Z d d l m Z d d l m Z d d l m Z y& d d l Z d d l m Z e Z Wn e k
r%e! Z n Xe j" e# � Z$ d � Z% d
� Z& d � Z' d � Z( e d
� d d � � Z* d � Z+ e d � d � � Z, d � Z- d � Z. d d � Z/ d � Z0 d S( uw
Platform independent versions of some os/os.path functions. Gets around PY2's
lack of support for reading NTFS links.
i ( t absolute_importt print_functiont unicode_literalsN( t CommandNotFoundError( t memoize( t jinja_filter( t six( t errorc C@ s� t j s t j j j � r, t j j | � St sE t
j d | � n t | � sU t
St | � } | sk t
St j d � } | j | | j � \ } | d @d k s� t
St Sd S( u(
Equivalent to os.path.islink()
u6 Cannot check if %s is a link, missing required modulesu LI�� � I � N( R t PY3t saltt utilst platformt
is_windowst ost patht islinkt
HAS_WIN32FILEt logR t _is_reparse_pointt Falset _get_reparse_datat structt Structt unpackt sizet True( R t reparse_datat
header_parsert
ReparseTag( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyR ' s c C@ s� t j s t j j j � r) t j | � St sB t j
d | � n t | � } | sr t t
j d j | � � � n t j d � } | j | | j � \ } | d @d k s� t t
j d j | � � � n t j d � } | j | | j � \ } } } } } } }
} | j } | | }
| |
|
| !} | j d � } | j d � rT| d
} n y t j | � } WnK t k
r�} | j d � r�t j d d
| � S| j d k r�| S� n X| S( u%
Equivalent to os.readlink()
u( Cannot read %s, missing required modulesu Invalid argument: '{0}'u LI�� � I � uB {0} is not a symlink, but another type of reparse point (0x{0:X}).u LHHHHHHLu UTF-16u \??\i u UNC\u ^UNC\\+u \\\\i ( R R R R
R R R
t readlinkR R R R t OSErrort errnot EINVALt formatR R R R t decodet
startswitht win32filet GetLongPathNamet
pywinerrort ret subt winerror( R R R R t data_parsert ReparseDataLengtht Reservedt SubstituteNameOffsett SubstituteNameLengtht PrintNameOffsett PrintNameLengtht Flagst path_buffer_offsett absolute_substitute_name_offsett target_bytest targett exc( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyR J s>
.
c C@ s1 t j | � } | d k r t S| d @r- t St S( uC
Returns True if path is a reparse point; False otherwise.
i����i ( R$ t GetFileAttributesWR R ( R t result( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyR � s c C@ s� t j j | � } t | � s" d Sd } z: t j | d d d d d � } t j | d d d � } Wd | r{ t j | � n X| S(
u
Retrieves the reparse point data structure for the given path.
If the path is not a reparse point, None is returned.
See http://msdn.microsoft.com/en-us/library/ff552012.aspx for details on the
REPARSE_DATA_BUFFER structure returned.
I � i i i i i� i @ Ni ( R
R t normpathR t NoneR$ t CreateFileWt DeviceIoControlt CloseHandle( R t
fileHandlet reparseData( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyR � s(
u whichc @ s� d � } � ru| � � r � St j j j t j j d t d � � � j t d � � � t � � f d � � } t j j j
t j j d d � � } | j t j � } t j j j
� s� | j g d D] } | | k r� | ^ q� � n xu | D]m } t | � � } | | � r| St j j j
� r� | � r� x) � D] } | | | � r6| | Sq6Wq� q� Wt j d
� | � n
t j d � d S( u(
Python clone of /usr/bin/which
c S@ s7 t j | t j � o6 t j j | � p6 t j j | � S( N( R
t accesst X_OKR t isfileR ( t exe( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt _is_executable_file_or_link� s u PATHEXTu .EXEu ;c @ s� x � D]w } yZ d j t j j j | � j d � � } t j | t j j j � � t j � j � t
SWq t k
r} q q Xq Wt S( um
Do a case insensitive test if exe has a file extension match in
PATHEXT
u .*\.{0}$u .(
R! R R
t stringutilst
to_unicodet lstripR' t matcht It groupsR t AttributeErrorR ( t extt pattern( RC t ext_list( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt _exe_has_ext� s
!
u PATHu u /binu /sbinu /usr/binu /usr/sbinu /usr/local/binu: '%s' could not be found in the following search path: '%s'uB No executable was passed to be searched by salt.utils.path.which()( u /binu /sbinu /usr/binu /usr/sbinu /usr/local/binN( R R
RE t to_strR
t environt gett strt splitt real_memoizeRF t pathsepR R t extendt joinR t traceR R: ( RC RD RO t system_patht search_patht xR t full_pathRL ( ( RC RN s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt which� s8 $
c C@ sD t | t j � s d Sx' | D] } t | � } | s; q n | SWd S( uT
Scan over some possible executables and return the first one that is found
N( t
isinstancet collectionst IterableR: R^ ( t exesRC R ( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt which_bin s
u path_joinc
O@ s^ t j rE g } x* | D]" } | j t j j j | � � q W| } n t j j j | � } | j d t
� } | r� t j j j | � n | r� t n t
j } g | D] } | j | � ^ q� } y | j d � } Wn t k
r� d SXt j j j | � } | s | } nF g | D] } | j t
j � ^ q} | j | t j j j | � � } | j | � S( uw
This functions tries to solve some issues when joining multiple absolute
paths on both *nix and windows platforms.
See tests/unit/utils/path_join_test.py for some examples on what's being
talked about here.
The "use_posixpath" kwarg can be be used to force joining using poxixpath,
which is useful for Salt fileserver paths on Windows masters.
u
use_posixpathi u ( R R t appendR R
RE RP t argst clean_kwargst popR t invalid_kwargst posixpathR
R R9 t
IndexErrorRF RG t sepRX t dataR" (
t partst kwargst new_partst partt
use_posixpatht pathlibt pt roott rett stripped( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyRX s*
"
%!c C@ sC | d k r t d � � n t | � s? t d j | � � � n d S( u�
Simple convenience function for modules to use for gracefully blowing up
if a required tool is not available in the system path.
Lazily import `salt.modules.cmdmod` to avoid any sort of circular
dependencies.
u 'None' is not a valid command.u '{0}' is not in the pathN( R: R R^ R! ( t command( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt check_or_die> s c C@ s� d } t | t j � r: | j t d � | D� � � } na t | t j � r� d t | � } t j rw d j | | � n t j | | � } | j | � } n | S( u4
Remove illegal path characters for windows
u <>:|?*c s@ s! | ] } t | � d f Vq d S( u _N( t ord( t .0t c( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pys <genexpr>S s u _u (
R_ R t text_typet translatet dictt string_typest lenR t maketranst string( t winpatht intabt outtabt trantab( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt sanitize_win_pathM s "-c C@ s t j j d d � } d d t j | � f } | rO t | t � rO | g } n t � } | r� x' | D] } | j t j | � � qe Wn t } x8 | D]0 } t j | | d t j
�d k r� t } q� q� W| s
x; | D]0 } t j | | d t j
�d k r� t } q� q� Wn | S( u
.. versionadded:: 2017.7.3
Checks that the path is safe for modification by Salt. For example, you
wouldn't want to have salt delete the contents of ``C:\Windows``. The
following directories are considered unsafe:
- C:\, D:\, E:\, etc.
- \
- C:\Windows
Args:
path (str): The path to check
allow_paths (str, list): A directory or list of directories inside of
path that may be safe. For example: ``C:\Windows\TEMP``
Returns:
bool: True if safe, otherwise False
u
SystemRootu
C:\Windowsu
[a-z]\:\\$u \\$t flagsN(
R
RQ RR R' t escapeR_ t listRd R RH t
IGNORECASER: R ( R t
allow_patht system_roott
deny_pathst allow_pathst itemt good_patht d_patht a_path( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt safe_path[ s&
!
!c o@ sw t j r$ t j j j � r$ | } n t j j j | � } x7 t j | | | � D] } t j j
j | d t �VqO Wd S( u]
This is a helper than ensures that all paths returned from os.walk are
unicode.
t preserve_tuplesN(
R t PY2R R
R R RE RP R
t walkRl R" R ( t topRe Rn t top_queryR� ( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt os_walk� s
(1 t __doc__t
__future__R R R R` R t loggingR
Ri R' R� R t salt.utils.argsR t salt.utils.platformt salt.utils.stringutilst salt.exceptionsR t salt.utils.decoratorsR RU t salt.utils.decorators.jinjaR t salt.extR R$ t
pywintypesR R& R R t ImportErrorR t getLoggert __name__R R R R R R: R^ Rc RX Rx R� R� R� ( ( ( s3 /usr/lib/python2.7/site-packages/salt/utils/path.pyt <module> sF
# ? ( G + 9
Mini Shell