| 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�/ � @ s d Z ddlZddlZddlZddlZddlmZ ddlZddl Zddl
Zddl m Z ddl
mZ z ddlZddlZdZW n eyG dZY nw e�e�Zdd � Zd
d � Zd d
� Zdd� Zed�d!dd��Zdd� Zed�dd� �Z dd� Z dd� Z d!dd �Z d d � Z d d � Z!dS )"zw
Platform independent versions of some os/os.path functions. Gets around PY2's
lack of support for reading NTFS links.
� N)�Iterable)�CommandNotFoundError)� jinja_filterTFc C s t jj�� r
t| �S tj�| �S )a
Equivalent to os.path.islink().
Returns True for Symlinks and Junctions on Windows. Junctions are symlinks
that only apply to directories. They are specific to Windows. Junctions are
not handled by `os.path.islink` until Python 3.12.
)�salt�utils�platform�
is_windows�_is_reparse_point�os�path�islink�r � r �C/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/path.pyr s
r c C s0 t �| �}tjj�� r|�d�r|dd� }|S )z%
Equivalent to os.readlink()
z\\?\� N)r
�readlinkr r r r �
startswith)r �baser r r r - s
r c C s( t �| �}|dkr dS |tj@ rdS dS )z�
A Symbolic Link and a Junction are both reparse points on Windows.
Returns True if path is a reparse point; False otherwise.
���FT)� win32fileZGetFileAttributesW�win32con� FILE_ATTRIBUTE_REPARSE_POINT)r �resultr r r r ; s
r c C sh t j�| �} t| �s dS d}z t�| ddddd�}t�|ddd�}W |r)t�|� |S |r3t�|� w w )a
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.
Nl � � i i� i @ )r
r �normpathr r Z CreateFileWZDeviceIoControlZ CloseHandle)r Z
fileHandleZ reparseDatar r r �_get_reparse_dataJ s2
�
�
� �r �whichc sr | s t �d� dS dd� �dd� }dd� � tjj�tj�d d
����� tj
�}tjj � � sAt
|��g d �}|��fd d
�|D �� tjj � � r~tjj�tj�dd����� tj
�}dd� |D ��tj�| �\}}|�� �v rtd
g}�}n�f� �fdd� }nd
g}�}|| �r�| S |D ]$}ttj�|�| �} |D ]}| | }
||
�} || �r�| | S q�q�t �d| |� dS )z(
Python clone of /usr/bin/which
zBNo executable was passed to be searched by salt.utils.path.which()Nc S s t j�| �o t �| t j�S )z�
This returns truth if posixy semantics (which python simulates on
windows) states that this is executable.
)r
r �isfile�access�X_OKr
r r r �is_executable_common~ s z#which.<locals>.is_executable_commonc S sN t j�| �r%t| �}t j�|�s t j�| �\}}t||�}|} t j�| �s| S )zl
This will take a path and recursively follow the link until we get to a
real file.
)r
r r r �isabs�split�join)r �res� directory�_r r r �resolve� s
� zwhich.<locals>.resolvec S s t j�| �\}}|�� |v S )z�
Extract the extension from the specified path, lowercase it so we
can be insensitive, and then check it against the available exts.
)r
r �splitext�lower)r Zext_membership�p�extr r r �has_executable_ext� s z!which.<locals>.has_executable_ext�PATH� )z/sbinz/binz /usr/sbinz/usr/binz/usr/local/sbinz/usr/local/binc s g | ]}|� vr|�qS r r ��.0r+ )r% r r �
<listcomp>� � zwhich.<locals>.<listcomp>�PATHEXTz.EXEc S s h | ]}|� � �qS r )r* )r1 r, r r r � <setcomp>� s zwhich.<locals>.<setcomp>c s �| �o� | |�S �Nr )r Z
membership)r- r! r r �
is_executable� s
�z which.<locals>.is_executablez:'%s' could not be found in the following search path: '%s')�log�errorr r � stringutils�
to_unicoder
�environ�getr# �pathsepr r �set�extend�to_strr r) r* r$ �
expandvarsZtrace) �exer( Z system_pathZ
extended_path�pathextr' r, r7 r r+ ZpextZrpr )r- r! r% r r s sL
�c C s@ t | t�r| g} t | t�sdS | D ] }t|�}|sq| S dS )zT
Scan over some possible executables and return the first one that is found
N)�
isinstance�strr r )ZexesrC r r r r � which_bin� s
rG Z path_joinc s� dd� | D �} t jjjd
i |��}|�dd�}|r t jj�|� |r$tntj� � fdd�| D �} z| �d�}W n
t yA Y dS w t jj
� |�}| sN|}ndd� | D �}� j |gt jj
�|��R � }� �|�S ) aw
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.
c S s g | ] }t jj�|��qS r )r r r: rA )r1 �partr r r r2 s zjoin.<locals>.<listcomp>�
use_posixpathFc s g | ]}� � |��qS r )r r0 ��pathlibr r r2 � r r/ c S s g | ]}|� tj��qS r )�lstripr
�sepr0 r r r r2 r3 Nr )r r �argsZ clean_kwargs�popZinvalid_kwargs� posixpathr
r �
IndexErrorr: r; r$ �data�decoder )�parts�kwargsrI �root�ret�strippedr rJ r r$ � s$ �
r$ c C s, | du rt d��t| �st d| � d���dS )z�
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.
Nz 'None' is not a valid command.�'z' is not in the path)r r )Zcommandr r r � check_or_die$ s
�r[ c C sV d}t | t�r| �dd� |D ��} | S t | t�r)dt|� }d�||�}| �|�} | S )z4
Remove illegal path characters for windows
z<>:|?*c S s i | ]}t |�d �qS )r' )�ord)r1 �cr r r �
<dictcomp>9 rL z%sanitize_win_path.<locals>.<dictcomp>r' r/ )rE rF � translate�len� maketrans)ZwinpathZintabZouttabZtrantabr r r �sanitize_win_path3 s
�
rb c C s� t j�dd�}ddt�|�f}|rt|t�s|g}t� }|r+|D ]
}|�t�|�� q d}|D ]}tj|| tj d�dur>d}q/|sS|D ]}tj|| tj d�durRd}qC|S ) a
.. 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
Z
SystemRootz
C:\Windowsz
[a-z]\:\\$z\\$T)�flagsNF)
r
r< r= �re�escaperE �list�append�match�
IGNORECASE) r Z
allow_pathZ system_rootZ
deny_pathsZ allow_paths�itemZ good_pathZd_path�a_pathr r r � safe_pathA s, ���rl c o sF � t jj�| �}tj|g|�R i |��D ] }t jjj|dd�V qdS )z]
This is a helper than ensures that all paths returned from os.walk are
unicode.
T)Zpreserve_tuplesN)r r r: rA r
�walkrS rT )�toprO rV Z top_queryrj r r r �os_walkz s
� �ro c C s$ t j�| �} t j�| �} t j�| �S )z�
Expands all user and environment variables
.. versionadded:: 3005
Args:
path (str): A path to a file or directory
Returns:
str: A fully expanded, real path
)r
r �
expanduserrB �realpathr
r r r �expand� s rr r6 )"�__doc__�loggingr
rQ rd �collections.abcr Zsalt.utils.argsr Zsalt.utils.platformZsalt.utils.stringutilsZsalt.exceptionsr Zsalt.utils.decorators.jinjar r r Z
HAS_WIN32FILE� ImportError� getLogger�__name__r8 r r r r r rG r$ r[ rb rl ro rr r r r r �<module> sB �
) y
&
9