o

�N�g�	�@sPdZd
dl
Z						ddd�
Zddd�
Zejj�ed	�Zejj�ed
�Z	dS)
z;
Send events through Salt's event system during state runs
�NFTc	Ksv|id
dd�}|r||
d�|d<ni|d<tdr#d|d<d	|d
<|St
d|f
|
||||d�|�
�
|d<d
|d
<|S)a�
    Send an event to the Salt Master

    .. versionadded:: 2014.7.0

    Accepts the same arguments as the :py:func:`event.send
    <salt.modules.event.send>` execution module of the same name,
    with the additional argument:

    :param show_changed: If ``True``, state will show as changed with the data
        argument as the change value. If ``False``, shows as unchanged.

    Example:

    .. code-block:: yaml

        # ...snip bunch of states above

        mycompany/mystaterun/status/update:
          event.send:
            - data:
                status: "Half-way through the state run!"

        # ...snip bunch of states below
    F���name�changes�result�comment)�tag�datar�testNrzEvent would have been firedrz
event.send)r	�preload�with_env�with_grains�with_pillarzEvent fired)Z__opts__Z__salt__)	rr	rrr
rZshow_changed�kwargs�ret�r�E/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/event.py�sends*#





�



�
�	rcCs|id
dd�S)a�
    Fire an event on the Salt master event bus if called from a watch statement

    .. versionadded:: 2014.7.0

    Example:

    .. code-block:: jinja

        # Stand up a new web server.
        apache:
          pkg:
            - installed
            - name: httpd
          service:
            - running
            - enable: True
            - name: httpd

        # Notify the load balancer to update the pool once Apache is running.
        refresh_pool:
          event:
            - wait
            - name: mycompany/loadbalancer/pool/update
            - data:
                new_web_server_ip: {{ grains['ipv4'] | first() }}
            - watch:
              - pkg: apache
    Trrr)rZsfunr	rrr�waitDsr�	mod_watch�fire_master)NNFFFT)NN)
�__doc__Zsalt.utils.functools�saltrr�utils�	functoolsZalias_functionrrrrrr�<module>
s





�
<"