Current File : //usr/lib/python2.7/site-packages/salt/modules/mac_power.pyc
�
���^c @@ s( d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l
m Z d d l m
Z
d Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" d S( uI
Module for editing power settings on macOS
.. versionadded:: 2016.3.0
i ( t absolute_importt unicode_literalst print_functionN( t SaltInvocationError( t six( t rangeu powerc C@ s t j j j � s t d f St S( u
Only for macOS
uM The mac_power module could not be loaded: module only works on macOS systems.( t saltt utilst platformt is_darwint Falset __virtualname__( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt __virtual__ s
c C@ s� t | t j � rF | j � d k r( d Sd j | � } t | � � n� t | t � r� | ry d j | � } t | � � q� d Sna t | t � r� | t d d � k r� | Sd j | � } t | � � n d j | � } t | � � d
S( uA
Helper function that validates the minutes parameter. Can be any number
between 1 and 180. Can also be the string values "Never" and "Off".
Because "On" and "Off" get converted to boolean values on the command line
it will error if "On" is passed
Returns: The value to be passed to the command
u neveru offu NeveruU Invalid String Value for Minutes.
String values must be "Never" or "Off".
Passed: {0}u� Invalid Boolean Value for Minutes.
Boolean value "On" or "True" is not allowed.
Salt CLI converts "On" to boolean True.
Passed: {0}i i� uX Invalid Integer Value for Minutes.
Integer values must be between 1 and 180.
Passed: {0}u5 Unknown Variable Type Passed for Minutes.
Passed: {0}N( u neveru off( t
isinstanceR t string_typest lowert formatR t boolt intR ( t minutest msg( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt _validate_sleep! s* c C@ s" i t � d 6t � d 6t � d 6S( uI
Displays the amount of idle time until the machine sleeps. Settings for
Computer, Display, and Hard Disk are displayed.
:return: A dictionary containing the sleep status for Computer, Display, and
Hard Disk
:rtype: dict
CLI Example:
.. code-block:: bash
salt '*' power.get_sleep
u Computeru Displayu Hard Disk( t get_computer_sleept get_display_sleept get_harddisk_sleep( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_sleepK s
c C@ sw t | � } d j | � } t j j j | � g } x6 t t t f D]% } | j t j j j
| | � � qD Wt | � S( u�
Sets the amount of idle time until the machine sleeps. Sets the same value
for Computer, Display, and Hard Disk. Pass "Never" or "Off" for computers
that should never sleep.
:param minutes: Can be an integer between 1 and 180 or "Never" or "Off"
:ptype: int, str
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_sleep 120
salt '*' power.set_sleep never
u systemsetup -setsleep {0}( R R R R t mac_utilst execute_return_successR R R t appendt confirm_updatedt all( R t valuet cmdt statet check( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_sleep` s c C@ s( t j j j d � } t j j j | � S( u�
Display the amount of idle time until the computer sleeps.
:return: A string representing the sleep settings for the computer
:rtype: str
CLI Example:
..code-block:: bash
salt '*' power.get_computer_sleep
u systemsetup -getcomputersleep( R R R t execute_return_resultt parse_return( t ret( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyR � s
c C@ sJ t | � } d j | � } t j j j | � t j j j t | � t � S( u�
Set the amount of idle time until the computer sleeps. Pass "Never" of "Off"
to never sleep.
:param minutes: Can be an integer between 1 and 180 or "Never" or "Off"
:ptype: int, str
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_computer_sleep 120
salt '*' power.set_computer_sleep off
u! systemsetup -setcomputersleep {0}( R R R R R R R t strR ( R R R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_computer_sleep� s c C@ s( t j j j d � } t j j j | � S( u�
Display the amount of idle time until the display sleeps.
:return: A string representing the sleep settings for the displey
:rtype: str
CLI Example:
..code-block:: bash
salt '*' power.get_display_sleep
u systemsetup -getdisplaysleep( R R R R$ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyR � s
c C@ sJ t | � } d j | � } t j j j | � t j j j t | � t � S( u�
Set the amount of idle time until the display sleeps. Pass "Never" of "Off"
to never sleep.
:param minutes: Can be an integer between 1 and 180 or "Never" or "Off"
:ptype: int, str
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_display_sleep 120
salt '*' power.set_display_sleep off
u systemsetup -setdisplaysleep {0}( R R R R R R R R' R ( R R R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_display_sleep� s c C@ s( t j j j d � } t j j j | � S( u�
Display the amount of idle time until the hard disk sleeps.
:return: A string representing the sleep settings for the hard disk
:rtype: str
CLI Example:
..code-block:: bash
salt '*' power.get_harddisk_sleep
u systemsetup -getharddisksleep( R R R R$ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyR � s
c C@ sJ t | � } d j | � } t j j j | � t j j j t | � t � S( u�
Set the amount of idle time until the harddisk sleeps. Pass "Never" of "Off"
to never sleep.
:param minutes: Can be an integer between 1 and 180 or "Never" or "Off"
:ptype: int, str
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_harddisk_sleep 120
salt '*' power.set_harddisk_sleep off
u! systemsetup -setharddisksleep {0}( R R R R R R R R' R ( R R R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_harddisk_sleep� s c C@ s= t j j j d � } t j j j t j j j | � � d k S( u�
Displays whether 'wake on modem' is on or off if supported
:return: A string value representing the "wake on modem" settings
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' power.get_wake_on_modem
u systemsetup -getwakeonmodemu on( R R R R$ t validate_enabledR% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_wake_on_modem
s
c C@ sM t j j j | � } d j | � } t j j j | � t j j j | t � S( u�
Set whether or not the computer will wake from sleep when modem activity is
detected.
:param bool enabled: True to enable, False to disable. "On" and "Off" are
also acceptable values. Additionally you can pass 1 and 0 to represent
True and False respectively
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_wake_on_modem True
u systemsetup -setwakeonmodem {0}( R R R R+ R R R R, ( t enabledR! R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_wake_on_modem s c C@ s= t j j j d � } t j j j t j j j | � � d k S( u�
Displays whether 'wake on network' is on or off if supported
:return: A string value representing the "wake on network" settings
:rtype: string
CLI Example:
.. code-block:: bash
salt '*' power.get_wake_on_network
u# systemsetup -getwakeonnetworkaccessu on( R R R R$ R+ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_wake_on_network9 s
c C@ sM t j j j | � } d j | � } t j j j | � t j j j | t � S( u�
Set whether or not the computer will wake from sleep when network activity
is detected.
:param bool enabled: True to enable, False to disable. "On" and "Off" are
also acceptable values. Additionally you can pass 1 and 0 to represent
True and False respectively
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_wake_on_network True
u' systemsetup -setwakeonnetworkaccess {0}( R R R R+ R R R R/ ( R- R! R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_wake_on_networkL s c C@ s= t j j j d � } t j j j t j j j | � � d k S( u
Displays whether 'restart on power failure' is on or off if supported
:return: A string value representing the "restart on power failure" settings
:rtype: string
CLI Example:
.. code-block:: bash
salt '*' power.get_restart_power_failure
u# systemsetup -getrestartpowerfailureu on( R R R R$ R+ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_restart_power_failureh s
c C@ sM t j j j | � } d j | � } t j j j | � t j j j | t � S( u�
Set whether or not the computer will automatically restart after a power
failure.
:param bool enabled: True to enable, False to disable. "On" and "Off" are
also acceptable values. Additionally you can pass 1 and 0 to represent
True and False respectively
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_restart_power_failure True
u' systemsetup -setrestartpowerfailure {0}( R R R R+ R R R R1 ( R- R! R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_restart_power_failure{ s c C@ s= t j j j d � } t j j j t j j j | � � d k S( u�
Displays whether 'restart on freeze' is on or off if supported
:return: A string value representing the "restart on freeze" settings
:rtype: string
CLI Example:
.. code-block:: bash
salt '*' power.get_restart_freeze
u systemsetup -getrestartfreezeu on( R R R R$ R+ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_restart_freeze� s
c C@ sP t j j j | � } d j | � } t j j j | � t j j j | t t � S( u�
Specifies whether the server restarts automatically after a system freeze.
This setting doesn't seem to be editable. The command completes successfully
but the setting isn't actually updated. This is probably a macOS. The
functions remains in case they ever fix the bug.
:param bool enabled: True to enable, False to disable. "On" and "Off" are
also acceptable values. Additionally you can pass 1 and 0 to represent
True and False respectively
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_restart_freeze True
u! systemsetup -setrestartfreeze {0}( R R R R+ R R R R3 t True( R- R! R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_restart_freeze� s c C@ s= t j j j d � } t j j j t j j j | � � d k S( u7
Displays whether 'allow power button to sleep computer' is on or off if
supported
:return: A string value representing the "allow power button to sleep
computer" settings
:rtype: string
CLI Example:
.. code-block:: bash
salt '*' power.get_sleep_on_power_button
u/ systemsetup -getallowpowerbuttontosleepcomputeru on( R R R R$ R+ R% ( R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt get_sleep_on_power_button� s c C@ sM t j j j | � } d j | � } t j j j | � t j j j | t � S( u�
Set whether or not the power button can sleep the computer.
:param bool enabled: True to enable, False to disable. "On" and "Off" are
also acceptable values. Additionally you can pass 1 and 0 to represent
True and False respectively
:return: True if successful, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' power.set_sleep_on_power_button True
u3 systemsetup -setallowpowerbuttontosleepcomputer {0}( R R R R+ R R R R6 ( R- R! R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt set_sleep_on_power_button� s (# t __doc__t
__future__R R R t salt.utils.mac_utilsR t salt.utils.platformt salt.exceptionsR t salt.extR t salt.ext.six.movesR R R R R R# R R( R R) R R* R, R. R/ R0 R1 R2 R3 R5 R6 R7 ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/mac_power.pyt <module> s6 *
Mini Shell