*jR D S r SSKJr SSKJr SSKJr SSKJr " S S5 r " S S 5 r " S
S \
5 r S r " S
S5 r
" S S\
5 r " S S5 r " S S\5 r " S S5 r " S S\5 r " S S\5 r " S S \5 r " S S 5 r " S S 5 r " S! S"\5 r " S# S$\5 r " S% S&5 r " S' S(5 r " S) S*5 r0 S+\_S,\_S-\_S.\_S/\_S0\_S1\_S2\_S3\_S4\_S5\_S6\_S7\_S8\_S9\_S:\_S;\_\\\\\S<.Er " S= S>5 r g?)@zRepresenting and manipulating email headers via custom objects.
This module provides an implementation of the HeaderRegistry API.
The implementation is designed to flexibly follow RFC5322 rules.
)MappingProxyType)utils)errors)_header_value_parserc p \ rS rSrS S jr\S 5 r\S 5 r\S 5 r\S 5 r S r
S r S
r S r
g)
Address Nc SR [ SXX445 5 nSU; d SU; a [ S5 eUb U( d U( a [ S5 e[ R
" U5 u pgU( a [ SR
Xd5 5 eUR ( a UR S eUR nUR nXl
X l X0l g) a Create an object representing a full email address.
An address can have a 'display_name', a 'username', and a 'domain'. In
addition to specifying the username and domain separately, they may be
specified together by using the addr_spec keyword *instead of* the
username and domain keywords. If an addr_spec string is specified it
must be properly quoted according to RFC 5322 rules; an error will be
raised if it is not.
An Address object has display_name, username, domain, and addr_spec
attributes, all of which are read-only. The addr_spec and the string
value of the object are both quoted according to RFC5322 rules, but
without any Content Transfer Encoding.
N
z8invalid arguments; address parts cannot contain CR or LFz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r )
joinfilter
ValueError TypeErrorparser
get_addr_specformat all_defects
local_partdomain
_display_name _username_domain)self display_nameusernamer addr_specinputsa_srests ;/opt/alt/python313/lib64/python3.13/email/headerregistry.py__init__Address.__init__ s " |v&QRS 6>TV^ WX X 6 !8 9 9 ,,Y7IC "==CV$'>45 5 ooa((~~HZZF )! c U R $ Nr r s r" r Address.display_name8 !!!r% c U R $ r' )r r) s r" r Address.username< ~~ r% c U R $ r' )r r) s r" r Address.domain@ ||r% c U R n[ R R U5 ( d [ R " U5 nU R
( a US- U R
- $ U( d gU$ )zThe addr_spec (username@domain) portion of the address, quoted
according to RFC 5322 rules, but with no Content Transfer Encoding.
@<>)r r
DOT_ATOM_ENDS
isdisjoint quote_stringr )r lps r" r Address.addr_specD sY
]]##..r22$$R(B ;;8dkk) ) r% c SR U R R U R U R U R
5 $ )Nz1{}(display_name={!r}, username={!r}, domain={!r}))r __class____name__r r r r) s r" __repr__Address.__repr__R s9 BII // ))4==$++G Gr% c U R n[ R R U5 ( d [ R " U5 nU( a/ U R
S:X a SO U R
nSR
X5 $ U R
$ )Nr4 r z{} <{}>)r r SPECIALSr6 r7 r r )r dispr s r" __str__Address.__str__W sf ))$//&&t,D "nnd 2I ##D4 4~~ r% c [ U[ 5 ( d [ $ U R UR :H =( a9 U R UR :H =( a U R
UR
:H $ r' )
isinstancer NotImplementedr r r r others r" __eq__Address.__eq__` sX %))! !!!U%7%77 ,
/, u||+ -r% )r r r )r r r N)r<
__module__ __qualname____firstlineno__r# propertyr r r r r= rB rI __static_attributes__ r% r" r r sh ( T " " G
-r% r c P \ rS rSrS
S jr\S 5 r\S 5 rS rS r S r
S r g) Grouph Nc ^ Xl U( a [ U5 U l g[ 5 U l g)a Create an object representing an address group.
An address group consists of a display_name followed by colon and a
list of addresses (see Address) terminated by a semi-colon. The Group
is created by specifying a display_name and a possibly empty list of
Address objects. A Group can also be used to represent a single
address that is not in a group, which is convenient when manipulating
lists that are a combination of Groups and individual Addresses. In
this case the display_name should be set to None. In particular, the
string representation of a Group whose display_name is None is the same
as the Address object, if there is one and only one Address object in
the addresses list.
N)r tuple
_addresses)r r addressess r" r# Group.__init__j s *.7% *UWr% c U R $ r' r( r) s r" r Group.display_name| r+ r% c U R $ r' )rV r) s r" rW Group.addresses s r% c x SR U R R U R U R 5 $ )Nz${}(display_name={!r}, addresses={!r})r r; r< r rW r) s r" r= Group.__repr__ s1 5<< ((""DNN4 4r% c U R c1 [ U R 5 S:X a [ U R S 5 $ U R nUb: [ R
R
U5 ( d [ R " U5 nSR S U R 5 5 nU( a SU- OUnSR X5 $ )N r , c 3 8 # U H n[ U5 v M g 7fr' )str).0xs r" Group.__str__.. s :>a3q66>s z{}:{};)
r lenrW rc r r@ r6 r7 r r )r rA adrstrs r" rB
Group.__str__ s $T^^)$>t$D$D&&t,D:4>>::!'v Vt,,r% c [ U[ 5 ( d [ $ U R UR :H =( a U R UR :H $ r' )rE rR rF r rW rG s r" rI Group.__eq__ sC %''! !!!U%7%77 2%//1 3r% )rV r )NN) r< rK rL rM r# rN r rW r= rB rI rO rP r% r" rR rR h s? E$ " " 4
-3r% rR c ` \ rS rSrSrS rS r\S 5 r\S 5 r S r
\ S 5 r S r
S
rg )
BaseHeader a Base class for message headers.
Implements generic behavior and provides tools for subclasses.
A subclass must define a classmethod named 'parse' that takes an unfolded
value string and a dictionary as its arguments. The dictionary will
contain one key, 'defects', initialized to an empty list. After the call
the dictionary must contain two additional keys: parse_tree, set to the
parse tree obtained from parsing the header, and 'decoded', set to the
string value of the idealized representation of the data from the value.
(That is, encoded words are decoded, and values that have canonical
representations are so represented.)
The defects key is intended to collect parsing defects, which the message
parser will subsequently dispose of as appropriate. The parser should not,
insofar as practical, raise any errors. Defects should be added to the
list instead. The standard header parsers register defects for RFC
compliance issues, for obsolete RFC syntax, and for unrecoverable parsing
errors.
The parse method may add additional keys to the dictionary. In this case
the subclass must define an 'init' method, which will be passed the
dictionary as its keyword arguments. The method should use (usually by
setting them as the value of similarly named attributes) and remove all the
extra keys added by its parse method, and then use super to call its parent
class with the remaining arguments and keywords.
The subclass should also make sure that a 'max_count' attribute is defined
that is either None or 1. XXX: need to better define this API.
c S/ 0nU R X#5 [ R " US 5 ( a [ R " US 5 US' [ R XS 5 nUS UR " U40 UD6 U$ )Ndefectsdecoded)parser _has_surrogates _sanitizerc __new__init)clsnamevaluekwdsr s r" rw BaseHeader.__new__ sq 2 % i 1 1 #ood9o >DO{{3Y0 O $ $ r% c ( Xl X l X0l g r' )_name _parse_tree_defects)r rz
parse_treerr s r" rx BaseHeader.init s
%
r% c U R $ r' )r r) s r" rz BaseHeader.name s zzr% c , [ U R 5 $ r' )rU r r) s r" rr BaseHeader.defects s T]]##r% c [ U R R U R R [ U 5 4U R 5 4$ r' )_reconstruct_headerr; r< __bases__rc __getstate__r) s r"
__reduce__BaseHeader.__reduce__ sC ''((D
! !r% c , [ R X5 $ r' )rc rw )ry r{ s r" _reconstructBaseHeader._reconstruct s {{3&&r% c [ R " [ R " [ R " U R S5 [ R " SS5 /5 /5 nU R
( a; UR
[ R " [ R " SS5 /5 5 UR
U R
5 UR US9$ )a$ Fold header according to policy.
The parsed representation of the header is folded according to
RFC5322 rules, as modified by the policy. If the parse tree
contains surrogateescaped bytes, the bytes are CTE encoded using
the charset 'unknown-8bit".
Any non-ASCII characters in the parse tree are CTE encoded using
charset utf-8. XXX: make this a policy setting.
The returned value is an ASCII-only string possibly containing linesep
characters, and ending with a linesep character. The string includes
the header name and the ': ' separator.
z header-name:z
header-seprh fws)policy)
r Header HeaderLabel
ValueTerminalrz r appendCFWSListWhiteSpaceTerminalfold)r r headers r" r BaseHeader.fold s " $$TYY
>$$S,7 9
:
MM!:!:3!F GH
J
d&&'{{&{))r% )r r r N)r< rK rL rM __doc__rw rx rN rz rr r classmethodr r rO rP r% r" ro ro sX @
$ $! ' '*r% ro c 8 [ X0 5 R U5 $ r' )typer )cls_namebasesr{ s r" r r s $ 1 1% 88r% c L \ rS rSrSr\" \R 5 r\ S 5 r
Sr g)UnstructuredHeaderi Nc N U R U5 US' [ US 5 US' g )Nr rs ) value_parserrc ry r{ r| s r" rt UnstructuredHeader.parse s* - -e 4\ d< 01Yr% rP ) r< rK rL rM max_count staticmethodr get_unstructuredr r rt rO rP r% r" r r s) I 7 78L2 2r% r c \ rS rSrSrSrg)UniqueUnstructuredHeaderi r` rP Nr< rK rL rM r rO rP r% r" r r Ir% r c t ^ \ rS rSrSrSr\" \R 5 r \
S 5 r U 4S jr \
S 5 rSrU =r$ )
DateHeaderi ay Header whose value consists of a single timestamp.
Provides an additional attribute, datetime, which is either an aware
datetime using a timezone, or a naive datetime if the timezone
in the input string is -0000. Also accepts a datetime as input.
The 'value' attribute is the normalized form of the timestamp,
which means it is the output of format_datetime on the datetime.
Nc U( dJ US R [ R " 5 5 S US' SUS' [ R " 5 US' g [ U[ 5 ( a XS' [ R " U5 nXS' [ R " US 5 US' U R US 5 US' g ! [ aH US R [ R " S5 5 S US' [ R " 5 US' g f = f)Nrr datetimer rs r z Invalid date value or format)
r r HeaderMissingRequiredValuer TokenListrE rc r parsedate_to_datetimer InvalidDateDefectformat_datetimer r s r" rt DateHeader.parse$ s O " "6#D#D#F G #D DO!'!1!1!3D eS ! ! #O
33E: !Z //Z0@AY - -d9o >\
Y&&v'?'?@^'_`#'Z %+%5%5%7\"
s ,B: :AD D c R > UR S5 U l [ TU ] " U0 UD6 g )Nr )pop _datetimesuperrx r argskwr; s r" rx DateHeader.init9 s$
+
d!b!r% c U R $ r' r r) s r" r DateHeader.datetime= r. r% r )r< rK rL rM r r r r r r r rt rx rN r rO
__classcell__r; s @r" r r sL I 7 78L? ?(" r% r c \ rS rSrSrSrg)UniqueDateHeaderiB r` rP Nr rP r% r" r r B r r% r c l ^ \ rS rSrSr\S 5 r\S 5 rU 4S jr \
S 5 r \
S 5 r Sr
U =r$ )
AddressHeaderiG Nc R [ R " U 5 u pU ( a S5 eU$ )Nzthis should not happen)r get_address_list)r{ address_lists r" r AddressHeader.value_parserK s) $ 5 5e < 222yr% c
[ U[ 5 ( a U R U5 =US' n/ nUR H nUR [ UR UR Vs/ s HI n[ UR =( d SUR =( d SUR =( d S5 PMK sn5 5 M [ UR 5 nOF[ US5 ( d U/nU Vs/ s H# n[ US5 ( d
[ S U/5 OUPM% nn/ nXBS' XrS' SR U Vs/ s H n[ U5 PM sn5 US' SU; a U R US 5 US' g g s snf s snf s snf ) Nr r __iter__rW groupsrr ra rs )rE rc r rW r rR r
all_mailboxesr r r listr hasattrr ) ry r{ r| r r addrmbrr items r" rt AddressHeader.parseQ s eS ! ! 140@0@0G GD F$..
eD$5$5 04/A/A%C 0B &-R__-B-/]]-@b-/YY_"&> 0B%C D E / <334G 5*-- 16705 29{1K1KeD4&)/3405
7 G X!Y ))6$B64SY6$BCY t #!$!1!1$y/!BD $!%C7 %Cs &AE63*E;8F c r > [ UR S5 5 U l S U l [ TU ] " U0 UD6 g )Nr )rU r _groupsrV r rx r s r" rx AddressHeader.initm s0 RVVH -.
d!b!r% c U R $ r' )r r) s r" r AddressHeader.groupsr r1 r% c v U R c! [ S U R 5 5 U l U R $ )Nc 3 N # U H nUR H nUv M M g 7fr' )rW )rd groupaddresss r" rf *AddressHeader.addresses..y s' $L ;@?? %,;J %, s #%)rV rU r r) s r" rW AddressHeader.addressesv s5 ?? " # $L $L LDO r% )rV r )r< rK rL rM r r r r rt rx rN r rW rO r r s @r" r r G s] I
C C6"
r% r c \ rS rSrSrSrg)UniqueAddressHeaderi~ r` rP Nr rP r% r" r r ~ r r% r c $ \ rS rSr\S 5 rSrg)SingleAddressHeaderi c [ U R 5 S:w a$ [ SR U R 5 5 eU R S $ )Nr` z9value of single address header {} is not a single addressr )ri rW r r rz r) s r" r SingleAddressHeader.address sB t~~ ! #$*F499$57
7~~a r% rP N)r< rK rL rM rN r rO rP r% r" r r s
! !r% r c \ rS rSrSrSrg)UniqueSingleAddressHeaderi r` rP Nr rP r% r" r r r r% r c ^ \ rS rSrSr\" \R 5 r\ S 5 r
U 4S jr \ S 5 r
\ S 5 r\ S 5 rSrU =r$ ) MIMEVersionHeaderi r` c > U R U5 =US' n[ U5 US' US R UR 5 UR c S O UR
US' UR US' UR b SR
US US 5 US' g S US' g )Nr rs rr majorminorz{}.{}version)r rc extendr r r r ry r{ r| r s r" rt MIMEVersionHeader.parse s *-*:*:5*AA\Z j/Y Y z 5 56 * 0 0 8j>N>NW
"((W
' %nnT']DM JDO "DOr% c > UR S5 U l UR S5 U l UR S5 U l [ TU ] " U0 UD6 g )Nr r r )r _version_major_minorr rx r s r" rx MIMEVersionHeader.init sB y)
ffWo ffWo
d!b!r% c U R $ r' )r r) s r" r MIMEVersionHeader.major {{r% c U R $ r' )r r) s r" r MIMEVersionHeader.minor r r% c U R $ r' )r r) s r" r MIMEVersionHeader.version }} r% )r r r )r< rK rL rM r r r parse_mime_versionr r rt rx rN r r r rO r r s @r" r r sk I 9 9:L # #" r% r c L ^ \ rS rSrSr\S 5 rU 4S jr\S 5 r Sr
U =r $ )ParameterizedMIMEHeaderi r` c p U R U5 =US' n[ U5 US' US R UR 5 UR c 0 US' g UR VVs0 s H> u pA[
R " U5 R 5 [
R " U5 _M@ snnUS' g s snnf )Nr rs rr params)r rc r r r r rv lower)ry r{ r| r rz s r" rt ParameterizedMIMEHeader.parse s *-*:*:5*AA\Z j/Y Y z 5 56 $ DN
3=2C2C E2C;4 $ood 3 9 9 ;$)OOE$: ;2C EDN Es %AB2c R > UR S5 U l [ TU ] " U0 UD6 g )Nr )r _paramsr rx r s r" rx ParameterizedMIMEHeader.init s$ vvh'
d!b!r% c , [ U R 5 $ r' )r r r) s r" r ParameterizedMIMEHeader.params s --r% )r ) r< rK rL rM r r rt rx rN r rO r r s @r" r r s7
I
E
E" . .r% r c | ^ \ rS rSr\" \R 5 rU 4S jr\ S 5 r
\ S 5 r \ S 5 r Sr
U =r$ )ContentTypeHeaderi c > [ TU ] " U0 UD6 [ R " U R R
5 U l [ R " U R R 5 U l g r' ) r rx r rv r maintype _maintypesubtype_subtyper s r" rx ContentTypeHeader.init sL
d!b! )9)9)B)BC (8(8(@(@A
r% c U R $ r' )r r) s r" r ContentTypeHeader.maintype r. r% c U R $ r' )r r) s r" r ContentTypeHeader.subtype r r% c : U R S- U R - $ )N/)r r r) s r" content_type ContentTypeHeader.content_type s }}s"T\\11r% )r r )r< rK rL rM r r parse_content_type_headerr rx rN r r r rO r r s @r" r r sU @ @ALB
2 2r% r c \ ^ \ rS rSr\" \R 5 rU 4S jr\ S 5 r
Sr U =r $ )ContentDispositionHeaderi c > [ TU ] " U0 UD6 U R R nUc X0l g [ R
" U5 U l g r' )r rx r content_dispositionr rv _content_disposition)r r r cdr; s r" rx ContentDispositionHeader.init s?
d!b!
1
1*,*B!%//":M!r% c U R $ r' r$ r) s r" r# ,ContentDispositionHeader.content_disposition s (((r% r( )
r< rK rL rM r r parse_content_disposition_headerr rx rN r# rO r r s @r" r! r! s- G GHLN
) )r% r! c p ^ \ rS rSrSr\" \R 5 r\ S 5 r
U 4S jr \ S 5 r
SrU =r$ ) ContentTransferEncodingHeaderi r` c U R U5 =US' n[ U5 US' US R UR 5 g Nr rs rr r rc r r r s r" rt #ContentTransferEncodingHeader.parse A *-*:*:5*AA\Z j/Y Y z 5 56r% c > [ TU ] " U0 UD6 [ R " U R R
5 U l g r' )r rx r rv r cte_cter s r" rx "ContentTransferEncodingHeader.init s0
d!b!OOD$4$4$8$89 r% c U R $ r' r4 r) s r" r3 !ContentTransferEncodingHeader.cte s yyr% r7 )r< rK rL rM r r r &parse_content_transfer_encoding_headerr r rt rx rN r3 rO r r s @r" r, r, sC I M MNL7 7
: r% r, c L \ rS rSrSr\" \R 5 r\ S 5 r
Sr g)MessageIDHeaderi
r` c U R U5 =US' n[ U5 US' US R UR 5 g r. r/ r s r" rt MessageIDHeader.parse r1 r% rP N) r< rK rL rM r r r parse_message_idr r rt rO rP r% r" r; r;
s) I 7 78L7 7r% r; c L \ rS rSrSr\" \R 5 r\ S 5 r
Sr g)ReferencesHeaderi r` c U R U5 =US' n[ U5 US' US R UR 5 g r. r/ r s r" rt ReferencesHeader.parse r1 r% rP N) r< rK rL rM r r r parse_message_idsr r rt rO rP r% r" r@ r@ s) I 8 89L7 7r% r@ subjectdatez resent-datez orig-datesenderz
resent-sendertoz resent-toccz resent-ccbccz
resent-bccfromz resent-fromzreply-toz mime-versionz content-type)zcontent-dispositionzcontent-transfer-encodingz
message-idz in-reply-to
referencesc : \ rS rSrSr\\S4S jrS rS r S r
Sr g )
HeaderRegistryi@ z%A header_factory and header registry.Tc x 0 U l Xl X l U( a U R R [ 5 gg)a Create a header_factory that works with the Policy API.
base_class is the class that will be the last class in the created
header class's __bases__ list. default_class is the class that will be
used if "name" (see __call__) does not appear in the registry.
use_default_map controls whether or not the default mapping of names to
specialized classes is copied in to the registry when the factory is
created. The default is True.
N)registry
base_class
default_classupdate_default_header_map)r rP rQ use_default_maps r" r# HeaderRegistry.__init__D s1
$ * MM !4 5 r% c < X R UR 5 ' g)zLRegister cls as the specialized class for handling "name" headers.
N)rO r r rz ry s r" map_to_typeHeaderRegistry.map_to_typeV s '*
djjl#r% c U R R UR 5 U R 5 n[ SUR
- X R 40 5 $ )N_)rO getr rQ r r< rP rW s r" __getitem__HeaderRegistry.__getitem__\ sC mm
d.@.@AC $sOO&rd s
# 0Y- Y-x/3 /3ha* a*H92 2 1
+ + \z
4 4 n-
!- ! 3
" " J. .:2/ 2, ) 6 ) * 7 7 7 7
$<
$4 J $4
$= $7
$7 M $7 M
$7 M $7 M $7 $5!" $5#$ %=$A$3$4$4- 2*' *'r%