Current File : //usr/lib/python2.7/site-packages/salt/states/grains.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l m Z e d � Z e e d � Z
e d � Z e d � Z e e e d � Z
e e d
� Z d S( uG
Manage grains on the minion
===========================
This state allows for grains to be set.
Grains set or altered with this module are stored in the 'grains'
file on the minions, By default, this file is located at: ``/etc/salt/grains``
.. note::
This does **NOT** override any grains set in the minion config file.
i ( t absolute_importt print_functiont unicode_literalsN( t DEFAULT_TARGET_DELIMc C@ sz t j | t | � } i | d 6i d 6t d 6d d 6} t � } t d | | � } | | k rv t | d <d | d <n | S( u�
Ensure that a grain is set
name
The grain name
delimiter
A delimiter different from the default can be provided.
Check whether a grain exists. Does not attempt to check or set the value.
u nameu changesu resultu Grain existsu commentu
grains.getu Grain does not exist( t ret subR t Truet objectt __salt__t False( t namet delimitert rett
_non_existentt existing( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt exists s
c C@ sC t j | t | � } i | d 6i d 6t d 6d d 6} t � } t d | | � } | | k rm d | d <| St d r� d | d <| | k r� d j | � | d <i | d
6| d <n+ d j | � | d <i i | | 6d 6| d <| St d
| | d | �} | d t k r5| d i k r5d j | | � | d <n | | d <| S( u�
Ensure that a grain is set
.. versionchanged:: v2015.8.2
name
The grain name
value
The value to set on the grain
force
If force is True, the existing grain will be overwritten
regardless of its existing or provided value type. Defaults to False
.. versionadded:: v2015.8.2
delimiter
A delimiter different from the default can be provided.
.. versionadded:: v2015.8.2
It is now capable to set a grain to a complex value (ie. lists and dicts)
and supports nested grains as well.
If the grain does not yet exist, a new grain is set to the given value. For
a nested grain, the necessary keys are created if they don't exist. If
a given key is an existing value, it will be converted, but an existing value
different from the given key will fail the state.
If the grain with the given name exists, its value is updated to the new
value unless its existing or provided value is complex (list or dict). Use
`force: True` to overwrite.
.. code-block:: yaml
cheese:
grains.present:
- value: edam
nested_grain_with_complex_value:
grains.present:
- name: icinga:Apache SSL
- value:
- command: check_https
- params: -H localhost -p 443 -S
with,a,custom,delimiter:
grains.present:
- value: yay
- delimiter: ','
u nameu changesu resultu u commentu
grains.getu Grain is already setu testu Grain {0} is set to be addedu newu Grain {0} is set to be changedu changedu
grains.sett forceu Set grain {0} to {1}N( R R R R R R t __opts__t Nonet format( R
t valueR R R R
R ( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt present0 s. 5
c C@ s t j | t | � } i | d 6i d 6t d 6d d 6} t d | � } | r
t | t � s} t | d <d j | � | d <| St | t � r�t | � j
t t d | � � � r� d j | | � | d <| S| t j d i � k rMt | � j
t j d i � | � } | rMt t | � j t d | � � } d
j | | � | d <qMn d t k rfi t d <n | t d k r�t � t d | <n t d | j | � n& | | k r�d j | | � | d <| St d r
d | d <d j | | � | d <i | d
6| d <| Sn t d rFd | d <d j | � | d <i | d
6| d <| St d | | � } t | t � r�t | � j
t t d | � � � s�t | d <d j | | � | d <| Sn@ | t d | d t �k r�t | d <d j | | � | d <| Sd j | | � | d <i | d
6| d <| S( u\
.. versionadded:: 2014.1.0
Ensure the value is present in the list-type grain. Note: If the grain that is
provided in ``name`` is not present on the system, this new grain will be created
with the corresponding provided value.
name
The grain name.
value
The value is present in the list type grain.
delimiter
A delimiter different from the default ``:`` can be provided.
.. versionadded:: v2015.8.2
The grain should be `list type <http://docs.python.org/2/tutorial/datastructures.html#data-structures>`_
.. code-block:: yaml
roles:
grains.list_present:
- value: web
For multiple grains, the syntax looks like:
.. code-block:: yaml
roles:
grains.list_present:
- value:
- web
- dev
u nameu changesu resultu u commentu
grains.getu Grain {0} is not a valid listu! Value {1} is already in grain {0}u pending_grainsu= Removed value {0} from update due to context found in "{1}".
u testu, Value {1} is set to be appended to grain {0}u newu Grain {0} is set to be addedu
grains.appendu$ Failed append value {1} to grain {0}R u Append value {1} to grain {0}N( R R R R R t
isinstancet listR R t sett issubsett __context__t gett intersectiont
differencet updateR R ( R
R R R t grainR t
new_grains( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt list_present sf %
%%#
%
c C@ s� t j | t | � } i | d 6i d 6t d 6d d 6} g } t d | d � } | r�t | t � r�t | t � s� | g } n x | D]} | | k r� | j d j | | � � q� t
d r$d | d <| j d j | | � � d
| d j � k r i g d
6| d <n | d d
j | � q� | | k r� t d | | � | j d j | | � � d
| d j � k r�i g d
6| d <n | d d
j | � q� q� Wd
j | � | d <| St
| d <d j | � | d <n d j | � | d <| S( u�
Delete a value from a grain formed as a list.
.. versionadded:: 2014.1.0
name
The grain name.
value
The value to delete from the grain list.
delimiter
A delimiter different from the default ``:`` can be provided.
.. versionadded:: v2015.8.2
The grain should be `list type <http://docs.python.org/2/tutorial/datastructures.html#data-structures>`_
.. code-block:: yaml
roles:
grains.list_absent:
- value: db
For multiple grains, the syntax looks like:
.. code-block:: yaml
roles:
grains.list_absent:
- value:
- web
- dev
u nameu changesu resultu u commentu
grains.getu" Value {1} is absent from grain {0}u testu+ Value {1} in grain {0} is set to be deletedu deletedu
grains.removeu$ Value {1} was deleted from grain {0}u
u Grain {0} is not a valid listu Grain {0} does not existN( R R R R R R R R t appendR R t keyst joinR ( R
R R R t commentsR t val( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt list_absent� sH $
c C@ sF t � } t j | t | � } i | d 6i d 6t d 6d d 6} t d | | � } | d k rt d r� d | d <| t k r� d j | � | d <i | d 6| d <n | St d
| d d | d | �} | d r | t k r d
j | � | d <i | d 6| d <q n | | d <n,| | k r/t d r�d | d <| t k rid j | � | d <i | d 6| d <n+ d j | � | d <i | d 6d d 6| d <| St d
| d d | d | �} | d r"| t k r�d
j | � | d <i | d 6| d <q"d j | � | d <i | d 6d d 6| d <n | | d <n d j | � | d <| S( u|
.. versionadded:: 2014.7.0
Delete a grain from the grains config file
name
The grain name
destructive
If destructive is True, delete the entire grain. If
destructive is False, set the grain's value to None. Defaults to False.
force
If force is True, the existing grain will be overwritten
regardless of its existing or provided value type. Defaults to False
.. versionadded:: v2015.8.2
delimiter
A delimiter different from the default can be provided.
.. versionadded:: v2015.8.2
.. versionchanged:: v2015.8.2
This state now support nested grains and complex values. It is also more
conservative: if a grain has a value that is a list or a dict, it will
not be removed unless the `force` parameter is True.
.. code-block:: yaml
grain_name:
grains.absent
u nameu changesu resultu u commentu
grains.getu testu Grain {0} is set to be deletedu deletedu
grains.sett destructiveR u Grain {0} was deletedu/ Value for grain {0} is set to be deleted (None)u grainu valueu# Value for grain {0} was set to Noneu Grain {0} does not existN( R R R R R R R R R ( R
R( R R R
R R ( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt absent* s\ '
c C@ s� t j | t | � } i | d 6i d 6t d 6d d 6} t d | d � } | s\ | t k r�t | t � r | | k r� d j | | � | d <| St
d r� d | d <d j | | � | d <i | d
6| d <| St d | | � d j | | � | d <i | d
6| d <q�| t k r�t
d rVd | d <d
j | | � | d <i | d
6| d <| S| d k rhg n | g } | j | � t d | | � d j | | � | d <i | d
6| d <q�t | d <d j | � | d <n t | d <d j | � | d <| S( u�
.. versionadded:: 2014.7.0
Append a value to a list in the grains config file. The grain that is being
appended to (name) must exist before the new value can be added.
name
The grain name
value
The value to append
convert
If convert is True, convert non-list contents into a list.
If convert is False and the grain contains non-list contents, an error
is given. Defaults to False.
delimiter
A delimiter different from the default can be provided.
.. versionadded:: v2015.8.2
.. code-block:: yaml
grain_name:
grains.append:
- value: to_be_appended
u nameu changesu resultu u commentu
grains.getu. Value {1} is already in the list for grain {0}u testu) Value {1} in grain {0} is set to be addedu addedu
grains.appendu Value {1} was added to grain {0}uD Grain {0} is set to be converted to list and value {1} will be addedu
grains.setvalu Grain {0} is not a valid listu Grain {0} does not existN(
R R R R R R t
__grains__R R R R R" R ( R
R t convertR R R ( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyR" � sL
( t __doc__t
__future__R R R R t
salt.defaultsR R R R R! R' R) R" ( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/grains.pyt <module>
s O _ M X
Mini Shell