| Dir : /proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : //proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/macdefaults.py |
"""
Set defaults on Mac OS
"""
import logging
import salt.utils.platform
log = logging.getLogger(__name__)
__virtualname__ = "macdefaults"
def __virtual__():
"""
Only work on Mac OS
"""
if salt.utils.platform.is_darwin():
return __virtualname__
return False
def write(domain, key, value, type="string", user=None):
"""
Write a default to the system
CLI Example:
.. code-block:: bash
salt '*' macdefaults.write com.apple.CrashReporter DialogType Server
salt '*' macdefaults.write NSGlobalDomain ApplePersistence True type=bool
domain
The name of the domain to write to
key
The key of the given domain to write to
value
The value to write to the given key
type
The type of value to be written, valid types are string, data, int[eger],
float, bool[ean], date, array, array-add, dict, dict-add
user
The user to write the defaults to
"""
if type == "bool" or type == "boolean":
if value is True:
value = "TRUE"
elif value is False:
value = "FALSE"
cmd = f'defaults write "{domain}" "{key}" -{type} "{value}"'
return __salt__["cmd.run_all"](cmd, runas=user)
def read(domain, key, user=None):
"""
Read a default from the system
CLI Example:
.. code-block:: bash
salt '*' macdefaults.read com.apple.CrashReporter DialogType
salt '*' macdefaults.read NSGlobalDomain ApplePersistence
domain
The name of the domain to read from
key
The key of the given domain to read from
user
The user to read the defaults as
"""
cmd = f'defaults read "{domain}" "{key}"'
return __salt__["cmd.run"](cmd, runas=user)
def delete(domain, key, user=None):
"""
Delete a default from the system
CLI Example:
.. code-block:: bash
salt '*' macdefaults.delete com.apple.CrashReporter DialogType
salt '*' macdefaults.delete NSGlobalDomain ApplePersistence
domain
The name of the domain to delete from
key
The key of the given domain to delete
user
The user to delete the defaults with
"""
cmd = f'defaults delete "{domain}" "{key}"'
return __salt__["cmd.run_all"](cmd, runas=user, output_loglevel="debug")