Current File : //usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyo
�
���^c @@ sG 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
m Z m Z d Z d � Z e e d � Z e e d � Z d � Z d
� Z d � Z d � Z d
� Z e e d � Z d � Z d � Z d � Z d � Z e e d � Z d � Z! d � Z" d � Z# d S( u2
Support for the softwareupdate command on MacOS.
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionErrort SaltInvocationErroru softwareupdatec C@ s t j j j � s t d f St S( u
Only for MacOS
uR The softwareupdate module could not be loaded: module only works on MacOS systems.( t saltt utilst platformt is_darwint Falset __virtualname__( ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt __virtual__ s
c @ s/ d d g } t j j j | � } t j d � } t j j j | � rW t j d � } n d d g � � f d � } | j | � } i } x6 | D]. } | | d � } | | d � }
|
| | <q� Wt j j j | � s� | St j d � } | j | � } i }
x+ | D]# } | | k r| | |
| <qqW|
S( u
Utility function to get all available update packages.
Sample return date:
{ 'updatename': '1.2.3-45', ... }
u softwareupdateu --listu( (?m)^ [*|-] ([^ ].*)[\r\n].*\(([^\)]+)u& (?m)^ [*] ([^ ].*)[\r\n].*\(([^\)]+)u nameu versionc @ s | � j | � S( N( t index( t lt k( t keys( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt <lambda>< s u& (?m)^ [*|-] ([^ ].*)[\r\n].*restart*( R R t mac_utilst execute_return_resultt ret compilet datat is_truet findall( t recommendedt restartt cmdt outt rexpt _gett updatest rett linet namet version_numt rexp1t restart_updatest ret_restartt update( ( R sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt _get_available" s,
c C@ s
t | | � S( uL
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 ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt list_availableX s c C@ sE | j d d � d } d d | g } t j j j | � | t � k S( u-
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>
u -i i u softwareupdateu --ignore( t rsplitR R R t execute_return_successt list_ignored( R! t to_ignoreR ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt ignorel s c C@ s@ d d d g } t j j j | � } t j d � } | j | � S( uE
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
u softwareupdateu --listu --ignoreu' (?m)^ ["]?([^,|\s].*[^"|\n|,])[,|"]?( R R R R R R R ( R R R ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyR+ � s c C@ s, d d g } t j j j | � t � g k S( u#
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
u softwareupdateu --reset-ignored( R R R R* R+ ( R ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt
reset_ignored� s c C@ sJ d d g } t j j j | � } | j � d } t j j j | � d k S( u�
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
u softwareupdateu
--schedulei����u on( R R R R t splitt validate_enabled( R R t enabled( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt schedule_enabled� s c C@ sb t j j j | � } d d t j j j | � g } t j j j | � t j j j t � � | k S( u�
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
u softwareupdateu
--schedule( R R R R0 R* R2 ( t enablet statusR ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt schedule_enable� s c C@ s� t | | � } | s i Sx0 | D]( } d d | g } t j j j | � q Wi } t � } x* | D]" } | | k rz t n t | | <qb W| S( u�
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
u softwareupdateu --install( R' R R R R* t TrueR ( R R t to_updatet _updateR R t updates_left( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt
update_all� s
c C@ sQ t | � s$ t d j | � � � n d d | g } t j j j | � t | � S( u
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>
u Update not available: {0}u softwareupdateu --install( t update_availableR t formatR R R R* ( R! R ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyR& s
c C@ s
| t � k S( uv
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! ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyR; , s c C@ s g } xS t j j j d � D]< \ } } } x* | D]" } | j t j j | | � � q2 Wq Wg } x- | D]% } | j d � ri | j | � qi qi Wg } x� t � D]v } xm | D]e } t j j j
| � �H } | j d d � d t j j j
| j � � k r| j | � n Wd QXq� Wq� W| S( u�
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
u /Library/Updatesu .distu -i i N( R R t patht os_walkt appendt ost joint endswithR' t filest fopenR) t stringutilst
to_unicodet read( t outfilest roott subFolderRC t ft
dist_filesR R& t fhr( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt list_downloads? s
%
$
1 c C@ sf t | � s$ t d j | � � � n | t � k r7 t Sd d | g } t j j j | � | t � k S( uK
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>
u Update not available: {0}u softwareupdateu
--download( R; R R< RN R6 R R R R* ( R! R ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt download` s c C@ s1 t | | � } x | D] } t | � q Wt � S( u~
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' RO RN ( R R t to_downloadR! ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt download_all| s
c C@ s� d d d g } t j j j | � } d | k rV | j d � t j j j | � } | Sd | k r� | j d � t j j j | � } | Sd Sd S( ur
.. 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
u defaultsu readu3 /Library/Preferences/com.apple.SoftwareUpdate.plistu AppleCatalogURLu
CatalogURLu DefaultN( R R R R R? ( R R ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt get_catalog� s
c C@ sI d d | g } y t j j j | � Wn t k
r; } n Xt � | k S( uS
.. 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
u softwareupdateu
--set-catalog( R R R R* R RR ( t urlR t exc( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt set_catalog� s c C@ sF d d g } y t j j j | � Wn t k
r8 } n Xt � d k S( u�
.. 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
u softwareupdateu --clear-catalogu Default( R R R R* R RR ( R RT ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt
reset_catalog� s ($ t __doc__t
__future__R R R R R@ t salt.utils.dataR t salt.utils.filest salt.utils.patht salt.utils.mac_utilst salt.utils.platformt salt.exceptionsR R R
R R R' R( R- R+ R. R2 R5 R6 R: R& R; RN RO RQ RR RU RV ( ( ( sC /usr/lib/python2.7/site-packages/salt/modules/mac_softwareupdate.pyt <module> s6 6 ) ! "
Mini Shell