[.jeSrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r J r J r SSKJrJrJrJrJrJrJrJrJrJrJrJrJrJr \R:"\5rSr Sr!Sr"Sr#S r$"S S 5r%g) aR Copyright 2016 Fedele Mantuano (https://twitter.com/fedelemantuano) Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. N)ADDRESSES_HEADERSEPILOGUE_DEFECTSREGXIPREGXIP6)convert_mail_datedecode_header_partextract_msg_convert find_between get_addresses get_header get_mail_keysget_to_domains msgconvert ported_open ported_string random_stringreceiveds_parsingwrite_attachmentsc,[RU5$)z Parsing email from a file-like object. Args: fp (file-like object): file-like object of raw email Returns: Instance of MailParser with raw email parsed ) MailParser from_file_objfps L/home/mande/repo/quber/.venv/lib/python3.13/site-packages/mailparser/core.pyparse_from_file_objr0  # #B ''c,[RU5$)z Parsing email from file. Args: fp (string): file path of raw email Returns: Instance of MailParser with raw email parsed )r from_filers rparse_from_filer =s    ##rc,[RU5$)z Parsing email from file Outlook msg. Args: fp (string): file path of raw Outlook email Returns: Instance of MailParser with raw email parsed )r from_file_msgrs rparse_from_file_msgr#Jrrc,[RU5$)zx Parsing email from string. Args: s (string): raw email Returns: Instance of MailParser with raw email parsed )r from_string)ss rparse_from_stringr'Ws  ! !! $$rc,[RU5$)z Parsing email from bytes. Only for Python 3 Args: bt (bytes-like object): raw email as bytes-like object Returns: Instance of MailParser with raw email parsed )r from_bytes)bts rparse_from_bytesr+ds   $$rc0\rSrSrSrS,SjrS\4Sjr\S5r \S-Sj5r \S 5r \S 5r \S 5r S rS rS.SjrSrSrSrSrSr\S5r\S5r\S5r\S5r\S5r\S\4Sj5r\S5r\S5r\S5r \S5r!\S5r"\S5r#\S 5r$\S!5r%\S"5r&\S#5r'\S$5r(\S%5r)\S&5r*\S'5r+\S(5r,\S)5r-\S*5r.S+r/g)/rqa MailParser package provides a standard parser that understands most email document structures like official email package. MailParser handles the encoding of email and split the raw email for you. Headers: https://www.iana.org/assignments/message-headers/message-headers.xhtml NcXlUbA[RSRSR UR 5555 UR 5 g)z4 Init a new object from a message object structure. NzAll headers of emails: {}z, )_messagelogdebugformatjoinkeysparse)selfmessages r__init__MailParser.__init__{s?   II1887<<>9RS T rreturncbUR(a[UR5$[5$N)r7strsubjectr6s r__str__MailParser.__str__s <<t||$ $5Lrc[RS5 URS5 UR 5nUR U5$![a N-f=f!UR 5nf=f)z Init a new object from a file-like object. Not for Outlook msg. Args: fp (file-like object): file-like object of raw email Returns: Instance of MailParser zParsing email from file objectr)r0r1seekOSErrorreadr%)clsrr&s rrMailParser.from_file_objsa 23  GGAJ  Aq!!     As#A AAAAA+c&[RSU<35 [U5n[R"U5nSSS5 U(a/[RSU<35 [ R "U5 U"W5$!,(df  NL=f)z Init a new object from a file path. Args: fp (string): file path of raw email is_outlook (boolean): if True is an Outlook email Returns: Instance of MailParser zParsing email from file Nz&Removing temp converted Outlook email )r0r1remailmessage_from_fileosremove)rFr is_outlookfr7s rrMailParser.from_filesl ,RF34 _--a0G  II>rfE F IIbM7|_s B Bc[RS5 [RR S5b[ U5up#O"[R S5 [U5up#URUS5$)u Init a new object from a Outlook message file, mime type: application/vnd.ms-outlook Conversion backend precedence: 1. ``extract-msg`` (pure Python, optional ``outlook`` extra). 2. ``msgconvert`` external Perl tool — **deprecated** fallback, used only when ``extract-msg`` is not installed. Args: fp (string): file path of raw Outlook email Returns: Instance of MailParser Raises: MailParserOSError: if no conversion backend is available zParsing email from file Outlook extract_msgzmsgconvert backend is deprecated and will be removed in a future release. Install the pure-Python Outlook support with 'pip install mail-parser[outlook]'.T) r0r1 importlibutil find_specr warningrr)rFrrN_s rr"MailParser.from_file_msgsd( 34 >> # #M 2 >&r*DAq KKC  b>DA}}Q%%rch[RS5 [R"U5nU"U5$)zh Init a new object from a string. Args: s (string): raw email Returns: Instance of MailParser zParsing email from string)r0r1rImessage_from_string)rFr&r7s rr%MailParser.from_strings+ -.++A.7|rch[RS5 [R"U5nU"U5$)z Init a new object from bytes. Args: bt (bytes-like object): raw email as bytes-like object Returns: Instance of MailParser zParsing email from bytes)r0r1rImessage_from_bytes)rFr*r7s rr)MailParser.from_bytess+ ,-**2.7|rc[RS5 /Ul/Ul/Ul/Ul/Ul[5UlSUl g)z! Reset the state of mail object. zReset all variablesFN) r0r1 _attachments _text_plain _text_html_text_not_managed_defectsset_defects_categories _has_defectsr?s r_resetMailParser._resetsI '(!# #&5 !rc0nURHnURRSUR3nURR URR5 UR U/5RU5 [RSU<35 M U(a#SUl URRU5 gg)z Add new defects and defects categories to object attributes. The defects are a list of all the problems found when parsing this message. Args: part (string): mail part part_content_type (string): content type of part z: z Added defect TN) defects __class____name____doc__readd setdefaultappendr0r1rfrc)r6partpart_content_type part_defectserjs r_append_defectsMailParser._append_defectss A--.b   # #$5r : A A' J II g[1 2   $D  MM  . rc80n[URU5nUH4n[RSU<35 [ X5nU(dM0XRU'M6 UR US'UR (a'UR US'[UR5US'U$)z This method assigns the right values to all tokens of email. Returns a parsed object Keyword Arguments: complete {bool} -- If True returns all mails parts (default: {True}) Returns: dict -- Parsed email object zGetting header or part has_defectsrjdefects_categories) r r7r0r1getattrrxrjlistry)r6completemailr4ivalues r _make_mailMailParser._make_mail#sT\\84A II/u5 6D$EuQ #..]   "llDO)-d.E.E)FD% & rc bUR(dU$UR5 /nURR5H5nUR5nUR X#5 UR U5 M7 UR [-(a[RS5 [URRSRSURR5-5SRSURR5-S-55nUb([R"U5nUR U5 [%U5GHVupRUR'5(a-[)UR+55R-5S:XdMHUR/S5nUR/5n[RSU<S U<35 [)UR+55R-5n[RS U<S U<35 [)UR1S 55n [RS U <S U<35 [)UR355n [RS U <S U<35 [5UR755n Sn U (aSn O=U (a U S;aSn U n O+U S;aSn [95S3n OUS:XaSn [95S3n U (GaX[RSU<S35 [RSU <S U<35 Sn [)UR55n[RSU<S U<35 [)UR1SS55R-5n[RSU<S U<35 [)UR1S55n[RS U<S U<35 UR'5(a^SR;UR=SS9Vs/sHnUR?5PM sn5nSn [RSU <S U<S35 OUS:Xd US:Xa6S U;a0UR=SS9nSn [RSU <S U<S!35 OS"U;aU[@RB"UR=SS95RES#5nSn Sn[RSU <S U<S$35 O5[)UR=SS9US%9n[RSU <S U<S&35 URFR U UU UU UUUS'.5 GM[RSU<S(35 UR=SS9nUR1S)5nU(aUR-5nU(aUS*;aDUR=SS9n[IU[J5(aURMS5 UnO[)UUS%9nO [)UUS%9nU(dGMUR35S,:XaURPR U5 GMUR35S-:XaURRR U5 GM[RUS.UR35<S/35 URVR U5 GMY URY5Ul-URYSS09Ul.g![ a [R#S5 GNf=fs snf![Na URMS#S+5n[)UUS%9nGN4f=f)1zs This method parses the raw email and makes the tokens. Returns: Instance of MailParser with raw email parsed zFound defects in emailsz{}z--Nz,Failed to get epilogue part. Check raw mail. attachmentzutf-8zCharset z part zcontent-disposition content-idz content-id zcontent subtype FT)htmlplainrtfz.rtfz.txtz Email part z is an attachmentz Filename zMail content type zcontent-transfer-encodingzTransfer encoding content-disposition)decodez is multipartbase64z'quoted- printable applicationz is binaryuuencodeasciiz* is binary (uuencode re-encoded to base64))encodingz is not binary)filenamepayloadbinarymail_content_typerrcharsetcontent_transfer_encodingz is not an attachmentzContent-Transfer-Encoding)7bit8bitsurrogateescaperrzEmail content z not handled)r|)/r7rgwalkget_content_typerurpryrr0r1r epiloguer2 get_boundaryrIrY Exceptionerror enumerate is_multipartrget_content_dispositionlowerget_content_charsetgetget_content_subtyper get_filenamerr3 get_payload as_stringr b64encoderr_ isinstancer=encodeUnicodeEncodeErrorrar`rUrbr_mail _mail_partial)r6partsprrrr~r charset_rawcontent_disposition content_idcontent_subtyper is_attachmentrrtransfer_encodingmrcteraw_str orig_bytess rr5MailParser.parseAss||K ""$A ! 2 2 4    6 LLO%  " "%5 5 II/ 0# %% D4<<#<#<#>>? D4<<#<#<#>>EFH #N11(;ALLO e$DANN$$ !:!:!<=CCEU//8335  HWKvaU;<&3A4M4M4O&P&V&V&X# 01D0GvaUST*155+>?  K ~VA5AB"/0E0E0G"H ,_,?vaUKL-ann.>? % $(M!o=N&N(, #-(U3(, &3o%6d#;, <(, &3o%6d#;!II A50ABCII (VA5AB"F(5a6H6H6J(K%II 23D2GvaUST(592>)eg&II 23D2GvaUST*7>S8T*U'II 45H4K6RSQVWX~~''"$''45MMM4OP4OqQ[[]4OP#"' Ih\uM"RS*h6)""*->>"#--u-"=!% Ih\uJ"OP#'88"("2"21===3M"N"U"U##"&,4) '|6!?55 #0MMM6# Ih\uN"ST%%,,(0'.&,1B*43F'29J  II A50EFGmm4m8G%% ;Bll))+r:PRJ -Z8 )9 )9$D-?t,DDLS) )9  dllK8 8 s  E#EcUR$)z. Return a list of all attachments in the mail )r_r?s rrMailParser.attachmentss    rc0URn[U5$)z. Return a list of all received headers parsed ) received_rawr)r6outputs rrMailParser.receivedzs "" ((rcB[R"URSSS9$)z' Return a JSON of all received headers Frindent)rrrr?s r received_jsonMailParser.received_jsons zz$--eAFFrc/nUR(aURRS/5O/HnUR[U55 M U$)z5 Return a list of all received headers in raw format r)r7rrpr)r6rr~s rrMailParser.received_rawsG 9=%%j"52MA MM,Q/ 0N rclSRURUR-UR-5$)za Return all text plain and text html parts of mail delimited from string "--- mail_boundary ---" z --- mail_boundary --- )r3 text_plain text_htmltext_not_managedr?s rbodyMailParser.bodys2 +// OOdnn ,t/D/D D  rc[UR(aURR5O/5S1- nUVs0sHo"[X5_M sn$s snf)z* Return only the headers as Python object headers)rdr7r4rz)r6 all_headersr~s rrMailParser.headerssJ $,,++-2F)T -89[74##[999sAcB[R"URSSS9$)z Return the JSON of headers Frr)rrrr?s r headers_jsonMailParser.headers_jsons zz$,,U1EErcUR$)z1 Return a list of all text plain parts of email. )r`r?s rrMailParser.text_plains rcUR$)z0 Return a list of all text html parts of email. )rar?s rrMailParser.text_htmls rcUR$)z1 Return a list of all text not managed of email. )rbr?s rrMailParser.text_not_manageds %%%rcUR(aURRS5OSnSn[U5up#U$![a U$f=f)z; Return the mail date in datetime.datetime format and UTC. dateNr7rrr)r6rconvrVs rrMailParser.datesV ,0<D  v &zz$++%JJrcUR$)z[ The defects property contains a list of all the problems found when parsing this message. )rcr?s rrjMailParser.defectss }}rcUR$)z, Return a set with only defects categories. )rer?s rryMailParser.defects_categoriess '''rcUR$)z- Return a boolean: True if mail has defects. )rfr?s rrxMailParser.has_defectsrrcUR$)z email.message.Message class. )r/r?s rr7MailParser.messages }}rc\UR(aURR5$S$)z2 Return the entire message flattened as a string. r)r7rr?s rmessage_as_stringMailParser.message_as_string#s" ,0<rrrDsr    QQ"! ( $ ( % %~ 6~ 6r