o hP@sddlZddlZddlmZddlmZmZddlmZddlmZddl m Z m Z m Z ddl mZddlZddlmZdd lmZmZdd lmZdd lmZdd lmZmZdd lmZmZddlm Z m!Z!ej"e#fZ$e%Z&ddZ'ddZ(e&fddZ)ddZ*dCddZ+dCddZ,Gddde%Z-Gddde%Z.d d!Z/e&ddd"fd#d$Z0d%d&Z1e&fd'd(Z2ed)dded*Z3d+d,Z4d-d.Z5d/d0Z6d1d2Z7d3d4Z8d5d6Z9d7d8Z:d9d:Z;d;d<Zydd>l m?Z?d?d@Z=YnwdAdBZ@dS)DN) b64encode)MappingMutableMapping)datetime)MIMEBase) formatdate getaddressesunquote)mktime)settings)sanitize_addressDEFAULT_ATTACHMENT_MIME_TYPE force_text)Promise)utcget_fixed_timezone)urlsplit urlunsplit)AnymailConfigurationErrorAnymailInvalidAddressc Gs~t}|D]8}|dur t}q|tur<|tur'z|}Wqty&|}Yqwz||Wqty;||}Yqwq|S)aq Combines all non-UNSET args, by shallow merging mappings and concatenating sequences >>> combine({'a': 1, 'b': 2}, UNSET, {'b': 3, 'c': 4}, UNSET) {'a': 1, 'b': 3, 'c': 4} >>> combine([1, 2], UNSET, [3, 4], UNSET) [1, 2, 3, 4] >>> combine({'a': 1}, None, {'b': 2}) # None suppresses earlier args {'b': 2} >>> combine() UNSET N)UNSETcopyAttributeErrorupdate)argsresultvaluer?/var/www/html/env/lib/python3.10/site-packages/anymail/utils.pycombines$     r!cGs2t|D]}|durtS|tur|SqtS)aReturns the last of its args which is not UNSET. (Essentially `combine` without the merge behavior) >>> last(1, 2, UNSET, 3, UNSET, UNSET) 3 >>> last(1, 2, None, UNSET) # None suppresses earlier args UNSET >>> last() UNSET N)reversedr)rrrrr last<s r#c CsH|D]}z||WStyYqw|tur"tdd||S)aReturns the value of the first of keys found in dict dct. >>> getfirst({'a': 1, 'b': 2}, ['c', 'a']) 1 >>> getfirst({'a': 1, 'b': 2}, ['b', 'a']) 2 >>> getfirst({'a': 1, 'b': 2}, ['c']) KeyError >>> getfirst({'a': 1, 'b': 2}, ['c'], None) None zNone of %s found in dict, )KeyErrorrjoin)dctkeysdefaultkeyrrr getfirstRs  r+cCsN|D] \}}||vr t||tr t|tr t|||q|||<qdS)zMerge (recursively) keys and values from dict other into dict dct Works with dict-like objects: dct (and descendants) can be any MutableMapping, and other can be any Mapping N)items isinstancerr update_deep)r'otherr*rrrr r.is   r.cCst|tjs t|r |g}|dus|dgkrgSdd|D}t|}|gkr/|dgkr/dg}dd|D}|D].}|jdksD|jdkrfdj|jd ||rRd |ndd }t |t |krb|d 7}t |q8|S) ayReturns a list of EmailAddress objects from strings in address_list. Essentially wraps :func:`email.utils.getaddresses` with better error messaging and more-useful output objects Note that the returned list might be longer than the address_list param, if any individual string contains multiple comma-separated addresses. :param list[str]|str|None|list[None] address_list: the address or addresses to parse :param str|None field: optional description of the source of these addresses, for error message :return list[:class:`EmailAddress`]: :raises :exc:`AnymailInvalidAddress`: NcSg|]}t|qSrr).0addressrrr z&parse_address_list..)r5r5cSsg|] \}}t||dqS)) display_name addr_spec) EmailAddress)r1nameemailrrr r3sz@Invalid email address '{problem}' parsed from '{source}'{where}.r$ in `%s`)problemsourcewherez. (Maybe missing quotes around a display-name?)) r-six string_typesis_lazyrusernamedomainformatr7r&lenr) address_listfieldaddress_list_stringsname_email_pairsparsedr2errmsgrrr parse_address_listws. rLcCsLt|g|d}t|}|dkr"tdj|||rd|ddd|dS)aParses a single EmailAddress from str address, or raises AnymailInvalidAddress :param str address: the fully-formatted email str to parse :param str|None field: optional description of the source of this address, for error message :return :class:`EmailAddress`: if address contains a single email :raises :exc:`AnymailInvalidAddress`: if address contains no or multiple emails )rGrzGOnly one email address is allowed; found {count} in '{address}'{where}.r;r5)countr2r>r)rLrErrD)r2rGrJrMrrr parse_single_addresssrNc@s8eZdZdZd ddZeddZd dd Zd d ZdS)r8acA sanitized, complete email address with easy access to display-name, addr-spec (email), etc. Similar to Python 3.6+ email.headerregistry.Address Instance properties, all read-only: :ivar str display_name: the address's display-name portion (unqouted, unescaped), e.g., 'Display Name, Inc.' :ivar str addr_spec: the address's addr-spec portion (unquoted, unescaped), e.g., 'user@example.com' :ivar str username: the local part (before the '@') of the addr-spec, e.g., 'user' :ivar str domain: the domain part (after the '@') of the addr-spec, e.g., 'example.com' :ivar str address: the fully-formatted address, with any necessary quoting and escaping, e.g., '"Display Name, Inc." ' (also available as `str(EmailAddress)`) r5NcCsvd|_|durz|\}}Wn tyYnw||_||_z |dd\|_|_WdSty:||_d|_YdSw)N@rr5)_address ValueErrorr6r7splitrBrC)selfr6r7rrr __init__s    zEmailAddress.__init__cCs|jdur ||_|jSN)rP formataddrrSrrr r2s  zEmailAddress.addresscCst|j|jf|S)apReturn a fully-formatted email address, using encoding. This is essentially the same as :func:`email.utils.formataddr` on the EmailAddress's name and email properties, but uses Django's :func:`~django.core.mail.message.sanitize_address` for improved PY2/3 compatibility, consistent handling of encoding (a.k.a. charset), and proper handling of IDN domain portions. :param str|None encoding: the charset to use for the display-name portion; default None uses ascii if possible, else 'utf-8' (quoted-printable utf-8/base64) )r r6r7)rSencodingrrr rVszEmailAddress.formataddrcCs|jSrU)r2rWrrr __str__szEmailAddress.__str__)r5NrU) __name__ __module__ __qualname____doc__rTpropertyr2rVrYrrrr r8s    r8c@s$eZdZdZddZeddZdS) AttachmentaA normalized EmailMessage.attachments item with additional functionality Normalized to have these properties: name: attachment filename; may be None content: bytestream mimetype: the content type; guessed if not explicit inline: bool, True if attachment has a Content-ID header content_id: for inline, the Content-ID (*with* <>); may be None cid: for inline, the Content-ID *without* <>; may be empty string cCs||_||_d|_d|_d|_t|trX||_|j dd|_ |j dur9t |dr0| |_ n | |j|_ ||_t|dkrWd|_|d|_|jdurWt|j|_n|\|_|_ |_t|j|_t|j |_ |jdur|jdurt|j\|_}|jdurt|_dSdS)NFr5T)decodeas_bytesinlinez Content-ID) _attachmentrXrb content_idcidr-r get_filenamer9 get_payloadcontenthasattrra as_stringencodeget_content_typemimetypeget_content_dispositionr force_non_lazy mimetypes guess_typer )rS attachmentrX_rrr rTs6              zAttachment.__init__cCs,|j}t|tjr||j}t|dS)z(Content encoded as a base64 ascii stringascii)rhr-r? text_typerkrXrr`)rSrhrrr b64content4s  zAttachment.b64contentN)rZr[r\r]rTr^rvrrrr r_s  &r_cCs0|d}|dur dSt|ddS)zReturn the message's content-disposition if it exists, or None. Backport of py3.5 :func:`~email.message.Message.get_content_disposition` zcontent-dispositionN;r)getstr partitionstriplower)mimeobjrrrr rn=s rnFc Cs&z||}|dvr|dur|WSn|WSWn ttfy!Ynw|dur5d|dd|}n|}d|}ztj|WSttfyztt|WYSty|rqz tt|WYYStypYnw|t urd||f}|r|d|7}|d 7}t ||YYSww) aReturns an Anymail option from kwargs or Django settings. Returns first of: - kwargs[name] -- e.g., kwargs['api_key'] -- and name key will be popped from kwargs - settings.ANYMAIL['_'] -- e.g., settings.ANYMAIL['MAILGUN_API_KEY'] - settings.ANYMAIL__ -- e.g., settings.ANYMAIL_MAILGUN_API_KEY - settings._ (only if allow_bare) -- e.g., settings.MAILGUN_API_KEY - default if provided; else raises AnymailConfigurationError If allow_bare, allows settings._ without the ANYMAIL_ prefix: ANYMAIL = { "MAILGUN_API_KEY": "xyz", ... } ANYMAIL_MAILGUN_API_KEY = "xyz" MAILGUN_API_KEY = "xyz" )rBpasswordNz{}_{} rsz ANYMAIL_%sz(You must set %s or ANYMAIL = {'%s': ...}z or %sz in your Django settings) poprr%rDupperreplacer ANYMAILgetattrrr) r9r)esp_namekwargs allow_barersettinganymail_settingmessagerrr get_anymail_settingIsH       rc CsHg}|jD]}zt||}Wn tyYqw||vr!||q|S)aIReturn list of all `method_name` methods for cls and its superclass chain. List is in MRO order, with no duplicates. Methods are unbound. (This is used to simplify mixins and subclasses that contribute to a method set, without requiring superclass chaining, and without requiring cooperating superclasses.) )__mro__rrappend)cls method_namemethodsancestor validatorrrr collect_all_methodss   rcCs2||}t|dkr|dS|tur|S||S)aLike :func:`django.http.QueryDict.get`, but returns *first* value of multi-valued field. >>> from django.http import QueryDict >>> q = QueryDict('a=1&a=2&a=3') >>> querydict_getfirst(q, 'a') '1' >>> q.get('a') '3' >>> q['a'] '3' You can bind this to a QueryDict instance using the "descriptor protocol": >>> q.getfirst = querydict_getfirst.__get__(q) >>> q.getfirst('a') '1' r)getlistrEr)qdictrGr)valuesrrr querydict_getfirsts  ri)tzinfocCsDz|WSty!|jdurt|YS|tYSw)zBReturn the unix timestamp (seconds past the epoch) for datetime dtN) timestamprrr timetupleEPOCH total_seconds)dtrrr rs   rcCst|}t|ddS)zReturn s surrounded by angle brackets, added only if necessaryr<>)rEsrrr angle_wraps   rcCs t|tS)z+Return True if obj is a Django lazy object.)r-robjrrr rAs rAcCst|r t|S|S)zIf obj is a Django lazy object, return it coerced to text; otherwise return it unchanged. (Similar to django.utils.encoding.force_text, but doesn't alter non-text objects.) )rAr?rurrrr ros roc Cs0zdd|DWSttfyt|YSw)zIReturn a (shallow) copy of sequence obj, with all values forced non-lazy.cSr0r)ro)r1itemrrr r3r4z'force_non_lazy_list..)r TypeErrorrorrrr force_non_lazy_lists  rc Cs4z dd|DWSttfyt|YSw)zBReturn a (deep) copy of dict obj, with all values forced non-lazy.cSsi|] \}}|t|qSr)force_non_lazy_dict)r1r*rrrr sz'force_non_lazy_dict..)r,rrrorrrr rs  rc CsTz|jd\}}|dkrt|dWSWdStttt fy)YdSw)zReturns HTTP basic auth string sent with request, or None. If request includes basic auth, result is string 'username:password'. HTTP_AUTHORIZATIONbasiczutf-8N) METArRr|base64 b64decoder` IndexErrorr%rrQ)requestauthtypeauthdatarrr get_request_basic_auths rcCsH|}t|}|dur"t|}t|j|d|j|j|j|jf}|S)zReturns the "exact" url used to call request. Like :func:`django.http.request.HTTPRequest.build_absolute_uri`, but also inlines HTTP basic auth, if present. NrO) build_absolute_urirrrschemenetlocpathqueryfragment)rurl basic_authpartsrrr get_request_uris r)parsedate_to_datetime) parsedate_tzcCsZt|}|d}|dus|dkrd|vrt|ddSt|d}t|ddd|iS)Nrrz-0000<r)rrr)rdtupletzrrrr rs  rc Cs&zt|WStttfyYdSw)aNParses an RFC-2822 formatted date string into a datetime.datetime Returns None if string isn't parseable. Returned datetime will be naive if string doesn't include known timezone offset; aware if it does. (Same as Python 3 email.utils.parsedate_to_datetime, with improved handling for unparseable date strings.) N)rrrrQrrrr parse_rfc2822date+s  rrU)Arrpr collectionsrrremail.mime.baser email.utilsrrr timer r? django.confr django.core.mail.messager r django.utils.encodingrdjango.utils.functionalrdjango.utils.timezonerrsix.moves.urllib.parserr exceptionsrr integer_typesfloatBASIC_NUMERIC_TYPESobjectrr!r#r+r.rLrNr8r_rnrrrrrrrrArorrrrr ImportErrorrrrrrr s^        !   1H; 9