Current File : //lib/python2.7/site-packages/salt/beacons/avahi_announce.pyo
�
���^c @@ s| d Z d d l m Z m Z d d l Z d d l Z d d l Z d d l m Z y d d l
Z
e Z Wn e
k
r e Z n Xy� d d l Z d d l m Z e j � Z e j e j e
j e
j � e
j � Z e j e j e
j e j � � e
j � Z e Z Wn3 e
e f k
r"e Z n e k
r8e Z n Xe j e � Z d Z! i a" d � Z# d � Z$ d � Z% d
� Z& d S( u�
Beacon to announce via avahi (zeroconf)
.. versionadded:: 2016.11.0
Dependencies
============
- python-avahi
- dbus-python
i ( t absolute_importt unicode_literalsN( t map( t
DBusExceptionu avahi_announcec C@ s6 t r# t r t St d j t � f St d j t � f S( NuI The {0} beacon cannot be loaded. The 'python-dbus' dependency is missing.uJ The {0} beacon cannot be loaded. The 'python-avahi' dependency is missing.( t HAS_PYAVAHIt HAS_DBUSt __virtualname__t Falset format( ( ( s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pyt __virtual__2 s
c @ se i � t t � j | � � t | t � s5 t d f St � f d � d D� � s[ t d f St d f S( u+
Validate the beacon configuration
u7 Configuration for avahi_announce beacon must be a list.c 3@ s | ] } | � k Vq d S( N( ( t .0t x( t _config( s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pys <genexpr>G s u servicetypeu portu txtuU Configuration for avahi_announce beacon must contain servicetype, port and txt items.u Valid beacon configuration.( u servicetypeu portu txt( t listR t updatet
isinstanceR t allt True( t config( ( R s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pyt validate< s
c C@ s: t | � t | � d d k r6 | d t | � d S| S( u�
Enforces the TXT record maximum length of 255 characters.
TXT record length includes key, value, and '='.
:param str key: Key of the TXT record
:param str value: Value of the TXT record
:rtype: str
:return: The value of the TXT record. It may be truncated if it exceeds
the maximum permitted length. In case of truncation, '...' is
appended to indicate that the entire value is not present.
i i� i� u ...( t len( t keyt value( ( s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pyt _enforce_txt_record_maxlenO s c
C@ sr g } i } i } i } t t | j | � � d | k rG | d } n- t d } t rt t d | k rt | | d <n t r | j d t � r t j d g � t j d g � k r� t j d g � | d <n t j d g � t j d g � k r t j d g � | d <q n xx| d D]l} d t j j j
| � } | d | j d � rN| d | d } d } | j
d
� }
|
d k r�| d d k r�t | |
d
d !� } | |
} n t j | d � } t | t � r�| d k r�| | } q�d j | � } n t | | � | | <t rit j | d � t j | d � k ri| | | | <qin t | | d | � | | <t s| | | | <qqW| rGt s=| | d <| d | d <| d | d <t j d g � | d <t j d g � | d <t j t j t j t j d � | | d d d t j | d � t j | � � t j � n� | j d t � s[d | k r�t j � | j d d � } | d k r�t j | � n t j t j t j t j d � | | d d d t j | d � t j | � � t j � n; t j t j t j t j d � | | d d t j | � � | j i d d 6| d 6� n | j d t � rht j! � a n t a | S( u
Broadcast values via zeroconf
If the announced values are static, it is advised to set run_once: True
(do not poll) on the beacon configuration.
The following are required configuration settings:
- ``servicetype`` - The service type to announce
- ``port`` - The port of the service to announce
- ``txt`` - The TXT record of the service being announced as a dict. Grains
can be used to define TXT values using one of following two formats:
- ``grains.<grain_name>``
- ``grains.<grain_name>[i]`` where i is an integer representing the
index of the grain to use. If the grain is not a list, the index is
ignored.
The following are optional configuration settings:
- ``servicename`` - Set the name of the service. Will use the hostname from
the minion's ``host`` grain if this value is not set.
- ``reset_on_change`` - If ``True`` and there is a change in TXT records
detected, it will stop announcing the service and then restart announcing
the service. This interruption in service announcement may be desirable
if the client relies on changes in the browse records to update its cache
of TXT records. Defaults to ``False``.
- ``reset_wait`` - The number of seconds to wait after announcement stops
announcing and before it restarts announcing in the case where there is a
change in TXT records detected and ``reset_on_change`` is ``True``.
Defaults to ``0``.
- ``copy_grains`` - If ``True``, Salt will copy the grains passed into the
beacon when it backs them up to check for changes on the next iteration.
Normally, instead of copy, it would use straight value assignment. This
will allow detection of changes to grains where the grains are modified
in-place instead of completely replaced. In-place grains changes are not
currently done in the main Salt code but may be done due to a custom
plug-in. Defaults to ``False``.
Example Config
.. code-block:: yaml
beacons:
avahi_announce:
- run_once: True
- servicetype: _demo._tcp
- port: 1234
- txt:
ProdName: grains.productname
SerialNo: grains.serialnumber
Comments: 'this is a test'
u servicenameu hostu reset_on_changeu ipv4u ipv6u txtu txt.u grains.i u [i����u ]i u u ,u servicetypeu porti u
reset_waitu resultu tagu changesu copy_grainsN(" R
R R t
__grains__t LAST_GRAINSt getR t saltt utilst stringutilst
to_unicodet
startswitht Nonet findt intR t joinR t GROUPt
AddServicet avahit IF_UNSPECt PROTO_UNSPECt dbust UInt32t UInt16t dict_to_txt_arrayt Committ Resett timet sleept UpdateServiceTxtt appendt copy(
R t rett changest txtR t servicenamet itemt changes_keyt graint grain_indext square_brackett grain_valuet
reset_wait( ( s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pyt beaconc s~ 6
$$
*
(' t __doc__t
__future__R R t loggingR/ t salt.utils.stringutilsR t salt.ext.six.movesR R& R R t ImportErrorR R) R t SystemBust BUSt Interfacet
get_objectt DBUS_NAMEt DBUS_PATH_SERVERt DBUS_INTERFACE_SERVERt SERVERt
EntryGroupNewt DBUS_INTERFACE_ENTRY_GROUPR$ R t NameErrort getLoggert __name__t logR R R R R R? ( ( ( s? /usr/lib/python2.7/site-packages/salt/beacons/avahi_announce.pyt <module>
s<
Mini Shell