File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/archive.cpython-310.pyc
Back
o ;j�� � @ sL d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlmZmZ zddlZdZW n e ym dZY nw ej j � � rxddl Z ddd�Z!e�"e#�Z$ d,d d �Z%e�&d �Z'd d� Z(dd� Z)ej j*j+�,d�d-dd��Z-ej j*j+�,d�d.dd��Z.ej j*j+�,d�d.dd��Z/ej j*j+�,d�d.dd��Z0ej j*j1de0d�d/dd ��Z2ej j*j+�,d � d0d d ��Z3 d1d d �Z4d2d!d"�Z5ej j*j+�,d#�d.d$d#��Z6ej j*j+�7d%�d/d&d'��Z8d(d)� Z9d*d+� Z:dS )3zJ A module to wrap (non-Windows) archive calls .. versionadded:: 2014.1.0 � N)�CommandExecutionError�SaltInvocationErrorTF�zip�list)�zip_�list_�basec s� d,� fdd� � dd� } dd� } t d | |||d �} | s"td | � ����z�|r@zt|� W n ty7 d }Y nw |d kr@td ��tj�| �} | jpK| j} dd� }|sct j j � | �}|du ra||� |}t � �d| �}t|d�st||� |dkr{|fnd}z|| | g|�R � \}}}W n7 ty� } z td| � d|� ���d}~w ty� } z� d}~w ty� } z td|� d| � ���d}~ww |r�z t�| � t�d| � W n ty� } z|jtjkr�t�d| |� W Y d}~nd}~ww |�r4|||fD ]9}t|�D ]#\}} z|| �tj|�| ||< W �q t �y# d||< Y �q w d d � |D �|dd�< |� � q�|�r�t t j j � |��t t j j � |��t t j j � |��d �}d d � |d! D �}tj�!|d! |d" |d# �}d$|v �r�|�d$�d d$ }||v�r�|�"|� ||d%< d&d � |d" D �|d'< d(d � |d# D �|d)< |W S t || | �}|W S t�y� } z|j#�p�i }| |d*< t|j$|d+��d}~ww )-aR .. versionadded:: 2016.11.0 .. versionchanged:: 2016.11.2,3005 The rarfile_ Python module is now supported for listing the contents of rar archives. This is necessary on minions with older releases of the ``rar`` CLI tool, which do not support listing the contents in a parsable format. .. _rarfile: https://pypi.python.org/pypi/rarfile List the files and directories in an tar, zip, or rar archive. .. note:: This function will only provide results for XZ-compressed archives if the xz_ CLI command is available, as Python does not at this time natively support XZ compression in its tarfile_ module. Keep in mind however that most Linux distros ship with xz_ already installed. To check if a given minion has xz_, the following Salt command can be run: .. code-block:: bash salt minion_id cmd.which xz If ``None`` is returned, then xz_ is not present and must be installed. It is widely available and should be packaged as either ``xz`` or ``xz-utils``. name Path/URL of archive archive_format Specify the format of the archive (``tar``, ``zip``, or ``rar``). If this argument is omitted, the archive format will be guessed based on the value of the ``name`` parameter. options **For tar archives only.** This function will, by default, try to use the tarfile_ module from the Python standard library to get a list of files/directories. If this method fails, then it will fall back to using the shell to decompress the archive to stdout and pipe the results to ``tar -tf -`` to produce a list of filenames. XZ-compressed archives are already supported automatically, but in the event that the tar archive uses a different sort of compression not supported natively by tarfile_, this option can be used to specify a command that will decompress the archive to stdout. For example: .. code-block:: bash salt minion_id archive.list /path/to/foo.tar.gz options='gzip --decompress --stdout' .. note:: It is not necessary to manually specify options for gzip'ed archives, as gzip compression is natively supported by tarfile_. strip_components This argument specifies a number of top-level directories to strip from the results. This is similar to the paths that would be extracted if ``--strip-components`` (or ``--strip``) were used when extracting tar archives. .. versionadded:: 2016.11.2 clean : False Set this value to ``True`` to delete the path referred to by ``name`` once the contents have been listed. This option should be used with care. .. note:: If there is an error listing the archive's contents, the cached file will not be removed, to allow for troubleshooting. verbose : False If ``False``, this function will return a list of files/dirs in the archive. If ``True``, it will return a dictionary categorizing the paths into separate keys containing the directory names, file names, and also directories/files present in the top level of the archive. .. versionchanged:: 2016.11.2 This option now includes symlinks in their own list. Before, they were included with files. saltenv : base Specifies the fileserver environment from which to retrieve ``archive``. This is only applicable when ``archive`` is a file from the ``salt://`` fileserver. source_hash If ``name`` is an http(s)/ftp URL and the file exists in the minion's file cache, this option can be passed to keep the minion from re-downloading the archive if the cached copy matches the specified hash. .. versionadded:: 2018.3.0 use_etag If ``True``, remote http/https file sources will attempt to use the ETag header to determine if the remote file needs to be downloaded. This provides a lightweight mechanism for promptly refreshing files changed on a web server without requiring a full hash comparison via the ``source_hash`` parameter. .. versionadded:: 3005 .. _tarfile: https://docs.python.org/2/library/tarfile.html .. _xz: http://tukaani.org/xz/ CLI Examples: .. code-block:: bash salt '*' archive.list /path/to/myfile.tar.gz salt '*' archive.list /path/to/myfile.tar.gz strip_components=1 salt '*' archive.list salt://foo.tar.gz salt '*' archive.list https://domain.tld/myfile.zip salt '*' archive.list https://domain.tld/myfile.zip source_hash=f1d2d2f924e986ac86fdf7b36c94bcdf32beec15 salt '*' archive.list ftp://10.1.2.3/foo.rar Fc s� g }g }g }z[t |tj�sd|in|jdd�}t�tjdi |����2}|�� D ]%} t j j � | j �} | �� r;|�| � q'| �� rG|�| d � q'|�| � q'W d � n1 sWw Y |||fW S tjy� |r�t |tj�r�|�� d } |jdkr�td| � �d | id ��n`t j j�d �s�td ��|dur�t |t�r�z d d� t�|�D �}W n$ ty� td��w t j j�d�r�td dd|gddd�dkr�g d�}|r�tj|t� |�g tj tj d�} � | | dd� Y S Y nw td� | ���)z5 List the contents of a tar archive. �namezr|)�fileobj�mode�/N� r zFailed to decompress �error��info�tarz'tar' command not availablec S s g | ]}t �|��qS � )�shlex�quote��.0�xr r �H/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/archive.py� <listcomp>� s �z,list_.<locals>._list_tar.<locals>.<listcomp>zInvalid CLI options�xzz cmd.retcodez-tFT�� python_shellZignore_retcode)r z --decompressz--stdout)�stdout�stderra Unable to list contents of {}. If this is an XZ-compressed tar archive, install XZ Utils to enable listing its contents. If it is compressed using something other than XZ, it may be necessary to specify CLI options to decompress the archive. See the documentation for details.r ) � isinstance� subprocess�Popenr � contextlib�closing�tarfile�open� getmembers�salt�utils�data�decoder �issym�append�isdir� ReadError� communicate� returncoder �path�which�strr �split�AttributeError�__salt__r �PIPE�format) r �cachedZdecompress_cmdZfailhard�dirs�files�linksZ open_kwargsZ tar_archive�memberZ_memberr Z decompressed�� _list_tarr r r? � s| � � � � �� � � ������(�zlist_.<locals>._list_tarc S s< t � }g }g }z�t�t�|���o}|�� D ]<}|j}tjj � � r1|� d�r+|� |� q|� |� q|jd? }t�|�rA|� |� qt�|�rL|� |� q|� |� qt�|�} | D ] }d�|�d�dd� �} | rw|� | � | |v rw|�| � qYW d � n1 s�w Y t|�||fW S tjy� t| � d���w )z� List the contents of a zip archive. Password-protected ZIP archives can still be listed by zipfile, so there is no reason to invoke the unzip command. r � � N� � is not a ZIP file)�setr" r# �zipfile�ZipFile�infolist�filenamer' r( �platform� is_windows�endswith�addr, � external_attr�stat�S_ISLNK�S_ISDIR�copy�deepcopy�join� rpartition�remover � BadZipfiler ) r r9 r: r; r< � zip_archiver= r1 r �_files�dirnamer r r � _list_zip� s> �� � �zlist_.<locals>._list_zipc S s g }g }t r;t�|��'}|�� D ]}|j�dd�}|�� r%|�|d � q|�|� qW d � n1 s5w Y nDtj j � d�sFt d��t d dd| gddd �}t�d |�}|D ]\}} | d krj|�|d � qZ|�|� qZ|s|st d �| �d |id��||g fS )z5 List the contents of a rar archive. �\r N�rarz+rar command not available, is it installed?�cmd.run�ltFr z#Name:\s*([^\n]+)\s*Type:\s*([^\n]+)Z Directoryz�Failed to list {}, is it a rar file? If so, the installed version of rar may be too old to list data in a parsable format. Installing the rarfile Python module may be an easier workaround if newer rar is not readily available.r r )� HAS_RARFILE�rarfileZRarFilerG rH �replacer- r, r' r( r1 r2 r r6 �re�findallr8 ) r r9 r: r; Zrfr= r1 �output�matches�type_r r r � _list_rar' s> � ��� � � zlist_.<locals>._list_rar� cp.cache_file�� source_hash�use_etag�Failed to cache ���r z-'strip_components' must be a positive integerc S s | du rt d��t d| � d���)zZ Raise the proper exception message for the given archive format. NzIUnable to guess archive format, please pass an 'archive_format' argument.z Unsupported archive format '�')r )�archive_formatr r r �_unsupported_formatc s � �z"list_.<locals>._unsupported_formatNZ_list_�__call__r r zFailed to list contents of z: zUncaught exception 'z' when listing contents of �Cleaned cached archive %s�%Failed to clean cached archive %s: %srA c s s � | ]}|r|V qd S )Nr r r r r � <genexpr>� s � zlist_.<locals>.<genexpr>)r: r; r< c S � g | ] }|� d �dkr|�qS )r r ��countr r r r r � � zlist_.<locals>.<listcomp>r: r; r< r �top_level_dirsc S ru �r r rv r r r r r � rx Ztop_level_filesc S ru rz rv r r r r r � rx Ztop_level_links�archive locationr )F)%r6 r �int� ValueError�urllib�parse�urlparser1 �netlocr' r( r; Zguess_archive_type�locals�get�hasattr�OSError� Exception�osrU �log�debug�errno�ENOENT�warning� enumerater4 �sep� IndexError�sort�sortedr) Z decode_list� commonprefixr, r r ) r ro �optionsZstrip_components�clean�verbose�saltenvrj rk rZ rg r9 �parsedr1 rp Zguessed_format�func�argsr: r; r< �exc�item�index�retry Z common_prefixr r r> r r 1 s� H+'� �� ����� ���� �� � ��r z[*?[]c C s t �| �du r | gS t�| �S )z� In case ``pathname`` contains glob wildcards, performs expansion and returns the possibly empty list of matching pathnames. Otherwise returns a list that contains only ``pathname`` itself. N)�_glob_wildcards�search�glob)�pathnamer r r �_glob� s r� c C sR | du rg S t | t�rdd� | �d�D �} n t | ttf�r"t| �g} dd� | D �S )zU Expands a user-provided specification of source files into a list of paths. Nc S � g | ]}|� � �qS r ��stripr r r r r � � z#_expand_sources.<locals>.<listcomp>�,c S s g | ] }t |�D ]}|�qqS r )r� )r �sourcer1 r r r r � rx )r r3 r4 �floatr| )�sourcesr r r �_expand_sources� s r� r c C sn | st d��dg}| r|�| �� � |�|� g� |r#|�d|� g� |�t|�� td ||||dd��� S )a� .. note:: This function has changed for version 0.17.0. In prior versions, the ``cwd`` and ``template`` arguments must be specified, with the source directories/files coming as a space-separated list at the end of the command. Beginning with 0.17.0, ``sources`` must be a comma-separated list, and the ``cwd`` and ``template`` arguments are optional. Uses the tar command to pack, unpack, etc. tar files options Options to pass to the tar command .. versionchanged:: 2015.8.0 The mandatory `-` prefixing has been removed. An options string beginning with a `--long-option`, would have uncharacteristically needed its first `-` removed under the former scheme. Also, tar will parse its options differently if short options are used with or without a preceding `-`, so it is better to not confuse the user into thinking they're using the non-`-` format, when really they are using the with-`-` format. tarfile The filename of the tar archive to pack/unpack sources Comma delimited list of files to **pack** into the tarfile. Can also be passed as a Python list. .. versionchanged:: 2017.7.0 Globbing is now supported for this argument dest The destination directory into which to **unpack** the tarfile cwd : None The directory in which the tar command should be executed. If not specified, will default to the home directory of the user under which the salt minion process is running. template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.tar cjvf /tmp/salt.tar.bz2 {{grains.saltpath}} template=jinja CLI Examples: .. code-block:: bash # Create a tarfile salt '*' archive.tar cjvf /tmp/tarfile.tar.bz2 /tmp/file_1,/tmp/file_2 # Create a tarfile using globbing (2017.7.0 and later) salt '*' archive.tar cjvf /tmp/tarfile.tar.bz2 '/tmp/file_*' # Unpack a tarfile salt '*' archive.tar xf foo.tar dest=/target/directory z Tar options can not be emptyr z-Cr] F��cwd�template�runasr )r �extendr4 r� r6 � splitlines)r� r$ r� �destr� r� r� �cmdr r r r � s A ���gzipc C �8 dg}|r |� |� |� | � � td |||dd��� S )a� Uses the gzip command to create gzip files template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.gzip template=jinja /tmp/{{grains.id}}.txt runas : None The user with which to run the gzip command line options : None Pass any additional arguments to gzip .. versionadded:: 2016.3.4 CLI Example: .. code-block:: bash # Create /tmp/sourcefile.txt.gz salt '*' archive.gzip /tmp/sourcefile.txt salt '*' archive.gzip /tmp/sourcefile.txt options='-9 --verbose' r� r] F�r� r� r �r, r6 r� )Z sourcefiler� r� r� r� r r r r� : � ���gunzipc C r� )a� Uses the gunzip command to unpack gzip files template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.gunzip template=jinja /tmp/{{grains.id}}.txt.gz runas : None The user with which to run the gzip command line options : None Pass any additional arguments to gzip .. versionadded:: 2016.3.4 CLI Example: .. code-block:: bash # Create /tmp/sourcefile.txt salt '*' archive.gunzip /tmp/sourcefile.txt.gz salt '*' archive.gunzip /tmp/sourcefile.txt options='--verbose' r� r] Fr� r� )Zgzipfiler� r� r� r� r r r r� a r� c C s< ddg}|� | � � |�t|�� td ||||dd��� S )au .. versionadded:: 2015.5.0 In versions 2014.7.x and earlier, this function was known as ``archive.zip``. Uses the ``zip`` command to create zip files. This command is part of the `Info-ZIP`_ suite of tools, and is typically packaged as simply ``zip``. .. _`Info-ZIP`: http://www.info-zip.org/ zip_file Path of zip file to be created sources Comma-separated list of sources to include in the zip file. Sources can also be passed in a Python list. .. versionchanged:: 2017.7.0 Globbing is now supported for this argument template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.cmd_zip template=jinja /tmp/zipfile.zip /tmp/sourcefile1,/tmp/{{grains.id}}.txt cwd : None Use this argument along with relative paths in ``sources`` to create zip files which do not contain the leading directories. If not specified, the zip file will be created as if the cwd was ``/``, and creating a zip file of ``/foo/bar/baz.txt`` will contain the parent directories ``foo`` and ``bar``. To create a zip file containing just ``baz.txt``, the following command would be used: .. code-block:: bash salt '*' archive.cmd_zip /tmp/baz.zip baz.txt cwd=/foo/bar .. versionadded:: 2014.7.1 runas : None Create the zip file as the specified user. Defaults to the user under which the minion is running. .. versionadded:: 2015.5.0 CLI Example: .. code-block:: bash salt '*' archive.cmd_zip /tmp/zipfile.zip /tmp/sourcefile1,/tmp/sourcefile2 # Globbing for sources (2017.7.0 and later) salt '*' archive.cmd_zip /tmp/zipfile.zip '/tmp/sourcefile*' r z-rr] Fr� )r, r� r� r6 r� )�zip_filer� r� r� r� r� r r r �cmd_zip� s : ��r� rE )Zfallback_functionc C sT |rt �� }t �� }td |�}|std|� d���t| |d|�\} }t|�}|s9|D ] } t j�| �s7td��q+nd} z t j�|�sFt| ��W n t yR t| ��w |ro||d ksa||d krot � |d � t � |d � d} �zz�g } t � t�| d tj|����} |D ]�} |r�t j�|| �} t j�| ��r"t j�| �r�d }n|dur�|nd }t j�| �r�tjj�| �D ]H\}}}|r�|�|�r�t j�||�}nt j�||�}|r�| �|d � | �||� |D ]}t j�||�}t j�||�}| �|� | �||� q�q�q�|�r| �|��rt j�| |�}nt j�| |�}| �|� | �| |� q�W d � n 1 �s.w Y W n t�yG } zW Y d} ~ nd} ~ ww W |�rVt � |� t � |� d t � v �sbd t � v �rx| du�rx| tj k�rqt d ��t d | � ���| S |�r�t � |� t � |� d t � v �s�d t � v �r�| du�r�| tj k�r�t d ��t d | � ���w )a8 Uses the ``zipfile`` Python module to create zip files .. versionchanged:: 2015.5.0 This function was rewritten to use Python's native zip file support. The old functionality has been preserved in the new function :mod:`archive.cmd_zip <salt.modules.archive.cmd_zip>`. For versions 2014.7.x and earlier, see the :mod:`archive.cmd_zip <salt.modules.archive.cmd_zip>` documentation. zip_file Path of zip file to be created sources Comma-separated list of sources to include in the zip file. Sources can also be passed in a Python list. .. versionchanged:: 2017.7.0 Globbing is now supported for this argument template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.zip template=jinja /tmp/zipfile.zip /tmp/sourcefile1,/tmp/{{grains.id}}.txt cwd : None Use this argument along with relative paths in ``sources`` to create zip files which do not contain the leading directories. If not specified, the zip file will be created as if the cwd was ``/``, and creating a zip file of ``/foo/bar/baz.txt`` will contain the parent directories ``foo`` and ``bar``. To create a zip file containing just ``baz.txt``, the following command would be used: .. code-block:: bash salt '*' archive.zip /tmp/baz.zip baz.txt cwd=/foo/bar runas : None Create the zip file as the specified user. Defaults to the user under which the minion is running. zip64 : False Used to enable ZIP64 support, necessary to create archives larger than 4 GByte in size. If true, will create ZIP file with the ZIPp64 extension when the zipfile is larger than 2 GB. ZIP64 extension is disabled by default in the Python native zip support because the default zip and unzip commands on Unix (the InfoZIP utilities) don't support these extensions. CLI Example: .. code-block:: bash salt '*' archive.zip /tmp/zipfile.zip /tmp/sourcefile1,/tmp/sourcefile2 # Globbing for sources (2017.7.0 and later) salt '*' archive.zip /tmp/zipfile.zip '/tmp/sourcefile*' � user.info�User '�' does not existNz*Relative paths require the 'cwd' parameterzcwd must be absolute�uid�gid�wr r� zrResulting zip file too large, would require ZIP64 supportwhich has not been enabled. Rerun command with zip64=Truez(Exception encountered creating zipfile: ) r� �geteuid�getegidr6 r �_render_filenamesr� r1 �isabsr5 �setegid�seteuidr" r# rE rF � ZIP_DEFLATEDrS �existsr- r' r( Zos_walk� startswith�relpathr, �writer� �vars�globalsZ LargeZipFiler )r� r� r� r� r� Zzip64�euid�egid�uinfo�src�err_msgr� Zarchived_files�zfileZrel_rootZdir_nameZsub_dirsr; Zarc_dirrH Zabs_nameZarc_namer r r r � s� ? �� � � � �� �� �� ��� ��� ��r �unzipc C s� t |t�rdd� |�d�D �}n t |ttf�r t|�g}dg}|r(|�d|g� |r2|�t�|�� |�| � d|� g� |durJ|�d� |�|� td |||d d |rVd nd d�} | d dkrft | d ��t | d � � |�S )a^ .. versionadded:: 2015.5.0 In versions 2014.7.x and earlier, this function was known as ``archive.unzip``. Uses the ``unzip`` command to unpack zip files. This command is part of the `Info-ZIP`_ suite of tools, and is typically packaged as simply ``unzip``. .. _`Info-ZIP`: http://www.info-zip.org/ zip_file Path of zip file to be unpacked dest The destination directory into which the file should be unpacked excludes : None Comma-separated list of files not to unpack. Can also be passed in a Python list. template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.cmd_unzip template=jinja /tmp/zipfile.zip '/tmp/{{grains.id}}' excludes=file_1,file_2 options Optional when using ``zip`` archives, ignored when usign other archives files. This is mostly used to overwrite existing files with ``o``. This options are only used when ``unzip`` binary is used. .. versionadded:: 2016.3.1 runas : None Unpack the zip file as the specified user. Defaults to the user under which the minion is running. .. versionadded:: 2015.5.0 trim_output : False The number of files we should output on success before the rest are trimmed, if this is set to True then it will default to 100 password Password to use with password protected zip files .. note:: This is not considered secure. It is recommended to instead use :py:func:`archive.unzip <salt.modules.archive.unzip>` for password-protected ZIP files. If a password is used here, then the unzip command run to extract the ZIP file will not show up in the minion log like most shell commands Salt runs do. However, the password will still be present in the events logged to the minion log at the ``debug`` log level. If the minion is logging at ``debug`` (or more verbose), then be advised that the password will appear in the log. .. versionadded:: 2016.11.0 CLI Example: .. code-block:: bash salt '*' archive.cmd_unzip /tmp/zipfile.zip /home/strongbad/ excludes=file_1,file_2 c S r� r r� r r r r r � r� z cmd_unzip.<locals>.<listcomp>r� r� z-Pz-dN�-xz cmd.run_allFT�quietr� )r� r� r �redirect_stderrZoutput_loglevel�retcoder r ) r r3 r4 r� r| r� r r, r6 r � _trim_filesr� ) r� r� �excludesr� r� r� � trim_output�passwordr� �resultr r r � cmd_unzip` s0 N � r� c s� � sg � |r t �� } t �� } td |�} | s td|� d���t| |d|�\} }|rC| | d ks5| | d krCt �| d � t �| d � �zz�g } t� t � | d����} | � � }t � t�rfdd � � �d �D �� n t � ttf�rrt� �g� | �� fd d �|D �� | D ]�}|� v�rtjj�� d u r�| �|�}t�|jd ? �r�| �|�}t � |t j � ||�� q�|r�t |t�r�t|�}t |t�r�|� � }| � |||� |�rtjj�� s�| �|�jd ? }|dkr�tjj!�"� }|�#d�r�d| @ }nd| @ }t �$t j � ||�|� q�| �|�jd@ }t%�&t j � ||�|� q�W d � n 1 �s w Y W n! t'�yE } z|�r:t �| � t �| � t(d|� ���d}~ww W |�rTt �| � t �| � n|�rct �| � t �| � w w t)| |�S )ay Uses the ``zipfile`` Python module to unpack zip files .. versionchanged:: 2015.5.0 This function was rewritten to use Python's native zip file support. The old functionality has been preserved in the new function :mod:`archive.cmd_unzip <salt.modules.archive.cmd_unzip>`. For versions 2014.7.x and earlier, see the :mod:`archive.cmd_zip <salt.modules.archive.cmd_zip>` documentation. zip_file Path of zip file to be unpacked dest The destination directory into which the file should be unpacked excludes : None Comma-separated list of files not to unpack. Can also be passed in a Python list. options This options are only used when ``unzip`` binary is used. In this function is ignored. .. versionadded:: 2016.3.1 template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.unzip template=jinja /tmp/zipfile.zip /tmp/{{grains.id}}/ excludes=file_1,file_2 runas : None Unpack the zip file as the specified user. Defaults to the user under which the minion is running. trim_output : False The number of files we should output on success before the rest are trimmed, if this is set to True then it will default to 100 CLI Example: .. code-block:: bash salt '*' archive.unzip /tmp/zipfile.zip /home/strongbad/ excludes=file_1,file_2 password Password to use with password protected zip files .. note:: The password will be present in the events logged to the minion log file at the ``debug`` log level. If the minion is logging at ``debug`` (or more verbose), then be advised that the password will appear in the log. .. versionadded:: 2016.3.0 extract_perms : True The Python zipfile_ module does not extract file/directory attributes by default. When this argument is set to ``True``, Salt will attempt to apply the file permission attributes to the extracted files/folders. On Windows, only the read-only flag will be extracted as set within the zip file, other attributes (i.e. user/group permissions) are ignored. Set this argument to ``False`` to disable this behavior. .. versionadded:: 2016.11.0 .. _zipfile: https://docs.python.org/2/library/zipfile.html CLI Example: .. code-block:: bash salt '*' archive.unzip /tmp/zipfile.zip /home/strongbad/ password='BadPassword' r� r� r� Nr� r� �rc S r� r r� r r r r r A r� zunzip.<locals>.<listcomp>r� c s g | ]}|� vr|�qS r r r �r� r r r E s Fr@ r r i� i� � z)Exception encountered unpacking zipfile: )*r� r� r� r6 r r� r� r� r" r# rE rF Znamelistr r3 r4 r� r| r� r' r( rI rJ ZgetinforN rO rM �read�symlinkr1 rS �encode�extractr; Z get_umaskrK �chmod� win32fileZSetFileAttributesr� r r� )r� r� r� r� r� r� r� r� Z extract_permsr� r� r� Z cleaned_filesr� r; �targetr r� �permZumask_Z win32_attrr� r r� r r� � s� Z ��� ��( ��� �� � c C s< t d | |||d�}|std| � ���d|i}z t�t�|��� }|�� W d � n1 s/w Y W n, ty@ d}Y n$ tjyP t| � d�|d�� t ya } zt| |d��d} ~ ww d }|r�zt � |� t � d |� W |S ty� } z| jtjkr�t �d || � W Y d} ~ |S W Y d} ~ |S d} ~ ww |S ) a� .. versionadded:: 2016.11.0 .. versionchanged:: 3005 Returns ``True`` if the zip archive is password-protected, ``False`` if not. If the specified file is not a ZIP archive, an error will be raised. name The path / URL of the archive to check. clean : False Set this value to ``True`` to delete the path referred to by ``name`` once the contents have been listed. This option should be used with care. .. note:: If there is an error listing the archive's contents, the cached file will not be removed, to allow for troubleshooting. saltenv : base Specifies the fileserver environment from which to retrieve ``archive``. This is only applicable when ``archive`` is a file from the ``salt://`` fileserver. source_hash If ``name`` is an http(s)/ftp URL and the file exists in the minion's file cache, this option can be passed to keep the minion from re-downloading the archive if the cached copy matches the specified hash. .. versionadded:: 2018.3.0 use_etag If ``True``, remote http/https file sources will attempt to use the ETag header to determine if the remote file needs to be downloaded. This provides a lightweight mechanism for promptly refreshing files changed on a web server without requiring a full hash comparison via the ``source_hash`` parameter. .. versionadded:: 3005 CLI Examples: .. code-block:: bash salt '*' archive.is_encrypted /path/to/myfile.zip salt '*' archive.is_encrypted salt://foo.zip salt '*' archive.is_encrypted salt://foo.zip saltenv=dev salt '*' archive.is_encrypted https://domain.tld/myfile.zip clean=True salt '*' archive.is_encrypted https://domain.tld/myfile.zip source_hash=f1d2d2f924e986ac86fdf7b36c94bcdf32beec15 salt '*' archive.is_encrypted ftp://10.1.2.3/foo.zip rh ri rl r{ NTrC r Frr rs )r6 r r" r# rE rF Ztestzip� RuntimeErrorrV r� r� rU r� r� r� r� r� r� ) r r� r� rj rk r9 Z archive_inforW r� r� r r r � is_encryptedu sD 5� �� �� � ���r� r\ c C s6 ddd| � g}|� t|�� td ||||dd��� S )a Uses `rar for Linux`_ to create rar files .. _`rar for Linux`: http://www.rarlab.com/ rarfile Path of rar file to be created sources Comma-separated list of sources to include in the rar file. Sources can also be passed in a Python list. .. versionchanged:: 2017.7.0 Globbing is now supported for this argument cwd : None Run the rar command from the specified directory. Use this argument along with relative file paths to create rar files which do not contain the leading directories. If not specified, this will default to the home directory of the user under which the salt minion process is running. .. versionadded:: 2014.7.1 template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.rar template=jinja /tmp/rarfile.rar '/tmp/sourcefile1,/tmp/{{grains.id}}.txt' CLI Example: .. code-block:: bash salt '*' archive.rar /tmp/rarfile.rar /tmp/sourcefile1,/tmp/sourcefile2 # Globbing for sources (2017.7.0 and later) salt '*' archive.rar /tmp/rarfile.rar '/tmp/sourcefile*' r\ �a�-idpr] Fr� )r� r� r6 r� )r` r� r� r� r� r� r r r r\ � s * ����unrarr\ c C s� t |t�rdd� |�d�D �}tjj�d�dd| � g}|dur,|D ] }|�d|� g� q!|�|� � t d |||d d �� � }t ||�S ) a9 Uses `rar for Linux`_ to unpack rar files .. _`rar for Linux`: http://www.rarlab.com/ rarfile Name of rar file to be unpacked dest The destination directory into which to **unpack** the rar file template : None Can be set to 'jinja' or another supported template engine to render the command arguments before execution: .. code-block:: bash salt '*' archive.unrar template=jinja /tmp/rarfile.rar /tmp/{{grains.id}}/ excludes=file_1,file_2 trim_output : False The number of files we should output on success before the rest are trimmed, if this is set to True then it will default to 100 CLI Example: .. code-block:: bash salt '*' archive.unrar /tmp/rarfile.rar /home/strongbad/ excludes=file_1,file_2 c S r� r r� )r �entryr r r r r� zunrar.<locals>.<listcomp>r� r� r r� Nr� r] Fr� ) r r3 r4 r' r( r1 � which_binr� r, r6 r� r� ) r` r� r� r� r� r� r� Zexcluder; r r r r� � s" � �� r� c sz �s| |fS �t jjjvrtd�� ���i � t� d< t� d< t� d< t� d< |� d< � �fdd�}|| �} ||�}| |fS ) z� Process markup in the :param:`filenames` and :param:`zipfile` variables (NOT the files under the paths they ultimately point to) according to the markup format provided by :param:`template`. z7Attempted to render file paths with unavailable engine r' ZpillarZgrains�optsr� c s� t jj�� }t jj�|d��}|�t jj�| �� W d � n1 s#w Y t jjj � |fddi� ��}t jj� |� |d sKt d� |d ���|d S )z� Render :param:`contents` into a literal pathname by writing it to a temp file, rendering that file, and returning the result. zw+N�to_strTr� z)Failed to render file path with error: {}r) ) r' r( r; ZmkstempZfopenr� Z stringutilsr� � templates�TEMPLATE_REGISTRYZsafe_rmr r8 )�contentsZ tmp_path_fnZfp_r) ��kwargsr� r r �_renderB s" � ��� �z"_render_filenames.<locals>._render) r' r( r� r� r r6 Z __pillar__Z __grains__Z__opts__)� filenamesr� r� r� r� r r� r r� , s �r� c C sR d}t |t�s |}t |t�r|du s't| �|kr'| d|� } | �d|� d�� | S )z( Trim the file list for output. �d FNzList trimmed after z files.)r �bool�lenr, )r; r� rw r r r r� \ s � r� )NNNFFr NF)NNNNN)NNN)NNNF)NNNNFN)NNNNFNT)Fr NF);�__doc__r" rQ r� r� �loggingr� rb r rN r r$ � urllib.parser~ rE Zsalt.utils.decoratorsr' Zsalt.utils.decorators.pathZsalt.utils.filesZsalt.utils.pathZsalt.utils.platformZsalt.utils.stringutilsZsalt.utils.templatesZsalt.exceptionsr r r` r_ � ImportErrorr( rI rJ r� Z__func_alias__� getLogger�__name__r� r �compiler� r� r� Z decoratorsr1 r2 r r� r� r� Zdependsr r� r� r� r\ r� r� r� r� r r r r �<module> s� � � Y & & A �o � )R 0 3 0
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings