Current File : //lib/python2.7/site-packages/salt/modules/mac_timezone.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d d l m Z d d l Z d d l 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 d � Z d � Z d � Z d S( uM
Module for editing date/time settings on macOS
.. versionadded:: 2016.3.0
i ( t absolute_importt unicode_literalst print_function( t datetimeN( t SaltInvocationErroru timezonec C@ s t j j j � s t d f St S( u
Only for macOS
uP The mac_timezone 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_timezone.pyt __virtual__ s
c C@ sw d d d d d d g } x= | D]5 } y t j | | � | SWq t k
rS q q Xq Wd j | � } t | � � d S( u
Function that detects the date/time format for the string passed.
:param str dt_string:
A date/time string
:return: The format of the passed dt_string
:rtype: str
:raises: SaltInvocationError on Invalid Date/Time string
u %H:%Mu %H:%M:%Su %m:%d:%yu %m:%d:%Yu %m/%d/%yu %m/%d/%Yu Invalid Date/Time Format: {0}N( R t strptimet
ValueErrort formatR ( t dt_stringt
valid_formatst dt_formatt msg( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt _get_date_time_format s
c C@ s( t j j j d � } t j j j | � S( u�
Displays the current date
:return: the system date
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_date
u systemsetup -getdate( R R t mac_utilst execute_return_resultt parse_return( t ret( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_date= s
c C@ sI t | � } t j | | � } d j | j d � � } t j j j | � S( u�
Set the current month, day, and year
:param str date: The date to set. Valid date formats are:
- %m:%d:%y
- %m:%d:%Y
- %m/%d/%y
- %m/%d/%Y
:return: True if successful, False if not
:rtype: bool
:raises: SaltInvocationError on Invalid Date format
:raises: CommandExecutionError on failure
CLI Example:
.. code-block:: bash
salt '*' timezone.set_date 1/13/2016
u systemsetup -setdate {0}u %m:%d:%Y( R R R R t strftimeR R R t execute_return_success( t datet date_formatt dt_objt cmd( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_dateN s c C@ s( t j j j d � } t j j j | � S( u�
Get the current system time.
:return: The current time in 24 hour format
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_time
u systemsetup -gettime( R R R R R ( R ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_timel s
c C@ sI t | � } t j | | � } d j | j d � � } t j j j | � S( u�
Sets the current time. Must be in 24 hour format.
:param str time: The time to set in 24 hour format. The value must be
double quoted. ie: '"17:46"'
:return: True if successful, False if not
:rtype: bool
:raises: SaltInvocationError on Invalid Time format
:raises: CommandExecutionError on failure
CLI Example:
.. code-block:: bash
salt '*' timezone.set_time '"17:34"'
u systemsetup -settime {0}u %H:%M:%S( R R R R R R R R R ( t timet time_formatR R ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_time} s c C@ s( t j j j d � } t j j j | � S( u�
Displays the current time zone
:return: The current time zone
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_zone
u systemsetup -gettimezone( R R R R R ( R ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_zone� s
c C@ s t j j j d � S( u�
Displays the current time zone abbreviated code
:return: The current time zone code
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_zonecode
u date +%Z( R R R R ( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_zonecode� s
c C@ s t j j j d � S( u�
Displays the current time zone offset
:return: The current time zone offset
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_offset
u date +%z( R R R R ( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt
get_offset� s
c C@ sM t j j j d � } t j j j | � } g | j � D] } | j � ^ q7 S( u�
Displays a list of available time zones. Use this list when setting a
time zone using ``timezone.set_zone``
:return: a list of time zones
:rtype: list
CLI Example:
.. code-block:: bash
salt '*' timezone.list_zones
u systemsetup -listtimezones( R R R R R t
splitlinest strip( R t zonest x( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt
list_zones� s c C@ sP | t � k r' t d j | � � � n t j j j d j | � � | t � k S( u�
Set the local time zone. Use ``timezone.list_zones`` to list valid time_zone
arguments
:param str time_zone: The time zone to apply
:return: True if successful, False if not
:rtype: bool
:raises: SaltInvocationError on Invalid Timezone
:raises: CommandExecutionError on failure
CLI Example:
.. code-block:: bash
salt '*' timezone.set_zone America/Denver
u Invalid Timezone: {0}u systemsetup -settimezone {0}( R+ R R R R R R R$ ( t time_zone( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_zone� s
c C@ s
| t � k S( u�
Compares the given timezone name with the system timezone name.
:return: True if they are the same, False if not
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' timezone.zone_compare America/Boise
( R$ ( R, ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt zone_compare� s
c C@ s= t j j j d � } t j j j t j j j | � � d k S( u�
Display whether network time is on or off
:return: True if network time is on, False if off
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' timezone.get_using_network_time
u systemsetup -getusingnetworktimeu on( R R R R t validate_enabledR ( R ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_using_network_time
s
c C@ sS t j j j | � } d j | � } t j j j | � | t j j j t � � k S( ug
Set whether network time is on or off.
:param enable: True to enable, False to disable. Can also use 'on' or 'off'
:type: str bool
:return: True if successful, False if not
:rtype: bool
:raises: CommandExecutionError on failure
CLI Example:
.. code-block:: bash
salt '*' timezone.set_using_network_time True
u$ systemsetup -setusingnetworktime {0}( R R R R/ R R R0 ( t enablet stateR ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_using_network_time s
c C@ s( t j j j d � } t j j j | � S( u�
Display the currently set network time server.
:return: the network time server
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' timezone.get_time_server
u! systemsetup -getnetworktimeserver( R R R R R ( R ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_time_server9 s
u time.apple.comc C@ s/ d j | � } t j j j | � | t � k S( u�
Designates a network time server. Enter the IP address or DNS name for the
network time server.
:param time_server: IP or DNS name of the network time server. If nothing
is passed the time server will be set to the macOS default of
'time.apple.com'
:type: str
:return: True if successful, False if not
:rtype: bool
:raises: CommandExecutionError on failure
CLI Example:
.. code-block:: bash
salt '*' timezone.set_time_server time.acme.com
u% systemsetup -setnetworktimeserver {0}( R R R R R R4 ( t time_serverR ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_time_serverK s c C@ s t S( u�
Get current hardware clock setting (UTC or localtime)
CLI Example:
.. code-block:: bash
salt '*' timezone.get_hwclock
( R ( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt get_hwclockf s c C@ s t S( u�
Sets the hardware clock to be either UTC or localtime
CLI Example:
.. code-block:: bash
salt '*' timezone.set_hwclock UTC
( R ( t clock( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt set_hwclockt s ( t __doc__t
__future__R R R R t salt.utils.mac_utilsR t salt.utils.platformt salt.exceptionsR R
R R R R R R# R$ R% R& R+ R- R. R0 R3 R4 R6 R7 R9 ( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/mac_timezone.pyt <module> s0
Mini Shell