mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 08:58:59 +00:00
Removed mac_update module
This commit is contained in:
twangboy
parent
d5eb0f39b0
commit
0e1c4b0cb1
@ -1,348 +0,0 @@
|
||||
'''
|
||||
Manage Software Updates on Mac OS X 10.11+
|
||||
'''
|
||||
|
||||
# Import python libs
|
||||
from __future__ import absolute_import
|
||||
import logging
|
||||
import re
|
||||
|
||||
# Import 3rdp-party libs
|
||||
|
||||
# Import salt libs
|
||||
import salt.utils
|
||||
|
||||
log = logging.getLogger(__name__)
|
||||
|
||||
# Define the module's virtual name
|
||||
__virtualname__ = 'updates'
|
||||
|
||||
|
||||
def __virtual__():
|
||||
if not salt.utils.is_darwin():
|
||||
return False
|
||||
|
||||
return __virtualname__
|
||||
|
||||
|
||||
def _parse_packages(output):
|
||||
'''
|
||||
Parse package listing from `softwareupdate` tool.
|
||||
'''
|
||||
lines = output.splitlines()
|
||||
|
||||
titles = [re.match('^\s*\*\s+(.*)', line).group(1) for line in lines if re.search('^\s*\*\s+', line)]
|
||||
descriptions = [re.match('^\t+(.*)', line).group(1) for line in lines if re.search('^\t+', line)]
|
||||
return dict(zip(titles, descriptions))
|
||||
|
||||
|
||||
def scheduled():
|
||||
'''
|
||||
Determine the status of the automatic checking schedule
|
||||
|
||||
:return: True if automatic checking is on, False if not
|
||||
:rtype: bool
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.scheduled
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --schedule'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
if 'on' in out:
|
||||
return True
|
||||
else:
|
||||
return False
|
||||
|
||||
|
||||
def schedule(enabled):
|
||||
'''
|
||||
Enable/Disable the automatic checking schedule.
|
||||
|
||||
:param bool enabled: True to enable automatic checking, False to disable
|
||||
|
||||
:return: True if successful, False if not
|
||||
:rtype: bool
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.schedule True
|
||||
'''
|
||||
if enabled:
|
||||
cmd = '/usr/sbin/softwareupdate --schedule on'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
else:
|
||||
cmd = '/usr/sbin/softwareupdate --schedule off'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
return enabled == scheduled()
|
||||
|
||||
|
||||
def list():
|
||||
'''
|
||||
List available software updates. (Warning: can take a while to execute)
|
||||
|
||||
:return: A dictionary containing a list of available updates
|
||||
:rtype: dict
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.list
|
||||
'''
|
||||
log.debug('Fetching available updates, this may take some time')
|
||||
cmd = '/usr/sbin/softwareupdate -l'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
packages = _parse_packages(out)
|
||||
|
||||
if not packages:
|
||||
return 'No new software available'
|
||||
|
||||
return packages
|
||||
|
||||
|
||||
def download(name):
|
||||
'''
|
||||
Download the update specified in the name. Get the name from ``update.list``
|
||||
. (Warning: can take a while to execute depending on the size of the
|
||||
download)
|
||||
|
||||
:param str name: The name of the update to download
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.download 'OS X El Capitan Update 10.11.2'
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate -d {0}'.format(name)
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
return out
|
||||
|
||||
|
||||
def cancel_download(name):
|
||||
'''
|
||||
Cancel the download of the update specified in the name.
|
||||
|
||||
:param str name: The name of the update to stop downloading
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.cancel_download 'OS X El Capitan Update 10.11.2'
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate -e {0}'.format(name)
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
return out
|
||||
|
||||
|
||||
def _install_command(cmd):
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
if 'Done' in out:
|
||||
return True
|
||||
elif 'No such' in out:
|
||||
return 'No update named {0}'.format(name)
|
||||
elif 'No updates' in out:
|
||||
return 'No updates are available'
|
||||
else:
|
||||
return False
|
||||
|
||||
|
||||
def install(name):
|
||||
'''
|
||||
Install the update specified in the name
|
||||
|
||||
:param str name: The name of the update to install. Get the name using
|
||||
``updates.list``.(Warning: this can take some time. The update must be
|
||||
downloaded and installed.)
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.install 'iTunesXPatch-12.1.2'
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate -i {0}'.format(name)
|
||||
return _install_command(cmd)
|
||||
|
||||
|
||||
def install_all():
|
||||
'''
|
||||
Install all pending software updates (Warning: this can take some time. Each
|
||||
update must be downloaded and installed.)
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.install_all
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate -i -a'
|
||||
return _install_command(cmd)
|
||||
|
||||
|
||||
def install_recommended():
|
||||
'''
|
||||
Install all recommended software updates (Warning: this can take some time.
|
||||
Each update must be downloaded and installed.)
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.install_recommended
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate -i -r'
|
||||
return _install_command(cmd)
|
||||
|
||||
|
||||
def _parse_ignored(ignored_string):
|
||||
ignored = []
|
||||
for line in ignored_string.splitlines():
|
||||
if re.search('^\s{4}(.*)', line):
|
||||
ignored.append(re.match('^\s{4}(.*)', line).group(1).rstrip(','))
|
||||
|
||||
return ignored
|
||||
|
||||
|
||||
def list_ignored():
|
||||
'''
|
||||
List updates which have been ignored
|
||||
|
||||
:return: A list of ignored updates
|
||||
:rtype: list
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.list_ignored
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --ignore'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
return _parse_ignored(out)
|
||||
|
||||
|
||||
def clear_ignored():
|
||||
'''
|
||||
Clear the list of ignored updates
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.clear_ignored
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --reset-ignored'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
|
||||
return _parse_ignored(out)
|
||||
|
||||
|
||||
def ignore(name):
|
||||
'''
|
||||
Ignore the update specified in the name
|
||||
|
||||
:param str name: The name of the update to place on the ignore list
|
||||
|
||||
:return: The results of the command
|
||||
:rtype: str
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.ignore iTunesXPatch-12.1.2
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --ignore {0}'.format(name)
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
return _parse_ignored(out)
|
||||
|
||||
|
||||
def get_catalog():
|
||||
'''
|
||||
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 '*' updates.get_catalog
|
||||
'''
|
||||
cmd = 'defaults read /Library/Preferences/com.apple.SoftwareUpdate.plist'
|
||||
out = __salt__['cmd.run_stdout'](cmd)
|
||||
|
||||
if 'CatalogURL' in out:
|
||||
cmd = '{0} CatalogURL'.format(cmd)
|
||||
out = __salt__['cmd.run_stdout'](cmd)
|
||||
return out
|
||||
else:
|
||||
return 'Default'
|
||||
|
||||
|
||||
def set_catalog(url):
|
||||
'''
|
||||
Set the Software Update Catalog to the URL specified
|
||||
|
||||
:param str url: The url to the update catalog
|
||||
|
||||
:return: True if successfult, False if not
|
||||
:rtype: bool
|
||||
|
||||
CLI Example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
salt '*' updates.set_url http://swupd.local:8888/index.sucatalog
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --set-catalog {0}'.format(url)
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
if url in out:
|
||||
return True
|
||||
else:
|
||||
return False
|
||||
|
||||
|
||||
def reset_catalog():
|
||||
'''
|
||||
Reset the Software Update Catalog to the default.
|
||||
|
||||
:return: True if successful, False if not
|
||||
:rtype: bool
|
||||
'''
|
||||
cmd = '/usr/sbin/softwareupdate --clear-catalog'
|
||||
out = __salt__['cmd.run'](cmd)
|
||||
return 'Default' == get_catalog()
|
||||
Loading…
Reference in New Issue
Block a user