File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/mac_softwareupdate.cpython-310.pyc
Back
o ;j: � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddl m Z m Z dZ dd� Z d)dd �Zd)d d �Zd d � Zdd� Zdd� Zdd� Zdd� Zd*dd�Zdd� Zdd � Zd d � Zd d � Zd*d!d"�Zd#d$� Zd%d&� Z d'd(� Z dS )+z2 Support for the softwareupdate command on MacOS. � N)�CommandExecutionError�SaltInvocationError�softwareupdatec C s t jj�� sdS tS )z Only for MacOS )FzRThe softwareupdate module could not be loaded: module only works on MacOS systems.)�salt�utils�platformZ is_darwin�__virtualname__� r r �S/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/mac_softwareupdate.py� __virtual__ s r Fc s� ddg}t jj�|�}td d dkstd d dkr!t�d�}nt�d �}g � t jj�| �r6� � d d � � t jj�|�rD� � d d � � t jj�|�rR� � d d � � � fdd�|� |�D �S )z Utility function to get all available update packages. Sample return date: { 'updatename': '1.2.3-45', ... } r �--listZosrelease_infor � � � z�(?m)^\s*[*-] Label: (?P<name>[^ ].*)[\r\n].*Version: (?P<version>[^,]*), Size: (?P<size>[^,]*),\s*(?P<recommended>Recommended: YES,)?\s*(?P<action>Action: (?:restart|shut down),)?z�(?m)^\s+[*-] (?P<name>.*)[\r\n].*\((?P<version>[^ \)]*)[^\r\n\[]*(?P<recommended>\[recommended\])?\s?(?P<action>\[(?:restart|shut down)\])?c S s | � d�S )N� recommended��group��mr r r �<lambda>\ s z _get_available.<locals>.<lambda>c S � d| � d�pdv S )N�restart�action� r r r r r r _ � c S r )Nz shut downr r r r r r r r c r c s4 i | ]� t � fd d��D ��r� �d�� �d��qS )c 3 s � | ]}|� �V qd S )Nr )�.0�fr r r � <genexpr>i s � z,_get_available.<locals>.<dictcomp>.<genexpr>�name�version)�allr )r �Z conditionsr r � <dictcomp>f s ��z"_get_available.<locals>.<dictcomp>) r r � mac_utils�execute_return_resultZ __grains__�re�compile�dataZis_true�append�finditer)r r � shut_down�cmd�out�rexpr r! r �_get_available s. �� �� �r. c C s t | ||�S )aL List all available updates. :param bool recommended: Show only recommended updates. :param bool restart: Show only updates that require a restart. :return: Returns a dictionary containing the updates :rtype: dict CLI Example: .. code-block:: bash salt '*' softwareupdate.list_available �r. )r r r* r r r �list_availablem s r0 c C s2 | � dd�d }dd|g}tjj�|� |t� v S )a- Ignore a specific program update. When an update is ignored the '-' and version number at the end will be omitted, so "SecUpd2014-001-1.0" becomes "SecUpd2014-001". It will be removed automatically if present. An update is successfully ignored when it no longer shows up after list_updates. :param name: The name of the update to add to the ignore list. :ptype: str :return: True if successful, False if not :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.ignore <update-name> �-r r r �--ignore)�rsplitr r r# �execute_return_success� list_ignored)r Z to_ignorer+ r r r �ignore� s r6 c C s* g d�} t jj�| �}t�d�}|�|�S )aE List all updates that have been ignored. Ignored updates are shown without the '-' and version number at the end, this is how the softwareupdate command works. :return: The list of ignored updates :rtype: list CLI Example: .. code-block:: bash salt '*' softwareupdate.list_ignored )r r r2 z'(?m)^ ["]?([^,|\s].*[^"|\n|,])[,|"]?)r r r# r$ r% r& �findall)r+ r, r- r r r r5 � s r5 c C s ddg} t jj�| � t� g kS )a# Make sure the ignored updates are not ignored anymore, returns a list of the updates that are no longer ignored. :return: True if the list was reset, Otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.reset_ignored r z--reset-ignored)r r r# r4 r5 )r+ r r r � reset_ignored� s r8 c C s4 ddg} t jj�| �}|�� d }t jj�|�dkS )z� Check the status of automatic update scheduling. :return: True if scheduling is enabled, False if disabled :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.schedule_enabled r � --schedule����on)r r r# r$ �split�validate_enabled)r+ �ret�enabledr r r �schedule_enabled� s r@ c C sD t jj�| �}ddt jj�|�g}t jj�|� t jj�t� �|kS )a� Enable/disable automatic update scheduling. :param enable: True/On/Yes/1 to turn on automatic updates. False/No/Off/0 to turn off automatic updates. If this value is empty, the current status will be returned. :type: bool str :return: True if scheduling is enabled, False if disabled :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.schedule_enable on|off r r9 )r r r# r= r4 r@ )�enable�statusr+ r r r �schedule_enable� s �rC Tc C s` t | |�}|s i S |D ]}dd|g}tjj�|� q i }t � }|D ] }||vr)dnd||< q!|S )a� Install all available updates. Returns a dictionary containing the name of the update and the status of its installation. :param bool recommended: If set to True, only install the recommended updates. If set to False (default) all updates are installed. :param bool restart: Set this to False if you do not want to install updates that require a restart. Default is True :return: A dictionary containing the updates that were installed and the status of its installation. If no updates were installed an empty dictionary is returned. :rtype: dict CLI Example: .. code-block:: bash salt '*' softwareupdate.update_all r � --installTF)r. r r r# r4 )r r Z to_updateZ_updater+ r> Z updates_leftr r r � update_all s rE c C s8 t | �s td| � ���dd| g}tjj�|� t | � S )a Install a named update. :param str name: The name of the of the update to install. :return: True if successfully updated, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.update <update-name> �Update not available: r rD )�update_availabler r r r# r4 �r r+ r r r �update* s rI c C s | t � v S )av Check whether or not an update is available with a given name. :param str name: The name of the update to look for :return: True if available, False if not :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.update_available <update-name> salt '*' softwareupdate.update_available "<update with whitespace>" r/ )r r r r rG B s rG c C s� g } t jj�d�D ]\}}}|D ] }| �tj�||�� qq g }| D ] }|�d�r.|�|� q"g }t� D ]4}|D ]/}t jj � |�� }|� dd�d t jj � |�� �v rX|�|� W d � n1 sbw Y q8q4|S )z� Return a list of all updates that have been downloaded locally. :return: A list of updates that have been downloaded :rtype: list CLI Example: .. code-block:: bash salt '*' softwareupdate.list_downloads z/Library/Updatesz.distr1 r r N)r r �pathZos_walkr( �os�join�endswithr. �filesZfopenr3 Z stringutilsZ to_unicode�read) Zoutfiles�rootZ subFolderrN r Z dist_filesr> rI Zfhrr r r �list_downloadsU s. � � � � ���rQ c C sF t | �s td| � ���| t� v rdS dd| g}tjj�|� | t� v S )aK Download a named update so that it can be installed later with the ``update`` or ``update_all`` functions :param str name: The update to download. :return: True if successful, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdate.download <update name> rF Tr z --download)rG r rQ r r r# r4 rH r r r �downloadx s rR c C s" t | |�}|D ]}t|� qt� S )a~ Download all available updates so that they can be installed later with the ``update`` or ``update_all`` functions. It returns a list of updates that are now downloaded. :param bool recommended: If set to True, only install the recommended updates. If set to False (default) all updates are installed. :param bool restart: Set this to False if you do not want to install updates that require a restart. Default is True :return: A list containing all downloaded updates on the system. :rtype: list CLI Example: .. code-block:: bash salt '*' softwareupdate.download_all )r. rR rQ )r r Z to_downloadr r r r � download_all� s rS c C sb g d�} t jj�| �}d|v r | �d� t jj�| �}|S d|v r/| �d� t jj�| �}|S dS )ar .. versionadded:: 2016.3.0 Get the current catalog being used for update lookups. Will return a url if a custom catalog has been specified. Otherwise the word 'Default' will be returned :return: The catalog being used for update lookups :rtype: str CLI Example: .. code-block:: bash salt '*' softwareupdates.get_catalog )�defaultsrO z3/Library/Preferences/com.apple.SoftwareUpdate.plistZAppleCatalogURLZ CatalogURL�Default)r r r# r$ r( )r+ r, r r r � get_catalog� s rV c C sL dd| g}z t jj�|� W n ty } zW Y d}~nd}~ww t� | kS )aS .. versionadded:: 2016.3.0 Set the Software Update Catalog to the URL specified :param str url: The url to the update catalog :return: True if successful, False if not :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdates.set_catalog http://swupd.local:8888/index.sucatalog r z --set-catalogN�r r r# r4 r rV )�urlr+ �excr r r � set_catalog� s �� rZ c C sJ ddg} z t jj�| � W n ty } zW Y d}~nd}~ww t� dkS )z� .. versionadded:: 2016.3.0 Reset the Software Update Catalog to the default. :return: True if successful, False if not :rtype: bool CLI Example: .. code-block:: bash salt '*' softwareupdates.reset_catalog r z--clear-catalogNrU rW )r+ rY r r r � reset_catalog� s �� r[ )FFF)FT) �__doc__rK r% Zsalt.utils.datar Zsalt.utils.filesZsalt.utils.mac_utilsZsalt.utils.pathZsalt.utils.platformZsalt.exceptionsr r r r r. r0 r6 r5 r8 r@ rC rE rI rG rQ rR rS rV rZ r[ r r r r �<module> s6 M )#
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings