Current File : //usr/lib/python2.7/site-packages/salt/modules/mandrill.pyc
�
���^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 y d d l Z e
Z Wn e k
ru e
Z n Xd Z e j e � Z d Z d Z d � Z d � Z d d d d � Z d
� Z d � Z d d d � Z e
d d d d d d
� Z d S( u&
Mandrill
========
Send out emails using the Mandrill_ API_.
.. _Mandrill: https://mandrillapp.com
.. _API: https://mandrillapp.com/api/docs/
In the minion configuration file, the following block is required:
.. code-block:: yaml
mandrill:
key: <API_KEY>
.. versionadded:: 2018.3.0
i ( t absolute_importt print_functiont unicode_literalsNu mandrillu https://mandrillapp.com/apii c C@ s t t k r t d f St S( u2
Return the execution module virtualname.
uI The requests python package is required for the mandrill execution module( t HAS_REQUESTSt Falset __virtualname__( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt __virtual__, s
c C@ s i t d 6d d 6d d 6S( u&
Default dictionary returned.
u resultu u commentu outN( R t None( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt _default_ret5 s c C@ sq t d d � } | s i } n i | p: | j d � p: t d 6| pP | j d � d 6| pl | j d � pl t d 6S( u7
Retrieve the API params from the config file.
u config.mergeu mandrillu api_urlu keyu api_keyu api_version( t __salt__t gett BASE_URLt DEFAULT_VERSION( t api_urlt api_versiont api_keyt mandrill_cfg( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt _get_api_params@ s c C@ s" d j d | d t | � d | � S( u
Build the API URL.
u {url}/{version}/{method}.jsont urlt versiont method( t formatt float( R R
R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt _get_urlP s c C@ s i d d 6d d 6S( u<
Return HTTP headers required for the Mandrill API.
u application/jsonu content-typeu Mandrill-Python/1.0.57u
user-agent( ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt _get_headers[ s c C@ s% | s t � } n t j � } t j d | � | j | d | d t j j j | � �} | j � } t
� } t j d | j � t j d � t j | � | j d k r | j d k r� | j d d � | d
<| | d <| S| j
i | j d d � d
6� | S| j
i t d
6| j � d 6� | S( uE
Make the HTTP request and return the body as python object.
u Querying %st headerst datau Status code: %du Response body:i� i� u messageu u commentu outu erroru result( R t requestst sessiont logt debugt postt saltt utilst jsont dumpsR t status_codet popt updateR
t True( R R R R t reqt req_bodyt ret( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt
_http_requeste s0
c K@ s� d | k r5 t j j j d d � t | d � } n t d | d | d | � } t d d | d d | d �} i | d
d 6| d 6| d 6| d
6| d 6}
t | d |
�S( u�
Send out the email using the details from the ``message`` argument.
message
The information on the message to send. This argument must be
sent as dictionary with at fields as specified in the Mandrill API
documentation.
asynchronous: ``False``
Enable a background sending mode that is optimized for bulk sending.
In asynchronous mode, messages/send will immediately return a status of
"queued" for every recipient. To handle rejections when sending in asynchronous
mode, set up a webhook for the 'reject' event. Defaults to false for
messages with no more than 10 recipients; messages with more than 10
recipients are always sent asynchronously, regardless of the value of
asynchronous.
ip_pool
The name of the dedicated ip pool that should be used to send the
message. If you do not have any dedicated IPs, this parameter has no
effect. If you specify a pool that does not exist, your default pool
will be used instead.
send_at
When this message should be sent as a UTC timestamp in
``YYYY-MM-DD HH:MM:SS`` format. If you specify a time in the past,
the message will be sent immediately. An additional fee applies for
scheduled email, and this feature is only available to accounts with a
positive balance.
.. note::
Fur further details please consult the `API documentation <https://mandrillapp.com/api/docs/messages.dart.html>`_.
CLI Example:
.. code-block:: bash
$ salt '*' mandrill.send message="{'subject': 'Hi', 'from_email': 'test@example.com', 'to': [{'email': 'recv@example.com', 'type': 'to'}]}"
``message`` structure example (as YAML for readability):
.. code-block:: yaml
message:
text: |
This is the body of the email.
This is the second line.
subject: Email subject
from_name: Test At Example Dot Com
from_email: test@example.com
to:
- email: recv@example.com
type: to
name: Recv At Example Dot Com
- email: cc@example.com
type: cc
name: CC At Example Dot Com
important: true
track_clicks: true
track_opens: true
attachments:
- type: text/x-yaml
name: yaml_file.yml
content: aV9hbV9zdXBlcl9jdXJpb3VzOiB0cnVl
Output example:
.. code-block:: bash
minion:
----------
comment:
out:
|_
----------
_id:
c4353540a3c123eca112bbdd704ab6
email:
recv@example.com
reject_reason:
None
status:
sent
result:
True
u asyncu SodiumuX Parameter "async" is renamed to "asynchronous" and will be removed in version {version}.R
R R u
messages/sendu api_urlu api_versionu api_keyu keyu messageu ip_poolu send_atR ( R R! t versionst
warn_untilt boolR R R+ ( t messaget asynchronoust ip_poolt send_atR
R R t kwargst paramsR R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt send� s ^
( t __doc__t
__future__R R R t loggingt salt.utils.jsonR t salt.utils.versionsR R' R t ImportErrorR R t getLoggert __file__R R R R R R R R R R+ R5 ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/mandrill.pyt <module> s8
&
Mini Shell