o hk.@sxddlZddlZddlZddlZddlmZddlmZddlm Z ze Z Wn e y1e Z YnwGdddeZdS)N parseaddr)Resource)SparkPostExceptionc@steZdZdZdZddZddZddZd d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZdS) Transmissionsz Transmission class used to send, list and get transmissions. For detailed request and response formats, see the `Transmissions API documentation `_. transmissionsc Ksniiid}|d|d<|dd|d<|d|d<|d|d<|d|d<|d |d d <|d |d d <|d |d d<|d|d d<|d|d d<|d|d d<|d|d d<|d|d d<|dd|dd<|d|dd<|d|dd<|d}t|tr||}||dd<|d|dd<|d|dd<|d|dd<|d i|dd!<|d"}|r||d#d$<n>|d#g}||}|d%}|d&}|rd'||dd!d(<|||}||}|r|||} || }||d#<|d)g} || |dd)<d*|vr5|d*} || |dd*<|S)+N)contentoptions recipients description return_pathzdefault@sparkpostmail.comcampaign campaign_idmetadatasubstitution_data start_timer track_opens open_tracking track_clicksclick_tracking transactional use_sandboxsandboxskip_suppressionip_pool inline_cssuse_draft_templateFr reply_tosubject from_emailfromhtmltexttemplate template_idcustom_headersheadersrecipient_listr list_idccbcc,CC attachments inline_images)get isinstance string_types_parse_address_extract_recipientsjoin_format_copies_extract_attachments) selfkwargsmodelr r(r r*r+ cc_copies bcc_copiesr.r/r=I/var/www/html/env/lib/python3.10/site-packages/sparkpost/transmissions.py_translate_keyssp                zTransmissions._translate_keyscCslg}t|dkr4||}t|d}|d|D]}|dd||di|jdi|q|S)Nraddress header_tor=)lenr4copydeepcopypopupdate_format_header_to)r8r copiesformatted_copiesmain_recipient recipientr=r=r>r6\s   zTransmissions._format_copiescCs6d|dvrdj|dd|dddS|ddS)Nnamer@z"{name}" <{email}>email)rLrM)format)r8rKr=r=r>rGis    zTransmissions._format_header_tocCsfg}|D],}i}|d|d<|d|d<d|vr$||d|d<n|d|d<||q|S)NtyperLfilenamedata)r0_get_base64_from_fileappend)r8r.formatted_attachments attachmentformatted_attachmentr=r=r>r7qs  z"Transmissions._extract_attachmentscCsDt|d}t|d}Wd|S1swY|S)Nrbascii)openbase64 b64encodereaddecode)r8rPa_fileencoded_stringr=r=r>rRs  z#Transmissions._get_base64_from_filecCs$t|\}}d|i}|r||d<|S)NrMrLr)r8r@rLrMparsed_addressr=r=r>r3s zTransmissions._parse_addresscCsRt|ttfs tdg}|D]}t|tr!|d||iq||q|S)Nz!recipients must be a list or dictr@)r1listdictrr2rSr3)r8r formatted_recipientsrecipr=r=r>r4s   z!Transmissions._extract_recipientscKs0|jdi|}t|}|jd|j|d}|S)a Send a transmission based on the supplied parameters :param list|dict recipients: If list it is an list of email addresses, if dict ``{'address': {'name': 'Name', 'email': 'me' }}`` :param str recipient_list: ID of recipient list, if set recipients above will be ignored :param cc: List of email addresses to send carbon copy to :param bcc: List of email addresses to send blind carbon copy to :param str template: ID of template. If set HTML or text will not be used :param bool use_draft_template: Default to False. Set to true if you want to send a template that is a draft :param str html: HTML part of transmission :param str text: Text part of transmission :param str subject: Subject of transmission :param str from_email: Email that the transmission comes from. The domain must be a verified sending domain to your account or the transmission will fail. You can pass a from email or both from name and from email - `testing@example.com` or `Test Email ` will both work. :param str reply_to: Reply to of transmission :param str description: Description of transmission :param str campaign: Campaign of transmission :param dict metadata: Any data you want to send along with transmission, used in WebHooks :param dict substitution_data: Corresponds to substitutions in html/text content. See `substitutions reference `_. :param attachments: List of dicts. For example: .. code-block:: python dict( type='application/pdf', name='document.pdf', data='base64 encoded string' ) Replace `data` with `filename` if you want the library to perform the base64 conversion. For example: .. code-block:: python dict( type='application/pdf', name='document.pdf', filename='/full/path/to/document.pdf' ) :param inline_images: List of dicts. For example: .. code-block:: python dict( type='image/png', name='imageCID', data='base64 encoded string' ) Replace `data` with `filename` if you want the library to perform the base64 conversion. For example: .. code-block:: python dict( type='image/png', name='imageCID', filename='/full/path/to/image.png' ) :param str start_time: Delay generation of messages until this datetime. Format YYYY-MM-DDTHH:MM:SS+-HH:MM. Example: '2015-02-11T08:00:00-04:00'. :param bool track_opens: Defaults to True. Used to track opens of transmission :param bool track_clicks: Defaults to True. Used to track clicks of transmission :param bool use_sandbox: Flag must be set to use sandbox domain instead of verified sending domain. Limited to a lifetime of 50 transmissions with this domain :param bool transactional: Whether message is transactional or non-transactional for unsubscribe and suppression purposes :param bool skip_suppression: Whether or not to ignore customer suppression rules, for this transmission only. Only applicable if your configuration supports this parameter. (SparkPost Elite only) :param str ip_pool: The name of a dedicated IP pool associated with your account :param bool inline_css: Whether or not to perform CSS inlining :param dict custom_headers: Used to set any headers associated with transmission :returns: a ``dict`` with the ID and number of accepted and rejected recipients :raises: :exc:`SparkPostAPIException` if transmission cannot be sent POST)rQNr=)r?jsondumpsrequesturi)r8r9payloadrQresultsr=r=r>sendsa zTransmissions.sendcCd|j|f}|d|}|S)N%s/%sGETrirhr8transmission_idrirkr=r=r> _fetch_gets zTransmissions._fetch_getcCs||}|dS)z Get a transmission by ID :param str transmission_id: ID of the transmission you want to retrieve :returns: the requested transmission if found :raises: :exc:`SparkPostAPIException` if transmission is not found transmission)rs)r8rrrkr=r=r>r0s zTransmissions.getcKs$d} t|t|jd|j|dS)a. Get a list of your transmissions :param campaign_id: ID of the campaign used by the transmissions :param template_id: ID of the template used by the transmissions :returns: list of transmissions :raises: :exc:`SparkPostAPIException` if API call fails z*This endpoint is deprecated. For details, ro)params)warningswarnDeprecationWarningrhri)r8r9warn_msgr=r=r>ras  zTransmissions.listcCrm)a Delete a transmission by ID :param str transmission_id: ID of the transmission you want to delete :returns: {} if transmission is deleted :raises: :exc:`SparkPostAPIException` if transmission is not found or Canceled rnDELETErprqr=r=r>delete#s zTransmissions.deleteN)__name__ __module__ __qualname____doc__keyr?r6rGr7rRr3r4rlrsr0rar{r=r=r=r>rsB  f r)rZrCrfrv email.utilsrbaser exceptionsr basestringr2 NameErrorstrrr=r=r=r>s