Current File : //proc/thread-self/root/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyc
�
���^c @@ sG d Z d d l m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l m Z d d l
m Z d d l m Z i Z d � Z d � Z d � Z d
� Z i e d 6e d 6e d
6e d 6e d 6e d 6e d 6Z d e e d � Z d � Z e d � Z d � Z d � Z d d d d d � Z d S( s+
Return/control aspects of the grains data
i ( t absolute_importt print_functionN( t DEFAULT_TARGET_DELIM( t
SaltException( t sixc C@ sA t | � } t t j | d � � } d j | | d | | � S( s4
Replaces the last 1/4 of a string with X's
g �?s {0}{1}t X( t lent intt matht floort format( t instrt lengtht index( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt _serial_sanitizer s c C@ s d S( Ns MINION.DOMAINNAME( ( t x( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt <lambda># s c C@ s d S( Nt MINION( ( R ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyR $ s c C@ s d S( Nt
DOMAINNAME( ( R ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyR % s t serialnumbert domaint fqdnt idt hostt localhostt nodenamet c C@ sU | t k r t } n$ t j j j t j j j t � � } t j j j t | | | � S( s2
Attempt to retrieve the named value from grains, if the named value is not
available return the passed default. The default return is an empty string.
The value can also represent a value in a nested dict using a ":" delimiter
for the dict. This means that if a dict in grains looks like this::
{'pkg': {'apache': 'httpd'}}
To retrieve the value associated with the apache key in the pkg dict this
key can be passed::
pkg:apache
CLI Example:
.. code-block:: bash
salt '*' grains.get pkg:apache
( t Truet
__grains__t saltt utilst jsont loadst dumpst datat traverse_dict_and_list( t keyt defaultt delimitert orderedt grains( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt get5 s $ c C@ s# t j j j t | t � r t St S( sl
Determine whether a named value exists in the grains dictionary.
Given a grains dictionary that contains the following structure::
{'pkg': {'apache': 'httpd'}}
One would determine if the apache key in the pkg dict exists by::
pkg:apache
CLI Example:
.. code-block:: bash
salt '*' grains.has_value pkg:apache
( R R R" R# R t FalseR ( R$ ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt has_valueU s c C@ sp t j j j | � rh t t � } x@ t j t � D]/ \ } } | | k r1 | | | � | | <q1 q1 W| St Sd S( s�
Return all of the minion's grains
CLI Example:
.. code-block:: bash
salt '*' grains.items
Sanitized CLI Example:
.. code-block:: bash
salt '*' grains.items sanitize=True
N( R R R" t is_truet dictR R t iteritemst _SANITIZERS( t sanitizet outR$ t func( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt itemsl s c O@ s� i } x4 | D], } y t | | | <Wq
t k
r8 q
Xq
Wt j j j | j d � � r� xC t j t � D]/ \ } } | | k rk | | | � | | <qk qk Wn | S( s
Return one or more grains
CLI Example:
.. code-block:: bash
salt '*' grains.item os
salt '*' grains.item os osrelease oscodename
Sanitized CLI Example:
.. code-block:: bash
salt '*' grains.item host sanitize=True
R0 (
R t KeyErrorR R R" R, R) R R. R/ ( t argst kwargst rett argR2 ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt item� s
c C@ s
t t � S( sw
Return a list of all available grains
CLI Example:
.. code-block:: bash
salt '*' grains.ls
( t sortedR ( ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt ls� s
t os_familyR% c C@ s | j t j | | � | j | d � � } | r� | | k r� | | } | d k r[ | } q� t | t j � r� t | t j � s� t d � � n t j j j
t j | � | � } q� n | r
t | t j � s� t d � � q
| d k r� | } q
t j j j
| | � n | S( s�
.. versionadded:: 0.17.0
Look up the given grain in a given dictionary for the current OS and return
the result
Although this may occasionally be useful at the CLI, the primary intent of
this function is for use in Jinja to make short work of creating lookup
tables for OS-specific data. For example:
.. code-block:: jinja
{% set apache = salt['grains.filter_by']({
'Debian': {'pkg': 'apache2', 'srv': 'apache2'},
'RedHat': {'pkg': 'httpd', 'srv': 'httpd'},
}), default='Debian' %}
myapache:
pkg.installed:
- name: {{ apache.pkg }}
service.running:
- name: {{ apache.srv }}
Values in the lookup table may be overridden by values in Pillar. An
example Pillar to override values in the example above could be as follows:
.. code-block:: yaml
apache:
lookup:
pkg: apache_13
srv: apache
The call to ``filter_by()`` would be modified as follows to reference those
Pillar values:
.. code-block:: jinja
{% set apache = salt['grains.filter_by']({
...
}, merge=salt['pillar.get']('apache:lookup')) %}
:param lookup_dict: A dictionary, keyed by a grain, containing a value or
values relevant to systems matching that grain. For example, a key
could be the grain for an OS and the value could the name of a package
on that particular OS.
:param grain: The name of a grain to match with the current system's
grains. For example, the value of the "os_family" grain for the current
system could be used to pull values from the ``lookup_dict``
dictionary.
:param merge: A dictionary to merge with the ``lookup_dict`` before doing
the lookup. This allows Pillar to override the values in the
``lookup_dict``. This could be useful, for example, to override the
values for non-standard package names such as when using a different
Python version from the default Python version provided by the OS
(e.g., ``python26-mysql`` instead of ``python-mysql``).
:param default: default lookup_dict's key used if the grain does not exists
or if the grain value has no match on lookup_dict.
.. versionadded:: 2014.1.0
:param base: A lookup_dict key to use for a base dictionary. The
grain-selected ``lookup_dict`` is merged over this and then finally
the ``merge`` dictionary is merged. This allows common values for
each case to be collected in the base and overridden by the grain
selection dictionary and the merge dictionary. Default is None.
.. versionadded:: 2015.8.11,2016.3.2
CLI Example:
.. code-block:: bash
salt '*' grains.filter_by '{Debian: Debheads rule, RedHat: I love my hat}'
# this one will render {D: {E: I, G: H}, J: K}
salt '*' grains.filter_by '{A: B, C: {D: {E: F,G: H}}}' 'xxx' '{D: {E: I},J: K}' 'C'
s? filter_by default and look-up values must both be dictionaries.s. filter_by merge argument must be a dictionary.N(
R) R t Nonet
isinstancet collectionst MappingR R R t
dictupdatet updatet copyt deepcopy( t lookup_dictt graint mergeR% t baseR7 t base_values( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt filter_by� s( S
' ( t __doc__t
__future__R R R? RC R t salt.utils.dataR t salt.utils.dictupdatet salt.utils.jsont
salt.defaultsR t salt.exceptionsR t salt.extR R R t _FQDN_SANITIZERt _HOSTNAME_SANITIZERt _DOMAINNAME_SANITIZERR/ R R) R+ R* R3 R9 R; R= RJ ( ( ( sB /usr/lib/python2.7/site-packages/salt/client/ssh/wrapper/grains.pyt <module> s@
Mini Shell