Current File : //lib/python2.7/site-packages/salt/modules/hipchat.pyo
�
���^c @@ s d Z d d l m Z m Z m 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 d d l Z e j e � Z d Z d � Z d d d d d d d
� Z d d d d � Z d d d d � Z d d d d
� Z d d d d � Z d d d d e d � Z d S( u�
Module for sending messages to hipchat.
.. versionadded:: 2015.5.0
:configuration: This module can be used by either passing an api key and version
directly or by specifying both in a configuration profile in the salt
master/minion config.
It is possible to use a different API than http://api.hipchat.com,
by specifying the API URL in config as api_url, or by passing the value directly.
For example:
.. code-block:: yaml
hipchat:
api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
api_version: v1
Custom API Example:
.. code-block:: yaml
hipchat:
api_url: http://api.hipchat.myteam.com
api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
api_version: v2
i ( t absolute_importt print_functiont unicode_literalsN( t urljoin( t urlencode( t rangeu hipchatc C@ s t S( uZ
Return virtual name of the module.
:return: The virtual name of the module.
( t __virtualname__( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt __virtual__5 s u GETc C@ s� i } i } | sU y# t d d � } | j d � } WqU t t t f k
rQ qU Xn | sc | r� yD t d d � } | s� | j d � } n | s� | j d � } n Wq� t t t f k
r� t j d � t SXn | r� d j | � } n d } i i i d d
6d d 6d 6i d
d
6d d 6d 6i d d
6d d 6d 6d 6i i d d
6d d 6d 6i d d
6d d 6d 6i | d
6d- d 6d 6d 6}
d } | r�| } n t
| | d � } |
j | � j | � j d
� }
t
| |
t � } | d k rPd | d <| | d <| d k rd | d <n | r�| j d d- � r>d | d <n t | � } q�nj | d k r�d! j | � | d" <| r�t j
j j | � } n | d k r�d# | d <q�n t j d$ � t St j
j j | | d% | d& | d' t d( t d) | d* t �} | j d d- � t j j j j j k rZ|
j | � j | � j d � } | j d+ i � j | d- � S| j d d- � t j j j j j k r�| d k r�t St j | � t j | � t j | � t j | � | j d, � r�t j | � n t Sd- S(. u�
HipChat object method function to construct and execute on the API URL.
:param api_url: The HipChat API URL.
:param api_key: The HipChat api key.
:param function: The HipChat api function to perform.
:param api_version: The HipChat api version (v1 or v2).
:param method: The HTTP method, e.g. GET or POST.
:param data: The data to be sent for POST method.
:return: The json response from the API call or False.
u
config.optionu hipchatu api_urlu api_keyu api_versionu$ No HipChat api key or version found.u room/{0}/notificationu room/0/notificationu
rooms/listu requestu roomsu responseu
users/listu usersu
rooms/messageu statusu messageu v1u roomu itemsu useru v2u https://api.hipchat.comu /u jsonu formatu
auth_tokenu POSTu! application/x-www-form-urlencodedu Content-Typeu notifyi u
Bearer {0}u
Authorizationu application/jsonu Unsupported HipChat API versiont paramst datat decodet statust header_dictt optsu dictu errorN( t __salt__t gett NameErrort KeyErrort AttributeErrort logt errort Falset formatt Nonet _urljoint
_urlencodet saltt utilst jsont dumpst httpt queryt Truet __opts__t extt sixt movest http_clientt OKt
NO_CONTENTt debug( t functiont api_urlt api_keyt api_versiont room_idt methodR t headerst query_paramst optionst hipchat_functionst use_api_urlt base_urlt patht urlt resultt response( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt _query> s�
!
'! '
c C@ s5 t d d d | d | d | � } t j d | � | S( u�
List all HipChat rooms.
:param api_url: The HipChat API URL, if not specified in the configuration.
:param api_key: The HipChat admin api key.
:param api_version: The HipChat api version, if not specified in the configuration.
:return: The room list.
CLI Example:
.. code-block:: bash
salt '*' hipchat.list_rooms
salt '*' hipchat.list_rooms api_key=peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version=v1
R) u roomsR* R+ R, u foo %s( R9 R R( ( R* R+ R, t foo( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt
list_rooms� s c C@ s t d d d | d | d | � S( u�
List all HipChat users.
:param api_url: The HipChat API URL, if not specified in the configuration.
:param api_key: The HipChat admin api key.
:param api_version: The HipChat api version, if not specified in the configuration.
:return: The user list.
CLI Example:
.. code-block:: bash
salt '*' hipchat.list_users
salt '*' hipchat.list_users api_key=peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version=v1
R) u usersR* R+ R, ( R9 ( R* R+ R, ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt
list_users� s c C@ sd t d | d | d | � } | r` x< t d t | � � D]" } | | d | k r7 | | Sq7 Wn t S( u(
Find a room by name and return it.
:param name: The room name.
:param api_url: The HipChat API URL, if not specified in the configuration.
:param api_key: The HipChat admin api key.
:param api_version: The HipChat api version, if not specified in the configuration.
:return: The room object.
CLI Example:
.. code-block:: bash
salt '*' hipchat.find_room name="Development Room"
salt '*' hipchat.find_room name="Development Room" api_key=peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version=v1
R* R+ R, i u name( R; R t lenR ( t nameR* R+ R, t roomst x( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt find_room� s c C@ sd t d | d | d | � } | r` x< t d t | � � D]" } | | d | k r7 | | Sq7 Wn t S( u0
Find a user by name and return it.
:param name: The user name.
:param api_url: The HipChat API URL, if not specified in the configuration.
:param api_key: The HipChat admin api key.
:param api_version: The HipChat api version, if not specified in the configuration.
:return: The user object.
CLI Example:
.. code-block:: bash
salt '*' hipchat.find_user name="Thomas Hatch"
salt '*' hipchat.find_user name="Thomas Hatch" api_key=peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version=v1
R* R+ R, i u name( R< R R= R ( R> R* R+ R, t usersR@ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt find_user s u yellowc
C@ s� t � } | | d <| d | d <| d | d <d | d <| | d <| | d <t d
d d | d | d
| d | d d d | � } | r� t St Sd S( u�
Send a message to a HipChat room.
:param room_id: The room id or room name, either will work.
:param message: The message to send to the HipChat room.
:param from_name: Specify who the message is from.
:param api_url: The HipChat api URL, if not specified in the configuration.
:param api_key: The HipChat api key, if not specified in the configuration.
:param api_version: The HipChat api version, if not specified in the configuration.
:param color: The color for the message, default: yellow.
:param notify: Whether to notify the room, default: False.
:return: Boolean if message was sent successfully.
CLI Example:
.. code-block:: bash
salt '*' hipchat.send_message room_id="Development Room" message="Build is done" from_name="Build Server"
salt '*' hipchat.send_message room_id="Development Room" message="Build failed" from_name="Build Server" color="red" notify=True
u room_idi u fromi' u messageu textu message_formatu coloru notifyR) R* R+ R, R- R. u POSTR N( t dictR9 R R (
R- t messaget from_nameR* R+ R, t colort notifyt
parametersR7 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt send_message3 s"
( t __doc__t
__future__R R R t loggingt salt.utils.httpR t salt.utils.jsont salt.ext.six.moves.urllib.parseR R R R t salt.ext.six.movesR t salt.ext.six.moves.http_clientt getLoggert __name__R R R R R9 R; R< RA RC R RJ ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/hipchat.pyt <module> sD
}
Mini Shell